Container for flexible class, instance, and function call options
Project description
options helps encapsulate options and configuration data using a layered stacking model (a.k.a. nested contexts).
For most functions and many classes, options is overkill and not recommended. Python’s already-flexible function arguments, *args, **kwargs, and inheritance patterns are elegant and sufficient for 99.9% of all development situations. options is for the other 0.1%:
highly functional classes,
with many different options,
which might be adjusted or overriden at any time,
yet that need “reasonable” or “intelligent” defaults, and
that yearn for a simple, unobtrusive API.
In those cases, Python’s simpler built-in, inheritance-based model adds complexity as non-trivial options and argument-management code spreads through many individual methods. This is where options’s delegation-based approach begins to shine.
For more backstory, see this StackOverflow.com discussion of how to combat “configuration sprawl”. options full documentation can be found at Read the Docs. For examples of options in use, see say and show.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.