Netsgiro

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

**Breaking**

- Dropped support for Python 3.5 and 3.6 (both have reached EOL).

**New**

- Add support for Python 3.9, 3.10, and added 3.11 pre-releases to test-suite.
- Fully annotated the project and added a ``py.typed`` to make the package `PEP 561`_-compliant.
- Added a ``get_minimum_due_date`` utility function for retrieving the earliest valid due date for a payment request.
- Added a ``validate_due_date`` kwarg to the ``add_payment_request`` ``Assignment`` method, to optionally perform due date validation. When enabled, due dates less than the minimum (4 calendar days in the future, offset by holidays) or more than the maximum (12 months in the future) will raise an exception.

.. _PEP 561: https://peps.python.org/pep-0561/

**Internal**

- Switched CI pipeline from CircleCI to Github actions.
- Added `isort`_, `black`_, `pyupgrade`_, and `pre-commit`_ for linting.
- Switched to `Poetry`_ for package and dependency management.

.. _isort: https://github.com/PyCQA/isort
.. _black: https://github.com/psf/black
.. _pyupgrade: https://github.com/asottile/pyupgrade
.. _pre-commit: https://github.com/pre-commit/pre-commit
.. _Poetry: https://python-poetry.org/

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

- Drop support for Python 3.4, which has reached end of life.
- Python 3.8 is now explicitly supported. No changes was required to the
library, but the test suite now runs on Python 3.4, 3.5, 3.6, 3.7 and 3.8.

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

- Python 3.7 is now explicitly supported. No changes was required to the
library, but the test suite now runs on Python 3.4, 3.5, 3.6, and 3.7.

- Require attrs >= 17.4, and replace all use of the deprecated keyword argument
``convert`` with ``converter`` so that netsgiro can continue working with
attrs relases after January 2019.

- Format code with Black.

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

Record parsing and writing are now tested with an additional suite of property
based tests, using the Hypothesis library. This testing effort identified a
number of issues, all of which are fixed by this release.

- Fixed exception in :meth:`netsgiro.records.TransactionAmountItem2.to_ocr()`
if :attr:`~netsgiro.records.TransactionAmountItem2.payer_name` was
:class:`None`.

- Fixed exception in :meth:`netsgiro.records.TransactionAmountItem3.to_ocr()`
if :attr:`~netsgiro.records.TransactionAmountItem3.text` was
:class:`None`.

- Raise a :exc:`ValueError` if a too long string is used for any of:

- :attr:`netsgiro.records.TransactionAmountItem1.kid` (max 25 chars)
- :attr:`netsgiro.records.TransactionAmountItem3.text` (max 40 chars)
- :attr:`netsgiro.records.TransactionSpecification.text` (max 40 chars)
- :attr:`netsgiro.records.AvtaleGiroAgreement.kid` (max 25 chars)

Previously the string was accepted and the record generated invalid OCR data.

- Strip newline characters (``\n`` and ``\r``) from record strings, like
:attr:`netsgiro.records.TransactionAmountItem2.payer_name`.

Previously the newline characters were accepted and the record generated
invalid OCR data.

- Automatically pad :attr:`netsgiro.records.TransactionSpecification.text` to
40 chars, so that a manually created record and a record parsed from OCR are
identical.

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

No changes from v1.0.0a3, which has been used in production for a few weeks
without any issues.

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

- Rename :attr:`netsgiro.TransactionType.AVTALEGIRO_AGREEMENTS` (plural)
to :attr:`netsgiro.TransactionType.AVTALEGIRO_AGREEMENT` (singular).

- When writing record to OCR, cut
:attr:`netsgiro.records.TransactionAmountItem2.payer_name` to 10 first chars,
as that is all the field has room for.