ConfArgParse 1.0.10

Specifiying the Name

By default all configuration names are the lowercase dest from argparse. Care must be taken to make sure that there are no name clashes from dests with different capitalizations.

The default name can be changed by using the “name” keyword to add_argument:

parser.add_argument("-n", type=int, name="my_n")

This targets the argument to “my_n” instead of “n” in the configuration file.

Specifying the Section

By default, all configurations go to the [defaults] section. Argument groups and subparsers inherit from the parser that initialized them.

The add_argument_group, add_argument, add_subparsers, and ConfArgParser initialization all include the “section” optional keyword argument. Specifying this section sets the section in the configuration the option will be targeted to. If the value is None, the object will inherit up as expected:

parser = ConfArgParser(section = "main")
parser.add_argument("-n", type=int)
group = parser.add_argument_group("my group", section="group")
group.add_argument("-g")
group.add_argument("-t", section="section2")

In this example, the first argument targets to “n” name in the [main] section. The second argument targets to the “g” name in the [group] section. The third argument targets to the “t” name in the [section2] section.

Excluding Arguments

Currently, positional arguments cannot be sent to the configuration file.

If you would like to exclude additional arguments, just use the exclude keyword argument to add_arguments:

parser.add_argument("-n", type=int, exclude=True)

Suggestions or BugFixes?

Feel free to contact me. I am findable online with a google search: S. Joshua Swamidass.

Please send bug fixes as pull requests to the bitbucket repository (https://bitbucket.org/swamidass/confargparse). Please keep pull requests clean, so I can easily figure out if it should be merged into the main line.