ipmg 1.13.2__tar.gz → 2.0.0__tar.gz

{ipmg-1.13.2/src/ipmg.egg-info → ipmg-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ipmg
-Version: 1.13.2
+Version: 2.0.0
 Summary: IP Management & Ping Monitoring CLI Tool
 Author: Sameer Alam
 Maintainer-email: Sameer Alam <sameeralam3127@gmail.com>
@@ -55,11 +55,11 @@ Dynamic: license-file
 
 IPMG pings hosts in parallel, resolves their names, and hands you a report you
 can send to someone: Excel, CSV, JSON, or Markdown. It works from the command
-line or from a local web dashboard, and it remembers every scan so it can tell
+line or from IPMG Web, a local browser UI, and it remembers every scan so it can tell
 you what moved.
 
 **Website:** [sameeralam3127.github.io/ipmg](https://sameeralam3127.github.io/ipmg/) ·
-**Live demo:** [dashboard with sample data](https://sameeralam3127.github.io/ipmg/demo/)
+**Live demo:** [IPMG Web with sample data](https://sameeralam3127.github.io/ipmg/demo/)
 
 ```bash
 pip install ipmg
@@ -76,7 +76,7 @@ ipmg --discover        # scan the network you are on, right now
 [Common tasks](#common-tasks) ·
 [Live results](#live-results) ·
 [Change detection](#change-detection) ·
-[Web dashboard](#web-dashboard) ·
+[IPMG Web](#ipmg-web) ·
 [What you can scan](#what-you-can-scan) ·
 [Reports](#reports) ·
 [All options](#all-options) ·
@@ -105,6 +105,17 @@ the handful of system packages it needs (`curl`, `tar`, `gzip`, `ping`) for you:
 curl -sSL https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.sh | bash -s -- --with-deps
 ```
 
+**macOS and Linux with Homebrew:**
+
+```bash
+brew install sameeralam3127/tap/ipmg
+```
+
+The formula lives in
+[sameeralam3127/homebrew-tap](https://github.com/sameeralam3127/homebrew-tap)
+and is updated with every release. Upgrade with `brew upgrade ipmg`, remove
+with `brew uninstall ipmg`.
+
 **Windows — two commands in PowerShell:**
 
 ```powershell
@@ -281,7 +292,7 @@ exist yet. A file you name with `--input` must already exist.
 | Keep scanning every 5 minutes | `ipmg --input targets.txt --interval 5` |
 | Look back at earlier scans | `ipmg history` |
 | Compare two specific scans | `ipmg diff 12 14` |
-| Use the web dashboard instead | `ipmg dashboard` |
+| Use IPMG Web in your browser instead | `ipmg web` |
 | See every available flag | `ipmg --help` |
 
 ---
@@ -320,7 +331,7 @@ plain lines, which makes `ipmg --stream-all >> scan.log` a usable live log.
 ## Change detection
 
 Every scan is stored in a local SQLite history (`~/.ipmg/dashboard.db`), shared
-by the CLI and the dashboard. IPMG can then tell you what moved between any two
+by the CLI and IPMG Web. IPMG can then tell you what moved between any two
 scans — which is usually the question you actually have.
 
 ```bash
@@ -368,15 +379,17 @@ source**, so file-based and `--discover` runs do not get mixed up. Pass
 
 ---
 
-## Web dashboard
+## IPMG Web
 
-Prefer clicking to typing? The dashboard runs locally and shares the CLI's
+Prefer clicking to typing? IPMG Web runs locally and shares the CLI's
 scanning engine:
 
 ```bash
-ipmg dashboard          # starts http://127.0.0.1:8080 and opens your browser
+ipmg web               # starts http://127.0.0.1:8080 and opens your browser
 ```
 
+`ipmg --web` does the same thing, so whichever one you reach for first works.
+
 It runs fully offline — every stylesheet and script is bundled with the
 package, nothing is loaded from a CDN. It gives you:
 
@@ -397,13 +410,11 @@ package, nothing is loaded from a CDN. It gives you:
 | `--no-browser` | off | Don't open the browser automatically |
 | `--db` | `~/.ipmg/dashboard.db` | History database location |
 
-`ipmg web` is an alias for `ipmg dashboard`.
-
 ### On a server with no browser
 
 On a Linux server with no display (e.g. accessed over plain SSH), IPMG detects
 that no browser can be opened, skips the attempt, and prints a hint instead of
-failing silently. The dashboard still binds to `127.0.0.1` by default, so reach
+failing silently. IPMG Web still binds to `127.0.0.1` by default, so reach
 it from your workstation with an SSH tunnel:
 
 ```bash
@@ -542,10 +553,10 @@ itself is hardened accordingly:
 
 - Pings run as a direct process call (no shell), and every target is
   validated as an IP address first
-- The dashboard binds to `127.0.0.1` by default and serves everything
+- IPMG Web binds to `127.0.0.1` by default and serves everything
   locally — no CDN assets, no outbound requests
 - WebSocket connections are origin-checked, so a web page you happen to
-  visit cannot connect to the local dashboard and read your scan results
+  visit cannot connect to your local IPMG Web and read your scan results
 - Uploads are capped at 5 MB and one scan expands to at most 65,536 hosts,
   so a bad input file cannot exhaust memory
 - All database access uses parameterized SQL
@@ -579,7 +590,7 @@ Contributions are welcome.
 [CONTRIBUTING.md](https://github.com/sameeralam3127/ipmg/blob/main/CONTRIBUTING.md)
 covers setting up a development environment, running the tests, the commit
 message format that drives automated releases, and how the project website and
-dashboard demo are built. Everyone taking part is expected to follow the
+IPMG Web demo are built. Everyone taking part is expected to follow the
 [Code of Conduct](https://github.com/sameeralam3127/ipmg/blob/main/CODE_OF_CONDUCT.md).
 
 ---

{ipmg-1.13.2 → ipmg-2.0.0}/README.md

@@ -9,11 +9,11 @@
 
 IPMG pings hosts in parallel, resolves their names, and hands you a report you
 can send to someone: Excel, CSV, JSON, or Markdown. It works from the command
-line or from a local web dashboard, and it remembers every scan so it can tell
+line or from IPMG Web, a local browser UI, and it remembers every scan so it can tell
 you what moved.
 
 **Website:** [sameeralam3127.github.io/ipmg](https://sameeralam3127.github.io/ipmg/) ·
-**Live demo:** [dashboard with sample data](https://sameeralam3127.github.io/ipmg/demo/)
+**Live demo:** [IPMG Web with sample data](https://sameeralam3127.github.io/ipmg/demo/)
 
 ```bash
 pip install ipmg
@@ -30,7 +30,7 @@ ipmg --discover        # scan the network you are on, right now
 [Common tasks](#common-tasks) ·
 [Live results](#live-results) ·
 [Change detection](#change-detection) ·
-[Web dashboard](#web-dashboard) ·
+[IPMG Web](#ipmg-web) ·
 [What you can scan](#what-you-can-scan) ·
 [Reports](#reports) ·
 [All options](#all-options) ·
@@ -59,6 +59,17 @@ the handful of system packages it needs (`curl`, `tar`, `gzip`, `ping`) for you:
 curl -sSL https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.sh | bash -s -- --with-deps
 ```
 
+**macOS and Linux with Homebrew:**
+
+```bash
+brew install sameeralam3127/tap/ipmg
+```
+
+The formula lives in
+[sameeralam3127/homebrew-tap](https://github.com/sameeralam3127/homebrew-tap)
+and is updated with every release. Upgrade with `brew upgrade ipmg`, remove
+with `brew uninstall ipmg`.
+
 **Windows — two commands in PowerShell:**
 
 ```powershell
@@ -235,7 +246,7 @@ exist yet. A file you name with `--input` must already exist.
 | Keep scanning every 5 minutes | `ipmg --input targets.txt --interval 5` |
 | Look back at earlier scans | `ipmg history` |
 | Compare two specific scans | `ipmg diff 12 14` |
-| Use the web dashboard instead | `ipmg dashboard` |
+| Use IPMG Web in your browser instead | `ipmg web` |
 | See every available flag | `ipmg --help` |
 
 ---
@@ -274,7 +285,7 @@ plain lines, which makes `ipmg --stream-all >> scan.log` a usable live log.
 ## Change detection
 
 Every scan is stored in a local SQLite history (`~/.ipmg/dashboard.db`), shared
-by the CLI and the dashboard. IPMG can then tell you what moved between any two
+by the CLI and IPMG Web. IPMG can then tell you what moved between any two
 scans — which is usually the question you actually have.
 
 ```bash
@@ -322,15 +333,17 @@ source**, so file-based and `--discover` runs do not get mixed up. Pass
 
 ---
 
-## Web dashboard
+## IPMG Web
 
-Prefer clicking to typing? The dashboard runs locally and shares the CLI's
+Prefer clicking to typing? IPMG Web runs locally and shares the CLI's
 scanning engine:
 
 ```bash
-ipmg dashboard          # starts http://127.0.0.1:8080 and opens your browser
+ipmg web               # starts http://127.0.0.1:8080 and opens your browser
 ```
 
+`ipmg --web` does the same thing, so whichever one you reach for first works.
+
 It runs fully offline — every stylesheet and script is bundled with the
 package, nothing is loaded from a CDN. It gives you:
 
@@ -351,13 +364,11 @@ package, nothing is loaded from a CDN. It gives you:
 | `--no-browser` | off | Don't open the browser automatically |
 | `--db` | `~/.ipmg/dashboard.db` | History database location |
 
-`ipmg web` is an alias for `ipmg dashboard`.
-
 ### On a server with no browser
 
 On a Linux server with no display (e.g. accessed over plain SSH), IPMG detects
 that no browser can be opened, skips the attempt, and prints a hint instead of
-failing silently. The dashboard still binds to `127.0.0.1` by default, so reach
+failing silently. IPMG Web still binds to `127.0.0.1` by default, so reach
 it from your workstation with an SSH tunnel:
 
 ```bash
@@ -496,10 +507,10 @@ itself is hardened accordingly:
 
 - Pings run as a direct process call (no shell), and every target is
   validated as an IP address first
-- The dashboard binds to `127.0.0.1` by default and serves everything
+- IPMG Web binds to `127.0.0.1` by default and serves everything
   locally — no CDN assets, no outbound requests
 - WebSocket connections are origin-checked, so a web page you happen to
-  visit cannot connect to the local dashboard and read your scan results
+  visit cannot connect to your local IPMG Web and read your scan results
 - Uploads are capped at 5 MB and one scan expands to at most 65,536 hosts,
   so a bad input file cannot exhaust memory
 - All database access uses parameterized SQL
@@ -533,7 +544,7 @@ Contributions are welcome.
 [CONTRIBUTING.md](https://github.com/sameeralam3127/ipmg/blob/main/CONTRIBUTING.md)
 covers setting up a development environment, running the tests, the commit
 message format that drives automated releases, and how the project website and
-dashboard demo are built. Everyone taking part is expected to follow the
+IPMG Web demo are built. Everyone taking part is expected to follow the
 [Code of Conduct](https://github.com/sameeralam3127/ipmg/blob/main/CODE_OF_CONDUCT.md).
 
 ---

{ipmg-1.13.2 → ipmg-2.0.0}/pyproject.toml

@@ -13,7 +13,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ipmg"
-version = "1.13.2"  # Managed automatically by semantic-release
+version = "2.0.0"  # Managed automatically by semantic-release
 description = "IP Management & Ping Monitoring CLI Tool"
 readme = "README.md"
 requires-python = ">=3.9"

{ipmg-1.13.2 → ipmg-2.0.0}/src/ipmg/__init__.py

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

{ipmg-1.13.2 → ipmg-2.0.0}/src/ipmg/cli/commands.py

@@ -7,10 +7,10 @@ import sys
 from typing import Callable, Dict, List, Optional
 
 from ipmg.cli.parser import (
-    build_dashboard_parser,
     build_diff_parser,
     build_history_parser,
     build_parser,
+    build_web_parser,
 )
 from ipmg.core.diff import DiffOptions
 from ipmg.core.security import print_disclaimer_once
@@ -39,10 +39,10 @@ def _scan_command(argv: List[str]) -> int:
     return EXIT_OK
 
 
-def _dashboard_command(argv: List[str]) -> int:
-    args = build_dashboard_parser().parse_args(argv)
+def _web_command(argv: List[str]) -> int:
+    args = build_web_parser().parse_args(argv)
     configure_logging(args.verbose)
-    ui.header("dashboard")
+    ui.header("web")
     print_disclaimer_once()
 
     # Imported lazily so plain CLI scans do not pay for the web stack.
@@ -100,19 +100,37 @@ def _diff_command(argv: List[str]) -> int:
 
 
 _COMMANDS: Dict[str, Callable[[List[str]], int]] = {
-    "dashboard": _dashboard_command,
-    "web": _dashboard_command,
+    "web": _web_command,
     "history": _history_command,
     "diff": _diff_command,
     "compare": _diff_command,
 }
 
+#: Flag spellings of a command. Reaching for "--web" before "web" is the
+#: obvious guess, and refusing it teaches nothing.
+_COMMAND_FLAGS: Dict[str, Callable[[List[str]], int]] = {
+    "--web": _web_command,
+}
+
+
+def _dispatch(argv: List[str]):
+    """Pick the handler for this command line, and the arguments it keeps."""
+    if argv and argv[0] in _COMMANDS:
+        return _COMMANDS[argv[0]], argv[1:]
+
+    for index, argument in enumerate(argv):
+        if argument in _COMMAND_FLAGS:
+            # Everything else is passed through, so `ipmg --web --port 9000`
+            # reaches the web parser intact.
+            return _COMMAND_FLAGS[argument], argv[:index] + argv[index + 1 :]
+
+    return _scan_command, argv
+
 
 def run(argv: Optional[List[str]] = None) -> int:
     """Entry point: returns the process exit code."""
     argv = list(sys.argv[1:] if argv is None else argv)
-    command = _COMMANDS.get(argv[0]) if argv else None
-    handler, handler_argv = (command, argv[1:]) if command else (_scan_command, argv)
+    handler, handler_argv = _dispatch(argv)
 
     try:
         return handler(handler_argv)

{ipmg-1.13.2 → ipmg-2.0.0}/src/ipmg/cli/parser.py

@@ -12,6 +12,23 @@ from ipmg.reporting.live import DEFAULT_REFRESH_S, MAX_REFRESH_S, MIN_REFRESH_S
 
 PROG = "IPMG - IP Management & Ping Monitoring Tool"
 
+#: Subcommands, named here so an argument error can point at them. argparse
+#: prints the epilog on --help but never on an error, which is exactly when
+#: someone who typed an unknown flag needs to see them.
+COMMANDS_HINT = (
+    "Commands: 'ipmg web' (IPMG Web, the browser UI), 'ipmg history' (stored scans), "
+    "'ipmg diff' (compare two scans)."
+)
+
+
+class ScanParser(argparse.ArgumentParser):
+    """Argument parser that mentions the subcommands when a flag misses."""
+
+    def error(self, message: str):  # pragma: no cover - exercised via parse_args
+        if "unrecognized arguments" in message:
+            message = f"{message}\n\n{COMMANDS_HINT}"
+        super().error(message)
+
 
 def _port_list(value: str) -> tuple:
     try:
@@ -65,41 +82,73 @@ def _add_diff_export_arguments(parser) -> None:
 
 
 def build_parser() -> argparse.ArgumentParser:
-    parser = argparse.ArgumentParser(
-        PROG,
-        epilog=(
-            "Commands: 'ipmg dashboard' (web UI), 'ipmg history' (stored scans), "
-            "'ipmg diff' (compare two scans)."
-        ),
+    parser = ScanParser(
+        prog="ipmg",
+        description=PROG,
+        epilog=COMMANDS_HINT,
     )
     parser.add_argument(
         "--version",
         action="version",
-        version=f"%(prog)s {__version__}",
+        version=f"{PROG} {__version__}",
     )
     # No default here, so the scan service can tell "no --input given" (use the
     # sample file) apart from an explicit file name that does not exist (error).
     parser.add_argument(
         "--input",
         default=None,
+        metavar="TARGETS",
         help=(
             "IP, CIDR block, range, or target file (.txt, .list, .csv, .xls, .xlsx). "
             f"Without --input or --discover, {DEFAULT_INPUT_FILE} is used and "
             "created with sample targets if it does not exist."
         ),
     )
-    parser.add_argument("--output", default="results")
-    parser.add_argument("--timeout", type=int, default=2)
-    parser.add_argument("--count", type=int, default=1)
-    parser.add_argument("--threads", type=int, default=50)
+    parser.add_argument(
+        "--output",
+        default="results",
+        metavar="PREFIX",
+        help="Report file name prefix; the timestamp is appended (default: results).",
+    )
+    parser.add_argument(
+        "--timeout",
+        type=int,
+        default=2,
+        metavar="SECONDS",
+        help="Seconds to wait for a reply from each host (default: 2).",
+    )
+    parser.add_argument(
+        "--count",
+        type=int,
+        default=1,
+        metavar="N",
+        help="Pings per host; raise it on a lossy link (default: 1).",
+    )
+    parser.add_argument(
+        "--threads",
+        type=int,
+        default=50,
+        metavar="N",
+        help="How many hosts to probe at once (default: 50).",
+    )
     parser.add_argument(
         "--formats",
         nargs="+",
         default=["xlsx"],
         choices=["xlsx", "csv", "json", "md"],
+        metavar="FORMAT",
+        help="One or more report formats: xlsx, csv, json, md (default: xlsx).",
+    )
+    parser.add_argument(
+        "--discover",
+        action="store_true",
+        help="Auto-detect this machine's subnet and scan it instead of --input.",
+    )
+    parser.add_argument(
+        "--resolve",
+        action="store_true",
+        help="Look up each host's name with a reverse DNS (PTR) query.",
     )
-    parser.add_argument("--discover", action="store_true")
-    parser.add_argument("--resolve", action="store_true")
     parser.add_argument(
         "--dns-cache-ttl",
         type=int,
@@ -107,8 +156,21 @@ def build_parser() -> argparse.ArgumentParser:
         metavar="SECONDS",
         help="Cache reverse DNS results for this many seconds (default: 300).",
     )
-    parser.add_argument("--interval", type=int)
-    parser.add_argument("--verbose", action="store_true")
+    parser.add_argument(
+        "--interval",
+        type=int,
+        metavar="MINUTES",
+        help="Repeat the whole scan every N minutes until interrupted.",
+    )
+    parser.add_argument("--verbose", action="store_true", help="Debug logging.")
+
+    # People reach for a flag before a subcommand, so accept both spellings
+    # rather than answering "unrecognized arguments: --web".
+    parser.add_argument(
+        "--web",
+        action="store_true",
+        help="Start IPMG Web, the local browser UI (same as 'ipmg web').",
+    )
 
     ports_group = parser.add_argument_group("TCP service discovery")
     ports_group.add_argument(
@@ -180,10 +242,10 @@ def build_parser() -> argparse.ArgumentParser:
     return parser
 
 
-def build_dashboard_parser() -> argparse.ArgumentParser:
+def build_web_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
-        "ipmg dashboard",
-        description="Start the local IPMG web dashboard.",
+        "ipmg web",
+        description="Start IPMG Web, the local browser UI.",
     )
     parser.add_argument(
         "--host",
@@ -199,7 +261,7 @@ def build_dashboard_parser() -> argparse.ArgumentParser:
     parser.add_argument(
         "--no-browser",
         action="store_true",
-        help="Do not open the dashboard in a browser automatically.",
+        help="Do not open IPMG Web in a browser automatically.",
     )
     _add_database_argument(parser)
     parser.add_argument("--verbose", action="store_true")

ipmg-2.0.0/src/ipmg/web/__init__.py

@@ -0,0 +1 @@
+"""IPMG Web: the local browser UI for IPMG (FastAPI backend + bundled frontend)."""

{ipmg-1.13.2 → ipmg-2.0.0}/src/ipmg/web/app.py

@@ -373,7 +373,7 @@ def create_app(db: Optional[Database] = None) -> FastAPI:
         manager.attach_loop(asyncio.get_running_loop())
         yield
 
-    app = FastAPI(title="IPMG Dashboard", version=__version__, lifespan=lifespan)
+    app = FastAPI(title="IPMG Web", version=__version__, lifespan=lifespan)
     app.state.db = database
     app.state.manager = manager
     app.state.history = history

{ipmg-1.13.2 → ipmg-2.0.0}/src/ipmg/web/static/index.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>IPMG Dashboard</title>
+  <title>IPMG Web</title>
   <link rel="stylesheet" href="css/app.css?v=20260911.1">
   <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Ccircle cx='16' cy='16' r='13' fill='none' stroke='%232a78d6' stroke-width='3'/%3E%3Ccircle cx='16' cy='16' r='5' fill='%232a78d6'/%3E%3C/svg%3E">
 </head>

{ipmg-1.13.2 → ipmg-2.0.0/src/ipmg.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ipmg
-Version: 1.13.2
+Version: 2.0.0
 Summary: IP Management & Ping Monitoring CLI Tool
 Author: Sameer Alam
 Maintainer-email: Sameer Alam <sameeralam3127@gmail.com>
@@ -55,11 +55,11 @@ Dynamic: license-file
 
 IPMG pings hosts in parallel, resolves their names, and hands you a report you
 can send to someone: Excel, CSV, JSON, or Markdown. It works from the command
-line or from a local web dashboard, and it remembers every scan so it can tell
+line or from IPMG Web, a local browser UI, and it remembers every scan so it can tell
 you what moved.
 
 **Website:** [sameeralam3127.github.io/ipmg](https://sameeralam3127.github.io/ipmg/) ·
-**Live demo:** [dashboard with sample data](https://sameeralam3127.github.io/ipmg/demo/)
+**Live demo:** [IPMG Web with sample data](https://sameeralam3127.github.io/ipmg/demo/)
 
 ```bash
 pip install ipmg
@@ -76,7 +76,7 @@ ipmg --discover        # scan the network you are on, right now
 [Common tasks](#common-tasks) ·
 [Live results](#live-results) ·
 [Change detection](#change-detection) ·
-[Web dashboard](#web-dashboard) ·
+[IPMG Web](#ipmg-web) ·
 [What you can scan](#what-you-can-scan) ·
 [Reports](#reports) ·
 [All options](#all-options) ·
@@ -105,6 +105,17 @@ the handful of system packages it needs (`curl`, `tar`, `gzip`, `ping`) for you:
 curl -sSL https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.sh | bash -s -- --with-deps
 ```
 
+**macOS and Linux with Homebrew:**
+
+```bash
+brew install sameeralam3127/tap/ipmg
+```
+
+The formula lives in
+[sameeralam3127/homebrew-tap](https://github.com/sameeralam3127/homebrew-tap)
+and is updated with every release. Upgrade with `brew upgrade ipmg`, remove
+with `brew uninstall ipmg`.
+
 **Windows — two commands in PowerShell:**
 
 ```powershell
@@ -281,7 +292,7 @@ exist yet. A file you name with `--input` must already exist.
 | Keep scanning every 5 minutes | `ipmg --input targets.txt --interval 5` |
 | Look back at earlier scans | `ipmg history` |
 | Compare two specific scans | `ipmg diff 12 14` |
-| Use the web dashboard instead | `ipmg dashboard` |
+| Use IPMG Web in your browser instead | `ipmg web` |
 | See every available flag | `ipmg --help` |
 
 ---
@@ -320,7 +331,7 @@ plain lines, which makes `ipmg --stream-all >> scan.log` a usable live log.
 ## Change detection
 
 Every scan is stored in a local SQLite history (`~/.ipmg/dashboard.db`), shared
-by the CLI and the dashboard. IPMG can then tell you what moved between any two
+by the CLI and IPMG Web. IPMG can then tell you what moved between any two
 scans — which is usually the question you actually have.
 
 ```bash
@@ -368,15 +379,17 @@ source**, so file-based and `--discover` runs do not get mixed up. Pass
 
 ---
 
-## Web dashboard
+## IPMG Web
 
-Prefer clicking to typing? The dashboard runs locally and shares the CLI's
+Prefer clicking to typing? IPMG Web runs locally and shares the CLI's
 scanning engine:
 
 ```bash
-ipmg dashboard          # starts http://127.0.0.1:8080 and opens your browser
+ipmg web               # starts http://127.0.0.1:8080 and opens your browser
 ```
 
+`ipmg --web` does the same thing, so whichever one you reach for first works.
+
 It runs fully offline — every stylesheet and script is bundled with the
 package, nothing is loaded from a CDN. It gives you:
 
@@ -397,13 +410,11 @@ package, nothing is loaded from a CDN. It gives you:
 | `--no-browser` | off | Don't open the browser automatically |
 | `--db` | `~/.ipmg/dashboard.db` | History database location |
 
-`ipmg web` is an alias for `ipmg dashboard`.
-
 ### On a server with no browser
 
 On a Linux server with no display (e.g. accessed over plain SSH), IPMG detects
 that no browser can be opened, skips the attempt, and prints a hint instead of
-failing silently. The dashboard still binds to `127.0.0.1` by default, so reach
+failing silently. IPMG Web still binds to `127.0.0.1` by default, so reach
 it from your workstation with an SSH tunnel:
 
 ```bash
@@ -542,10 +553,10 @@ itself is hardened accordingly:
 
 - Pings run as a direct process call (no shell), and every target is
   validated as an IP address first
-- The dashboard binds to `127.0.0.1` by default and serves everything
+- IPMG Web binds to `127.0.0.1` by default and serves everything
   locally — no CDN assets, no outbound requests
 - WebSocket connections are origin-checked, so a web page you happen to
-  visit cannot connect to the local dashboard and read your scan results
+  visit cannot connect to your local IPMG Web and read your scan results
 - Uploads are capped at 5 MB and one scan expands to at most 65,536 hosts,
   so a bad input file cannot exhaust memory
 - All database access uses parameterized SQL
@@ -579,7 +590,7 @@ Contributions are welcome.
 [CONTRIBUTING.md](https://github.com/sameeralam3127/ipmg/blob/main/CONTRIBUTING.md)
 covers setting up a development environment, running the tests, the commit
 message format that drives automated releases, and how the project website and
-dashboard demo are built. Everyone taking part is expected to follow the
+IPMG Web demo are built. Everyone taking part is expected to follow the
 [Code of Conduct](https://github.com/sameeralam3127/ipmg/blob/main/CODE_OF_CONDUCT.md).
 
 ---

{ipmg-1.13.2 → ipmg-2.0.0}/tests/test_commands.py

@@ -168,3 +168,59 @@ def test_missing_input_file_is_an_error_not_a_sample(tmp_path, capsys):
     assert exit_code == commands.EXIT_ERROR
     assert "was not found" in capsys.readouterr().out
     assert not missing.exists()
+
+
+def web_calls(monkeypatch):
+    """Capture what run_dashboard would have been started with."""
+    calls = []
+    monkeypatch.setattr(
+        "ipmg.web.server.run_dashboard",
+        lambda **kwargs: calls.append(kwargs),
+    )
+    return calls
+
+
+@pytest.mark.parametrize("argv", [["web"], ["--web"]])
+def test_both_spellings_of_web_start_it(argv, monkeypatch):
+    """A flag is the obvious guess; refusing it only teaches frustration."""
+    calls = web_calls(monkeypatch)
+
+    assert commands.run(argv) == commands.EXIT_OK
+    assert calls == [{"host": "127.0.0.1", "port": 8080, "open_browser": True, "db_path": None}]
+
+
+def test_web_flag_still_takes_the_web_options(monkeypatch):
+    calls = web_calls(monkeypatch)
+
+    assert commands.run(["--web", "--port", "9000", "--no-browser"]) == commands.EXIT_OK
+    assert calls[0]["port"] == 9000
+    assert calls[0]["open_browser"] is False
+
+
+@pytest.mark.parametrize("argv", [["dashboard"], ["--dashboard"]])
+def test_dashboard_is_no_longer_a_command(argv, monkeypatch, capsys):
+    calls = web_calls(monkeypatch)
+
+    with pytest.raises(SystemExit):
+        commands.run(argv)
+
+    assert calls == []
+    assert "ipmg web" in capsys.readouterr().err
+
+
+def test_scan_flags_are_documented(capsys):
+    """Bare flags with no help text are invisible to anyone reading --help."""
+    with pytest.raises(SystemExit):
+        commands.run(["--help"])
+
+    # argparse wraps to the terminal width, so compare against flattened text.
+    out = " ".join(capsys.readouterr().out.split())
+    for phrase in (
+        "Report file name prefix",
+        "Seconds to wait",
+        "Pings per host",
+        "How many hosts to probe",
+        "Repeat the whole scan",
+        "same as 'ipmg web'",
+    ):
+        assert phrase in out

{ipmg-1.13.2 → ipmg-2.0.0}/tests/test_web_api.py

@@ -219,7 +219,7 @@ def test_upload_rejects_oversized_files(client, monkeypatch):
 def test_index_served(client):
     response = client.get("/")
     assert response.status_code == 200
-    assert "IPMG Dashboard" in response.text
+    assert "IPMG Web" in response.text
 
 
 def test_report_rendering_neutralizes_formula_cells():

ipmg-1.13.2/src/ipmg/web/__init__.py

@@ -1 +0,0 @@
-"""Local web dashboard for IPMG (FastAPI backend + bundled frontend)."""