Puresnmp

~~~~~~~~~~~~~

* **[fix]** Fixed a regression which was introduced in ``v1.3.2``

~~~~~~~~~~~~~

* **[new]** PEP 561 compliance (since 1.4.0.post1)
* **[new]** asyncio support via :py:mod:`puresnmp.aio` (Thanks to acspike).
* **[new]** Much better error detail if the SNMP agent returns a response with
an error-code. See :py:exc:`puresnmp.exc.ErrorResponse`.
* **[new]** The ``ObjectIdentifier`` class now has two convenience methods
:py:meth:`~puresnmp.x690.types.ObjectIdentifier.childof` and
:py:meth:`~puresnmp.x690.types.ObjectIdentifier.parentof`. They merely
delegat to ``__contains__`` but can make code more readable.

~~~~~~~~~~~~~

* **[fix]** Fixed a regression introduced by `v1.3.1` for Python < 3.6.

~~~~~~~~~~~~~

* **[fix]** Fixed an endless loop caused by some network devices with broken
SNMP implementations. This will now raise a `FaultySNMPImplementation`
exception unless `errors=puresnmp.api.raw.ERRORS_WARN` is passed to `walk`
operations.

~~~~~~~~~~~~~

* **[new]** Python 2 support (Royce Mitchell).
* **[new]** Expose ``timeout`` argument in additional functions.
* **[new]** Walk operations now yield rows as they come in over the network
instead of materialising them in memory (Royce Mitchell).
* **[new]** Introduce ``puresnmp.api.raw`` with same signatures as ``puresnmp``
but for for non-pythonized output.
* **[new]** ``ObjectIdentifier.from_string`` now allows a leading ``.``.
* **[new]** Collections of ``ObjectIdentifier`` instances are now sortable.
* **[new]** Enforce ``str`` type in ``ObjectIdentifier.from_string``.
* **[new]** ``ObjectIdentifier`` now supports ``__len__``::

len(ObjectIdentifier(1, 2, 3)) == 3

* **[new]** ``ObjectIdentifier`` instances can now be converted to ``int`` (if
they only have one node)::

int(ObjectIdentifier(5)) == 5

* **[new]** ``ObjectIdentifier`` instances can now be concatenated using
``+``::

ObjectIdentifier(1) + ObjectIdentifier(2) == ObjectIdentifier(1, 2)

* **[new]** ``ObjectIdentifier`` instances are now indexable::

ObjectIdentifier(1, 2, 3)[1] == ObjectIdentifier(2)

* **[new]** The SNMP type ``IpAddress`` is now properly transcoded to the
Python ``IPv4Address`` type (via RFC3416).
* **[changed]** ``NonASN1Type`` is now deprectated. Use ``UnknownType`` instead
(Royce Mitchell).
* **[fix]** ``ObjectIdentifier(0)`` is now correctly detected & transcoded.
* **[fix]** ``port`` no longer ignores the ``port`` argument.
* **[fix]** Avoid potential error in reported ``OctetString`` length.
* **[fix]** UDP connection retries are now handled properly.
* **[code-quality]** Improved type-hints.
* **[code-quality]** Update contribution guide, adding code-style rules. Added
an appropriate ``pylintrc`` and fixed some style violations.

~~~~~~~~~~~~~

* Clarify error message if a ``bulkwalk`` is requested with non-iterable OIDs.