ipmg 3.2.0__tar.gz → 4.0.0__tar.gz

ipmg-4.0.0/PKG-INFO

@@ -0,0 +1,254 @@
+Metadata-Version: 2.4
+Name: ipmg
+Version: 4.0.0
+Summary: Network discovery and change detection: ping sweeps, scan history, and reports for what changed on your network
+Author: Sameer Alam
+Maintainer-email: Sameer Alam <sameeralam3127@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://sameeralam3127.github.io/ipmg/
+Project-URL: Documentation, https://github.com/sameeralam3127/ipmg#readme
+Project-URL: Repository, https://github.com/sameeralam3127/ipmg
+Project-URL: Issues, https://github.com/sameeralam3127/ipmg/issues
+Project-URL: Changelog, https://github.com/sameeralam3127/ipmg/releases
+Keywords: ip,network,ping,monitoring,cli,port-scan,network-scanner,ping-sweep,subnet-scanner,homelab,sysadmin
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: System :: Monitoring
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Information Technology
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: rich>=13.0
+Requires-Dist: tomli>=2.0.1; python_version < "3.11"
+Provides-Extra: web
+Requires-Dist: fastapi>=0.110; extra == "web"
+Requires-Dist: pydantic>=2.7; extra == "web"
+Requires-Dist: uvicorn>=0.27; extra == "web"
+Requires-Dist: websockets>=12; extra == "web"
+Requires-Dist: python-multipart>=0.0.9; extra == "web"
+Provides-Extra: all
+Requires-Dist: ipmg[web]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: ipmg[web]; extra == "dev"
+Requires-Dist: pytest>=7.4; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: pre-commit>=3.5.0; extra == "dev"
+Requires-Dist: python-semantic-release>=10.5.3; extra == "dev"
+Requires-Dist: httpx>=0.27; extra == "dev"
+Requires-Dist: httpx2>=2.0; extra == "dev"
+Dynamic: license-file
+
+# IPMG — IP Management & Ping Monitoring Tool
+
+[![PyPI](https://img.shields.io/pypi/v/ipmg)](https://pypi.org/project/ipmg/)
+![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+[![Publish](https://github.com/sameeralam3127/ipmg/actions/workflows/publish.yml/badge.svg)](https://github.com/sameeralam3127/ipmg/actions/workflows/publish.yml)
+
+**Know what changed on your network since the last scan.**
+
+IPMG scans IPs, CIDR blocks, and ranges in parallel, keeps a history of every
+scan, and tells you what moved between two of them: hosts that went offline or
+appeared, IP addresses, hostnames, and MAC addresses that changed, latency that
+shifted, web services that started failing. Every change carries a severity,
+so only the ones that matter reach Slack, Teams, a webhook, or email, or fail a
+cron job or CI step. Use it from the command line or from IPMG Web, a local
+dashboard that works offline.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/sameeralam3127/ipmg/main/docs/assets/ipmg-compare.gif" alt="ipmg scans 13 hosts with --stream, printing each one as it answers; a new address is added to the target file; a second scan with --compare reports it as a new host (warning) against the first" width="820">
+</p>
+
+```bash
+curl -sSL https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.sh | bash
+ipmg --discover             # scan the network you are on, right now
+ipmg --discover --compare   # later: scan again and see what changed
+ipmg web --lan              # open the dashboard from any machine on your network
+```
+
+> **Please read:** only scan networks you are authorized to scan. Unauthorized
+> scanning may violate your organization's policies or the law.
+
+**Website:** [sameeralam3127.github.io/ipmg](https://sameeralam3127.github.io/ipmg/) ·
+**Live demo:** [IPMG Web with sample data](https://sameeralam3127.github.io/ipmg/demo/) ·
+**Command builder:** [pick what you want, copy the command](https://sameeralam3127.github.io/ipmg/#builder) ·
+**Docs:** [everything else](#documentation)
+
+---
+
+## What it does
+
+- **Scans fast, without root.** IPv4 and IPv6, CIDR blocks, ranges, and
+  target files (text, CSV, Excel, JSON), `--threads` hosts at a time, using
+  your system's own `ping`.
+- **Finds hosts that block ping** with TCP probes (`--probe icmp,tcp`), and
+  checks web services (`--http-check`: status, response time, TLS, certificate
+  expiry).
+- **Identifies devices** by reverse DNS name and, on your LAN, by MAC address
+  and vendor (`--mac`). Wakes them with Wake-on-LAN (`ipmg wake`).
+- **Remembers every scan** and reports what changed, with severities and
+  alerts to Slack, Teams, webhooks, or email.
+- **Fits into automation:** exit codes for cron and CI, a GitHub Action,
+  `--json` for scripts, systemd and launchd templates, Prometheus metrics.
+- **IPMG Web**, a local dashboard: live scans, history, changes, inventory,
+  and scheduled scans.
+- **Reports** in Excel, CSV, JSON, JSON Lines, and Markdown, written as the
+  scan runs, so an interrupted scan keeps its results and can be resumed.
+
+[How it compares](https://github.com/sameeralam3127/ipmg/blob/main/docs/COMPARISON.md)
+with nmap, fping, and Uptime Kuma.
+
+---
+
+## Install
+
+**Linux and macOS**, on any distribution, with no Python needed:
+
+```bash
+curl -sSL https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.sh | bash
+```
+
+**Windows** (PowerShell, no administrator rights):
+
+```powershell
+irm https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.ps1 | iex
+```
+
+**Homebrew:** `brew install sameeralam3127/tap/ipmg` ·
+**uv:** `uv tool install --python ">=3.10" "ipmg[web]"` ·
+**pipx:** `pipx install "ipmg[web]"` ·
+**Docker:** `docker run --rm ghcr.io/sameeralam3127/ipmg --input 10.0.0.0/24`
+
+IPMG needs Python 3.10 or newer (the installers bring their own) and the
+system `ping` command. Minimal images, version pinning, upgrading from 3.x,
+tab completion, and the systems CI verifies are in the
+[install guide](https://github.com/sameeralam3127/ipmg/blob/main/docs/INSTALL.md).
+
+---
+
+## Your first scan
+
+```bash
+ipmg --input 192.168.1.0/24 --stream        # each host as it answers
+```
+
+```text
+  ipmg X.Y.Z  ·  scan
+  ICMP probes only — scan only networks you are authorized to scan.
+
+  Source   192.168.1.0/24
+  Targets  254 hosts
+  Config   50 threads · 2s timeout · 1 ping
+
+  Results
+  ● Active    12  ━───────────────────────   4.7%
+  ● Timeout  242  ━━━━━━━━━━━━━━━━━━━━━━━━  95.3%
+
+  254 hosts · 4.7% active · 3.1 ms avg · 5.21s · 2026-10-18 09:15:02
+
+  Saved    results_20261018_091502.xlsx
+```
+
+Every scan is stored in a local history (`~/.ipmg/dashboard.db`). Scan again
+with `--compare` to see what changed, or open IPMG Web to browse it.
+
+---
+
+## Common tasks
+
+| I want to… | Command |
+| --- | --- |
+| Scan the network I am on | `ipmg --discover` |
+| Scan hosts listed in a file, plus a few more | `ipmg --input targets.txt 10.0.0.5` |
+| See what changed since last time | `ipmg --input targets.txt --compare` |
+| Get alerted when something changes | `ipmg --input targets.txt --interval 15 --notify-slack` |
+| Find hosts that block ping | `ipmg --input 10.0.0.0/24 --probe icmp,tcp` |
+| Know which device each address is | `ipmg --discover --resolve --mac` |
+| Check that a web service works | `ipmg --http-check https://intranet.example.com/` |
+| See which services are listening | `ipmg --input targets.txt --scan-ports` |
+| Get a report I can send to someone | `ipmg --input targets.txt --formats md csv` |
+| Pipe the results into a script | `ipmg --input targets.txt --json \| jq .` |
+| Fail a cron job or CI step when hosts are down | `ipmg --input servers.txt --fail-on-down` |
+| Wake a machine | `ipmg wake AA:BB:CC:DD:EE:FF` |
+| Use the dashboard from another machine | `ipmg web --lan` |
+| Keep it running after logout and reboots | [systemd and launchd templates](https://github.com/sameeralam3127/ipmg/blob/main/docs/SERVICES.md) |
+| See every option | `ipmg --help`, or the [command reference](https://github.com/sameeralam3127/ipmg/blob/main/docs/COMMANDS.md) |
+
+---
+
+## IPMG Web
+
+```bash
+ipmg web          # this machine: opens http://127.0.0.1:8080 in your browser
+ipmg web --lan    # any machine on your network: prints the link to open
+```
+
+With `--lan`, IPMG Web prints the link with this machine's address and access
+token, checks the firewall, and tells you the exact command that opens the
+port if it is blocked (`sudo ipmg web --open-firewall` opens it only while
+IPMG Web runs). Every request needs the token in that link.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/sameeralam3127/ipmg/main/docs/assets/ipmg-web.png" alt="IPMG Web dashboard: scan totals, a status donut of 16 active, 1 timeout and 1 inactive host, a latency trend chart, and a list of recent scans" width="820">
+</p>
+
+Dashboard, live monitor, history, changes, inventory with Wake-on-LAN, and
+scheduled scans; see the
+[IPMG Web guide](https://github.com/sameeralam3127/ipmg/blob/main/docs/WEB.md).
+Try it first with the [live demo](https://sameeralam3127.github.io/ipmg/demo/).
+
+---
+
+## Documentation
+
+| Guide | What is in it |
+| --- | --- |
+| [Install](https://github.com/sameeralam3127/ipmg/blob/main/docs/INSTALL.md) | Installers, Docker, pip, Python versions, upgrading from 3.x, tab completion, verified systems |
+| [Command reference](https://github.com/sameeralam3127/ipmg/blob/main/docs/COMMANDS.md) | Every command and flag with examples: targets, probes, HTTP checks, reports, history, change detection, notifications, `ipmg.toml`, exit codes |
+| [IPMG Web](https://github.com/sameeralam3127/ipmg/blob/main/docs/WEB.md) | The dashboard, opening it from other machines, the firewall, scheduled scans, Prometheus metrics |
+| [Web API](https://github.com/sameeralam3127/ipmg/blob/main/docs/API.md) | Scripting IPMG Web over HTTP and WebSocket |
+| [Running as a service](https://github.com/sameeralam3127/ipmg/blob/main/docs/SERVICES.md) | systemd and launchd templates for scheduled scans and IPMG Web |
+| [GitHub Action](https://github.com/sameeralam3127/ipmg/blob/main/docs/GITHUB-ACTION.md) | Reachability checks in CI, before a deploy or on a schedule |
+| [How it compares](https://github.com/sameeralam3127/ipmg/blob/main/docs/COMPARISON.md) | IPMG next to nmap, fping, and Uptime Kuma |
+| [Troubleshooting](https://github.com/sameeralam3127/ipmg/blob/main/docs/TROUBLESHOOTING.md) and [FAQ](https://github.com/sameeralam3127/ipmg/blob/main/docs/FAQ.md) | Install errors, timeouts, slow scans, empty MAC addresses, common questions |
+| [Architecture](https://github.com/sameeralam3127/ipmg/blob/main/docs/ARCHITECTURE.md) | How the code fits together, for contributors |
+
+---
+
+## Security
+
+IPMG runs `ping` as a direct process call with no shell, validates every
+target first, and needs no root. IPMG Web listens on `127.0.0.1` unless you
+pass `--lan`, serves everything locally, and requires its access token on
+every request, behind a strict Content-Security-Policy. The only outbound
+requests IPMG makes are the notifications and HTTP checks you ask for. Found a
+vulnerability? See
+[SECURITY.md](https://github.com/sameeralam3127/ipmg/blob/main/.github/SECURITY.md).
+
+---
+
+## Contributing
+
+Contributions are welcome.
+[CONTRIBUTING.md](https://github.com/sameeralam3127/ipmg/blob/main/.github/CONTRIBUTING.md)
+covers the development setup, the tests, and the commit format that drives
+releases, and
+[ARCHITECTURE.md](https://github.com/sameeralam3127/ipmg/blob/main/docs/ARCHITECTURE.md)
+explains the code. Everyone taking part is expected to follow the
+[Code of Conduct](https://github.com/sameeralam3127/ipmg/blob/main/.github/CODE_OF_CONDUCT.md).
+
+## License
+
+MIT — free for commercial and personal use.

ipmg-4.0.0/README.md

@@ -0,0 +1,202 @@
+# IPMG — IP Management & Ping Monitoring Tool
+
+[![PyPI](https://img.shields.io/pypi/v/ipmg)](https://pypi.org/project/ipmg/)
+![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+[![Publish](https://github.com/sameeralam3127/ipmg/actions/workflows/publish.yml/badge.svg)](https://github.com/sameeralam3127/ipmg/actions/workflows/publish.yml)
+
+**Know what changed on your network since the last scan.**
+
+IPMG scans IPs, CIDR blocks, and ranges in parallel, keeps a history of every
+scan, and tells you what moved between two of them: hosts that went offline or
+appeared, IP addresses, hostnames, and MAC addresses that changed, latency that
+shifted, web services that started failing. Every change carries a severity,
+so only the ones that matter reach Slack, Teams, a webhook, or email, or fail a
+cron job or CI step. Use it from the command line or from IPMG Web, a local
+dashboard that works offline.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/sameeralam3127/ipmg/main/docs/assets/ipmg-compare.gif" alt="ipmg scans 13 hosts with --stream, printing each one as it answers; a new address is added to the target file; a second scan with --compare reports it as a new host (warning) against the first" width="820">
+</p>
+
+```bash
+curl -sSL https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.sh | bash
+ipmg --discover             # scan the network you are on, right now
+ipmg --discover --compare   # later: scan again and see what changed
+ipmg web --lan              # open the dashboard from any machine on your network
+```
+
+> **Please read:** only scan networks you are authorized to scan. Unauthorized
+> scanning may violate your organization's policies or the law.
+
+**Website:** [sameeralam3127.github.io/ipmg](https://sameeralam3127.github.io/ipmg/) ·
+**Live demo:** [IPMG Web with sample data](https://sameeralam3127.github.io/ipmg/demo/) ·
+**Command builder:** [pick what you want, copy the command](https://sameeralam3127.github.io/ipmg/#builder) ·
+**Docs:** [everything else](#documentation)
+
+---
+
+## What it does
+
+- **Scans fast, without root.** IPv4 and IPv6, CIDR blocks, ranges, and
+  target files (text, CSV, Excel, JSON), `--threads` hosts at a time, using
+  your system's own `ping`.
+- **Finds hosts that block ping** with TCP probes (`--probe icmp,tcp`), and
+  checks web services (`--http-check`: status, response time, TLS, certificate
+  expiry).
+- **Identifies devices** by reverse DNS name and, on your LAN, by MAC address
+  and vendor (`--mac`). Wakes them with Wake-on-LAN (`ipmg wake`).
+- **Remembers every scan** and reports what changed, with severities and
+  alerts to Slack, Teams, webhooks, or email.
+- **Fits into automation:** exit codes for cron and CI, a GitHub Action,
+  `--json` for scripts, systemd and launchd templates, Prometheus metrics.
+- **IPMG Web**, a local dashboard: live scans, history, changes, inventory,
+  and scheduled scans.
+- **Reports** in Excel, CSV, JSON, JSON Lines, and Markdown, written as the
+  scan runs, so an interrupted scan keeps its results and can be resumed.
+
+[How it compares](https://github.com/sameeralam3127/ipmg/blob/main/docs/COMPARISON.md)
+with nmap, fping, and Uptime Kuma.
+
+---
+
+## Install
+
+**Linux and macOS**, on any distribution, with no Python needed:
+
+```bash
+curl -sSL https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.sh | bash
+```
+
+**Windows** (PowerShell, no administrator rights):
+
+```powershell
+irm https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.ps1 | iex
+```
+
+**Homebrew:** `brew install sameeralam3127/tap/ipmg` ·
+**uv:** `uv tool install --python ">=3.10" "ipmg[web]"` ·
+**pipx:** `pipx install "ipmg[web]"` ·
+**Docker:** `docker run --rm ghcr.io/sameeralam3127/ipmg --input 10.0.0.0/24`
+
+IPMG needs Python 3.10 or newer (the installers bring their own) and the
+system `ping` command. Minimal images, version pinning, upgrading from 3.x,
+tab completion, and the systems CI verifies are in the
+[install guide](https://github.com/sameeralam3127/ipmg/blob/main/docs/INSTALL.md).
+
+---
+
+## Your first scan
+
+```bash
+ipmg --input 192.168.1.0/24 --stream        # each host as it answers
+```
+
+```text
+  ipmg X.Y.Z  ·  scan
+  ICMP probes only — scan only networks you are authorized to scan.
+
+  Source   192.168.1.0/24
+  Targets  254 hosts
+  Config   50 threads · 2s timeout · 1 ping
+
+  Results
+  ● Active    12  ━───────────────────────   4.7%
+  ● Timeout  242  ━━━━━━━━━━━━━━━━━━━━━━━━  95.3%
+
+  254 hosts · 4.7% active · 3.1 ms avg · 5.21s · 2026-10-18 09:15:02
+
+  Saved    results_20261018_091502.xlsx
+```
+
+Every scan is stored in a local history (`~/.ipmg/dashboard.db`). Scan again
+with `--compare` to see what changed, or open IPMG Web to browse it.
+
+---
+
+## Common tasks
+
+| I want to… | Command |
+| --- | --- |
+| Scan the network I am on | `ipmg --discover` |
+| Scan hosts listed in a file, plus a few more | `ipmg --input targets.txt 10.0.0.5` |
+| See what changed since last time | `ipmg --input targets.txt --compare` |
+| Get alerted when something changes | `ipmg --input targets.txt --interval 15 --notify-slack` |
+| Find hosts that block ping | `ipmg --input 10.0.0.0/24 --probe icmp,tcp` |
+| Know which device each address is | `ipmg --discover --resolve --mac` |
+| Check that a web service works | `ipmg --http-check https://intranet.example.com/` |
+| See which services are listening | `ipmg --input targets.txt --scan-ports` |
+| Get a report I can send to someone | `ipmg --input targets.txt --formats md csv` |
+| Pipe the results into a script | `ipmg --input targets.txt --json \| jq .` |
+| Fail a cron job or CI step when hosts are down | `ipmg --input servers.txt --fail-on-down` |
+| Wake a machine | `ipmg wake AA:BB:CC:DD:EE:FF` |
+| Use the dashboard from another machine | `ipmg web --lan` |
+| Keep it running after logout and reboots | [systemd and launchd templates](https://github.com/sameeralam3127/ipmg/blob/main/docs/SERVICES.md) |
+| See every option | `ipmg --help`, or the [command reference](https://github.com/sameeralam3127/ipmg/blob/main/docs/COMMANDS.md) |
+
+---
+
+## IPMG Web
+
+```bash
+ipmg web          # this machine: opens http://127.0.0.1:8080 in your browser
+ipmg web --lan    # any machine on your network: prints the link to open
+```
+
+With `--lan`, IPMG Web prints the link with this machine's address and access
+token, checks the firewall, and tells you the exact command that opens the
+port if it is blocked (`sudo ipmg web --open-firewall` opens it only while
+IPMG Web runs). Every request needs the token in that link.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/sameeralam3127/ipmg/main/docs/assets/ipmg-web.png" alt="IPMG Web dashboard: scan totals, a status donut of 16 active, 1 timeout and 1 inactive host, a latency trend chart, and a list of recent scans" width="820">
+</p>
+
+Dashboard, live monitor, history, changes, inventory with Wake-on-LAN, and
+scheduled scans; see the
+[IPMG Web guide](https://github.com/sameeralam3127/ipmg/blob/main/docs/WEB.md).
+Try it first with the [live demo](https://sameeralam3127.github.io/ipmg/demo/).
+
+---
+
+## Documentation
+
+| Guide | What is in it |
+| --- | --- |
+| [Install](https://github.com/sameeralam3127/ipmg/blob/main/docs/INSTALL.md) | Installers, Docker, pip, Python versions, upgrading from 3.x, tab completion, verified systems |
+| [Command reference](https://github.com/sameeralam3127/ipmg/blob/main/docs/COMMANDS.md) | Every command and flag with examples: targets, probes, HTTP checks, reports, history, change detection, notifications, `ipmg.toml`, exit codes |
+| [IPMG Web](https://github.com/sameeralam3127/ipmg/blob/main/docs/WEB.md) | The dashboard, opening it from other machines, the firewall, scheduled scans, Prometheus metrics |
+| [Web API](https://github.com/sameeralam3127/ipmg/blob/main/docs/API.md) | Scripting IPMG Web over HTTP and WebSocket |
+| [Running as a service](https://github.com/sameeralam3127/ipmg/blob/main/docs/SERVICES.md) | systemd and launchd templates for scheduled scans and IPMG Web |
+| [GitHub Action](https://github.com/sameeralam3127/ipmg/blob/main/docs/GITHUB-ACTION.md) | Reachability checks in CI, before a deploy or on a schedule |
+| [How it compares](https://github.com/sameeralam3127/ipmg/blob/main/docs/COMPARISON.md) | IPMG next to nmap, fping, and Uptime Kuma |
+| [Troubleshooting](https://github.com/sameeralam3127/ipmg/blob/main/docs/TROUBLESHOOTING.md) and [FAQ](https://github.com/sameeralam3127/ipmg/blob/main/docs/FAQ.md) | Install errors, timeouts, slow scans, empty MAC addresses, common questions |
+| [Architecture](https://github.com/sameeralam3127/ipmg/blob/main/docs/ARCHITECTURE.md) | How the code fits together, for contributors |
+
+---
+
+## Security
+
+IPMG runs `ping` as a direct process call with no shell, validates every
+target first, and needs no root. IPMG Web listens on `127.0.0.1` unless you
+pass `--lan`, serves everything locally, and requires its access token on
+every request, behind a strict Content-Security-Policy. The only outbound
+requests IPMG makes are the notifications and HTTP checks you ask for. Found a
+vulnerability? See
+[SECURITY.md](https://github.com/sameeralam3127/ipmg/blob/main/.github/SECURITY.md).
+
+---
+
+## Contributing
+
+Contributions are welcome.
+[CONTRIBUTING.md](https://github.com/sameeralam3127/ipmg/blob/main/.github/CONTRIBUTING.md)
+covers the development setup, the tests, and the commit format that drives
+releases, and
+[ARCHITECTURE.md](https://github.com/sameeralam3127/ipmg/blob/main/docs/ARCHITECTURE.md)
+explains the code. Everyone taking part is expected to follow the
+[Code of Conduct](https://github.com/sameeralam3127/ipmg/blob/main/.github/CODE_OF_CONDUCT.md).
+
+## License
+
+MIT — free for commercial and personal use.

{ipmg-3.2.0 → ipmg-4.0.0}/pyproject.toml

@@ -13,10 +13,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ipmg"
-version = "3.2.0"  # Managed automatically by semantic-release
+version = "4.0.0"  # Managed automatically by semantic-release
 description = "Network discovery and change detection: ping sweeps, scan history, and reports for what changed on your network"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 license = "MIT"
 license-files = ["LICENSE"]
 
@@ -33,7 +33,6 @@ keywords = ["ip", "network", "ping", "monitoring", "cli", "port-scan", "network-
 classifiers = [
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -84,10 +83,10 @@ dev = [
     "pre-commit>=3.5.0",
     "python-semantic-release>=10.5.3",
     # The TestClient's HTTP client. Starlette 1.x wants httpx2 and warns
-    # about httpx; the Starlette releases Python 3.9 and the lowest-deps job
-    # resolve to predate httpx2 and need httpx.
+    # about httpx; the older Starlette the lowest-deps job resolves to
+    # predates httpx2 and needs httpx.
     "httpx>=0.27",
-    "httpx2>=2.0; python_version >= '3.10'",
+    "httpx2>=2.0",
 ]
 
 [project.scripts]
@@ -107,10 +106,10 @@ dev = [
     "pre-commit>=3.5.0",
     "python-semantic-release>=10.5.3",
     # The TestClient's HTTP client. Starlette 1.x wants httpx2 and warns
-    # about httpx; the Starlette releases Python 3.9 and the lowest-deps job
-    # resolve to predate httpx2 and need httpx.
+    # about httpx; the older Starlette the lowest-deps job resolves to
+    # predates httpx2 and needs httpx.
     "httpx>=0.27",
-    "httpx2>=2.0; python_version >= '3.10'",
+    "httpx2>=2.0",
 ]
 
 
@@ -121,7 +120,6 @@ dev = [
 # Publishing is done by the workflow (pypa/gh-action-pypi-publish), not by
 # semantic-release itself.
 [tool.semantic_release]
-branch = "main"
 version_toml = ["pyproject.toml:project.version"]
 version_variables = ["src/ipmg/__init__.py:__version__"]
 tag_format = "v{version}"
@@ -129,6 +127,16 @@ commit_message = "chore(release): {version}"
 build_command = "python -m build"
 major_on_zero = false
 
+# main releases; v4 releases betas (4.0.0-beta.N) until it merges into main.
+[tool.semantic_release.branches.main]
+match = "^main$"
+prerelease = false
+
+[tool.semantic_release.branches.v4]
+match = "^v4$"
+prerelease = true
+prerelease_token = "beta"
+
 [tool.semantic_release.changelog.default_templates]
 changelog_file = ".github/CHANGELOG.md"
 
@@ -178,7 +186,7 @@ fail_under = 90
 
 [tool.ruff]
 line-length = 100
-target-version = "py39"
+target-version = "py310"
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I", "C90"]
@@ -195,4 +203,4 @@ known-first-party = ["ipmg"]
 
 [tool.black]
 line-length = 100
-target-version = ["py39"]
+target-version = ["py310"]

{ipmg-3.2.0 → ipmg-4.0.0}/src/ipmg/__init__.py

@@ -2,4 +2,4 @@
 ipmg - IP Management & Ping Monitoring Tool
 """
 
-__version__ = "3.2.0"
+__version__ = "4.0.0"

{ipmg-3.2.0 → ipmg-4.0.0}/src/ipmg/cli/commands.py

@@ -40,6 +40,9 @@ WEB_EXTRA_MISSING = (
     "  pip install 'ipmg[web]'"
 )
 
+#: Where ``ipmg web --lan`` listens; only ever used when asked for with --lan.
+ALL_INTERFACES = "0.0.0.0"  # nosec B104
+
 EXIT_OK = 0
 EXIT_ERROR = 1
 EXIT_CHANGES_DETECTED = 2
@@ -96,13 +99,15 @@ def _web_command(argv: List[str]) -> int:
             raise
         raise IPMGError(WEB_EXTRA_MISSING) from exc
 
+    host = args.host or (ALL_INTERFACES if args.lan or args.open_firewall else "127.0.0.1")
     run_dashboard(
-        host=args.host,
+        host=host,
         port=args.port,
         open_browser=not args.no_browser,
         db_path=args.db,
         metrics_sources=max(args.metrics_sources, 1) if args.metrics else None,
         max_scans=max(args.max_scans, 1),
+        open_firewall=args.open_firewall,
     )
     return EXIT_OK
 

{ipmg-3.2.0 → ipmg-4.0.0}/src/ipmg/cli/parser.py

@@ -571,10 +571,19 @@ def build_web_parser() -> argparse.ArgumentParser:
         "ipmg web",
         description="Start IPMG Web, the local browser UI.",
     )
-    parser.add_argument(
+    where = parser.add_mutually_exclusive_group()
+    where.add_argument(
         "--host",
-        default="127.0.0.1",
-        help="Interface to bind (default: 127.0.0.1, local only).",
+        default=None,
+        help="Interface to bind (default: 127.0.0.1, this machine only).",
+    )
+    where.add_argument(
+        "--lan",
+        action="store_true",
+        help=(
+            "Let other machines open IPMG Web: listen on every interface (as --host "
+            "0.0.0.0) and print the link with this machine's network address."
+        ),
     )
     parser.add_argument(
         "--port",
@@ -582,6 +591,14 @@ def build_web_parser() -> argparse.ArgumentParser:
         default=8080,
         help="Port to listen on (default: 8080).",
     )
+    parser.add_argument(
+        "--open-firewall",
+        action="store_true",
+        help=(
+            "Open the port in firewalld or ufw while IPMG Web runs, and close it again "
+            "when it stops (needs root; implies --lan)."
+        ),
+    )
     parser.add_argument(
         "--no-browser",
         action="store_true",

{ipmg-3.2.0 → ipmg-4.0.0}/src/ipmg/reporting/ui.py

@@ -121,13 +121,18 @@ def heading(title: str) -> None:
     console.print(Text(INDENT + title, style="ipmg.heading"))
 
 
-def field(label: str, value: object, value_style: str = "ipmg.value") -> None:
-    """One aligned ``label   value`` line."""
+def field(label: str, value: object, value_style: str = "ipmg.value", wrap: bool = True) -> None:
+    """One aligned ``label   value`` line.
+
+    ``wrap=False`` keeps the value on one line however narrow the terminal,
+    for a URL or a command someone will copy: a line break rich inserted
+    would end up in the pasted text.
+    """
     text = Text(INDENT)
     # A label as long as the column still gets one space before its value.
     text.append(f"{label:<{LABEL_WIDTH - 1}} ", style="ipmg.label")
     text.append(str(value), style=value_style)
-    console.print(text)
+    console.print(text, soft_wrap=not wrap)
 
 
 def fields(pairs: Iterable[Tuple[str, object]]) -> None: