Metadata-Version: 1.1
Name: pykwalify
Version: 14.12
Summary: Python lib/cli for JSON/YAML schema validation
Home-page: http://github.com/grokzen/pykwalify
Author: Johan Andersson
Author-email: Grokzen@gmail.com
License: MIT
Description: # pyKwalify
        
        [![Build Status](https://travis-ci.org/Grokzen/pykwalify.svg?branch=master)](https://travis-ci.org/Grokzen/pykwalify) [![Coverage Status](https://coveralls.io/repos/Grokzen/pykwalify/badge.png?branch=master)](https://coveralls.io/r/Grokzen/pykwalify) [![Latest Version](https://pypip.in/version/pykwalify/badge.svg)](https://pypi.python.org/pypi/pykwalify/) [![Downloads](https://pypip.in/download/pykwalify/badge.svg)](https://pypi.python.org/pypi/pykwalify/) [![Supported Python versions](https://pypip.in/py_versions/pykwalify/badge.svg)](https://pypi.python.org/pypi/pykwalify/) [![Development Status](https://pypip.in/status/pykwalify/badge.svg)](https://pypi.python.org/pypi/pykwalify/) [![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/Grokzen/pykwalify?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
        
        
        YAML/JSON validation library
        
        This framework is a port with alot added functionality of the java version of the framework kwalify that can be found at: http://www.kuwata-lab.com/kwalify/
        
        The source code can be found at: http://sourceforge.net/projects/kwalify/files/kwalify-java/0.5.1/
        
        The schema this library is base and extended from: http://www.kuwata-lab.com/kwalify/ruby/users-guide.01.html#schema
        
        
        # Installation
        
        Latest stable release from pypi
        
        ```
        $ pip install pykwalify
        ```
        
        or from source
        
        ```
        $ python setup.py install
        ```
        
        
        # Usage
        
        Create a data file. Json and yaml formats are both supported.
        
        ```yaml
        - foo
        - bar
        ```
        
        Create a schema file with validation rules.
        
        ```yaml
        type: seq
        sequence:
          - type: str
        ```
        
        Run validation from cli.
        
        ```bash
        pykwalify --data-file data.yaml --schema-file schema.yaml
        ```
        
        If validation passes then return code from the invocation will be 0. If errors was found then 1.
        
        Run validation from code. Multiple schema files is possible to use when using partial schemas (See doc for details).
        
        ```python
        from pykwalify.core import Core
        c = Core(source_file="data.yaml", schema_files=["schema.yaml"])
        c.validate(raise_exception=True)
        ```
        
        If validation fails then exception will be raised.
        
        
        ## Runtime Dependencies
        
         - docopt 0.6.2
         - PyYaml 3.11
        
        
        ## Supported python version
        
         - Python 2.7
         - Python 3.2
         - Python 3.3
         - Python 3.4
        
        
        # How to test
        
        Install test requirements with
        
        ```
        $ pip install -r dev-requirements.txt
        ```
        
        Run tests with
        
        ```
        $ py.test
        ```
        
        or if you want to test against all python versions and pep8
        
        ```
        $ tox
        ```
        
        
        # Documentation
        
        [Implemented validation rules](docs/Validation Rules.md)
        
        
        # Licensing
        
        MIT, See docs/License.txt for details
        
        Copyright (c) 2013-2014 Johan Andersson
        
        
        =============
        Release Notes
        =============
        
        v14.12
        ======
        
         - Fixed broken regex matching on map keys.
         - Source files with file ending `.yml` can now be loaded
         - Added aliases to some directives to make it easier/faster to write
            * `sequence` --> `seq` 
            * `mapping` --> `map` 
            * `required` --> `req`
            * `regex` --> `re`
         - Reworked all testing files to reduce number of files
        
        v14.08
        ======
        
         - First version to be uploaded to pypi
         - Keyword 'range' can now be applied to map & seq types.
         - Added many more test files.
         - Keyword 'length' was removed because 'range' can handle all cases now.
         - Keyword 'range' now correctly checks the internal keys to be integers
         - Major update to testing and increased coverage.
        
        v14.06.1
        ========
        
         - New feature "partial schema". Define a small schema with a ID that can be reused at other places in the schema. See readme for details.
         - New directive "include" that is used to include a partial schema at the specefied location.
         - Cli and Core() now can handle multiple schema files.
         - Directive "pattern" can no longer be used with map to validate all keys against that regex. Use "regex;" inside "mapping:"
         - 'none' can now be used as a type
         - Many more tests added
        
        v14.06
        ======
        
         - New version scheme [YY.MM(.Minor-Release)]
         - Added TravisCI support
         - Update runtime dependency docopt to 0.6.1
         - Update runtime dependency pyyaml to 3.11
         - Huge refactoring of logging and how it works. Logging config files is now removed and everything is alot simpler
         - Cleanup some checks that docopt now handles
         - New keyword "regex;<regex-pattern>" that can be used as a key in map to give more flexibility when validating map keys
         - New keyword "matching-rule" that can be used to control how keys should be matched
         - Added python 3.4 & python 2.7 support (See TravisCI tests for status)
         - Dropped python 3.1 support
         - Alot of refactoring of testing code.
         - Tests should now be runned with "nosetests" and not "python runtests.py"
         - Refactored alot of exceptions to be more specific (SchemaError and RuleError for example) and not a generic Exception
         - Parsed rules is now stored correctly in Core() so it can be tested from the outside
        
        v0.1.2
        ======
        
         - Added new and experimental validation rule allowempty. (See README for more info)
         - Added TODO tracking file.
         - Reworked the CLI to now use docopt and removede argparse.
         - Implemented more typechecks, float, number, text, any
         - Now suports python 3.3.x
         - No longer support any python 2.x.y version
         - Enabled pattern for map rule. It enables the validation of all keys in that map. (See README for more info)
         - Alot more test files and now tests source_data and schema_data input arguments to core.py
         - Alot of cleanup in the test suit
        
        v0.1.1
        ======
        
         - Reworked the structure of the project to be more clean and easy to find stuff.
         - lib/ folder is now removed and all contents is placed in the root of the project
         - All scripts is now moved to its own folder scripts/ (To use the script during dev the path to the root of the project must be in your python path somehow, recomended is to create a virtualenv and export the correct path when it activates)
         - New make target 'cleanegg'
         - Fixed path bugs in Makefile
         - Fixed path bugs in Manifest
        
        v0.1.0
        ======
        
         - Initial stable release of pyKwalify.
         - All functions is not currently implemented but the cli/lib can be used but probably with some bugs.
         - This should be considered a Alpha release used for bug and stable testing and to be based on further new feature requests for the next version.
         - Implemented most validation rules from the original Java version of kwalify. Some is currently not implemented and can be found via [NYI] tag in output, doc & code.
         - Installable via pip (Not the official online pip repo but from the releases folder found in this repo)
         - Supports YAML & JSON files from cli and any dict/list data structure if used in lib mode.
         - Uses pythons internal logging functionality and default logging output can be changed by changing logging.ini (python 3.1.x) or logging.yaml (python 3.2.x) to change the default logging output, or use -v cli input argument to change the logging level. If in lib mode it uses your implemented python std logging.
         
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console
Classifier: Programming Language :: Python
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
