feat: Add comprehensive network analysis module v1.1.0

- Add network interface discovery and monitoring
- Add network device scanning with multi-threading
- Add advanced port scanning capabilities
- Add network performance analysis
- Add network security assessment
- Add network utility functions (subnet calc, MAC lookup, etc.)
- Update CLI to support network module
- Add comprehensive documentation and examples
- Add internationalization support for network features
- Bump version to 1.1.0

Author: esfiam

CHANGELOG.md

@@ -25,6 +25,53 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Security
 - Nothing yet
 
+## [1.1.0] - 2024-12-24
+
+### Added
+- 🌐 **Network Analysis Module**
+  - Network interface discovery and monitoring
+  - Network device scanning and identification
+  - Advanced port scanning with multi-threading
+  - Network performance analysis and metrics
+  - Network security scanning and assessment
+  - Real-time network topology mapping
+
+- 🔧 **Network Utility Functions**
+  - Subnet calculation and network analysis
+  - MAC address vendor identification
+  - ARP table parsing and analysis
+  - Routing table extraction
+  - Network speed testing integration
+  - Port knocking functionality
+  - Public IP address detection
+
+- 🚀 **Performance Enhancements**
+  - Multi-threaded network scanning (up to 50 concurrent connections)
+  - Optimized network discovery algorithms
+  - Cross-platform network interface support
+  - Enhanced timeout management for network operations
+
+- 📊 **Extended CLI Support**
+  - New `network` module option for CLI
+  - Comprehensive network analysis output formats
+  - Integration with existing output formats (JSON, CSV, pretty print)
+
+### Changed
+- Enhanced error handling for network operations
+- Improved cross-platform compatibility (Windows, macOS, Linux)
+- Updated CLI help messages for new network module
+
+### Dependencies
+- Added `psutil>=5.9.0` for system and network monitoring
+- Added `netifaces>=0.11.0` for network interface management
+- Added `speedtest-cli>=2.1.3` for network speed testing
+
+### Technical Improvements
+- Thread-safe network operations
+- Memory-efficient network scanning
+- Graceful degradation when dependencies are missing
+- Comprehensive input validation for network functions
+
 ## [1.0.0] - 2024-06-24
 
 ### Added

README.md

@@ -48,6 +48,14 @@ DeepRecon provides a comprehensive suite of tools for analyzing domains and IP a
 - **Server Identification**: Web server and proxy detection
 - **Meta Information**: Page titles, meta tags extraction
 
+### 🌐 Network Analysis
+- **Interface Discovery**: Network interface monitoring and analysis
+- **Device Scanning**: Local network device identification
+- **Port Scanning**: Advanced multi-threaded port scanning
+- **Performance Metrics**: Network speed and latency analysis
+- **Security Assessment**: Network vulnerability scanning
+- **Topology Mapping**: Network structure visualization
+
 ### 🌍 Multi-language Support
 - **English** and **Persian (فارسی)** interface
 - **Internationalization**: Easy to extend for more languages
@@ -86,6 +94,9 @@ DeepRecon automatically installs these required packages:
 - `pyOpenSSL` - SSL/TLS toolkit
 - `beautifulsoup4` - HTML parser
 - `lxml` - XML/HTML parser
+- `psutil` - System and network monitoring
+- `netifaces` - Network interface management
+- `speedtest-cli` - Network speed testing
 
 ---
 
@@ -100,6 +111,9 @@ deeprecon google.com
 # Specific analysis modules
 deeprecon github.com --modules resolve dns ssl
 
+# Include network analysis
+deeprecon example.com --modules resolve dns network
+
 # Output in JSON format
 deeprecon example.com --output json
 
@@ -111,12 +125,15 @@ deeprecon google.com --language fa
 
 # Quiet mode (results only)
 deeprecon google.com --quiet
+
+# Network analysis only
+deeprecon --modules network
 ```
 
 ### Python API Usage
 
 ```python
-from deeprecon import resolve, dns, geoip, ssl
+from deeprecon import resolve, dns, geoip, ssl, network
 
 # Basic domain to IP resolution
 ip = resolve.get_ip('google.com')
@@ -133,6 +150,14 @@ print(f"Location: {location['city']}, {location['country']}")
 # SSL certificate information
 ssl_info = ssl.get_ssl_info('github.com')
 print(f"SSL Issuer: {ssl_info['issuer']['organizationName']}")
+
+# Network analysis
+interfaces = network.get_network_interfaces()
+print(f"Network Interfaces: {list(interfaces.keys())}")
+
+# Scan network devices
+devices = network.scan_network_devices()
+print(f"Found {len(devices)} devices on network")
 ```
 
 ---
@@ -148,7 +173,7 @@ deeprecon <target> [options]
 
 #### Options
 - `--modules, -m`: Specify analysis modules
-  - Available: `resolve`, `dns`, `whois`, `geoip`, `ssl`, `availability`, `security`, `tech`
+  - Available: `resolve`, `dns`, `whois`, `geoip`, `ssl`, `availability`, `security`, `tech`, `network`
 - `--output, -o`: Output format (`json`, `csv`, `pretty`)
 - `--file, -f`: Save output to file
 - `--language, -l`: Interface language (`en`, `fa`)
@@ -165,6 +190,12 @@ deeprecon 8.8.8.8
 # Custom modules
 deeprecon google.com -m resolve dns ssl
 
+# Network analysis
+deeprecon -m network
+
+# Combined analysis
+deeprecon example.com -m resolve dns network
+
 # JSON output to file
 deeprecon github.com -o json -f analysis.json
 ```
@@ -242,6 +273,29 @@ waf = has_waf('example.com')
 score = get_security_score('example.com')
 ```
 
+#### Network Module
+```python
+from deeprecon.network import (
+    get_network_interfaces, scan_network_devices,
+    advanced_port_scan, network_performance, network_security_scan
+)
+
+# Get network interfaces
+interfaces = get_network_interfaces()
+
+# Scan network devices
+devices = scan_network_devices('192.168.1.0/24')
+
+# Advanced port scanning
+ports = advanced_port_scan('192.168.1.1', '1-1000')
+
+# Network performance analysis
+performance = network_performance()
+
+# Network security scan
+security = network_security_scan()
+```
+
 ---
 
 ## 🏗️ Architecture
@@ -259,9 +313,11 @@ deeprecon/
 ├── availability.py    # Connectivity testing
 ├── security.py        # Security analysis
 ├── tech_detect.py     # Technology detection
+├── network.py         # Network analysis and scanning
 ├── utils/
 │   ├── validator.py   # Input validation
-│   └── formatter.py   # Output formatting
+│   ├── formatter.py   # Output formatting
+│   └── network_utils.py # Network utility functions
 └── locales/           # Internationalization
     ├── en.json
     └── fa.json
@@ -288,6 +344,9 @@ deeprecon/
 - **Port scanning** for connectivity testing
 - **Geolocation analysis** for CDN optimization
 - **Technology stack identification**
+- **Local network discovery** and device mapping
+- **Network performance monitoring** and optimization
+- **Network security assessment** and vulnerability scanning
 
 ### Research & Analytics
 - **Domain analysis** for market research
@@ -341,6 +400,8 @@ We welcome contributions! Here's how you can help:
 - 🔧 **New analysis modules**
 - 📊 **Enhanced output formats**
 - 🚀 **Performance optimizations**
+- 🌐 **Extended network analysis features**
+- 🔒 **Advanced security scanning**
 - 🐛 **Bug fixes and improvements**
 
 ---

deeprecon/__init__.py

@@ -1,6 +1,6 @@
 from .config import DEFAULT_LANGUAGE, SUPPORTED_LANGUAGES
 
-__version__ = '1.0.1'
+__version__ = '1.1.0'
 __author__ = 'DeepRecon Team'
 
 import json

deeprecon/cli.py

@@ -11,6 +11,7 @@
 from .availability import ping, get_http_status
 from .security import is_filtered, has_waf, get_security_score
 from .tech_detect import detect_technologies
+from .network import get_network_interfaces, scan_network_devices, network_performance, network_security_scan
 from .utils.formatter import to_json, export_to_csv
 from .utils.validator import validate_domain, validate_ip
 
@@ -28,9 +29,9 @@ def main():
     parser.add_argument(
         '-m', '--modules',
         nargs='+',
-        choices=['resolve', 'dns', 'whois', 'geoip', 'ssl', 'availability', 'security', 'tech'],
+        choices=['resolve', 'dns', 'whois', 'geoip', 'ssl', 'availability', 'security', 'tech', 'network'],
         default=['resolve', 'dns', 'whois', 'geoip', 'ssl', 'availability', 'security', 'tech'],
-        help='Modules to run (default: all)'
+        help='Modules to run (default: all except network)'
     )
 
     parser.add_argument(
@@ -131,6 +132,16 @@ def main():
             print(get_message('messages.detecting_tech'))
         results['tech'] = detect_technologies(target)
 
+    if 'network' in args.modules:
+        if not args.quiet:
+            print(get_message('messages.scanning_network'))
+        results['network'] = {
+            'interfaces': get_network_interfaces(),
+            'devices': scan_network_devices(),
+            'performance': network_performance(),
+            'security': network_security_scan()
+        }
+    
     if not args.quiet:
         print(f"\n{get_message('messages.complete')}\n")
 

deeprecon/config.py

@@ -49,3 +49,25 @@
 CACHE_ENABLED = True
 CACHE_TTL = 3600
 MAX_CACHE_SIZE = 1000
+
+NETWORK_SCAN_TIMEOUT = 30
+NETWORK_DISCOVERY_TIMEOUT = 60
+PORT_SCAN_TIMEOUT = 120
+PING_COUNT = 4
+MAX_THREADS = 50
+
+SCAN_COMMON_PORTS = [21, 22, 23, 25, 53, 80, 110, 143, 443, 993, 995]
+FULL_PORT_RANGE = range(1, 65536)
+
+BANDWIDTH_TEST_SERVERS = [
+    'speedtest.net',
+    'fast.com',
+    'testmy.net'
+]
+
+NETWORK_INTERFACE_TYPES = {
+    'ethernet': ['eth', 'ens', 'enp'],
+    'wireless': ['wlan', 'wlp'],
+    'loopback': ['lo'],
+    'virtual': ['docker', 'br-', 'veth', 'tun', 'tap']
+}

deeprecon/locales/en.json

@@ -21,6 +21,10 @@
     "checking_availability": "Checking availability",
     "scanning_security": "Scanning security",
     "detecting_tech": "Detecting technologies",
+    "scanning_network": "Scanning network topology",
+    "discovering_devices": "Discovering network devices",
+    "analyzing_performance": "Analyzing network performance",
+    "checking_network_security": "Checking network security",
     "complete": "Analysis complete"
   },
   "results": {
@@ -38,6 +42,13 @@
     "filtered": "Filtered",
     "not_filtered": "Not Filtered",
     "protected": "Protected",
-    "not_protected": "Not Protected"
+    "not_protected": "Not Protected",
+    "network_interfaces": "Network Interfaces",
+    "connected_devices": "Connected Devices",
+    "network_performance": "Network Performance",
+    "network_security": "Network Security",
+    "bandwidth": "Bandwidth",
+    "latency": "Latency",
+    "packet_loss": "Packet Loss"
   }
 }

deeprecon/locales/fa.json

@@ -21,6 +21,10 @@
     "checking_availability": "بررسی دسترس‌پذیری",
     "scanning_security": "اسکن امنیتی",
     "detecting_tech": "شناسایی تکنولوژی‌ها",
+    "scanning_network": "اسکن توپولوژی شبکه",
+    "discovering_devices": "کشف دستگاه‌های شبکه",
+    "analyzing_performance": "تحلیل عملکرد شبکه",
+    "checking_network_security": "بررسی امنیت شبکه",
     "complete": "تحلیل کامل شد"
   },
   "results": {
@@ -38,6 +42,13 @@
     "filtered": "فیلتر شده",
     "not_filtered": "فیلتر نشده",
     "protected": "محافظت شده",
-    "not_protected": "محافظت نشده"
+    "not_protected": "محافظت نشده",
+    "network_interfaces": "رابط‌های شبکه",
+    "connected_devices": "دستگاه‌های متصل",
+    "network_performance": "عملکرد شبکه",
+    "network_security": "امنیت شبکه",
+    "bandwidth": "پهنای باند",
+    "latency": "تاخیر",
+    "packet_loss": "از دست رفتن بسته"
   }
 }