nust-nmap 2.1.1

A comprehensive Python wrapper for nmap with enhanced features

nust-nmap

🎯 Enterprise-Grade Python Nmap Wrapper
Production-ready network scanning with built-in stealth capabilities

---

🌟 What is nust-nmap?

A comprehensive Python wrapper for nmap that enhances the original functionality with enterprise-grade features. Designed for security professionals, penetration testers, and network administrators who need reliable, production-ready network scanning capabilities.

✨ Key Features

• 🎯 Complete nmap Coverage: All scan types, NSE scripts, and advanced features
• 🛡️ Built-in Security: Stealth profiles, evasion techniques, input validation
• ⚡ High Performance: Async scanning, intelligent caching, memory efficiency
• 🔧 Enterprise Ready: Thread-safe, comprehensive error handling, resource management
• 📊 Rich Output: Multiple export formats (XML, JSON, CSV) with enhanced parsing
• 🌐 Cross-Platform: Windows, macOS, Linux with automatic nmap detection
• 🔄 100% Compatible: Drop-in replacement for python-nmap

📦 Quick Installation

Prerequisites

• Python 3.8+
• Nmap 7.90+ installed on your system

Install

pip install nust-nmap

Install Nmap

# Ubuntu/Debian
sudo apt update && sudo apt install nmap

# macOS  
brew install nmap

# Windows: Download from nmap.org

🚀 Quick Start

Basic Usage

import nmap

# Create scanner instance
scanner = nmap.PortScanner()

# Basic network scan
result = scanner.scan('192.168.1.0/24', '22,80,443')

# Process results
for host in scanner.all_hosts():
    print(f"Host: {host} ({scanner[host].state()})")
    for protocol in scanner[host].all_protocols():
        ports = scanner[host][protocol].keys()
        for port in ports:
            state = scanner[host][protocol][port]['state']
            print(f"  {port}/{protocol}: {state}")

Stealth Scanning

# Built-in stealth profiles
result = scanner.scan(
    hosts='target.com',
    evasion_profile=nmap.EvasionProfile.STEALTH
)

# Quick stealth functions
result = nmap.scan_stealth('target.com', '1-1000')
result = nmap.scan_ghost('target.com', '80,443')  # Maximum stealth

Advanced Features

# Asynchronous scanning
def scan_callback(host, result):
    print(f"Completed scan for {host}")

nmap.scan_progressive('192.168.1.0/24', callback=scan_callback)

# Memory-efficient large network scanning
yield_scanner = nmap.YieldScanner()
for host, result in yield_scanner.scan('10.0.0.0/16'):
    process_host_data(host, result)

📚 Documentation

• 📖 Complete Programmer Guide: Comprehensive technical documentation
• 🔧 API Reference: Detailed API documentation
• 🚀 Examples: Usage examples and patterns
• 📝 Changelog: Version history and updates

🛡️ Security & Ethics

This tool is designed for legitimate security testing and network administration. Users are responsible for:

• Obtaining proper authorization before scanning networks
• Complying with applicable laws and regulations
• Using responsible disclosure for any vulnerabilities discovered

🤝 Contributing

Contributions are welcome! Please see our contributing guidelines for details.

📄 License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.

� Author

Sameer Ahmed

• Email: [e-mail]
• GitHub: @codeNinja62

�🙏 Acknowledgments

• Powered by the Nmap Security Scanner - the industry standard for network discovery
• Inspired by the network security community and best practices in vulnerability assessment
• Thanks to the cybersecurity community for continuous feedback and improvements

🔗 Links

• 📦 PyPI Package
• 📚 Documentation
• 🐛 Issue Tracker
• 🌐 Nmap Official Site

⚠️ Legal Disclaimer

IMPORTANT: This tool is designed for authorized security testing and network administration only.

• ✅ Authorized Use: Own networks, approved penetration testing, security research
• ❌ Prohibited Use: Unauthorized scanning, malicious activities, illegal reconnaissance

Users are solely responsible for compliance with applicable laws and regulations. Always obtain explicit permission before scanning networks you do not own or administer.

---

⚡ Ready to secure your network? Start scanning with nust-nmap today!