Skip to main content

Load a value from an environmental variable, YAML/JSON file, or default to a provided value.

Project description

chainload
=========

Load a value from an environmental variable, YAML/JSON file, or default to a provided value.


|TravisBadge|_

.. |TravisBadge| image:: https://travis-ci.org/tristanfisher/chainload.svg?branch=master
.. _TravisBadge: https://travis-ci.org/tristanfisher/chainload


Getting chainload
-----------------

Simply:

.. code-block:: bash

pip install chainload


Install requirements
--------------------

.. code-block:: bash

pip install -r requirements.txt

or:

.. code-block:: bash

python setup.py install


Using chainload
---------------

If you have variables that exist in a file, I recommend assigning a file object to a variable, then passing that variable to the chain loading method.

e.g.

.. code-block:: python

$ python
>>> from chainload import chainload
>>> variable_file = chainload.load_file(file_name="tests/test_settings.yaml")
>>> chainload.chain_load_variable("environment", "environment", "debug", variable_file)
'production'

See the docstring for `chain_load_variable`, but this will load a variable in order of:

1. A default value
2. From file object
3a. An environmental variable
3b. If the environmental variable is None, and the specified file option name exists in the env,
and this behavior is enabled, an attempt to load from an environmental variable of the same name as specified for #2


Running tests
-------------

If you want to run the tests for this package:

.. code-block:: bash

$ make test
python setup.py test
running nosetests
running egg_info
writing chainload.egg-info/PKG-INFO
writing top-level names to chainload.egg-info/top_level.txt
writing dependency_links to chainload.egg-info/dependency_links.txt
reading manifest file 'chainload.egg-info/SOURCES.txt'
writing manifest file 'chainload.egg-info/SOURCES.txt'
.........
----------------------------------------------------------------------
Ran 9 tests in 0.007s


Filing bugs / issues
--------------------

When filing a bug report, please include a [Short, Self Contained, Correct (Compilable), Example](http://sscce.org/).


New features / Pull requests
----------------------------

If requesting a new feature, please include a well-explained use-case with example usage.

When making a pull request, if new functionality is added, please include appropriate tests.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for chainload, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size chainload-1.0.tar.gz (3.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page