Simple, Elegant, Typed Argument Parsing

simple-parsing allows you to transform your ugly argparse scripts into beautifully structured, strongly typed little works of art. Using dataclasses, simple-parsing makes it easier to share and reuse command-line arguments - no more copy pasting!

Supports inheritance, nesting, easy serialization to json/yaml, automatic help strings from comments, and much more!

# examples/demo.py
from dataclasses import dataclass
from simple_parsing import ArgumentParser

parser = ArgumentParser()
parser.add_argument("--foo", type=int, default=123, help="foo help")

@dataclass
class Options:
    """ Help string for this group of command-line arguments """
    log_dir: str                # Help string for a required str argument    
    learning_rate: float = 1e-4 # Help string for a float argument

parser.add_arguments(Options, dest="options")

args = parser.parse_args()
print("foo:", args.foo)
print("options:", args.options)

$ python examples/demo.py --log_dir logs --foo 123
foo: 123
options: Options(log_dir='logs', learning_rate=0.0001)

$ python examples/demo.py --help
usage: demo.py [-h] [--foo int] --log_dir str [--learning_rate float]

optional arguments:
  -h, --help            show this help message and exit
  --foo int             foo help (default: 123)

Options ['options']:
   Help string for this group of command-line arguments 

  --log_dir str         Help string for a required str argument (default:
                        None)
  --learning_rate float
                        Help string for a float argument (default: 0.0001)

installation

pip install simple-parsing

Examples

API Documentation (Under construction)

Features

Automatic "--help" strings

As developers, we want to make it easy for people coming into our projects to understand how to run them. However, a user-friendly --help message is often hard to write and to maintain, especially as the number of arguments increases.

With simple-parsing, your arguments and their decriptions are defined in the same place, making your code easier to read, write, and maintain.

Modular, Reusable, Cleanly Grouped Arguments

(no more copy-pasting)

When you need to add a new group of command-line arguments similar to an existing one, instead of copy-pasting a block of argparse code and renaming variables, you can reuse your argument class, and let the ArgumentParser take care of adding relevant prefixes to the arguments for you:

parser.add_arguments(Options, dest="train")
parser.add_arguments(Options, dest="valid")
args = parser.parse_args()
train_options: Options = args.train
valid_options: Options = args.valid
print(train_options)
print(valid_options)

$ python examples/demo.py \
    --train.log_dir "training" \
    --valid.log_dir "validation"
Options(log_dir='training', learning_rate=0.0001)
Options(log_dir='validation', learning_rate=0.0001)

These prefixes can also be set explicitly, or not be used at all. For more info, take a look at the Prefixing Guide

Easy serialization:

Easily save/load configs to json or yaml!.
Inheritance!

You can easily customize an existing argument class by extending it and adding your own attributes, which helps promote code reuse accross projects. For more info, take a look at the inheritance example
Nesting!:

Dataclasses can be nested within dataclasses, as deep as you need!
Easier parsing of lists and tuples :

This is sometimes tricky to do with regular argparse, but simple-parsing makes it a lot easier by using the python's builtin type annotations to automatically convert the values to the right type for you. As an added feature, by using these type annotations, simple-parsing allows you to parse nested lists or tuples, as can be seen in this example
Enums support
(More to come!)

Examples:

Additional examples for all the features mentioned above can be found in the examples folder

License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3

Release files for simple-parsing 0.0.11.post13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for simple-parsing 0.0.11.post13
File	Size	Uploaded
simple_parsing-0.0.11.post13.tar.gz	51.7 kB	Jul 21, 2020	Details

Built distribution (wheel)

Table of built distributions (wheels) for simple-parsing 0.0.11.post13
File	Interpreter	ABI	Platform	Reset
simple_parsing-0.0.11.post13-py3-none-any.whl 50.5 kB Jul 21, 2020	Python 3	none	any	Details

Total release size: 102.2 kB

Release files / simple_parsing-0.0.11.post13.tar.gz

Download URL	simple_parsing-0.0.11.post13.tar.gz
Size	51.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`e1aca19ac453cdae7e7fd7a2503b3576a26aa3783be328d552330d578473c1d9`
BLAKE2b-256 checksum How to use checksums	`e10c716351cd9dd8afea66229cae207362692ce377322724052c6c05d2c0750b`
Upload date	Jul 21, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.6.7`

Release files / simple_parsing-0.0.11.post13-py3-none-any.whl

Download URL	simple_parsing-0.0.11.post13-py3-none-any.whl
Size	50.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5fe02dd754fdf57330d0aad0fde3d116e36f70470f91b5ce06f81154d5da96ff`
BLAKE2b-256 checksum How to use checksums	`62e66b15ac7ad4a37e12a93672e79a023279b3f9b0045ad549dcfb93998ed77d`
Upload date	Jul 21, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.6.7`