semvec/pypi-packages huggingface dataset:
aiosnmp 0.7.2
asyncio SNMP client
License: MIT
Requires Python: >=3.7

aiosnmp
=======


.. image:: https://dev.azure.com/6660879/aiosnmp/_apis/build/status/hh-h.aiosnmp?branchName=master
   :target: https://dev.azure.com/6660879/aiosnmp/_build/results?buildId=38&view=results
   :alt: Build Status


.. image:: https://img.shields.io/codecov/c/github/hh-h/aiosnmp/master.svg?style=flat
   :target: https://codecov.io/github/hh-h/aiosnmp?branch=master
   :alt: Code Coverage


.. image:: https://badge.fury.io/py/aiosnmp.svg
   :target: https://badge.fury.io/py/aiosnmp
   :alt: PyPI version


.. image:: https://img.shields.io/badge/license-MIT-brightgreen.svg
   :target: https://img.shields.io/badge/license-MIT-brightgreen.svg
   :alt: License


.. image:: https://img.shields.io/badge/code%20style-black-black.svg
   :target: https://github.com/ambv/black
   :alt: Code Style


.. image:: https://img.shields.io/badge/python-3.7%2B-brightgreen.svg
   :target: https://img.shields.io/badge/python-3.7%2B-brightgreen.svg
   :alt: Python version


aiosnmp is an asynchronous SNMP client for use with asyncio.

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

.. code-block:: shell

   pip install aiosnmp

Documentation
-------------

https://aiosnmp.readthedocs.io/en/latest/api.html

Notice
------

| Only snmp v2c supported, v3 version is not supported
| Oids should be like ``.1.3.6...`` or ``1.3.6...``. ``iso.3.6...`` is not supported

Source address (host and port) validation
-----------------------------------------

By default, v2c should not validate source addr, but in this library, it is enabled by default.
You can disable validation by passing ``validate_source_addr=False`` to ``Snmp``.

Basic Usage
-----------

.. code-block:: python

   import asyncio
   import aiosnmp

   async def main():
       async with aiosnmp.Snmp(host="127.0.0.1", port=161, community="public") as snmp:
           for res in await snmp.get(".1.3.6.1.2.1.1.1.0"):
               print(res.oid, res.value)

   asyncio.run(main())

more in `/examples <https://github.com/hh-h/aiosnmp/tree/master/examples>`_

TODO
----

* snmp v3 support
* more tests

License
-------

aiosnmp is developed and distributed under the MIT license.

Run local tests
---------------

.. code-block:: shell

   pip install -r requirements-dev.txt
   tox

Before submitting PR
--------------------

.. code-block:: shell

   pip install -r requirements-dev.txt
   tox -e format