Merge pull request #3 from tosumitdhaka/mib_browser_update

Version 1.2.0

Author: tosumitdhaka

.env

@@ -10,7 +10,7 @@ TRAP_PORT=1162
 
 # Application
 APP_NAME=Trishul-SNMP
-APP_VERSION=1.1.7
+APP_VERSION=1.2.0
 APP_AUTHOR=Sumit Dhaka
 APP_DESCRIPTION=Professional SNMP Utilities
 

.gitignore

@@ -1,3 +1,4 @@
 backend/data*
 .venv*
 .vscode*
+*.tmp*

README.md

@@ -8,7 +8,7 @@
 [![License](https://img.shields.io/github/license/tosumitdhaka/trishul-snmp?style=for-the-badge)](LICENSE)
 [![Docker Pulls](https://img.shields.io/docker/pulls/tosumitdhaka/trishul-snmp-backend?style=for-the-badge)](https://github.com/tosumitdhaka/trishul-snmp/pkgs/container/trishul-snmp-backend)
 
-A web-based SNMP toolkit for network engineers and administrators. Simulate SNMP agents, send/receive traps, walk devices with MIB resolution, and manage MIB files—all from a clean, intuitive interface.
+A web-based SNMP toolkit for network engineers and administrators. Simulate SNMP agents, send/receive traps, walk devices with MIB resolution, browse MIB trees, and manage MIB files—all from a clean, intuitive interface.
 
 **Replace 5+ SNMP tools with one modern platform**
 
@@ -19,7 +19,8 @@ A web-based SNMP toolkit for network engineers and administrators. Simulate SNMP
 - 🖥️ **SNMP Simulator** - Run configurable SNMP agent with custom OID values
 - 🚶 **Walk & Parse** - Execute SNMP walks with MIB resolution, export to JSON/CSV
 - 📡 **Trap Manager** - Send/receive SNMP traps with real-time monitoring
-- 📚 **MIB Manager** - Upload, validate MIBs, browse traps, auto-resolve OIDs with dependency detection
+- 📚 **MIB Manager** - Upload, validate MIBs, browse trap library, auto-resolve OIDs with dependency detection
+- 🌳 **MIB Browser** - Interactive tree explorer with hierarchical OID navigation, search, and filtering
 - 🔐 **Secure** - Session-based authentication with credential management
 - 🐳 **Containerized** - One-command Docker deployment with host network support
 - 🌐 **Modern UI** - Clean, responsive interface built with Bootstrap 5
@@ -32,7 +33,7 @@ A web-based SNMP toolkit for network engineers and administrators. Simulate SNMP
 
 ✅ **Net-SNMP CLI tools** → Web UI with no command memorization  
 ✅ **snmpsim** → Custom OID simulator with web interface  
-✅ **iReasoning MIB Browser ($500)** → Free MIB browser and validator  
+✅ **iReasoning MIB Browser ($500)** → Free MIB browser with tree navigation  
 ✅ **snmptrapd** → Real-time trap receiver with web display  
 ✅ **Custom scripts** → Built-in JSON/CSV export functionality  
 ✅ **Multiple scattered tools** → One unified platform
@@ -109,6 +110,55 @@ BACKEND_PORT=9000 FRONTEND_PORT=3000 ./install-trishul-snmp.sh up
 
 ---
 
+## 🧩 Component Overview
+
+### 🖥️ **SNMP Simulator**
+Run a configurable SNMP agent on UDP port 1061 with custom OID values. Perfect for testing SNMP clients without real hardware.
+- **Custom OIDs** - Define any OID with custom values and types
+- **SNMPv1/v2c** - Support for community-based authentication
+- **Persistent data** - OID values survive restarts
+- **Web control** - Start/stop agent from dashboard
+
+### 🚶 **Walk & Parse**
+Execute SNMP walks against any device with automatic MIB resolution and data export.
+- **MIB resolution** - Converts numeric OIDs to human-readable names
+- **Bulk operations** - Walk entire MIB trees efficiently
+- **Export formats** - JSON and CSV export for analysis
+- **History** - View previous walk results
+
+### 📡 **Trap Manager**
+Send and receive SNMP traps with real-time monitoring and MIB-based trap browsing.
+- **Trap sender** - Send v1/v2c traps with custom varbinds
+- **Trap receiver** - Real-time trap display on UDP port 1162
+- **Trap library** - Browse 24+ available traps from loaded MIBs
+- **Auto-populate** - Select trap from library to auto-fill varbinds
+
+### 🌳 **MIB Browser**
+Interactive tree explorer for navigating OID hierarchies and understanding MIB structures.
+- **Dual views** - Browse by module or standard OID hierarchy
+- **Real-time search** - Find OIDs by name, numeric OID, or description
+- **Smart filtering** - Filter by module and type (scalars, tables, notifications)
+- **Tree navigation** - Expandable hierarchy with configurable depth (1-5 levels)
+- **Details panel** - View full metadata, descriptions, and varbinds
+- **Integration** - Jump to Walker or Trap Sender with pre-filled data
+- **State persistence** - Remembers your position across page switches
+
+### 📚 **MIB Manager**
+Upload, validate, and manage MIB files with automatic dependency resolution.
+- **Upload MIBs** - Drag-and-drop or file selection
+- **Validation** - Automatic syntax checking and dependency detection
+- **Trap enumeration** - Lists all notification types per MIB
+- **Statistics** - View object counts, imports, and trap counts
+- **Delete/Reload** - Manage MIB lifecycle with hot-reload
+
+### 🔐 **Settings**
+Manage authentication and system preferences.
+- **Credentials** - Change admin password
+- **Session management** - Secure token-based authentication
+- **System info** - View version and configuration
+
+---
+
 ## 🔧 Configuration
 
 ### Environment Variables
@@ -174,11 +224,11 @@ docker-compose build
 
 ## 👥 Best For
 
-- 🔧 **Network engineers** testing devices
+- 🔧 **Network engineers** testing devices and exploring MIB structures
 - 🚀 **DevOps teams** testing SNMP integrations
-- 📚 **Students** learning SNMP protocols
-- ✅ **QA teams** validating implementations
-- 👥 **Small teams** needing trap monitoring
+- 📚 **Students** learning SNMP protocols and MIB hierarchies
+- ✅ **QA teams** validating SNMP implementations
+- 👥 **Small teams** needing trap monitoring and MIB browsing
 - 🧪 **Developers** building SNMP-enabled applications
 
 ---
@@ -267,7 +317,19 @@ Thank you to all our supporters! Your contributions help maintain and improve Tr
 
 ## 📝 Changelog
 
-### v1.1.7 (Current)
+### v1.2.0 (Current) - MIB Browser Release 🌳
+- ✨ **NEW: MIB Browser** - Interactive tree explorer with dual view modes
+- ✨ **Tree Navigation** - Expandable OID hierarchy with configurable depth (1-5 levels)
+- ✨ **Smart Search** - Real-time search by name, OID, or description
+- ✨ **Advanced Filtering** - Filter by module and object type (scalars, tables, notifications)
+- ✨ **Detailed Panel** - Compact metadata display with breadcrumb navigation
+- ✨ **Seamless Integration** - Jump to Walker/Trap Sender with pre-filled data
+- ✨ **Trap Library** - Enhanced trap manager
+- 🐛 **Fixed** - MIB delete function error handling
+- 🐛 **Fixed** - Trap count consistency across dashboard, manager, and browser
+- 🎨 **Dashboard** - Added MIB Browser card
+
+### v1.1.7
 - ✅ Rebranded to Trishul-SNMP
 - ✅ Improved documentation and contributing guidelines
 
@@ -310,7 +372,7 @@ Thank you to all our supporters! Your contributions help maintain and improve Tr
 
 ## 🏷️ Keywords
 
-`snmp` `snmp-simulator` `snmp-trap` `mib-browser` `network-management` `network-monitoring` `snmpwalk` `snmptrap` `docker` `fastapi` `python` `devops` `sysadmin` `netops` `open-source` `self-hosted` `monitoring` `observability` `infrastructure` `network-tools`
+`snmp` `snmp-simulator` `snmp-trap` `mib-browser` `mib-tree` `oid-explorer` `network-management` `network-monitoring` `snmpwalk` `snmptrap` `docker` `fastapi` `python` `devops` `sysadmin` `netops` `open-source` `self-hosted` `monitoring` `observability` `infrastructure` `network-tools`
 
 ---
 
@@ -333,6 +395,8 @@ Thank you to all our supporters! Your contributions help maintain and improve Tr
 | **Send Traps** | ✅ CLI | ✅ GUI | ✅ Web + MIB Browse |
 | **Receive Traps** | ✅ CLI | ❌ | ✅ Web + Real-time |
 | **MIB Manager** | ✅ CLI | ✅ GUI | ✅ Web + Validate |
+| **MIB Browser** | ❌ | ✅ GUI | ✅ Web + Tree Nav |
+| **OID Search** | ❌ | ✅ | ✅ Real-time |
 | **Export JSON/CSV** | ❌ | ✅ | ✅ |
 | **Web-Based** | ❌ | ❌ | ✅ |
 | **Docker Deploy** | ❌ | ❌ | ✅ |
@@ -344,6 +408,7 @@ Thank you to all our supporters! Your contributions help maintain and improve Tr
 ## 🎓 Learning Resources
 
 - 📖 [SNMP Basics Tutorial](https://github.com/tosumitdhaka/trishul-snmp/wiki/SNMP-Basics) *(coming soon)*
+- 📖 [MIB Browser Guide](https://github.com/tosumitdhaka/trishul-snmp/wiki/MIB-Browser-Guide) *(coming soon)*
 - 🎥 [Video Tutorials](https://www.youtube.com/@tosumitdhaka) *(coming soon)*
 - 📝 [Blog Posts](https://dev.to/tosumitdhaka) *(coming soon)*
 - 💬 [Community Discord](https://discord.gg/tosumitdhaka) *(coming soon)*
@@ -364,7 +429,7 @@ MIT License - See [LICENSE](LICENSE) file for details.
 - SNMP implementation by [pysnmp](https://github.com/etingof/pysnmp)
 - MIB parsing by [pysmi](https://github.com/etingof/pysmi)
 - UI powered by [Bootstrap 5](https://getbootstrap.com/)
-- Icons by [Bootstrap Icons](https://icons.getbootstrap.com/)
+- Icons by [Font Awesome](https://fontawesome.com/) & [Bootstrap Icons](https://icons.getbootstrap.com/)
 
 ---
 
@@ -403,18 +468,33 @@ Deploy on your own infrastructure using the one-command installer or Docker Comp
 
 ## 🎯 Roadmap
 
-- [ ] Full MIB tree browser
-- [ ] View OID descriptions and syntax
-- [ ] Search OIDs across MIBs
-- [ ] SNMPv3 authentication support
-- [ ] Scheduled SNMP walks
-- [ ] Email/Slack/Webhook notifications
-- [ ] Custom dashboard widgets
-- [ ] API rate limiting and keys
-- [ ] Bulk device management
-- [ ] Historical data retention
-- [ ] Advanced trap filtering
-- [ ] Mobile-responsive improvements
+### ✅ Completed (v1.2.0)
+- [x] Full MIB tree browser with dual view modes
+- [x] Interactive OID navigation with expandable tree
+- [x] Search OIDs across MIBs with real-time results
+- [x] View OID descriptions, syntax, and metadata
+- [x] Filter by module and object type
+- [x] Seamless integration with Walker and Trap Sender
+- [x] State persistence across page switches
+- [x] Configurable expansion depth (1-5 levels)
+
+### 🚧 In Progress
+- [ ] SNMPv3 authentication support (MD5, SHA, AES)
+- [ ] Scheduled SNMP walks with cron-like syntax
+- [ ] Email/Slack/Webhook notifications for traps
+
+### 📋 Planned
+- [ ] Custom dashboard widgets with drag-and-drop
+- [ ] API rate limiting and authentication keys
+- [ ] Bulk device management (import/export CSV)
+- [ ] Historical data retention with time-series graphs
+- [ ] Advanced trap filtering with regex support
+- [ ] Mobile-responsive improvements for tablets
+- [ ] Dark mode theme
+- [ ] Multi-language support (i18n)
+- [ ] SNMP SET operations in Walker
+- [ ] MIB compiler for custom MIBs
+- [ ] Export MIB tree to PDF/PNG
 
 See [Issues](https://github.com/tosumitdhaka/trishul-snmp/issues) for detailed roadmap and vote on features!
 

backend/api/routers/browser.py

@@ -0,0 +1,133 @@
+import logging
+from typing import Optional
+from fastapi import APIRouter, HTTPException, Query
+from services.mib_service import get_mib_service
+
+router = APIRouter(prefix="/mibs/browse", tags=["MIB Browser"])
+logger = logging.getLogger(__name__)
+
+
+@router.get("/modules")
+def list_modules():
+    """List all MIB modules with statistics"""
+    try:
+        mib_service = get_mib_service()
+        modules = mib_service.get_module_stats()
+        
+        return {"modules": modules}
+    
+    except Exception as e:
+        logger.error(f"Failed to list modules: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/tree/module")
+def get_module_tree(module: Optional[str] = None):
+    """
+    Get tree organized by modules
+    
+    Args:
+        module: Filter by specific module (optional)
+    
+    Returns:
+        List of module trees with their root objects
+    """
+    try:
+        mib_service = get_mib_service()
+        tree = mib_service.get_module_tree(module)
+        
+        return {
+            "view": "module",
+            "modules": tree,
+            "count": len(tree)
+        }
+    
+    except Exception as e:
+        logger.error(f"Failed to get module tree: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/tree/oid")
+def get_oid_tree(
+    root_oid: str = Query("1.3.6.1", description="Starting OID"),
+    depth: int = Query(1, ge=1, le=5, description="Expansion depth"),
+    module: Optional[str] = Query(None, description="Filter by module")
+):
+    """
+    Get OID tree starting from root_oid
+    
+    Args:
+        root_oid: Starting OID (default: 1.3.6.1 = internet)
+        depth: How many levels to expand (1-5)
+        module: Filter by MIB module
+    
+    Returns:
+        Tree structure with root and children
+    """
+    try:
+        mib_service = get_mib_service()
+        tree = mib_service.get_oid_tree(root_oid, depth, module)
+        
+        return tree
+    
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        logger.error(f"Failed to get OID tree: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/node/{oid:path}")
+def get_node_details(oid: str):
+    """
+    Get detailed information about a specific OID node
+    """
+    try:
+        mib_service = get_mib_service()
+        details = mib_service.get_node_details(oid_identifier=oid)
+        
+        # If it's a notification, get associated objects
+        node = details["node"]
+        if node.get("type") == "NotificationType":
+            # Get trap details from list_traps
+            trap_details = mib_service.get_trap_details(oid)
+            if trap_details:
+                details["trap_objects"] = trap_details.get("objects", [])
+        
+        return details
+    
+    except ValueError as e:
+        raise HTTPException(status_code=404, detail=str(e))
+    except Exception as e:
+        logger.error(f"Failed to get node details for {oid}: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/search")
+def search_oids(
+    query: str = Query(..., min_length=2, description="Search term"),
+    limit: int = Query(100, ge=1, le=500, description="Max results"),
+    module: Optional[str] = Query(None, description="Filter by module"),
+    type_filter: Optional[str] = Query(None, description="Filter by node type")
+):
+    """
+    Search OIDs by name, description, or numeric OID
+    
+    Args:
+        query: Search term (minimum 2 characters)
+        limit: Maximum number of results (1-500)
+        module: Filter by MIB module
+        type_filter: Filter by node type (MibScalar, MibTable, MibTableColumn, NotificationType, etc.)
+    
+    Returns:
+        Search results with count
+    """
+    try:
+        mib_service = get_mib_service()
+        results = mib_service.search_oids(query, limit, module, type_filter)
+        
+        return results
+    
+    except Exception as e:
+        logger.error(f"Search failed for query '{query}': {e}")
+        raise HTTPException(status_code=500, detail=str(e))

backend/main.py

@@ -3,7 +3,7 @@
 
 from core.security import validate_auth
 from core.logging import setup_logging
-from api.routers import simulator, walker, settings, traps, mibs
+from api.routers import simulator, walker, settings, traps, mibs, browser
 from core.config import meta
 
 setup_logging()
@@ -40,6 +40,7 @@ def health_check():
 app.include_router(simulator.router, prefix="/api", dependencies=[Depends(validate_auth)])
 app.include_router(walker.router, prefix="/api", dependencies=[Depends(validate_auth)])
 app.include_router(traps.router, prefix="/api", dependencies=[Depends(validate_auth)])
+app.include_router(browser.router, prefix="/api", dependencies=[Depends(validate_auth)]) 
 app.include_router(mibs.router, prefix="/api", dependencies=[Depends(validate_auth)])
 app.include_router(settings.router, prefix="/api")