Docopt module in Python

10 Jul, 2020
Docopt is a command line interface description module. It helps you define a interface for a command-line application and generates parser for it. The interface message in docopt is a formalized help message.
You can install docopt module in various ways, pip is one of the best ways to install docopt.
$pip install docopt
Note: docopt is tested with Python 2.5, 2.6, 2.7, 3.2, 3.3 and PyPy as well.
docopt is most commonly used to display the help messages and it is invoked with -h or –help option. You can import and call this module with the following command.
from docopt import docopt  docopt(doc, argv = None, version = None,       help = True, options = False)
Parameters of the module is as shown below :
doc : It is a docstring (__doc__) that contains the help message.
argv : It is an optional argument vector contains list of strings.
version : It is an optional argument mentioning the version of the program.
help : Responsible for displaying the help message. It is True by default.
options_first : This doesn’t allow the mixing of positional arguments and optional arguments. By default it is False.
docopt gives you strong control over your help page and it consists of the usage keyword which is case-insensitive that is followed by your program_name. A usage pattern can be described with various elements as mentioned below :
usage ='''Usage :   program_name.py command --option  program_name.py [optional argument]  program_name.py --another-option =<argument>  program_name.py (--option1 | --option2 )  program_name.py  <argument>...  '''
< argument > argument : The element starting with “<” and ending with “>” is called a positional argument. It is position sensitive.
–option -o: The element starting with “–” or “-” are called as long or short option. It can either be mentioned as --option or -o.
  -h, --help     Display help
  -o, --option   Display options
  -l, --all      List all
  -q, --quit     exit
  --version      Version 3.6.1 

[optional argument] : The element starting with “[” and ending with “]” is called an optional argument. It is considered optionally.
< argument >... : The ellipsis “...” is used when the element present to the left can be repeated more than once.
(required arguments) : The elements starting with “(” and ending with “)” is a required element. (--option1 | --option2) says that either of –option1 or –option2 is required.
Example :
# filename ='docopt_example.py"  usage ='''Usage:      docopt_example.py  [(<name1>|<name2>)] <name3>...  docopt_example.py  mov <name1> <name2>  docopt_example.py  (--h|--q) [<name1> -l]  docopt_example.py  --version  Options:    -l, --all      List all.  -q, --quit     exit.  --version      Version 3.6.1   -h --help      Show this screen.  --version      Show version.  --speed =<kn>   Speed in knots [default: 10].  --moored       Moored (anchored) mine.  --drifting     Drifting mine.       '''      from docopt import docoptargs = docopt(usage)print(args)
Output :
python-modules
Python
Writing code in comment?
Please use ide.geeksforgeeks.org,
generate link and share the link here.
How to Install PIP on Windows ?
Python Classes and Objects
Python OOPs Concepts
Introduction To PYTHON
How to drop one or multiple columns in Pandas Dataframe
Python | os.path.join() method
Check if element exists in list in Python
How To Convert Python Dictionary To JSON?
Python | Get unique values from a list
Python | datetime.timedelta() function