SNMP SMI compiler

The PySMI library and tools are designed to parse, verify and transform SNMP SMI MIB modules from their original ASN.1 form into JSON or pysnmp representation.

pysnmp drives it for you: ask an engine to resolve a name in a module it does not have and pysmi is what compiles that module. You reach for it directly to compile MIBs outside an engine, with mibdump, or to build a whole corpus from a manifest, with mibcorpus – which is what builds the MIB distribution this organization publishes.

It installs as pysnmp-pysmi, and pysnmp’s compile extra pulls it in. The organization site describes how the four projects fit together.

Documentation

• PySMI documentation
  • The mibdump tool
  • The mibcopy tool
  • The mibcorpus tool
  • The mibpatch tool
  • Bundled base MIBs
  • JSON document schema
  • Corpus database schema
  • MIBs as data: layering review
  • PySMI library

Source code & Changelog

Project source code is hosted at GitHub. Everyone is welcome to fork and contribute back!

We maintain the detailed log of changes to our software.

Download & Install

• Download & Install

Development

How changes reach a release: the branches, what CI runs, and how a version is cut and published.

• Continuous integration and releases
  • Branches
  • Commit messages
  • What runs on a pull request
  • The test matrix
  • Cutting a release
  • Keeping next and main in step
  • Reaching PyPI
  • Troubleshooting

Changes

The changelog is generated from the commit history at release time. The narrative history of the project through 1.0.5 is kept separately.

• Changelog
• Historical changelog

License

The SNMP SMI library software is distributed under 2-clause BSD License.

• License
• Third-party MIB sources

MIB files archive

The PySMI project maintains a collection of publicly available ASN.1 MIB files collected on the Internet. You are welcome to use this MIBs archive however we can’t guarantee any degree of consistency or reliability when it comes to these MIB modules.

The mibdump tool as well as many other utilities based on PySMI are programmed to use this MIB repository for automatic download and dependency resolution.

You can always reconfigure PySMI to use some other remote MIB repository instead or in addition to this one.

Contact

In case of questions or troubles using SNMP SMI library, please open up an issue at GitHub or ask at Stack Overflow .