{ "info": { "author": "Kent Coble", "author_email": "coblekent@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: System :: Networking", "Topic :: System :: Networking :: Monitoring" ], "description": "Easy SNMP\n=========\n\n|Build Status| |Coverage Status| |Gitter| |License|\n\n.. |Build Status| image:: https://travis-ci.org/kamakazikamikaze/easysnmp.svg?branch=master\n :target: https://travis-ci.org/kamakazikamikaze/easysnmp\n.. |Coverage Status| image:: https://coveralls.io/repos/kamakazikamikaze/easysnmp/badge.svg\n :target: https://coveralls.io/r/kamakazikamikaze/easysnmp\n.. |License| image:: https://img.shields.io/badge/license-BSD-blue.svg\n :target: https://github.com/kamakazikamikaze/easysnmp/blob/master/LICENSE\n.. |Gitter| image:: https://badges.gitter.im/easysnmp/Lobby.svg\n :alt: Join the chat at https://gitter.im/easysnmp/Lobby\n :target: https://gitter.im/easysnmp/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge\n\n.. image:: https://raw.githubusercontent.com/fgimian/easysnmp/master/images/easysnmp-logo.png\n :alt: Easy SNMP Logo\n\nArtwork courtesy of `Open Clip Art\nLibrary `_\n\nIntroduction\n------------\n\nEasy SNMP is a fork of the official `Net-SNMP Python\nBindings `_\nbut attempts to bring a more Pythonic interface to the library. Check\nout the `Net-SNMP website `_ for more\ninformation about SNMP.\n\nThis module provides a full featured SNMP client API supporting all\ndialects of the SNMP protocol.\n\nWhy Another Library?\n--------------------\n\n- The `original Net-SNMP Python\n library `_\n is a great starting point but is quite un-Pythonic and lacks proper\n unit tests and documentation.\n- `PySNMP `_ is written in pure Python\n and therefore has a huge performance hit. In some brief tests, I\n estimate that both the Net-SNMP Python bindings and Easy SNMP are\n more than 4 times faster. Further to this, PySNMP has an even less\n Pythonic interface than the official Net-SNMP bindings.\n- Many other libraries like\n `Snimpy `_ are sadly\n based on PySNMP and so they suffer the same performance penalty.\n\nQuick Start\n-----------\n\nThere are primarily two ways you can use the Easy SNMP library.\n\nThe first is with the use of a Session object which is most suitable\nwhen you are planning on requesting multiple pieces of SNMP data from a\nsource.\n\n.. code:: python\n\n from easysnmp import Session\n\n # Create an SNMP session to be used for all our requests\n session = Session(hostname='localhost', community='public', version=2)\n\n # You may retrieve an individual OID using an SNMP GET\n location = session.get('sysLocation.0')\n\n # You may also specify the OID as a tuple (name, index)\n # Note: the index is specified as a string as it can be of other types than\n # just a regular integer\n contact = session.get(('sysContact', '0'))\n\n # And of course, you may use the numeric OID too\n description = session.get('.1.3.6.1.2.1.1.1.0')\n\n # Set a variable using an SNMP SET\n session.set('sysLocation.0', 'The SNMP Lab')\n\n # Perform an SNMP walk\n system_items = session.walk('system')\n\n # Each returned item can be used normally as its related type (str or int)\n # but also has several extended attributes with SNMP-specific information\n for item in system_items:\n print '{oid}.{oid_index} {snmp_type} = {value}'.format(\n oid=item.oid,\n oid_index=item.oid_index,\n snmp_type=item.snmp_type,\n value=item.value\n )\n\nYou may also use Easy SNMP via its simple interface which is intended\nfor one-off operations where you wish to specify all details in the\nrequest:\n\n.. code:: python\n\n from easysnmp import snmp_get, snmp_set, snmp_walk\n\n # Grab a single piece of information using an SNMP GET\n snmp_get('sysDescr.0', hostname='localhost', community='public', version=1)\n\n # Perform an SNMP SET to update data\n snmp_set(\n 'sysLocation.0', 'My Cool Place',\n hostname='localhost', community='public', version=1\n )\n\n # Perform an SNMP walk\n snmp_walk('system', hostname='localhost', community='public', version=1)\n\nDocumentation\n-------------\n\nPlease check out the `Easy SNMP documentation at Read the\nDocs `_. This includes install\ninstructions for various operating systems.\n\nYou may generate the documentation as follows:\n\n.. code:: bash\n\n # Install Sphinx\n pip install sphinx\n\n # You may optionally export the READTHEDOCS environment variable to build docs\n # on systems where you haven't built the C interface\n export READTHEDOCS=1\n\n # Build the documentation into static HTML pages\n cd docs\n make html\n\nAcknowledgments\n---------------\n\nI'd like to say thanks to the following folks who have made this project\npossible:\n\n- **Giovanni Marzot**: the original author\n- **ScienceLogic, LLC**: sponsored the initial development of this\n module\n- **Wes Hardaker and the net-snmp-coders**: for their hard work and\n dedication\n\nRunning Tests\n-------------\n\nYou may run the unit tests as follows:\n\n.. code:: bash\n\n git clone https://github.com/fgimian/painter.git\n cd painter\n python setup.py test\n\nLicense\n-------\n\nEasy SNMP is released under the **BSD** license. Please see the\n`LICENSE `_\nfile for more details.\n\nCopyright\n---------\n\nThe original version of this library is copyright (c) 2006 G. S. Marzot.\nAll rights reserved.\n\nThis program is free software; you can redistribute it and/or modify it\nunder the same terms as Net-SNMP itself.\n\nCopyright (c) 2006 SPARTA, Inc. All Rights Reserved. This program is\nfree software; you can redistribute it and/or modify it under the same\nterms as Net-SNMP itself.", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/kamakazikamikaze/easysnmp", "keywords": "", "license": "BSD", "maintainer": "", "maintainer_email": "", "name": "easysnmp", "package_url": "https://pypi.org/project/easysnmp/", "platform": "", "project_url": "https://pypi.org/project/easysnmp/", "project_urls": { "Homepage": "https://github.com/kamakazikamikaze/easysnmp" }, "release_url": "https://pypi.org/project/easysnmp/0.2.5/", "requires_dist": null, "requires_python": "", "summary": "A blazingly fast and Pythonic SNMP library based on the official Net-SNMP bindings", "version": "0.2.5" }, "last_serial": 2950799, "releases": { "0.2.1": [ { "comment_text": "", "digests": { "md5": "ad0bcf13099581d98fa9af0fa4b951a9", "sha256": "ef7137be41eef0dd6ada311a594ce05eeeac8f877c060cf67f873e06ea5dda5c" }, "downloads": -1, "filename": "easysnmp-0.2.1.tar.gz", "has_sig": false, "md5_digest": "ad0bcf13099581d98fa9af0fa4b951a9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 26055, "upload_time": "2015-06-02T07:21:37", "url": "https://files.pythonhosted.org/packages/49/59/cbf49be6384b63ab7f650649a612d5b04de3bb0dcf3f362344ac74c535e4/easysnmp-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "d19ac7daab3cfb49fbe9e2ca9840e46f", "sha256": "4d8dbc2739f2382c8a990aaadabed019db56b5c5261150c3ce454b8cec6f5d7d" }, "downloads": -1, "filename": "easysnmp-0.2.2.tar.gz", "has_sig": false, "md5_digest": "d19ac7daab3cfb49fbe9e2ca9840e46f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 25952, "upload_time": "2015-06-03T04:12:37", "url": "https://files.pythonhosted.org/packages/b5/ee/424d4e319eb437a7e9ed8cd800df832cc6460427500c79dd782518ab5fda/easysnmp-0.2.2.tar.gz" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "bf6aaaeb0802b9fcd2257fa01e2c4086", "sha256": "85ecff6617ca657fe24ac889ac4d1f116d3a9836db61baa96c995c485eb13b6d" }, "downloads": -1, "filename": "easysnmp-0.2.3.tar.gz", "has_sig": false, "md5_digest": "bf6aaaeb0802b9fcd2257fa01e2c4086", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 28846, "upload_time": "2015-06-30T09:23:10", "url": "https://files.pythonhosted.org/packages/e3/75/8ba414b3e79d6c15428dac6fcc6bbaaf4b324e37b614705fa44ae3cfa5ff/easysnmp-0.2.3.tar.gz" } ], "0.2.4": [ { "comment_text": "", "digests": { "md5": "e509ef7ecce08e3e97281bbd56eaf710", "sha256": "ea404c17d0a57f20ba30030dd05fd9fb57fa5b572dd2d21519abbc694b62bffc" }, "downloads": -1, "filename": "easysnmp-0.2.4.tar.gz", "has_sig": false, "md5_digest": "e509ef7ecce08e3e97281bbd56eaf710", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30008, "upload_time": "2015-07-08T22:24:06", "url": "https://files.pythonhosted.org/packages/3e/2f/169c6ac3c8312d32b521a2f0f610da0e7777daa2c5bd7bb72fe4fe847fed/easysnmp-0.2.4.tar.gz" } ], "0.2.5": [ { "comment_text": "", "digests": { "md5": "e74edfac8797ae3dd4747e259c67c6f7", "sha256": "56cd64ce8d73d46a39b6166a750b0d1452657acf96adb51702aa5fd041b20f93" }, "downloads": -1, "filename": "easysnmp-0.2.5.tar.gz", "has_sig": false, "md5_digest": "e74edfac8797ae3dd4747e259c67c6f7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 67811, "upload_time": "2017-06-14T23:00:33", "url": "https://files.pythonhosted.org/packages/e0/6f/2fd5c9113a488c81aa95f9006744c6998878a80135010f87506638ba6d5c/easysnmp-0.2.5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "e74edfac8797ae3dd4747e259c67c6f7", "sha256": "56cd64ce8d73d46a39b6166a750b0d1452657acf96adb51702aa5fd041b20f93" }, "downloads": -1, "filename": "easysnmp-0.2.5.tar.gz", "has_sig": false, "md5_digest": "e74edfac8797ae3dd4747e259c67c6f7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 67811, "upload_time": "2017-06-14T23:00:33", "url": "https://files.pythonhosted.org/packages/e0/6f/2fd5c9113a488c81aa95f9006744c6998878a80135010f87506638ba6d5c/easysnmp-0.2.5.tar.gz" } ] }