snmpkit 1.1.0__tar.gz

snmpkit-1.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,63 @@
+name: Bug Report
+description: Report a bug in snmpkit
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug! Please fill out the form below.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear description of the bug
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Minimal code or steps to reproduce the bug
+      placeholder: |
+        ```python
+        from snmpkit.agent import Agent, Updater
+        # ...
+        ```
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened
+
+  - type: input
+    id: version
+    attributes:
+      label: snmpkit Version
+      placeholder: "1.0.0"
+    validations:
+      required: true
+
+  - type: input
+    id: python
+    attributes:
+      label: Python Version
+      placeholder: "3.14.0"
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: Operating System
+      placeholder: "Ubuntu 24.04"

snmpkit-1.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,36 @@
+name: Feature Request
+description: Suggest a new feature
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature! Please describe what you'd like to see.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this feature solve?
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How would you like this to work?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any alternative solutions you've thought about?
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, or examples

snmpkit-1.1.0/.github/workflows/ci.yml

@@ -0,0 +1,86 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install Python 3.14
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14-dev"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run Rust tests
+        run: cargo test
+
+      - name: Run Python tests
+        run: uv run pytest
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy, rustfmt
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Rust format check
+        run: cargo fmt --check
+
+      - name: Rust clippy
+        run: cargo clippy -- -D warnings
+
+      - name: Python lint
+        run: uvx ruff check .
+
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install Python 3.14
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14-dev"
+
+      - name: Install maturin
+        run: pip install maturin
+
+      - name: Build wheel
+        run: maturin build --release
+
+      - name: Upload wheel
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheel-${{ matrix.os }}
+          path: target/wheels/*.whl

snmpkit-1.1.0/.github/workflows/release.yml

@@ -0,0 +1,134 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  # Run tests first
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install Python 3.14
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14-dev"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run Rust tests
+        run: cargo test
+
+      - name: Run Python tests
+        run: uv run pytest
+
+  # Build wheels for all platforms
+  build:
+    needs: test
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          # Linux x86_64
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+          # Linux aarch64
+          - os: ubuntu-latest
+            target: aarch64-unknown-linux-gnu
+          # macOS x86_64
+          - os: macos-latest
+            target: x86_64-apple-darwin
+          # macOS aarch64 (Apple Silicon)
+          - os: macos-latest
+            target: aarch64-apple-darwin
+          # Windows x86_64
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Python 3.14
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14-dev"
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist -i python3.14
+          manylinux: auto
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.target }}
+          path: dist/*.whl
+
+  # Build source distribution
+  sdist:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  # Publish to PyPI
+  publish:
+    needs: [build, sdist]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  # Create GitHub release
+  github-release:
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true

snmpkit-1.1.0/.gitignore

@@ -0,0 +1,26 @@
+# Rust
+/target
+Cargo.lock
+
+# Python
+__pycache__/
+*.py[cod]
+*.so
+*.egg-info/
+dist/
+build/
+.venv/
+.eggs/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Miscellaneous
+**local.*

snmpkit-1.1.0/.python-version

@@ -0,0 +1 @@
+3.14

snmpkit-1.1.0/CHANGELOG.md

@@ -0,0 +1,100 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.1.0] - 2026-02-08
+
+### Added
+
+- **SNMP Manager API**
+  - `Manager` class for querying SNMP devices
+  - `get()`, `get_many()`, `get_next()`, `get_bulk()` operations
+  - `walk()` async iterator for traversing OID subtrees
+  - `set()` for SNMPv2c write operations
+  - Full SNMPv1/v2c/v3 support with authentication and privacy
+  - UDP transport with configurable timeouts and retries
+  - Async context manager for connection lifecycle
+
+- **Manager PDUs (RFC 3411-3418)**
+  - SNMP GET/GETNEXT/GETBULK/SET request encoding
+  - SNMPv3 security model with USM
+  - Response decoding with error handling
+
+- **ASN.1 BER Encoding**
+  - Complete BER encoder for SNMP message construction
+  - High-performance Rust implementation
+
+- **Exception Hierarchy for Manager**
+  - `NoSuchObjectError`, `NoSuchInstanceError`, `EndOfMibViewError`
+  - `GenericError` with status and index
+
+- **Performance**
+  - 170,910 SNMP GET requests/sec
+  - 108,857 SNMPv3 requests/sec
+  - 389,342 AgentX PDUs/sec
+  - 127x faster BER encoding than pure Python
+
+- **Documentation**
+  - Redesigned landing page with split layout
+  - Interactive code snippet with Manager and Agent examples
+  - One-click install command copy
+
+### Changed
+
+- All Python class attributes are now public (removed underscore prefix)
+  - `Manager`: `host`, `port`, `community`, `version`, `timeout`, `retries`, `transport`
+  - `Agent`: `agent_id`, `socket_path`, `timeout`, `registrations`, `protocol`
+  - `Protocol`: `session_id`, `transaction_id`, `packet_id`
+  - `UdpTransport`: `host`, `port`, `timeout`, `retries`, `transport`, `protocol`
+
+## [1.0.1] - 2026-01-23
+
+### Fixed
+
+- README images now use raw GitHub URLs for PyPI compatibility
+
+## [1.0.0] - 2026-01-22
+
+### Added
+
+- **Rust Core**
+  - `Oid` type with parsing, comparison, parent/child operations
+  - Radix trie for O(1) OID lookups
+  - All SNMP value types: Integer, OctetString, Counter32, Counter64, Gauge32, TimeTicks, IpAddress, ObjectIdentifier, Opaque
+  - Complete AgentX PDU encoding/decoding (RFC 2741)
+  - Optional parallel encoding with rayon
+
+- **Python Agent API**
+  - `Agent` class with async/sync entry points
+  - `Updater` base class with `set_*` methods for all SNMP types
+  - `SetHandler` for SNMP SET operations (test/commit/undo/cleanup)
+  - Typed exception hierarchy (`SnmpkitError`, `ConnectionError`, `RegistrationError`, etc.)
+  - SNMP context support for multi-tenant scenarios
+  - Automatic reconnection on connection loss
+  - uvloop integration for high performance
+
+- **Performance**
+  - PDU encoding 11.5x faster than pyagentx3
+  - Value creation 6.4x faster than pyagentx3
+  - OID parsing 1.5x faster than pyagentx3
+
+- **Documentation**
+  - Nextra-based docs site
+  - Agent quickstart, updater, set-handler, traps, advanced guides
+  - Real-world examples
+  - Performance benchmarks
+
+### Technical Requirements
+
+- Python 3.14+
+- Rust 1.83.0+
+
+[Unreleased]: https://github.com/darhebkf/snmpkit/compare/v1.1.0...HEAD
+[1.1.0]: https://github.com/darhebkf/snmpkit/compare/v1.0.1...v1.1.0
+[1.0.1]: https://github.com/darhebkf/snmpkit/compare/v1.0.0...v1.0.1
+[1.0.0]: https://github.com/darhebkf/snmpkit/releases/tag/v1.0.0

snmpkit-1.1.0/CONTRIBUTING.md

@@ -0,0 +1,95 @@
+# Contributing to snmpkit
+
+## Development Setup
+
+1. Install Rust: https://rustup.rs/
+2. Install Python 3.14+
+3. Install uv: `curl -LsSf https://astral.sh/uv/install.sh | sh`
+4. Clone and install:
+
+```bash
+git clone https://github.com/darhebkf/snmpkit.git
+cd snmpkit
+uv sync --all-extras
+```
+
+## Building
+
+```bash
+# Development build (uses maturin develop)
+uv run maturin develop
+
+# Release build
+uv run maturin build --release
+```
+
+## Testing
+
+```bash
+# Run all tests
+uv run pytest
+
+# Run Rust tests only
+cargo test
+
+# Run Python tests only
+uv run pytest python/tests/
+```
+
+## Linting
+
+```bash
+# Python
+uv run ruff check .
+uv run ruff format .
+
+# Rust
+cargo fmt
+cargo clippy
+```
+
+## Pre-commit Hooks
+
+Install pre-commit hooks:
+
+```bash
+uv run pre-commit install
+```
+
+Run manually:
+
+```bash
+uv run pre-commit run --all-files
+```
+
+## Project Structure
+
+```
+snmpkit/
+├── src/                    # Rust source code
+│   ├── lib.rs             # PyO3 module entry point
+│   ├── oid/               # OID type and trie
+│   ├── types/             # SNMP value types
+│   └── agentx/            # AgentX protocol implementation
+├── python/
+│   └── snmpkit/           # Python package
+│       ├── agent/         # Agent, Updater, SetHandler
+│       └── core.pyi       # Type stubs for Rust module
+├── docs/                   # Nextra documentation site
+└── benchmarks/            # Performance benchmarks
+```
+
+## Pull Requests
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/my-feature`
+3. Make your changes
+4. Run tests and linting
+5. Commit with a descriptive message
+6. Push and open a PR
+
+## Code Style
+
+- Rust: Follow rustfmt defaults
+- Python: Follow ruff defaults (based on Black + isort)
+- Commit messages: Use conventional commits format