toomanyports 0.1.11

Port allocation cleanup usage reporting

TooManyPorts

A lightweight Python library for port allocation, monitoring, and management.

Installation

Install via pip:

pip install toomanyports

Usage

from toomanyports import PortManager

pm = PortManager()

Examples

Find a free port

Find a single available port starting from 3000:

port = pm.find(3000, 1)[0]

Find multiple free ports

ports = pm.find(3000, 2)

Kill a process on a specific port

success = pm.kill(8080)

Kill processes on multiple ports

results = pm.kill_all([8080, 8081])

List port usage

Retrieve the process IDs listening on ports 3000 through 3010:

usage = pm.list_usage((3000, 3010))

Obtain a random ephemeral port

random_port = pm.random_port()

Shorthand call

free_port = pm(3000)

Testing

Run the test suite with:

pytest tests_core.py

License

This project is licensed under the MIT License.