======= EzSnmp

.. list-table:: :widths: auto

• • |Python Code Style|
  • |Clang-format Code Style|
  • |Black|
• • |Clang-format|
  • |Pull Request Sphinx Docs Check|
  • |PyPI Distributions|
• • |TestPyPI Distributions|
  • |Tests Homebrew|
  • |Tests Native|
• • |CodeCov|
  • |License|
  • |Build and Publish Docker Images|

.. |Python Code Style| image:: https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square :target: https://github.com/psf/black .. |Clang-format Code Style| image:: https://img.shields.io/badge/code%20style-clang--format-brightgreen.svg?style=flat-square :target: https://clang.llvm.org/docs/ClangFormat.html .. |Black| image:: https://img.shields.io/github/actions/workflow/status/carlkidcrypto/ezsnmp/black.yml?style=flat-square&label=Black :target: https://github.com/carlkidcrypto/ezsnmp/actions/workflows/black.yml .. |Clang-format| image:: https://img.shields.io/github/actions/workflow/status/carlkidcrypto/ezsnmp/clang_format.yml?style=flat-square&label=Clang-format :target: https://github.com/carlkidcrypto/ezsnmp/actions/workflows/clang_format.yml .. |Pull Request Sphinx Docs Check| image:: https://img.shields.io/github/actions/workflow/status/carlkidcrypto/ezsnmp/sphinx_build.yml?style=flat-square&label=Sphinx+Docs+Check :target: https://github.com/carlkidcrypto/ezsnmp/actions/workflows/sphinx_build.yml .. |PyPI Distributions| image:: https://img.shields.io/github/actions/workflow/status/carlkidcrypto/ezsnmp/build_and_publish_to_pypi.yml?style=flat-square&label=PyPI+Distributions :target: https://github.com/carlkidcrypto/ezsnmp/actions/workflows/build_and_publish_to_pypi.yml .. |TestPyPI Distributions| image:: https://img.shields.io/github/actions/workflow/status/carlkidcrypto/ezsnmp/build_and_publish_to_test_pypi.yml?style=flat-square&label=TestPyPI+Distributions :target: https://github.com/carlkidcrypto/ezsnmp/actions/workflows/build_and_publish_to_test_pypi.yml .. |Tests Homebrew| image:: https://img.shields.io/github/actions/workflow/status/carlkidcrypto/ezsnmp/tests_homebrew.yml?style=flat-square&label=Tests+Homebrew :target: https://github.com/carlkidcrypto/ezsnmp/actions/workflows/tests_homebrew.yml .. |Tests Native| image:: https://img.shields.io/github/actions/workflow/status/carlkidcrypto/ezsnmp/tests_native.yml?style=flat-square&label=Tests+Native :target: https://github.com/carlkidcrypto/ezsnmp/actions/workflows/tests_native.yml .. |CodeCov| image:: https://img.shields.io/codecov/c/github/carlkidcrypto/ezsnmp/main?style=flat-square&label=CodeCov :target: https://codecov.io/gh/carlkidcrypto/ezsnmp .. |License| image:: https://img.shields.io/badge/license-BSD-blue.svg?style=flat-square :target: https://github.com/carlkidcrypto/ezsnmp/blob/main/LICENSE .. |Build and Publish Docker Images| image:: https://img.shields.io/github/actions/workflow/status/carlkidcrypto/ezsnmp/build_and_publish_docker_images.yml?style=flat-square&label=Build+Docker+Images :target: https://github.com/carlkidcrypto/ezsnmp/actions/workflows/build_and_publish_docker_images.yml

.. image:: https://raw.githubusercontent.com/carlkidcrypto/ezsnmp/main/images/ezsnmp_logo.jpeg :alt: EzSnmp Logo

Introduction

EzSnmp is a fork of Easy SNMP <https://github.com/easysnmp/easysnmp>__

Why Another Library?

• Simply because the maintainer of Easy SNMP seems to have abandoned the project or isn't actively working on it.
• This version (EzSnmp) will attempt to remain up to date with Python versions that are supported by Python <https://devguide.python.org/versions/>__ and net-snmp versions that are supported by Net-SNMP <https://www.net-snmp.org/download.html>__

How to Support This Project?

.. image:: https://raw.githubusercontent.com/carlkidcrypto/ezsnmp/main/images/buy_me_a_coffee.png :alt: Buy Me A Coffee

Use this link to buy me a coffee! <https://www.buymeacoffee.com/carlkidcrypto>__

Getting Started

Please check out the EzSnmp documentation <https://carlkidcrypto.github.io/ezsnmp/>_. This includes installation instructions for various operating systems, including self-contained Windows wheels (AMD64, x86, and ARM64) that bundle Net-SNMP for pip install ezsnmp and source-build instructions when you want to link against an existing Net-SNMP installation.

Code Coverage

EzSnmp uses CodeCov <https://codecov.io/gh/carlkidcrypto/ezsnmp>_ for tracking code coverage across both Python and C++ components.

Coverage reports are automatically generated and uploaded for:

• Python tests: Coverage from pytest runs (both Docker and native environments)
• C++ tests: Coverage from Google Test runs using lcov (both Docker and native environments)

Coverage data is collected from multiple test workflows:

• Docker-based Python tests across multiple distributions
• Native Python tests on Ubuntu and macOS
• Docker-based C++ tests
• Native C++ tests on Ubuntu and macOS

Each workflow uploads with exactly one Codecov flag (python-native, python-docker, cpp-native, cpp-docker) so carryforward keeps every environment's coverage when its tests are skipped on a commit. Use the Python Code and C++ Code components for per-language line coverage.

You can view the latest coverage reports and trends at the CodeCov dashboard <https://codecov.io/gh/carlkidcrypto/ezsnmp>_.

Operational Reports

EzSnmp also keeps a small set of maintenance reports and supporting scripts for CI diagnostics:

• Valgrind PR history report: .github/workflows/valgrind_pr_history_report.yml runs .github/scripts/analyze_valgrind_pr_history.py to scan historical Homebrew Valgrind bot comments, then publishes markdown and JSON report artifacts.
• Docker test summary report: docker/generate_test_reports.sh summarizes existing docker/test_outputs_* results. Its usage details and prerequisites are documented in docker/README.rst.
• Monthly report tooling maintenance: .github/workflows/monthly_report_tooling_maintenance.md is the scheduled agentic workflow that reviews these report paths on the first day of each month and proposes fixes when their scripts or docs drift out of sync.

Want to Contribute?

Check out the development guide at EzSnmp Development <https://carlkidcrypto.github.io/ezsnmp/html/development.html>. If you plan to use AI coding assistants while contributing, please also read HOWTOAI.rst <HOWTOAI.rst> for guidelines on effective and responsible AI-assisted development.

Acknowledgments

I'd like to say thanks to the following folks who have made this project possible:

• Giovanni Marzot: the original author
• ScienceLogic, LLC: sponsored the initial development of this module
• Wes Hardaker and the net-snmp-coders: for their hard work and dedication
• fgimian and nnathan: the original contributors to this codebase
• Kent Coble: who was the most recent maintainer. Easy SNMP <https://github.com/easysnmp/easysnmp>_

License

EzSnmp is released under the BSD license. Please see the LICENSE <LICENSE>_ file for more details.

Copyright

The original version of this library is copyright (c) 2006 G. S. Marzot. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Net-SNMP itself.

Copyright (c) 2006 SPARTA, Inc. All Rights Reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Net-SNMP itself.

Copyright (c) 2024-2026 carlkidcrypto All Rights Reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Net-SNMP itself.

---

.. note:: This content was generated by AI and reviewed by humans. Mistakes may still occur. PRs for corrections are welcome.