trishul-smi 0.1.1

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
• Two output formats — structured JSON and pysnmp-compatible Python
• 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 IF-MIB and all its dependencies to JSON
trishul-smi compile IF-MIB

# Compile to both JSON and pysnmp Python modules
trishul-smi compile IF-MIB IP-MIB -f json -f pysnmp -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"))
    async with HttpReader(config.sources) as http:
        compiler = (
            MibCompiler(config)
            .add_reader(FileReader("/usr/share/snmp/mibs"))
            .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
• Contributing — dev setup, test and lint commands
• Changelog — version history

---

License

MIT — see LICENSE.