philiprehberger-net-scanner 0.2.0

LAN device discovery and TCP port scanning.

philiprehberger-net-scanner

LAN device discovery and TCP port scanning.

Installation

pip install philiprehberger-net-scanner

Usage

Network Discovery

from philiprehberger_net_scanner import scan_network

devices = scan_network("192.168.1.0/24", timeout=2.0)
for device in devices:
    print(f"{device.ip} - {device.hostname or 'unknown'} ({device.response_time_ms:.1f}ms)")

Port Scanning

from philiprehberger_net_scanner import scan_ports

# Scan common ports
ports = scan_ports("192.168.1.1", ports="common")
for port in ports:
    print(f"Port {port.number}: {port.state} ({port.service})")

# Scan specific range
ports = scan_ports("192.168.1.1", ports=range(1, 1024), timeout=0.5)

# Scan specific ports
ports = scan_ports("192.168.1.1", ports=[22, 80, 443, 3306, 5432])

Single port check

from philiprehberger_net_scanner import is_port_open

if is_port_open("example.com", 443, timeout=1.0):
    print("HTTPS is reachable")

Async Port Scanning

import asyncio
from philiprehberger_net_scanner import async_scan_ports

ports = asyncio.run(async_scan_ports("192.168.1.1", ports=range(1, 65536), timeout=0.5))

API

Function / Class	Description
scan_network(cidr, timeout=1.0, max_workers=64, resolve_hostnames=True)	Discover devices on a network using TCP connect probes
scan_ports(host, ports="common", timeout=1.0, max_workers=128)	Scan TCP ports on a host ("common", range, or list[int])
async_scan_ports(host, ports="common", timeout=1.0, concurrency=128)	Asyncio-based version of scan_ports
is_port_open(host, port, timeout=1.0)	One-off boolean check for a single TCP port
Device	Discovered host: ip, hostname, mac, response_time_ms
PortResult	Scan result: number, state ("open"/"closed"/"filtered"), service

Development

pip install -e .
python -m pytest tests/ -v

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT