{"library":"python3-nmap","title":"python3-nmap","description":"Python3-nmap converts Nmap commands into python3 methods making it very easy to use nmap in any of your python pentesting projects. It provides a Python 3 interface to the Nmap port scanner, enabling manipulation of scan results and automation of scanning tasks and reports. The library is actively maintained, with the latest stable release being 1.9.1.","language":"python","status":"active","last_verified":"Mon May 18","install":{"commands":["pip install python3-nmap"],"cli":null},"imports":["from nmap3 import Nmap"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import nmap3\n\ndef run_nmap_scan(target_host):\n    try:\n        # Initialize nmap3\n        nmap = nmap3.Nmap()\n\n        # Perform a top ports scan (example: scanme.nmap.org is a safe target)\n        print(f\"Scanning top ports on {target_host}...\")\n        results = nmap.scan_top_ports(target_host)\n\n        if results:\n            print(\"Scan results:\")\n            for host, host_data in results.items():\n                if host == 'runtime': continue # Skip runtime metadata\n                print(f\"  Host: {host}\")\n                for port_entry in host_data['ports']:\n                    port_id = port_entry.get('portid')\n                    state = port_entry.get('state')\n                    service = port_entry.get('service', {}).get('name')\n                    product = port_entry.get('service', {}).get('product')\n                    version = port_entry.get('service', {}).get('version')\n                    \n                    port_info = f\"    Port: {port_id}/{port_entry.get('protocol')} State: {state}\"\n                    if service: port_info += f\" Service: {service}\"\n                    if product: port_info += f\" Product: {product}\"\n                    if version: port_info += f\" Version: {version}\"\n                    print(port_info)\n        else:\n            print(\"No results found or host is down.\")\n\n    except nmap3.exceptions.NmapCommandError as e:\n        print(f\"Nmap command error: {e}. Ensure Nmap is installed and in your PATH.\")\n    except Exception as e:\n        print(f\"An unexpected error occurred: {e}\")\n\n# Replace 'scanme.nmap.org' with your target. \n# DO NOT scan hosts without explicit permission.\nrun_nmap_scan(\"scanme.nmap.org\")","lang":"python","description":"This quickstart initializes the `nmap3.Nmap` class and performs a top ports scan on a specified target. It then prints the host and open port information. Remember to have the Nmap binary installed on your system.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-18","installed_version":"1.9.1","pypi_latest":"1.9.1","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":1.7,"avg_import_s":0.28,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"python3-nmap","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.15,"mem_mb":8.3,"disk_size":"18.8M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"python3-nmap","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.7,"import_time_s":0.13,"mem_mb":8.3,"disk_size":"19M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"python3-nmap","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.23,"mem_mb":9.5,"disk_size":"20.8M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"python3-nmap","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.7,"import_time_s":0.22,"mem_mb":9.5,"disk_size":"21M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"python3-nmap","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.48,"mem_mb":9.6,"disk_size":"12.6M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"python3-nmap","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.5,"import_time_s":0.41,"mem_mb":9.6,"disk_size":"13M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"python3-nmap","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.46,"mem_mb":10.1,"disk_size":"12.4M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"python3-nmap","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.4,"mem_mb":10.1,"disk_size":"13M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"python3-nmap","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.15,"mem_mb":8.1,"disk_size":"18.3M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"python3-nmap","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2,"import_time_s":0.13,"mem_mb":8.1,"disk_size":"19M"}]}}