Metadata-Version: 2.4
Name: whoport
Version: 0.2.0
Summary: Show which processes are listening on which ports
License-Expression: MIT
Project-URL: Homepage, https://github.com/Gnomecromancer/portmap
Project-URL: Repository, https://github.com/Gnomecromancer/portmap
Keywords: ports,networking,process,developer-tools,devtools
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Provides-Extra: full
Requires-Dist: psutil>=5.9.0; extra == "full"

# whoport

Show which processes are listening on which ports — with filtering by port number or process name.

## Install

```bash
pip install whoport[full]
```

(`psutil` is required for process information. The base `pip install whoport` works but will prompt you to install it.)

## Usage

```bash
# Show all listening ports
whoport

# Show only specific ports
whoport 8080 3000 5432

# Filter by process name (partial match)
whoport --process node
whoport --process python

# Include UDP sockets
whoport --udp

# Show full command lines
whoport --cmd

# Include established connections, not just listeners
whoport --all
```

## Example output

```
PORT   PROTO  HOST  PID      PROCESS
────────────────────────────────────────────────────
  3000   tcp    *     41234    node
  5432   tcp    *     812      postgres
  8080   tcp    *     9876     uvicorn
  11434  tcp    lo    22980    ollama

4 ports shown.
```

## License

MIT
