Metadata-Version: 2.1
Name: puresnmp
Version: 2.0.1
Summary: Pure Python SNMP implementation
Author-email: Michel Albert <michel@albert.lu>, POST Luxembourg <opensource@post.lu>
License: MIT
Project-URL: Homepage, https://github.com/exhuma/puresnmp
Project-URL: Bug Tracker, https://github.com/exhuma/puresnmp/issues
Project-URL: Repository, https://github.com/exhuma/puresnmp
Keywords: networking,snmp
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Networking :: Monitoring
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
Requires-Dist: x690 <2.0,>=1.0
Requires-Dist: dataclasses ; python_version < "3.7"
Requires-Dist: importlib-metadata ; python_version < "3.8"
Requires-Dist: typing-extensions ; python_version < "3.8"
Provides-Extra: crypto
Requires-Dist: puresnmp-crypto >=1.0.1 ; extra == 'crypto'
Provides-Extra: dev
Requires-Dist: black >=20.8b1 ; extra == 'dev'
Requires-Dist: fabric >=2.6.0 ; extra == 'dev'
Requires-Dist: furo ; extra == 'dev'
Requires-Dist: mypy ; extra == 'dev'
Requires-Dist: pylint ; extra == 'dev'
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: pytest-asyncio ; extra == 'dev'
Requires-Dist: pytest-cov ; extra == 'dev'
Requires-Dist: pytest-dependency ; extra == 'dev'
Requires-Dist: sphinx ; extra == 'dev'
Requires-Dist: types-dataclasses ; extra == 'dev'
Requires-Dist: asyncmock ; (python_version < "3.8") and extra == 'dev'
Provides-Extra: readthedocs
Requires-Dist: fabric ; extra == 'readthedocs'

.. >>> Shields >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

.. image:: https://github.com/exhuma/puresnmp/workflows/Python%20package/badge.svg?branch=master
    :target: https://github.com/exhuma/puresnmp/actions?query=workflow%3A%22Python+package%22

.. image:: https://readthedocs.org/projects/puresnmp/badge/?version=latest
    :target: http://puresnmp.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

.. image:: https://img.shields.io/badge/repository-github-green.svg?style=flat
    :target: https://github.com/exhuma/puresnmp
    :alt: Github Project

.. image:: https://img.shields.io/pypi/v/puresnmp.svg
    :alt: PyPI
    :target: https://pypi.org/project/puresnmp/

.. <<< Shields <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

----

For detailed information, see the documentation_


Quick Info
----------

What
    A pure Python implementation for Python 3.6+ of SNMP without any external
    dependencies (neither MIBs or libsnmp).

Why
    SNMP in itself is simple and well defined. A bit convoluted, but simple.
    MIB parsing however complicates the code-base and is *technically* not
    required. They add typing information and variables and give names to OIDs.
    All existing libraries have a direct or indirect dependency on libsnmp.
    With all the advantages and disadvantages.

    The aim of this project is to focus on SNMP in itself and provide a very
    simple API. Instead of implementing ASN.1 parsing, the SNMP related ASN.1
    and information is hard-coded (keeping in mind that all that's hard-coded is
    well defined).

    It is of course possible to *wrap* this package in another package adding
    MIB parsing and processing. This is, and will be however **out of the scope
    of this project**!

When
    First commit: Sat Jul 23 12:01:05 2016 +0200

Who
    Michel Albert


Installation
------------

::

    pip install puresnmp



Package Version Numbers
-----------------------

As an important side-note, you might want to know that this project follows
`Semantic Versioning`_.


.. _documentation: http://puresnmp.readthedocs.io/en/latest
.. _Semantic Versioning: http://semver.org/spec/v2.0.0.html


Development & Maintenance
-------------------------

The easiest way to get started it to use the provided "development container" in
the ``.devcontainer`` folder. When using VS-Code with the `Remote Development
extension`_ it will be picked up automatically when opening the project. If not,
open the command-console and select ``Remote-Containers: Rebuild Container`` to
get started.

Type ``./env/bin/pytest`` to ensure that everything is set up properly. It
should run and pass all unit-tests.

This will provide a container with all required dependencies for development.
**Including** a tiny SNMP daemon on hostname ``snmpd`` which can be used to play
around with.


.. _Remote Development extension: https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack
