From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 9AC4046BAC; Fri, 18 Jul 2025 16:34:25 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 5D85B40A7F; Fri, 18 Jul 2025 16:34:09 +0200 (CEST) Received: from mgamail.intel.com (mgamail.intel.com [198.175.65.10]) by mails.dpdk.org (Postfix) with ESMTP id 46BFA40A6D for ; Fri, 18 Jul 2025 16:34:07 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1752849248; x=1784385248; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=sMS2yrnn5nhX+7yItg+n+u5485BjKsOTVWAWw3P8zFM=; b=TJCnCr6ILDPg7F089Uu1UNTChpyqMi1uVTXTzcO0pKL+BVAxYE7QAuXE euLvxLn1YkjquG7x5C9KT7Oon87IREb298Qpqk7epXWgrv90LV5U3h7iI Nt14W/V7RTL7xVEGf1KdKpK3k7dI3L9Kj2O2bxBknirVPcxH//Q8XAoih bCCJjcXZspkXnod05glJTKlr0NSdcmED2b1KzHYIG54Z8355iequGIroa S/HEUTDAqGzbKk/AOKyTEjP5Tk2fXvxHWtK7Qb+d8kgzJeoT8Ms7+1PUy ezzgl1t+R00kWITj8qzLFfi8h2VzEI+ExZpNlV8s85XTS1LaCLy3hBEwa g==; X-CSE-ConnectionGUID: 1KoD8hp7SVGmzbew965ULQ== X-CSE-MsgGUID: NvfN0f/+RZ6zidSvjfQkLw== X-IronPort-AV: E=McAfee;i="6800,10657,11496"; a="72597082" X-IronPort-AV: E=Sophos;i="6.16,321,1744095600"; d="scan'208";a="72597082" Received: from fmviesa005.fm.intel.com ([10.60.135.145]) by orvoesa102.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 18 Jul 2025 07:34:07 -0700 X-CSE-ConnectionGUID: /Ab4q3lFTNGwrBlplm9uug== X-CSE-MsgGUID: cU0wop/3TuiyloAAkalEGA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.16,321,1744095600"; d="scan'208";a="162389319" Received: from silpixa00401385.ir.intel.com ([10.237.214.33]) by fmviesa005.fm.intel.com with ESMTP; 18 Jul 2025 07:34:05 -0700 From: Bruce Richardson To: dev@dpdk.org Cc: david.marchand@redhat.com, Bruce Richardson , Chengwen Feng Subject: [PATCH v3 3/9] argparse: allow user-override of help printing Date: Fri, 18 Jul 2025 15:33:49 +0100 Message-ID: <20250718143356.1578988-4-bruce.richardson@intel.com> X-Mailer: git-send-email 2.48.1 In-Reply-To: <20250718143356.1578988-1-bruce.richardson@intel.com> References: <20250520164025.2055721-1-bruce.richardson@intel.com> <20250718143356.1578988-1-bruce.richardson@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org When the arguments passed to argparse include -h/--help then usage information is automatically printed. Provide the capability for the user to supply their own help function for this. Signed-off-by: Bruce Richardson --- doc/guides/prog_guide/argparse_lib.rst | 16 ++++++++++++++++ lib/argparse/rte_argparse.c | 5 ++++- lib/argparse/rte_argparse.h | 7 ++++++- 3 files changed, 26 insertions(+), 2 deletions(-) diff --git a/doc/guides/prog_guide/argparse_lib.rst b/doc/guides/prog_guide/argparse_lib.rst index 9f11714890..b309260d20 100644 --- a/doc/guides/prog_guide/argparse_lib.rst +++ b/doc/guides/prog_guide/argparse_lib.rst @@ -24,6 +24,8 @@ Features and Capabilities #. autosave: used for parsing known value types; #. callback: will invoke user callback to parse. +- Supports automatic help and usage information. + Usage Guide ----------- @@ -193,3 +195,17 @@ Then the user input could contain multiple ``--xyz`` arguments. The multiple times argument only support with optional argument and must be parsed by callback way. + +Help and Usage Information +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The argparse library supports automatic generation of help and usage information. +When the input arguments include ``-h`` or ``--help``, +it will print the usage information to standard output. +If the default help output is not what is wanted, +the user can provide a custom help printing function by setting the ``print_help`` field in the ``rte_argparse`` object. +(If this field is set to NULL, the default help printing function will be used.) + +If the custom help printing function wants to use the text produced by the default help function, +it can call the function ``rte_argparse_print_help()`` to get the help text printed to an output stream, +for example: stdout or stderr. diff --git a/lib/argparse/rte_argparse.c b/lib/argparse/rte_argparse.c index d3b32c6357..e7b9bf573d 100644 --- a/lib/argparse/rte_argparse.c +++ b/lib/argparse/rte_argparse.c @@ -821,7 +821,10 @@ rte_argparse_parse(const struct rte_argparse *obj, int argc, char **argv) goto error; if (show_help) { - rte_argparse_print_help(stdout, obj); + if (obj->print_help != NULL) + obj->print_help(obj); + else + rte_argparse_print_help(stdout, obj); exit(0); } diff --git a/lib/argparse/rte_argparse.h b/lib/argparse/rte_argparse.h index baf278f6b9..63b49ba220 100644 --- a/lib/argparse/rte_argparse.h +++ b/lib/argparse/rte_argparse.h @@ -160,8 +160,13 @@ struct rte_argparse { rte_arg_parser_t callback; /** Opaque which used to invoke callback. */ void *opaque; + /** + * Function pointer for printing usage when -h is passed. + * If this is NULL, default printing function will be used. + */ + void (*print_help)(const struct rte_argparse *obj); /** Reserved field used for future extension. */ - void *reserved[16]; + void *reserved[15]; /** Arguments configuration. Must ended with ARGPARSE_ARG_END(). */ struct rte_argparse_arg args[]; }; -- 2.48.1