4:50
315 ;
404 Not Found
Not Found
The requested URL was not found on this server.
Additionally, a 404 Not Found
error was encountered while trying to use an ErrorDocument to handle the request.
, l4('TX pF
m_I| ? ===================================
Validation Schema with validate.py
===================================
--------------------------
Using the Validator class
--------------------------
:Authors: `Michael Foord`_, `Nicola Larosa`_, `Mark Andrews`_
:Version: Validate 1.0.1
:Date: 2010/01/09
:Homepage: `Validate Homepage`_
:Repository: `Google code homepage `_
:PyPI Entry: `Validate on Python Packaging Index `_
:License: `BSD License`_
:Support: `Mailing List`_
.. _Mailing List: http://lists.sourceforge.net/lists/listinfo/configobj-develop
.. _Michael Foord: fuzzyman@voidspace.org.uk
.. _Nicola Larosa: nico@teknico.net
.. _This Document:
.. _Validate Homepage: http://www.voidspace.org.uk/python/validate.html
.. _BSD License: http://www.voidspace.org.uk/python/license.shtml
.. contents:: Validate Manual
.. sectnum::
Introduction
============
Validation is used to check that supplied values conform to a specification.
The value can be supplied as a string, e.g. from a config file. In this case
the check will also *convert* the value to the required type. This allows you
to add validation as a transparent layer to access data stored as strings. The
validation checks that the data is correct *and* converts it to the expected
type.
Checks are also strings, and are easy to write. One generic system can be used
to validate information from different sources via a single consistent
mechanism.
Checks look like function calls, and map to function calls. They can include
parameters and keyword arguments. These arguments are passed to the relevant
function by the ``Validator`` instance, along with the value being checked.
The syntax for checks also allows for specifying a default value. This default
value can be ``None``, no matter what the type of the check. This can be used
to indicate that a value was missing, and so holds no useful value.
Functions either return a new value, or raise an exception. See `Validator
Exceptions`_ for the low down on the exception classes that ``validate.py``
defines.
Some standard functions are provided, for basic data types; these come built
into every validator. Additional checks are easy to write: they can be provided
when the ``Validator`` is instantiated, or added afterwards.
Validate was primarily written to support ConfigObj_, but is designed to be
applicable to many other situations.
For support and bug reports please use the ConfigObj `Mailing List`_.
.. _ConfigObj: http://www.voidspace.org.uk/python/configobj.html
Downloading
===========
The current version is **1.0.1**, dated 9th January 2010.
You can get obtain validate in the following ways :
Files
-----
* validate.py_ from Voidspace
* configobj.zip from Voidspace - See the homepage of ConfigObj_ for the latest
version and download links.
This contains validate.py and `this document`_. (As well as ConfigObj_ and
the ConfigObj documentation).
* The latest development version can be obtained from the `Subversion Repository`_.
Documentation
-------------
*configobj.zip* contains `this document`_.
* You can view `this document`_ online as the `Validate Homepage`_.
.. _configobj.py: http://www.voidspace.org.uk/cgi-bin/voidspace/download/configobj.py
.. _configobj.zip: http://www.voidspace.org.uk/cgi-bin/voidspace/download/configobj-4.7.0.zip
.. _validate.py: http://www.voidspace.org.uk/cgi-bin/voidspace/download/validate.py
.. _Subversion Repository: http://code.google.com/p/configobj/
.. _Sourceforge: http://sourceforge.net/projects/configobj
.. _validate: http://www.voidspace.org.uk/python/validate.html
The stand