-``options`` helps encapsulate options and configuration data using a
-layered stacking model (a.k.a. nested contexts).
+``options`` helps represent option and configuration data in
+a clean, high-function way. Changes to options can "overlay"
-For most functions and
many classes, ``options``
+For most functions and classes, ``options``
already-flexible function arguments, ``*args``,
+Python's function arguments, ``*args``,
``**kwargs``, and inheritance patterns are elegant and sufficient
for 99.9% of all development situations.
- * highly functional classes,
+ * highly functional classes,
* with many different features and 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
as non-trivial options and argument-management
+adds complexityon-trivial options and argument-management
code spreads through many individual methods. This is where
``options``'s delegation-based approach begins to shine.
* ``options`` undergoes frequent automated multi-version testing with
and `tox <http://pypi.python.org/pypi/tox>`_. It is
- successfully packaged for, and tested against, Python 2.6, 2.7, 3.2, and 3.
+ successfully packaged for, and tested against, Python 2.6, 2.7, 3.2, and 3..
It additionally runs under, and is tested against, PyPy 2.1 (based on 2.7.3)
though it has to work around a few bugs in the underlying ``stuf`` module
-To ``easy_install`` under a specific Python version (3.
3 in this example)::
+To ``easy_install`` under a specific Python version (3. in this example)::
3 -m easy_install --upgrade options
+ python3. -m easy_install --upgrade options
(You may need to prefix these with "sudo " to authorize installation.)