How To Use Python Argparse Subparser?

The Python argparse subparsers allows us to create command-line interfaces with multiple subcommands in a convenient way. The argparse is a module, with which we can define the arguments, options, and flags that the script expects from the command line. It automatically generates help messages and error handling, making your command-line interface more user-friendly and robust.

Way to use subparsers with argparse

Here is an example how to use surparsers with argparse in the following manner:

  • We define a main parser using argparse.ArgumentParser().
  • We create a subparser object using parser.add_subparsers() which will hold the subparsers for each command.
  • Each subparser is added using subparsers.add_parser(), specifying the command name and providing additional arguments and options for that command.
  • When the script is run with command-line arguments, argparse will automatically determine which subcommand is being invoked based on the provided arguments.
  • The selected command’s arguments and options can be accessed through the args object returned by parser.parse_args().


subparsers with argparse

Note: The # Add your code... comments to be replaced with their own logic for handling each command

Why subparser is needed in Python?

Here are some key benefits of using subparsers:

  1. Organizing command-line interfaces: Subparsers allow us to organize the command-line interface into logical groups or subcommands. This can make the interface more user-friendly and easier to navigate, especially when we have multiple related commands.
  2. Separate argument sets: Each subparser can have its own set of arguments and options. This allows to define different arguments and options for each subcommand, tailoring the command-line interface to specific functionalities or use cases.
  3. Modular code structure: By using subparsers, we can modularize our codebase and have separate functions or methods dedicated to handling each subcommand. This can improve code maintainability and readability.
  4. Clear command identification: Subparsers make it explicit which command is being executed by the user. Users can specify the desired command as a subcommand, making it clear what action they want to perform.
  5. Contextual help: Subparsers provide context-specific help messages. When users request help for a particular subcommand, argparse can display the relevant help information for that specific command, making it easier for users to understand and use the command-line interface.

Features of Python argparse subparser

With argparse, we can define the arguments, options, and flags that your script expects from the command line. Here are some key features and concepts of argparse:

  1. Argument Parsing: argparse allows you to define positional arguments and optional arguments with various data types (e.g., strings, integers, booleans). It handles the parsing of command-line arguments and provides default values, type checking, and error handling.
  2. Options and Flags: argparse supports the definition of optional arguments, often referred to as options or flags. These can be specified with a short flag (e.g., -v) or a long flag (e.g., --verbose), providing flexibility for users.
  3. Help Messages: argparse automatically generates help messages based on your argument definitions. Users can request help by using the -h or --help flag, and argparse will display information about the available arguments and their usage.
  4. Default Values: You can set default values for your arguments, allowing users to omit them when invoking your script. If an argument is not provided, argparse will assign the default value defined in your argument configuration.
  5. Validation and Error Handling: argparse performs type checking and validation of arguments based on your definitions. It raises appropriate errors if the provided values do not match the specified types or fail custom validation rules.
  6. Namespace and Attribute Access: argparse returns the parsed command-line arguments as an argparse.Namespace object, which allows you to access the values of arguments as attributes. This makes it straightforward to retrieve and use the parsed arguments in your code.


What is the Background to Python argparse subparser?

The argparse module’s subparser functionality was introduced in Python 3.2 as an extension to the existing argument parsing capabilities. Before addition of subparsers, argparse already provided a comprehensive framework for parsing command-line arguments, but it lacked native support for subcommands. The introduction of subparsers addressed this limitation and made it easier to create more complex command-line interfaces.

What is subcommand?

In the context of argparse, a subcommand refers to a specific command or action that is part of a larger command-line interface. Subcommands allow you to define and handle different actions or functionalities within your application or script.


Overall, Python argparse subparsers helps create a well-structured and user-friendly command-line interface that supports multiple commands or functionalities. It allows to define different arguments, options, and actions for each subcommand, improving the clarity and usability of the application.


  1. Python Documentation
  2. PythonHosted

To learn more follow PythonClear

Leave a Comment