philiprehberger-portcheck 0.1.6

Check if a port is open on a host

philiprehberger-portcheck

Check if a port is open on a host.

Installation

pip install philiprehberger-portcheck

Usage

from philiprehberger_portcheck import is_open, scan, wait_for

# Single port check
is_open("localhost", 8080)                  # True/False
is_open("192.168.1.1", 22, timeout=2.0)    # True/False

# Scan multiple ports
results = scan("localhost", ports=[80, 443, 8080, 5432])
for port, result in results.items():
    if result.is_open:
        print(f"Port {port}: open ({result.service})")

# Scan common ports
results = scan("localhost", ports="common")

# Wait for a port to become available
wait_for("localhost", 5432, timeout=30)

API

Function / Class	Description
is_open(host, port, timeout=2.0)	Check if a TCP port is open
scan(host, ports, timeout=1.0, max_workers=50)	Scan multiple ports concurrently
wait_for(host, port, timeout=30, interval=1.0)	Block until port opens or raise TimeoutError
PortResult	Scan result — .port, .is_open, .service
COMMON_PORTS	List of well-known port numbers (HTTP, SSH, DB, etc.)

Development

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

License

MIT