Skip to main content

Simple Multi Command Line Parser

Project description

SMCLIP is a simple framework for parsing multi command line arguments using python’s builtin ArgumentParser. With SMCLIP you are able to built git-like commands. Commands are created by inheriting from base Command classes and extending their callbacks.

Core features includes:

  • building trees of multi-level sub-commands
  • support for default sub-commands (e.g. git stash [save])
  • support for fallback sub-commands (when sub-command is not found; e.g. catching ID)
  • support for chained sub-commands
  • sub-command lazy loading

Differences with …

Why you should choose SMCLIP when [X] supports sub-commands?


Python’s ArgumentParser support sub-commands by adding sub-parsers to the parent parser. The ArgumentParser with sub-commands considers that a CLI application is simple and does simple operations. A CLI application starts can get confusing to users (in help) when there are more and more sub-commands being added.

Subparsers of ArgumentParser should be constructed prior to calling the base parser. Subparsers don not support any routing based on the commands.


Click utilizes Python’s decorators to create sub-commands hierarchy. Using decorators makes the code more readable. On the other hand, extending Click is done by creating new decorators. Supporting new parsing techniques (default or fallback commands) and conditional callback triggering is not done simplistically.


Cement is a framework intended for complex CLI applications. Cement comes with multiple set of utilities (logging, caching). Command line parsing is a one part of Cement framework. Cement support sub-commands by nesting controllers. Default and fallback commands and conditional callback triggering is done by extending core controllers.

Argument Examples

# Simple command
(1)$ app help
           +---- sub-command of base application

# Two commands
(2)$ app task list
(3)$ app --debug task list --listopt
     *----+----* *--* *-----+------*
           \       \         \
            \       \         +------- list sub-command with option
             \       +---------------- task command
              +----------------------- application with its own option

# fallback command
(4)$ app task 1234 --viewopt
                      +------- fallback command catching ID

# chained commands
(5)$ app task 1234 change --state ASSIGNED assign person
                   *----------+----------* *-----+-----*
                              |                   \
                               \                   +------ chained command
                                \                          with positional
                                 \                         argument
                                   +---------------------- chained command
                                                           with option



preprocess is called after successful parsing of command’s arguments. Invocation is done even when a sub-command is being called. preprocess is not called when default command is in effect.


this_action is a main callback for actions in current command. This callback is called after preprocess and only when current command is final (no other sub-commands are being invoked). Exceptions are chained command, in which the this_action is invoked every time.


(commands group only)

results_callback is called after a sub-command invocation is done. A return value from sub-command, returned by this_action callback, is passed as a positional argument. Results from chained commands are wrapped and passed in ChainedOutputResults class object.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for smclip, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size smclip-0.3.0-py2.py3-none-any.whl (12.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size smclip-0.3.0.tar.gz (17.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page