https://github.com/exhuma/puresnmp

Pure Python SNMPv2 Library
https://github.com/exhuma/puresnmp

python python-3 snmp snmpv2

Last synced: 3 months ago
JSON representation

Pure Python SNMPv2 Library

• Host: GitHub
• URL: https://github.com/exhuma/puresnmp
• Owner: exhuma
• License: mit
• Created: 2016-09-10T12:53:29.000Z (almost 8 years ago)
• Default Branch: develop
• Last Pushed: 2023-04-04T19:11:35.000Z (about 1 year ago)
• Last Synced: 2024-03-24T08:02:44.057Z (3 months ago)
• Topics: python, python-3, snmp, snmpv2
• Language: Python
• Homepage:
• Size: 1.49 MB
• Stars: 75
• Watchers: 9
• Forks: 21
• Open Issues: 28
• Metadata Files:
  • Readme: README.rst
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt

Lists

• awesome-snmp - puresnmp - Pure Python3 SNMPv2 library without any dependencies.  (Libraries / Python)

README

        
.. >>> 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 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

----

TL;DR

-----

Jump right in with the `cookbook`_

----

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`_.

Examples

--------

See the `cookbook`_.

.. _cookbook: http://puresnmp.readthedocs.io/en/latest/cookbook/index.html

.. _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