ipmg 3.1.4__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.1.4 → ipmg-4.0.0}/pyproject.toml

@@ -13,10 +13,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ipmg"
-version = "3.1.4"  # Managed automatically by semantic-release
-description = "IP Management & Ping Monitoring CLI Tool"
+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",
@@ -83,7 +82,11 @@ dev = [
     "ruff>=0.4",
     "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 older Starlette the lowest-deps job resolves to
+    # predates httpx2 and needs httpx.
     "httpx>=0.27",
+    "httpx2>=2.0",
 ]
 
 [project.scripts]
@@ -102,7 +105,11 @@ dev = [
     "ruff>=0.4",
     "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 older Starlette the lowest-deps job resolves to
+    # predates httpx2 and needs httpx.
     "httpx>=0.27",
+    "httpx2>=2.0",
 ]
 
 
@@ -113,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}"
@@ -121,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"
 
@@ -136,6 +152,7 @@ package-dir = { "" = "src" }
 where = ["src"]
 
 [tool.setuptools.package-data]
+"ipmg" = ["data/*.tsv.gz"]
 "ipmg.web" = ["static/*.html", "static/css/*.css", "static/js/*.js"]
 
 
@@ -146,6 +163,13 @@ where = ["src"]
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 pythonpath = ["src"]
+# A deprecated call in IPMG's own code or tests fails the run, so the next
+# one is fixed when it appears instead of scrolling past in the output.
+filterwarnings = [
+    "error::DeprecationWarning:ipmg",
+    "error::DeprecationWarning:test_",
+    "error::PendingDeprecationWarning:ipmg",
+]
 
 [tool.coverage.run]
 source = ["ipmg"]
@@ -162,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"]
@@ -179,4 +203,4 @@ known-first-party = ["ipmg"]
 
 [tool.black]
 line-length = 100
-target-version = ["py39"]
+target-version = ["py310"]

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

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