diff options
Diffstat (limited to 'jsonschema-0.6/debian/python-jsonschema/usr/share/doc')
4 files changed, 183 insertions, 0 deletions
diff --git a/jsonschema-0.6/debian/python-jsonschema/usr/share/doc/python-jsonschema/README.Debian b/jsonschema-0.6/debian/python-jsonschema/usr/share/doc/python-jsonschema/README.Debian new file mode 100644 index 0000000..7dd7563 --- /dev/null +++ b/jsonschema-0.6/debian/python-jsonschema/usr/share/doc/python-jsonschema/README.Debian @@ -0,0 +1,6 @@ +python-jsonschema for Debian +---------------------------- + +<possible notes regarding this package - if none, delete this file> + + -- Kristina Clair <kclair@leap.se> Wed, 03 Oct 2012 11:34:56 -0700 diff --git a/jsonschema-0.6/debian/python-jsonschema/usr/share/doc/python-jsonschema/README.rst b/jsonschema-0.6/debian/python-jsonschema/usr/share/doc/python-jsonschema/README.rst new file mode 100644 index 0000000..28e0451 --- /dev/null +++ b/jsonschema-0.6/debian/python-jsonschema/usr/share/doc/python-jsonschema/README.rst @@ -0,0 +1,135 @@ +========== +jsonschema +========== + +``jsonschema`` is an implementation of JSON Schema (currently in `Draft 3 +<http://tools.ietf.org/html/draft-zyp-json-schema-03>`_) for Python (supporting +2.6+ including Python 3). + +:: + + >>> from jsonschema import validate + + >>> # A sample schema, like what we'd get from json.load() + >>> schema = { + ... "type" : "object", + ... "properties" : { + ... "price" : {"type" : "number"}, + ... "name" : {"type" : "string"}, + ... }, + ... } + + >>> # If no exception is raised by validate(), the instance is valid. + >>> validate({"name" : "Eggs", "price" : 34.99}, schema) + + >>> validate( + ... {"name" : "Eggs", "price" : "Invalid"}, schema + ... ) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + ValidationError: 'Invalid' is not of type 'number' + + +Features +-------- + +* Support for Draft 3 of the Schema with the exception of + + * ``$ref``, and ``extends`` that use ``$ref``\s + +* Lazy validation that can iteratively report *all* validation errors. + +:: + + >>> from jsonschema import Validator + >>> schema = { + ... "type" : "array", + ... "items" : {"enum" : [1, 2, 3]}, + ... "maxItems" : 2, + ... } + >>> v = Validator() + >>> for error in sorted(v.iter_errors([2, 3, 4], schema), key=str): + ... print(error) + 4 is not one of [1, 2, 3] + [2, 3, 4] is too long + +* Small and extensible + +* Programmatic querying of which properties or items failed validation. + +:: + + >>> from jsonschema import ErrorTree, Validator + >>> schema = { + ... "type" : "array", + ... "items" : {"type" : "number", "enum" : [1, 2, 3]}, + ... "minItems" : 3, + ... } + >>> instance = ["spam", 2] + >>> v = Validator() + >>> tree = ErrorTree(v.iter_errors(instance, schema)) + + >>> sorted(tree.errors) + ['minItems'] + + >>> 0 in tree + True + + >>> 1 in tree + False + + >>> sorted(tree[0].errors) + ['enum', 'type'] + + >>> print(tree[0].errors["type"].message) + 'spam' is not of type 'number' + + +Schema Versioning +----------------- + +JSON Schema is, at the time of this writing, seemingly at Draft 3, with +preparations for Draft 4 underway. The ``Validator`` class and ``validate`` +function take a ``version`` argument that you can use to specify what version +of the Schema you are validating under. + +As of right now, Draft 3 (``jsonschema.DRAFT_3``) is the only supported +version, and the default when validating. Whether it will remain the default +version in the future when it is superceeded is undecided, so if you want to be +safe, *explicitly* declare which version to use when validating. + + +Release Notes +------------- + +``0.6`` fixes the behavior for the ``dependencies`` property, which was +mis-implemented. + + +Running the Test Suite +---------------------- + +``jsonschema`` uses the wonderful `Tox <http://tox.readthedocs.org>`_ for its +test suite. (It really is wonderful, if for some reason you haven't heard of +it, you really should use it for your projects). + +Assuming you have ``tox`` installed (perhaps via ``pip install tox`` or your +package manager), just run ``tox`` in the directory of your source checkout to +run ``jsonschema``'s test suite on all of the versions of Python ``jsonschema`` +supports. Note that you'll need to have all of those versions installed in +order to run the tests on each of them, otherwise ``tox`` will skip (and fail) +the tests on that version. + + +Contributing +------------ + +I'm Julian Berman. + +``jsonschema`` is on `GitHub <http://github.com/Julian/jsonschema>`_. + +Get in touch, via GitHub or otherwise, if you've got something to contribute, +it'd be most welcome! + +You can also generally find me on Freenode (nick: ``tos9``) in various +channels, including ``#python``. diff --git a/jsonschema-0.6/debian/python-jsonschema/usr/share/doc/python-jsonschema/changelog.Debian.gz b/jsonschema-0.6/debian/python-jsonschema/usr/share/doc/python-jsonschema/changelog.Debian.gz Binary files differnew file mode 100644 index 0000000..5617af4 --- /dev/null +++ b/jsonschema-0.6/debian/python-jsonschema/usr/share/doc/python-jsonschema/changelog.Debian.gz diff --git a/jsonschema-0.6/debian/python-jsonschema/usr/share/doc/python-jsonschema/copyright b/jsonschema-0.6/debian/python-jsonschema/usr/share/doc/python-jsonschema/copyright new file mode 100644 index 0000000..e483d9c --- /dev/null +++ b/jsonschema-0.6/debian/python-jsonschema/usr/share/doc/python-jsonschema/copyright @@ -0,0 +1,42 @@ +This work was packaged for Debian by: + + Kristina Clair <kclair@leap.se> on Tue, 02 Oct 2012 22:53:20 -0700 + +It was downloaded from: + + http://pypi.python.org/packages/source/j/jsonschema/jsonschema-0.6.tar.gz + +Upstream Author(s): + + Julian Berman + +Copyright: + + Copyright (c) 2011 Julian Berman + +License: + + Permission is hereby granted, free of charge, to any person obtaining a copy + of this software and associated documentation files (the "Software"), to deal + in the Software without restriction, including without limitation the rights + to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + copies of the Software, and to permit persons to whom the Software is + furnished to do so, subject to the following conditions: + + The above copyright notice and this permission notice shall be included in + all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + THE SOFTWARE. + +The Debian packaging is: + + Copyright (C) 2012 Kristina Clair <kclair@leap.se> + + and is licensed under the GPL version 3, + see "/usr/share/common-licenses/GPL-3". |