Skip to main content

interactive SNMP tool

Project description


.. image::

.. image::

.. image::

Interactive SNMP tool.

*Snimpy* is a Python-based tool providing a simple interface to build
SNMP query. Here is a very simplistic example that allows us to
display the routing table of a given host::

m=M("localhost", "public", 2)
routes = m.ipCidrRouteNextHop
for x in routes:
net, netmask, tos, src = x
print("%15s/%-15s via %-15s src %-15s" % (net, netmask, routes[x], src))

You can either use *Snimpy* interactively throught its console
(derived from Python own console or from IPython_ if available) or
write *Snimpy* scripts which are just Python scripts with some global
variables available.

.. _IPython:

* Free software: ISC license
* Documentation:

*Snimpy* requires libsmi_ to work correctly. See the documentation for
more information.

.. _libsmi:


*Snimpy* is aimed at being the more Pythonic possible. You should forget
that you are doing SNMP requests. *Snimpy* will rely on MIB to hide SNMP
details. Here are some "features":

* MIB parser based on libsmi (through CFFI)
* SNMP requests are handled by PySNMP (SNMPv1, SNMPv2 and SNMPv3
* scalars are just attributes of your session object
* columns are like a Python dictionary and made available as an
* getting an attribute is like issuing a GET method
* setting an attribute is like issuing a SET method
* iterating over a table is like using GETNEXT
* when something goes wrong, you get an exception


0.8.12 (2017-10-02)

* Support for more recent versions of IPython.
* Support for SNMPv3 context name.
* Support for notification nodes (MIB only).

0.8.11 (2016-08-13)

* Fix IPython interactive shell.
* Fix IPv6 handling for sessions.
* Ability for a session to return None instead of raising an exception.

0.8.10 (2016-02-16)

* Ability to walk a table (if the first index is accessible).
* Ability to do a partial walk (courtesy of Alex Unigovsky).

0.8.8 (2015-11-15)

* Fix thread-safety problem introduced in 0.8.6. This also undo any
improvement advertised in 0.8.6 when using multiple
threads. However, performance should be kept when using a single

0.8.7 (2015-11-14)

* Ability to specify a module name when querying a manager.
* Compatibility with PySNMP 4.3
* Array-like interface for OIDs.
* Ability to restrict lookups to a specific MIB: m['IF-MIB'].ifDescr.
* Fix multithread support with SNMPv3 (with a performance impact).

0.8.6 (2015-06-24)

* Major speed improvement.
* Major memory usage improvement.

0.8.5 (2015-04-04)

* Ability to set SMI search path (with ``mib.path()``)
* Fix documentation build on *Read the Doc*.
* Add a loose mode to manager to loosen type coercion.

0.8.4 (2015-02-10)

* More CFFI workarounds, including cross-compilation support.
* Ability to override a node type.
* Automatic workaround for "SNMP too big" error message.

0.8.3 (2014-08-18)

* IPv6 support.

0.8.2 (2014-06-08)

* Minor bugfixes.

0.8.1 (2013-10-25)

* Workaround a problem with CFFI extension installation.

0.8.0 (2013-10-19)

* Python 3.3 support. Pypy support.
* PEP8 compliant.
* Sphinx documentation.
* Octet strings with a display hint are now treated differently than
plain octet strings (unicode). Notably, they can now be set using
the displayed format (for example, for MAC addresses).

0.7.0 (2013-09-23)

* Major rewrite.
* SNMP support is now provided through PySNMP_.
* MIB parsing is still done with libsmi_ but through CFFI instead of a
C module.
* More unittests. Many bugfixes.

.. _PySNMP:
.. _libsmi:

0.6.4 (2013-03-21)

* GETBULK support.
* MacAddress SMI type support.

0.6.3 (2012-04-13)

* Support for IPython 0.12.
* Minor bugfixes.

0.6.2 (2012-01-19)

* Ability to return None instead of getting an exception.

0.6.1 (2012-01-14)

* Thread safety and efficiency.

0.6 (2012-01-10)

* SNMPv3 support

0.5.1 (2011-08-07)

* Compatibility with IPython 0.11.
* Custom timeouts and retries.

0.5 (2010-02-03)

* Check conformity of loaded modules.
* Many bugfixes.

0.4 (2009-06-06)

* Allow to cache requests.

0.3 (2008-11-23)

* Provide a manual page.
* Use a context manager to group SET requests.

0.2.1 (2008-09-28)

* First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for snimpy, version 0.8.12
Filename, size File type Python version Upload date Hashes
Filename, size snimpy-0.8.12.tar.gz (73.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page