trishul-smi 0.3.0

A clean, modern SMI/MIB compiler

trishul-smi

A clean, modern SNMP MIB compiler written in Python.

trishul-smi fetches, parses, and compiles SNMP MIB definitions (SMIv1 and SMIv2) into structured JSON or pysnmp-compatible Python modules. It resolves transitive imports automatically, caches compiled modules on disk, and ships a CLI that works out-of-the-box with no SNMP toolchain required.

---

Features

• Full import closure — resolves every transitive dependency automatically
• Full OID resolution — all objects carry absolute numeric OID paths after compile
• Two output formats — structured JSON and pysnmp-compatible Python
• pysmi-parity pysnmp output — MibTableColumn detection, full TC subtypeSpec, setIndexNames, setOrganization, setRevisions, inline constraint wrappers
• Reverse conversion — tsmi convert FILE.py converts a compiled PySNMP module back to JSON
• Directory compile mode — tsmi compile -d /path/to/mibs auto-discovers and compiles every MIB file
• Concurrent fetching — parallel async HTTP with retry and timeout
• Pluggable readers — FileReader, HttpReader, ZipReader, composable via ReaderChain
• Disk cache — compiled modules cached with mtime-based TTL; atomic writes
• Cycle detection — Kahn's algorithm with actionable error messages
• SMIv1 + SMIv2 — separate Lark grammars, auto-detected per MIB

---

Installation

pip install trishul-smi

Requires Python ≥ 3.10.

---

Quick Start

# Compile from a local MIB directory
tsmi compile IF-MIB --mib-dir /usr/share/snmp/mibs

# Fetch from the internet and compile to JSON + pysnmp
tsmi compile IF-MIB IP-MIB -f json -f pysnmp --online -o ./out

Python API:

import asyncio
from pathlib import Path
from trishul_smi import MibCompiler, CompilerConfig
from trishul_smi.reader import FileReader, HttpReader

async def main():
    config = CompilerConfig(output_dir=Path("./out"))
    compiler = MibCompiler(config).add_reader(FileReader("/usr/share/snmp/mibs"))
    # optionally add HTTP: async with HttpReader(*config.sources) as http: compiler.add_reader(http)
    results = await compiler.compile("IF-MIB", "IP-MIB")
    for r in results:
        print(r.name, r.status, r.output_paths)

asyncio.run(main())

---

Documentation

• CLI Reference — all commands, options, and output format examples
• Configuration — CompilerConfig fields and defaults
• Architecture — package structure, data flow, design principles
• Roadmap — planned features and known limitations
• Contributing — dev setup, test and lint commands
• Changelog — version history

---

License

MIT — see LICENSE.