Metadata-Version: 1.1
Name: json_config
Version: 1.2.0
Summary: A convenience utility for working with JSON config files.
Home-page: https://github.com/bionikspoon/json_config
Author: Manu Phatak
Author-email: bionikspoon@gmail.com
License: MIT
Description: ===========
        json_config
        ===========
        .. image:: https://img.shields.io/badge/Status-Beta-yellow.svg
            :target: https://pypi.python.org/pypi/json_config/
            :alt: Development Status
        
        .. image:: https://travis-ci.org/bionikspoon/json_config.svg?branch=develop
            :target: https://travis-ci.org/bionikspoon/json_config
        
        .. image:: https://img.shields.io/pypi/v/json_config.svg
            :target: https://pypi.python.org/pypi/json_config?branch=develop
        
        .. image:: https://coveralls.io/repos/bionikspoon/json_config/badge.svg?branch=develop
            :target: https://coveralls.io/r/bionikspoon/json_config?branch=develop
        
        .. image:: https://readthedocs.org/projects/json-config/badge/?version=develop
            :target: https://readthedocs.org/projects/json-config/?badge=develop
            :alt: Documentation Status
        
        A convenience utility for working with JSON configuration files.
        
        
        Features
        --------
        
        * Automatically syncs file on changes.
        * Automatically handles complicated nested data structures.
        * Lightweight (<5KB) and Fast.
        * Takes advantage of Python's native dictionary syntax.
        * Tested against python 2.7, 3.2, 3.3, 3.4, and PYPY.
        * Saves silently in the background.
        * Unit Tested with high coverage.
        * Fully documented at https://json-config.readthedocs.org
        
        .. code-block:: python
        
            >>> import json_config
            >>> config = json_config.connect('categories.json')
            >>> config
            {}
            >>> config['comics']['dc']['batman']['antagonists'] = ['Scarecrow', 'The Joker', 'Bane']
            >>> config['comics']['marvel']['ironman']['antagonists'] = 'Ultron'
            >>> config
            {
              "comics": {
                "dc": {
                  "batman": {
                    "antagonists": [
                      "Scarecrow",
                      "The Joker",
                      "Bane"
                    ]
                  }
                },
                "marvel": {
                  "ironman": {
                    "antagonists": "Ultron"
                  }
                }
              }
            }
        
        Installation
        ------------
        
        At the command line either via easy_install or pip:
        
        .. code-block:: shell
        
            $ pip install json_config
        
        .. code-block:: shell
        
            $ easy_install json_config
        
        **Uninstall**
        
        .. code-block:: shell
        
            $ pip uninstall json_config
        
        
        Getting Started
        ---------------
        To use json_config in a project:
        
        .. code-block:: python
        
            import json_config
        
            config = json_config.connect('config.json')
            config['root'] = '/var/www/html/'
        
            print config['root'] # '/var/www/html/'
            print config # { "root": "/var/www/html" }
        
        
        
        Documentation
        -------------
        
        The full documentation is at https://json-config.readthedocs.org.
        
        
        
        
        History
        -------
        
        Next Release
        ++++++++++++
        * Stay Tuned.
        
        1.2.0 (2015-05-18)
        ++++++++++++++++++
        * Feature: Improved compatibility to PY27, PY32, PY33, PY34, and PYPY
        * Feature: Supports multiple config files.
        * Feature: Writes less, smarter logic on deciding if a write is necessary.
        * Feature: Delegates writes to a background process.
        * Testing: Renamed tests to be more descriptive of expectations.
        * Testing: Added a bunch of tests describing different scenarios.
        * Massive Refactoring
        
        1.1.0 (2015-04-15)
        ++++++++++++++++++
        
        * Massive improvement to documentation and presentation.
        
        1.0.0 (2015-04-13)
        ++++++++++++++++++
        
        * First working version.
        
        0.1.0 (2015-04-11)
        ++++++++++++++++++
        
        * First release on PyPI.
Keywords: json config
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Database
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
