philiprehberger-portcheck 0.1.5

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

• is_open(host, port, timeout=2.0) — Check if 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

Development

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

License

MIT