========
Cutplace
========
Cutplace is a tool and API to validate that tabular and flat data conform
to an interface definition (CID). Cutplace checks CSV, PRN (fixed
length), Excel and ODS files using configurable separators, delimiters and
fillers. It supports error conditions for single cells, across rows or
concerning the whole set of data.
CID's are simple spread sheets that describe the basic file format of the
data to validate, the fields provided and additional conditions to check
across rows or the whole data set.
Additionally cutplace offers an API to validate and read data described
by a CID. It provides a uniform interface to :py:func:`csv.reader` and
packages to read other formats, saving you from having to learn the
intrinsics of each package.
* `Download cutplace from PyPI `_
or run ``pip install cutplace``.
* :doc:`Read the tutorial ` to find out what cutplace can do for
you and how it works.
* Visit the `project site `_.
* Take a look at the
`roadmap `_ to find
out what the future has in store.
* Read the :doc:`application programmer interface tutorial ` to learn
how to integrate cutplace based validations in your own application. For a
complete reference, browse the :ref:`modindex` of the API reference
documentation.
* Read the :doc:`developer guide ` to learn how to obtain the
source code, build a distribution archive and contribute patches.
Contents
========
.. toctree::
:maxdepth: 2
self
installation
tutorial
writing-an-icd
command-line-usage
api
support
development
changes
license
Indices and tables
==================
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`