Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

A parser for arguments and config-files that also allows direct python input.

Project description

Generic Parser

Travis (.com) Code Climate coverage Code Climate maintainability (percentage) GitHub last commit GitHub release

A parser for arguments and config-files that also allows direct python input.

Getting Started

Installing

Installation is easily done via pip. The package is then used as generic_parser.

pip install generic-parser

Example Usage:

Content of myscript.py

from generic_parser import entrypoint, EntryPointParameters


def get_arguments():
    args = EntryPointParameters()
    args.add_parameter(name="first",
                       flags=["-f", "--first"],
                       help="First Parameter, an int",
                       choices=[1, 2, 3],
                       type=int,
                       required=True,
                       )
    args.add_parameter(name="second",
                       flags=["-s", "--second"],
                       help="Second Parameter, a string",
                       type=str,
                       default="default",
                       required=False,
                       )
    return args


@entrypoint(get_arguments())
def main(opt, unknown):
    print(opt.first == 1)
    print(opt.second == "default")


if __name__ == '__main__':
    main()

Commandline

Calling that script with python myscript.py -f 1 -s "test" will result in

True
False

It is assumed, that this is the standard mode of operation for your functions.

Config File

Further, one can also use a config file config.ini containing:

[Section]
first = 2
second = "Hello"

and run the script with python myscript.py --entry_cfg config.ini leading to

False
False

Config files are very useful if you want to rerun your code with the same or similar parameters. Especially the declaration of a [DEFAULT] section can be helpful. For further information about config files, check the python Config Parser.

Python

Or call the function directly from python code

if __name__ == '__main__':
    main(first=1, second="World")   
True
False

This is incredibly helpful if one wants to write python-wrappers around entrypoint-functions, and does not want to resort to commandline calls from python.

Note that also in this case all variables are validated, courtesy of the dict_parser. dict_parser provides even multi-level dictionary checking functionality, which is not used in the Entrypoint, but can be handy in other use-cases.

Description

The package provides an all-around parser for arguments and config-files. The creation of the arguments is similar to the ones from argparse, but the input can then be either from command line, a config file or directly from python.

For a detailed description check the documentation.

Authors

  • Josch - JoschD
  • pyLHC/OMC-Team - Working Group - pyLHC

License

This project is licensed under the MIT License - see the LICENSE.md file for details

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 generic-parser, version 1.0.5
Filename, size File type Python version Upload date Hashes
Filename, size generic_parser-1.0.5-py3-none-any.whl (17.7 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size generic-parser-1.0.5.tar.gz (15.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page