Cutplace

=========================

* Added option :ref:`quoting` to specify when quotes should be written for
delimited data (`117 <https://github.com/roskakori/cutplace/issues/117>`_,
contributed by quapka).
* Added support for more quote characters for delimited data
(`113 <https://github.com/roskakori/cutplace/issues/113>`_).
* Dropped support for Python 3.6.
* Updated dependencies.
* Cleaned up CI build and pre-commit hooks to work with current versions.

=========================

* Removed support for Python 2.
* Updated build process to more contemporary tool chain:

- Removed checks and badge for defunct landscape.io.
- Changed build tool to `poetry <https://python-poetry.org/>`_.
- Changed test tool to `pytest <https://docs.pytest.org/>`_.
- Changed continuous integration from Travis CI to
`GitHub actions <https://docs.github.com/en/actions>`_.
- Changed ant targets to shell scripts (with ``set -e`` to ensure basic
robustness). Granted, that's not more contemporary but what can you do?
With ant being obsoleted by even more messy tools like maven and
gradle, :file:`setup.py` being replaced by the purely declarative
:file:`pyproject.toml` and :command:`make` being awful since 1976...

* Added `pre-commit <https://pre-commit.com/>`_ with additional hooks for
`black <https://github.com/psf/black>`_,
`isort <https://pycqa.github.io/isort/>`_ and
`prettier <https://prettier.io/>`_.
* Changed flake8 to be part of pre-commit check.
* Improved badges in README.

=========================

This is the last version that supposedly works with Python 2. There is no
actual release for it because the Python build process and tools changed too
much to keep it working both with Python 2 and 3 with reasonable effort. The
next version will drop Python 2 and rework the build process.

* Fixed "field type part must be a single word" error in Python 3 because at
some point ``generate_tokens`` in the standard library startet adding a
spurious newline character at the end (issue
`121 <https://github.com/roskakori/cutplace/issues/121>`_).
* Removed dependency to external argparse that caused headache with Python 3's
internal argparse.
* Updated several dependencies to last version that works with both Python 2
and Python 3.
* Removed ability to build the documentation with Python 2.

=========================

* Changed development status to "Production/Stable" as cutplace has been
processing millions of data rows on a daily base for a couple of months
now.
* Improved validation of Excel dates and times. Fields of type
:ref:`field-format-datetime` now check the format specified by the rule
and in case it only contains date or time components only extracts those.
(API note: internally, Excel dates and times returned by the low level
function :py:meth:`cutplace.rowio.excel_rows()` still use the full
`YYYY-MM-DD hh:mm:ss` format. This change mostly concerns
:py:class:`cutplace.validio.Reader` and
:py:meth:`cutplace.fields.DateTimeFieldFormat.validated_value()`.)
* Cleaned up CID and data files for documentation, examples and tests (
issue `107 <https://github.com/roskakori/cutplace/issues/107>`_). There
are fewer files now and they have multiple uses. Furthermore examples in
the documentation now match the CID's in the :file:`examples` folder.
Partially this can be attributed to parts of the documentation now
including RST files that are updated during the build process.
* Added Python 3.5 as a supported version.

=========================

* Fixed that errors detected by field formats during declaration got
suppressed and typically resulted in more confusing errors later.
* Fixed :py:exc:`NameError` on platforms without :py:mod:`tkinter`.
* Improved documentation:

* Fixed missing example for own field and check in
:ref:`using-own-check-and-field-formats` (issue
`33 <https://github.com/roskakori/cutplace/issues/33>`_).

* Improved API:

* Fixed that :py:meth:`cutplace.rows` also yielded header rows instead of
only data rows.
* Cleaned up API documentation (typos, links).

=========================

* Fixed installation from source distribution by upgrading to
`Pyscaffold <https://pypi.python.org/pypi/pyscaffold>`_
2.2.1. Earlier versions used
`versioneer <https://pypi.python.org/pypi/versioneer>`_ for version
numbering and forgot to include ``versionneer.py`` in the distribution
archive. The current version uses
`setuptools_scm <https://pypi.python.org/pypi/setuptools_scm>`_ which only
needs a clean dependency instead of additional source code (issue
`108 <https://github.com/roskakori/cutplace/issues/108>`_).
* Added command line option :option:`--gui` to open a graphical user
interface for validation (issue
`77 <https://github.com/roskakori/cutplace/issues/77>`_).
* Improved error message for broken field declarations in CIDs detected by
the field format constructor, which now include the name of the field and
the location in the CID.
* Improved error message when attempting to use a 0 byte as item delimiter in
CID's for delimited data. (Python's :py:mod:`csv` module fails with a
:py:exc:`TypeError` because the low level implementation is based on C).
* Improved API: Cleaned up :py:class:`cutplace.Cid`:

* Changed :py:meth:`cutplace.Cid.add_check` to require an
:py:class:`cutplace.fields.AbstractCheck` as parameter and added
:py:meth:`cutplace.Cid.add_check_row` to accept a row.
* Changed :py:meth:`cutplace.Cid.add_field_format` to require an
:py:class:`cutplace.fields.AbstractFieldFormat` as parameter and added
:py:meth:`cutplace.Cid.add_field_format_row` to accept a row.