Skip to content

v0.1.0 - Whose port is it anyway?

Choose a tag to compare

View all tags
@hc-ui hc-ui released this 13 Aug 09:17
· 6 commits to main since this release
v0.1.0
9a4dabd

First release.

whoseport - one command to see which process is using a port, and free it if you want. Pure Python stdlib, zero dependencies, Windows/macOS/Linux.

\\�ash
pip install whoseport # or grab the wheel below
whoseport 8080 # who's on 8080?
whoseport 8080 --kill # free it (asks first)
\\

Highlights

  • Zero dependencies - no psutil, no compiled wheels. Linux reads /proc directly, Windows calls iphlpapi via ctypes (locale-proof - no netstat text parsing), macOS drives the bundled lsof in machine-readable mode.
  • Look before you kill - table with PID, process name, command line and state; connection noise collapsed.
  • Safe kill - confirmation, SIGTERM first, refuses system PIDs, verifies the port is actually free afterwards.
  • Script/agent friendly - --json, meaningful exit codes (1 = port free).
  • Tested end-to-end on 3 OS x Python 3.9-3.14 (79 tests, real sockets, real kills).
Assets 4
Loading