| |version| |downloads| |versions| |impls| |wheel| |coverage| |br-coverage|
.. |version| image:: http://img.shields.io/pypi/v/options.svg?style=flat :alt: PyPI Package latest release :target: https://pypi.org/project/options
.. |downloads| image:: http://img.shields.io/pypi/dm/options.svg?style=flat :alt: PyPI Package monthly downloads :target: https://pypi.org/project/options
.. |versions| image:: https://img.shields.io/pypi/pyversions/options.svg :alt: Supported versions :target: https://pypi.org/project/options
.. |impls| image:: https://img.shields.io/pypi/implementation/options.svg :alt: Supported implementations :target: https://pypi.org/project/options
.. |wheel| image:: https://img.shields.io/pypi/wheel/options.svg :alt: Wheel packaging support :target: https://pypi.org/project/options
.. |coverage| image:: https://img.shields.io/badge/test_coverage-100%25-6600CC.svg :alt: Test line coverage :target: https://pypi.org/project/options
.. |br-coverage| image:: https://img.shields.io/badge/branch_coverage-99%25-blue.svg :alt: Test branch coverage :target: https://pypi.org/project/options
options helps represent option and configuration data in a clean,
high-function way. Changes can "overlay" defaults or earlier settings.
For most functions and classes, options is flexibility overkill. Not
everyone wants to be a world-class gymnast, yogi, or contortionist.
For most, Python's regular function arguments, *args, **kwargs, and
inheritance patterns are elegant and sufficient. options is for the top
1% that need:
In those cases, Python's built-in, inheritance-based model stops being the
simple approach. Non-trivial argument-management code and complexity
begins to pervade. This is where options's layered, delegation-based
approach begins to shine. Almost regardless of how varied the options it
wrangles, or how much flexibility is required, code complexity remains very
flat.
.. image:: http://content.screencast.com/users/jonathaneunice/folders/Jing/media/02e27ff4-402d-4450-b3ee-2c7be26eb05b/00000014.png :align: center
Python has very flexible arguments for functions and methods, and
good connection of values from classes to subclasses to methods.
It doesn't, however, connect those very well to configuration files,
module defaults, method parameters, and other uses. options,
in contrast, seamlessly connects all of these varied layers and cases.
For more backstory, see this StackOverflow.com discussion of how to combat "configuration sprawl" <http://stackoverflow.com/questions/11702437/where-to-keep-options-values-paths-to-important-files-etc/11703813#11703813>.
options full documentation
can be found at Read the Docs <http://options.readthedocs.org/en/latest/>. For examples of options
in use, see say <https://pypi.org/project/say>_ and show <https://pypi.org/project/show>_.
FAQs
Simple, super-flexible options. Does magic upon request.
We found that options demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.
Security News
Research
Socket researchers found a malicious Maven package impersonating the legitimate ‘XZ for Java’ library, introducing a backdoor for remote code execution.
