eping 3.65__tar.gz → 3.84__tar.gz

{eping-3.65 → eping-3.84}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eping
-Version: 3.65
+Version: 3.84
 Summary: Continuous ICMP reachability monitor built on fping, with a CSV logfile analyser (epinga)
 Author-email: Ewald Jeitler <ewald@jeitler.cc>
 License: GPL-3.0-or-later
@@ -17,7 +17,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
 
-# eping.py 3.65
+# eping.py 3.84
 
 Continuous ICMP reachability monitor built on `fping`. Scans a host list in a loop,
 reports each host UP/DOWN/NO-DNS, counts state changes. CLI (curses) or web GUI.
@@ -48,6 +48,19 @@ Standalone scripts (installs/updates `eping.py`, `epinga.py`, `esplit.py`):
 
 `esplit.py` isn't part of the pip package - use the standalone install for it.
 
+## Windows
+
+Portable Windows version (web GUI only, no installation): download and unpack
+[`eping-windows.zip`](https://github.com/ewaldj/eping/blob/main/Windows_Version/eping-windows.zip)
+([folder](https://github.com/ewaldj/eping/tree/main/Windows_Version/)), then start `eping.exe`.
+
+- Contains `eping.exe` (small launcher window: web port, Start / Stop / Restart, open web GUI),
+  `eping.py`, `epinga.py`, `fping.exe` + `cygwin1.dll` (fping for Windows) and an embedded Python.
+- The web GUI opens in the browser (default `http://127.0.0.1:8080`). The port is read from the hosts file
+  (`opt: -port 9000`); a port already in use is reported and can be changed in the launcher window.
+- No terminal (curses) mode and no `-wv`/`-wvc` on Windows; log file names use `-` instead of `:`.
+- Extra options: put them in `eping-args.txt` next to `eping.exe`. Details: `README-WINDOWS.txt` in the zip.
+
 ## Quick start
 
 pip install: use `eping`/`epinga` instead of `./eping.py`/`./epinga.py` below.
@@ -61,7 +74,7 @@ pip install: use `eping`/`epinga` instead of `./eping.py`/`./epinga.py` below.
 ./eping.py -wvc                        # CLI + controllable web view
 ```
 
-No args: creates a sample `eping-hosts.txt`. `-df`: start with no hosts, add at runtime.
+No args: creates a sample `eping-hosts.txt` and `eping-hosts-sample.csv` (same hosts with invented inventory values, a template for the *Inventory CSV import*; never loaded by eping). `-df`: start with no hosts, add at runtime.
 
 ### Running unattended (screen / tmux)
 
@@ -86,7 +99,7 @@ expansion includes network/broadcast. Several `-f` files are combined before ded
 
 ### Host file format
 
-Same parser for `-f`, `F`/ADD FILE (CLI), and web GUI ADD FILE:
+Same parser for `-f`, `F`/ADD FILE (CLI), and web GUI ADD HOSTS FILE:
 
 ```
 # comment to end of line
@@ -99,7 +112,7 @@ www.google.com            # hostname/FQDN
 2606:4700:4700::1111/128  # IPv6 with /128 - single host
 ```
 
-Network mask range /13…/32 everywhere (host file, ADD FILE, web upload, ADD/DELETE
+Network mask range /13…/32 everywhere (host file, ADD HOSTS FILE, web upload, ADD/DELETE
 host input); out of range is rejected (message names the allowed range; `-f` warns and
 ignores). IPv6: only `/128` accepted, any other mask rejected. Anything else is ignored.
 
@@ -117,34 +130,38 @@ opt: -web -port 9000
 Multiple `opt:` lines join in file order. `#` comments out the rest of the line (or
 the whole line at the start). Quote values with spaces: `opt: -f "my hosts.txt"`. A
 flag typed on the command line wins over the same flag from a file. Only applies to
-the initial `-f` read at startup — `F`/ADD FILE (CLI or web, FROM CLIENT/FROM SERVER)
+the initial `-f` read at startup — `F`/ADD FILE (CLI) and ADD HOSTS FILE (web)
 never parse `opt:` lines, they're just text.
 
+`opt:` lines also work at the top of an inventory `.csv`. SAVE HOSTS FILE and DOWNLOAD ALL/ACTIVE HOSTS write every option that differs from the default there (start-up flags and live ADV OPTIONS changes; not `-f -df -n -r -o -up -setref -gn -cl`).
+
 The default `eping-hosts.txt`: sample hosts, this section, then every CLI option as a
 commented-out `opt:` line with its default (remove `# ` to activate).
 
 ## Inventory CSV import
 
 A `.csv` inventory export (one device per row) can be used as host file: `-f FILE.csv`,
-`F`/ADD FILE (CLI), web GUI ADD FILE (FROM CLIENT, FROM SERVER, drag and drop). Files
+`F`/ADD FILE (CLI), web GUI FILE OPERATIONS > ADD HOSTS FILE (FROM CLIENT, FROM SERVER, drag and drop). Files
 named `*.txt` are never treated as CSV - they keep the plain host file format above.
 
-- **Detection**: first non-empty line is a header with the columns `IP Address` and
+- **Detection**: first line that is not blank, a `#` comment or an `opt:` line is a header with the columns `IP Address` and
   `Hostname` (case-insensitive); the delimiter (`;`, `,` or tab) is detected.
 - **Columns used**: `IP Address`, `Hostname`, `Serial Number`, `Model`, `Location`,
   `sysLocation`, `Type`, `Comment`. All other columns are ignored.
-- **Host entry**: the IP address; rows without a valid IP are ignored. With PREFER
-  HOSTNAME (`-ph`, or that address mode active when the file is added) the entry is
-  the `Hostname` instead - rows without an IP are then pinged by name too (NO-DNS if it
-  does not resolve); a name that is not a valid hostname falls back to the IP.
-  Rows without a usable entry are ignored.
+- **Host entry**: the `Hostname` (default; rows without an IP are pinged by name too,
+  NO-DNS if it does not resolve). A name that is not a valid hostname falls back to the
+  IP; rows without a usable entry are ignored. In the IP modes (`-ipo`, PREFER IP
+  ADDRESS, also when active while the file is added) the entry is the IP address
+  instead and rows without a valid IP are ignored. `-ph` is not needed for a CSV.
 - **Duplicates**: one host per entry, the first row wins. The count of ignored and
   duplicate rows is reported when the file is added (startup message / web footer).
 - **Log**: the six inventory values and the CSV hostname are written with every row
   of that host, see *Logging*. A `Hostname` that is not the host entry (IP mode) is
   only kept there as information.
-- Plain `.txt` hosts and `SAVE HOSTS FILE` carry no inventory values: a saved hosts
-  file lists only the host entries.
+- **Filters**: `M` matches the inventory values as text, `V` / ADV FILTER selects them
+  (see *ADV FILTER*).
+- **Save**: if the displayed hosts carry inventory values, `SAVE HOSTS FILE` writes an
+  inventory `.csv` (see *Web GUI*); plain `.txt` hosts are saved as `.txt`.
 
 Example (`;` delimited, extra columns are ignored):
 
@@ -158,8 +175,8 @@ sw-access-01;10.0.1.1;FOC5678C3DE;C9200L-24P;Vienna DC1;Rack C1;Switch;
 fw-edge-01;192.0.2.1;JMX2345F6GH;ASA5516;Linz POP;Rack B2;Firewall;ASA 5516 - EoL 2027
 ```
 
-Without `-ph` this gives 5 hosts (the IP addresses); `ap-lobby-01` has no IP and is
-ignored. With `-ph` it gives 6 hosts, named by `Hostname`.
+This gives 6 hosts, named by `Hostname`. In an IP mode it gives 5 hosts (the IP
+addresses); `ap-lobby-01` has no IP and is ignored.
 
 ## CLI mode
 
@@ -170,6 +187,7 @@ DOWN. Columns: hostname/IP, state, RTT (ms), last-change timestamp, change count
 |---|---|
 | `U` | view picker — all 9 views (see *Views and sort orders*) |
 | `M` | match filter — regex on hostname/IP and inventory fields, display only (see *Match filter*) |
+| `V` | ADV FILTER — check/uncheck Model/Location/sysLocation/Type/Comment values (show only / hide), display only (see *ADV FILTER*) |
 | `A` | add host — IP, hostname, CIDR (/13…/32), or `ip1-ip2` (max 524288) |
 | `D` | delete host — same formats/limits as add |
 | `F` | add hosts from a file |
@@ -192,7 +210,7 @@ same option set as the matching web GUI dropdown.
 Dialogs: ENTER confirms, ESC/empty cancels. Key bar shortens on narrow terminals.
 `PLEASE WAIT` box with elapsed counter shown until the first round has results.
 
-Ping checks keep running while a dialog (`A`/`D`/`F`/`M`/`T`) is open — same
+Ping checks keep running while a dialog (`A`/`D`/`F`/`M`/`V`/`T`) is open — same
 retry/state/logging logic as the main loop; screen repaints once the dialog closes.
 
 Screen repaints ~7×/s independent of fping. `UP`, `SET REFERENCE`, `DEL HOST`, `ZERO
@@ -217,9 +235,9 @@ Single self-contained page, no external resources.
 
 - Table: CLI-style columns, filled top-down then next column right. Horizontal scroll
   if needed ("SCROLL RIGHT FOR MORE" hint in the stats bar).
-- Footer stats: RUNTIME, HOST UP/DOWN/FLAPPING, for the whole current view regardless
-  of the match filter. RUNTIME shows `n/a` briefly during a background round.
-- Adding many hosts (`ADD`, `ADD FILE`, upload) shows "added N host(s) - please wait,
+- Footer stats: HOSTS, RUNTIME, HOST UP/DOWN/FLAPPING, for the whole current view regardless
+  of the match filter and the ADV FILTER (HOSTS-SHOWN = shown count). The CLI footer counts the same way. RUNTIME shows `n/a` briefly during a background round.
+- Adding many hosts (`ADD`, ADD HOSTS FILE, upload) shows "added N host(s) - please wait,
   pinging ..." until they appear with a state, then `done`.
 - Font size 6–28px (slider, `A−`/`A+`, `+`/`−` keys), stored in `localStorage`.
 - Column headers sort the list (IPv4-aware).
@@ -227,38 +245,46 @@ Single self-contained page, no external resources.
   - Row 1: view select (9 views), sort order select, SET REFERENCE, ZERO CHANGES,
     CLEAR ALL, address mode select, GET NAMES, ADV OPTIONS, RESET LOG, FILE OPERATIONS
     select, EXIT, font size.
-  - Row 2: match filter (SET/CLEAR), host field (ADD/DELETE), comment field (COMMENT),
-    ADD FILE select, GENERATE REPORT select.
+  - Row 2: match filter (SET/CLEAR), ADV FILTER, host field (ADD/DELETE), comment
+    field (COMMENT), GENERATE REPORT select.
   - View select, sort order select, address mode select and ADV OPTIONS all match the
-    CLI's `U`/`O`/`P`/`X` pickers exactly. FILE OPERATIONS and ADD FILE > FROM CLIENT/
-    FROM SERVER are web-gui-only (no CLI key - CLI already runs on the server's own
+    CLI's `U`/`O`/`P`/`X` pickers exactly. FILE OPERATIONS (incl. ADD HOSTS FILE FROM CLIENT/
+    FROM SERVER) is web-gui-only (no CLI key - CLI already runs on the server's own
     filesystem).
 - **FILE OPERATIONS** dropdown, in this order:
   | Entry | Does |
   |---|---|
-  | SAVE HOSTS FILE ON SERVER | confirmation, then saves the currently displayed hosts; blank name overwrites the active `-f` hostfile (first one, if eping.py was started with one) or, with none active, the default `eping-hosts.txt`; a typed name always saves as that new file instead, `.txt` appended once, active hostfile left untouched |
+  | ADD HOSTS FILE FROM SERVER | picks one or more `.txt` files or inventory `.csv` files already on the server, adds their hosts; a `.csv` without the inventory header, e.g. an eping log, is refused |
+  | ADD HOSTS FILE FROM CLIENT | local file picker (`.txt`/`.csv`), adds the hosts; a file can also be dropped anywhere on the page |
+  | SAVE HOSTS FILE ON SERVER | confirmation, then saves the currently displayed hosts; blank name overwrites the active `-f` hostfile (first one, if eping.py was started with one) or, with none active, the default `eping-hosts.txt`; a typed name always saves as that new file instead, `.txt` appended once, active hostfile left untouched. If the displayed hosts carry inventory values (CSV import) an inventory `.csv` is written instead (`;` delimited, columns as in *Inventory CSV import*); a `.txt` name or hostfile then becomes `.csv`, the default is `eping-hosts.csv`. The options that differ from the default are written first as `opt:` lines (see *Host file format*); for a `.csv` the checkboxes `include options (opt: lines)` (default on) and `save as .txt (hosts only, no inventory)` (default off) are offered |
   | UPLOAD FILE TO SERVER | picks a local `.txt`/`.csv`, saves as-is server-side, no host parsing; never overwrites, appends `-1`/`-2`/... |
-  | DOWNLOAD ALL HOSTS | full reference list, plain text |
-  | DOWNLOAD ACTIVE HOSTS | currently displayed hosts (view/address mode/filter applied), plain text |
+  | DOWNLOAD ALL HOSTS | full reference list: inventory `.csv` if the hosts carry inventory values, else `.txt`; non-default options first as `opt:` lines (`.csv`: checkboxes `include options`, default on, and `save as .txt`, default off) |
+  | DOWNLOAD ACTIVE HOSTS | currently displayed hosts (view/address mode/filter applied), same format and options as DOWNLOAD ALL HOSTS |
   | DOWNLOAD ACTIVE LOGFILE | active CSV log, zipped; disabled while logging off |
   | DOWNLOAD SELECTED FILES | picker: every `.csv`/`.txt`/`.html` in the working dir, table (name/size/date), extension filter, "select all", "no compression" checkbox (single-file selection only); multi-select bundles into one ZIP |
   | DELETE FILES FROM SERVER | same picker as DOWNLOAD SELECTED FILES, red DELETE button, confirms with file count; active logfile can't be deleted |
   | VIEW FILE FROM SERVER | picker: every `.csv`/`.txt` in the working dir, table (name/size/date), "select all"; opens each picked file read-only, raw content, COPY/DOWNLOAD buttons - see *VIEW FILE FROM SERVER* below |
-- **ADD FILE** dropdown: `FROM CLIENT` (local file picker) / `FROM SERVER` (picks one
-  or more `.txt` files or inventory `.csv` files already on the server, adds their
-  hosts; a `.csv` without the inventory header, e.g. an eping log, is refused).
 - Keyboard shortcuts (no modifier, only while no text field has focus; own quick
   variants, not the CLI's picker keys of the same letter): `U` cycles the original 3
   views (ALL HOSTS → CURRENTLY-UP → UP+FLAPPING → ALL HOSTS), the other 6 need the
   dropdown; `O` cycles all 5 sort orders one at a time; `P`/`I` toggle PREFER HOSTNAME /
   SWITCH TO IP ONLY directly, the address mode select reaches all 4 modes; `G`/`S`/`Z`/
   `C`/`L`/`E` click the matching button (`E`/`C`/`L` confirm); `A`/`D` focus host field;
-  `M`/`T` focus their field; `F` opens the file picker; `R` forces a status refresh;
+  `M`/`T` focus their field; `V` opens ADV FILTER; `F` opens the ADD HOSTS FILE FROM CLIENT picker; `R` forces a status refresh;
   `+`/`−` font size (works while typing). No keyboard shortcut for `X`/ADV OPTIONS or
   GENERATE REPORT - click required.
 - Host field feeds both ADD/DELETE; ENTER triggers the button used last, ESC clears.
 - Files can also be dropped anywhere on the page (max 16MB, see *Host file format*).
 - Commands acknowledge immediately; a click aborts the running round.
+- **Host popup**: hovering a host row (after ~350 ms) shows everything known about it:
+  state, previous state, RTT, last check, changes, time in the current state, resolved/CSV
+  IP, inventory values (Model, Location, sysLocation, Type, Comment, serial) and its
+  history (last up to 50 state changes, newest first, merged with the log `COMMENT`s
+  by time). The data is fetched per host on demand (`GET /api/host`), the polled status
+  stays small. A click on the row pins the popup: the text can be selected, `COPY` copies
+  all of it, `DELETE` removes the host immediately (no confirmation; not shown in `-wv`),
+  `×`/ESC/click elsewhere closes it. The history lives in memory only; it is cleared by
+  ZERO CHANGES and CLEAR ALL.
 
 ### Views and sort orders
 
@@ -330,7 +356,8 @@ Same bounds as the matching CLI flags (`-lms`/`-lmf` for the last two - see *Out
 |---|---|---|---|
 | GET | `/` | — | the page |
 | GET | `/api/status` | — | JSON: rows, counters, scan/phase info |
-| GET | `/api/logfiles` | — | JSON list of `.csv`/`.txt`/`.html` files (FILE OPERATIONS, ADD FILE > FROM SERVER) |
+| GET | `/api/host?name=...` | — | JSON: all known data and history of one host (mouse-over popup) |
+| GET | `/api/logfiles` | — | JSON list of `.csv`/`.txt`/`.html` files (FILE OPERATIONS > ADD HOSTS FILE FROM SERVER) |
 | GET | `/api/download/hosts_all` | — | full reference list, `.txt` |
 | GET | `/api/download/hosts_shown` | — | shown hosts, `.txt` |
 | GET | `/api/download/logfile` | — | active CSV log, zipped; `404` if logging off |
@@ -341,11 +368,14 @@ Same bounds as the matching CLI flags (`-lms`/`-lmf` for the last two - see *Out
 | POST | `/api/add_from_server` | `{"names":[...]}` | add hosts from listed `.txt` files |
 | GET | `/api/report` | — | last GENERATE REPORT HTML; `404` until done |
 | POST | `/api/command` | `{"cmd":"...","value":"..."}` | control (see cmd list below) |
+| POST | `/api/advvalues` | `{"filter":{...}}` | ADV FILTER: values still selectable for a draft selection (same format as `adv_filter`) |
 | POST | `/api/upload` | host list, text | add hosts |
 
 `cmd` values: `up_only`, `set_filter`, `addr_mode`, `get_names`, `match_filter`,
-`sort`, `add`, `del`, `set_ref`, `zero`, `add_comment`, `reset_log`, `clear`,
-`set_option`, `reset_options`, `run_report`, `save_hosts_file`, `exit`. `set_option`
+`adv_filter`, `sort`, `add`, `del`, `set_ref`, `zero`, `add_comment`, `reset_log`, `clear`,
+`set_option`, `reset_options`, `run_report`, `save_hosts_file`, `exit`. `adv_filter` value: JSON object `{"<field>":{"mode":"in|out","values":[...]}}` with the fields `model`,
+`location`, `sysloc`, `type`, `comment`; `\u0001none` as value = hosts without a value; `{}` = off
+(the old `{"<field>":"<value>"}` form is still accepted as `in` with one value). `set_option`
 value: `key=value`. `reset_log` value: logging off - optional custom file name (blank =
 auto-generated); logging on - `y` (clear) or `new`/`new=<name>` (new file, optional
 custom name). `run_report`: `value` = empty (active logfile) or one `.csv` filename; or
@@ -361,7 +391,9 @@ authentication. Default bind `0.0.0.0` — use `-bind 127.0.0.1` outside trusted
 1. Hostnames resolved once (32 parallel), cached around `-dns` seconds (randomized a
    bit so a large batch resolved together doesn't all expire - and need re-resolving -
    in the same round later). Same-address names share one probe. Unresolvable → NO-DNS,
-   no fping call. `-dns 0` = fping-side resolve.
+   no fping call. `-dns 0` = fping-side resolve. A command (filter, add, ...) cuts
+   the name resolution short as well, so it applies at once even with thousands of
+   hostnames.
 2. UP/new hosts get full `-re` retries; confirmed-DOWN hosts get `-dr` retries. Every
    `-fs`-th round probes everything with full retries.
 3. Only 1/`-ds` of DOWN hosts probed per round, strided.
@@ -565,6 +597,31 @@ value turns it off. CLI: replaces the version banner with `MATCH FILTER '<regex>
 active (N of M hosts shown, all still pinged)`. Invalid regex: error shown, previous
 filter unchanged.
 
+## ADV FILTER
+
+Excel-style display filter on the inventory values of a CSV import (*Inventory CSV
+import*) for `Model`, `Location`, `sysLocation`, `Type` and `Comment`. Display only -
+every host keeps being pinged. Needs hosts with inventory values; without them the
+dialog says so.
+
+- **Open**: CLI `V`, web GUI button `ADV FILTER` or key `V`. A separate window; the
+  filter only changes when applied.
+- **Per field**: check any number of values (with host count; `(empty)` = hosts without
+  a value) and choose the mode: `SHOW ONLY CHECKED` (include) or `HIDE CHECKED`
+  (exclude). Nothing checked = field not filtered.
+- **Combination**: values within a field are ORed, fields are ANDed with each other, with
+  the match filter (`M`) and the view. The lists narrow as you select: only values still
+  possible with the other fields' selection are offered.
+- **Web window**: one list per field with search box, `ALL`/`NONE` (act on the entries
+  matching the search), the mode toggle, APPLY, RESET ALL, CLOSE. Lists show the first
+  500 entries, the rest via search.
+- **CLI window**: `↑`/`↓` field, ENTER opens the value list (`SPACE` check, `I` show-only/hide,
+  `A` all, `N` none, ENTER ok, ESC cancel), then `A` APPLY, `R` RESET ALL, ESC CANCEL.
+  No search in the CLI list.
+- **Banner**: while active the CLI banner shows e.g. `ADV Type not in (Firewall, Switch)`.
+- **Reset**: SET REFERENCE and CLEAR ALL turn the filter off. It is not saved
+  with `SAVE HOSTS FILE`.
+
 ## IPv6
 
 IPv4/IPv6 mixed freely. Resolution follows `-4`/`-6` (preference, not restriction; A

{eping-3.65 → eping-3.84}/README.md

@@ -1,4 +1,4 @@
-# eping.py 3.65
+# eping.py 3.84
 
 Continuous ICMP reachability monitor built on `fping`. Scans a host list in a loop,
 reports each host UP/DOWN/NO-DNS, counts state changes. CLI (curses) or web GUI.
@@ -29,6 +29,19 @@ Standalone scripts (installs/updates `eping.py`, `epinga.py`, `esplit.py`):
 
 `esplit.py` isn't part of the pip package - use the standalone install for it.
 
+## Windows
+
+Portable Windows version (web GUI only, no installation): download and unpack
+[`eping-windows.zip`](https://github.com/ewaldj/eping/blob/main/Windows_Version/eping-windows.zip)
+([folder](https://github.com/ewaldj/eping/tree/main/Windows_Version/)), then start `eping.exe`.
+
+- Contains `eping.exe` (small launcher window: web port, Start / Stop / Restart, open web GUI),
+  `eping.py`, `epinga.py`, `fping.exe` + `cygwin1.dll` (fping for Windows) and an embedded Python.
+- The web GUI opens in the browser (default `http://127.0.0.1:8080`). The port is read from the hosts file
+  (`opt: -port 9000`); a port already in use is reported and can be changed in the launcher window.
+- No terminal (curses) mode and no `-wv`/`-wvc` on Windows; log file names use `-` instead of `:`.
+- Extra options: put them in `eping-args.txt` next to `eping.exe`. Details: `README-WINDOWS.txt` in the zip.
+
 ## Quick start
 
 pip install: use `eping`/`epinga` instead of `./eping.py`/`./epinga.py` below.
@@ -42,7 +55,7 @@ pip install: use `eping`/`epinga` instead of `./eping.py`/`./epinga.py` below.
 ./eping.py -wvc                        # CLI + controllable web view
 ```
 
-No args: creates a sample `eping-hosts.txt`. `-df`: start with no hosts, add at runtime.
+No args: creates a sample `eping-hosts.txt` and `eping-hosts-sample.csv` (same hosts with invented inventory values, a template for the *Inventory CSV import*; never loaded by eping). `-df`: start with no hosts, add at runtime.
 
 ### Running unattended (screen / tmux)
 
@@ -67,7 +80,7 @@ expansion includes network/broadcast. Several `-f` files are combined before ded
 
 ### Host file format
 
-Same parser for `-f`, `F`/ADD FILE (CLI), and web GUI ADD FILE:
+Same parser for `-f`, `F`/ADD FILE (CLI), and web GUI ADD HOSTS FILE:
 
 ```
 # comment to end of line
@@ -80,7 +93,7 @@ www.google.com            # hostname/FQDN
 2606:4700:4700::1111/128  # IPv6 with /128 - single host
 ```
 
-Network mask range /13…/32 everywhere (host file, ADD FILE, web upload, ADD/DELETE
+Network mask range /13…/32 everywhere (host file, ADD HOSTS FILE, web upload, ADD/DELETE
 host input); out of range is rejected (message names the allowed range; `-f` warns and
 ignores). IPv6: only `/128` accepted, any other mask rejected. Anything else is ignored.
 
@@ -98,34 +111,38 @@ opt: -web -port 9000
 Multiple `opt:` lines join in file order. `#` comments out the rest of the line (or
 the whole line at the start). Quote values with spaces: `opt: -f "my hosts.txt"`. A
 flag typed on the command line wins over the same flag from a file. Only applies to
-the initial `-f` read at startup — `F`/ADD FILE (CLI or web, FROM CLIENT/FROM SERVER)
+the initial `-f` read at startup — `F`/ADD FILE (CLI) and ADD HOSTS FILE (web)
 never parse `opt:` lines, they're just text.
 
+`opt:` lines also work at the top of an inventory `.csv`. SAVE HOSTS FILE and DOWNLOAD ALL/ACTIVE HOSTS write every option that differs from the default there (start-up flags and live ADV OPTIONS changes; not `-f -df -n -r -o -up -setref -gn -cl`).
+
 The default `eping-hosts.txt`: sample hosts, this section, then every CLI option as a
 commented-out `opt:` line with its default (remove `# ` to activate).
 
 ## Inventory CSV import
 
 A `.csv` inventory export (one device per row) can be used as host file: `-f FILE.csv`,
-`F`/ADD FILE (CLI), web GUI ADD FILE (FROM CLIENT, FROM SERVER, drag and drop). Files
+`F`/ADD FILE (CLI), web GUI FILE OPERATIONS > ADD HOSTS FILE (FROM CLIENT, FROM SERVER, drag and drop). Files
 named `*.txt` are never treated as CSV - they keep the plain host file format above.
 
-- **Detection**: first non-empty line is a header with the columns `IP Address` and
+- **Detection**: first line that is not blank, a `#` comment or an `opt:` line is a header with the columns `IP Address` and
   `Hostname` (case-insensitive); the delimiter (`;`, `,` or tab) is detected.
 - **Columns used**: `IP Address`, `Hostname`, `Serial Number`, `Model`, `Location`,
   `sysLocation`, `Type`, `Comment`. All other columns are ignored.
-- **Host entry**: the IP address; rows without a valid IP are ignored. With PREFER
-  HOSTNAME (`-ph`, or that address mode active when the file is added) the entry is
-  the `Hostname` instead - rows without an IP are then pinged by name too (NO-DNS if it
-  does not resolve); a name that is not a valid hostname falls back to the IP.
-  Rows without a usable entry are ignored.
+- **Host entry**: the `Hostname` (default; rows without an IP are pinged by name too,
+  NO-DNS if it does not resolve). A name that is not a valid hostname falls back to the
+  IP; rows without a usable entry are ignored. In the IP modes (`-ipo`, PREFER IP
+  ADDRESS, also when active while the file is added) the entry is the IP address
+  instead and rows without a valid IP are ignored. `-ph` is not needed for a CSV.
 - **Duplicates**: one host per entry, the first row wins. The count of ignored and
   duplicate rows is reported when the file is added (startup message / web footer).
 - **Log**: the six inventory values and the CSV hostname are written with every row
   of that host, see *Logging*. A `Hostname` that is not the host entry (IP mode) is
   only kept there as information.
-- Plain `.txt` hosts and `SAVE HOSTS FILE` carry no inventory values: a saved hosts
-  file lists only the host entries.
+- **Filters**: `M` matches the inventory values as text, `V` / ADV FILTER selects them
+  (see *ADV FILTER*).
+- **Save**: if the displayed hosts carry inventory values, `SAVE HOSTS FILE` writes an
+  inventory `.csv` (see *Web GUI*); plain `.txt` hosts are saved as `.txt`.
 
 Example (`;` delimited, extra columns are ignored):
 
@@ -139,8 +156,8 @@ sw-access-01;10.0.1.1;FOC5678C3DE;C9200L-24P;Vienna DC1;Rack C1;Switch;
 fw-edge-01;192.0.2.1;JMX2345F6GH;ASA5516;Linz POP;Rack B2;Firewall;ASA 5516 - EoL 2027
 ```
 
-Without `-ph` this gives 5 hosts (the IP addresses); `ap-lobby-01` has no IP and is
-ignored. With `-ph` it gives 6 hosts, named by `Hostname`.
+This gives 6 hosts, named by `Hostname`. In an IP mode it gives 5 hosts (the IP
+addresses); `ap-lobby-01` has no IP and is ignored.
 
 ## CLI mode
 
@@ -151,6 +168,7 @@ DOWN. Columns: hostname/IP, state, RTT (ms), last-change timestamp, change count
 |---|---|
 | `U` | view picker — all 9 views (see *Views and sort orders*) |
 | `M` | match filter — regex on hostname/IP and inventory fields, display only (see *Match filter*) |
+| `V` | ADV FILTER — check/uncheck Model/Location/sysLocation/Type/Comment values (show only / hide), display only (see *ADV FILTER*) |
 | `A` | add host — IP, hostname, CIDR (/13…/32), or `ip1-ip2` (max 524288) |
 | `D` | delete host — same formats/limits as add |
 | `F` | add hosts from a file |
@@ -173,7 +191,7 @@ same option set as the matching web GUI dropdown.
 Dialogs: ENTER confirms, ESC/empty cancels. Key bar shortens on narrow terminals.
 `PLEASE WAIT` box with elapsed counter shown until the first round has results.
 
-Ping checks keep running while a dialog (`A`/`D`/`F`/`M`/`T`) is open — same
+Ping checks keep running while a dialog (`A`/`D`/`F`/`M`/`V`/`T`) is open — same
 retry/state/logging logic as the main loop; screen repaints once the dialog closes.
 
 Screen repaints ~7×/s independent of fping. `UP`, `SET REFERENCE`, `DEL HOST`, `ZERO
@@ -198,9 +216,9 @@ Single self-contained page, no external resources.
 
 - Table: CLI-style columns, filled top-down then next column right. Horizontal scroll
   if needed ("SCROLL RIGHT FOR MORE" hint in the stats bar).
-- Footer stats: RUNTIME, HOST UP/DOWN/FLAPPING, for the whole current view regardless
-  of the match filter. RUNTIME shows `n/a` briefly during a background round.
-- Adding many hosts (`ADD`, `ADD FILE`, upload) shows "added N host(s) - please wait,
+- Footer stats: HOSTS, RUNTIME, HOST UP/DOWN/FLAPPING, for the whole current view regardless
+  of the match filter and the ADV FILTER (HOSTS-SHOWN = shown count). The CLI footer counts the same way. RUNTIME shows `n/a` briefly during a background round.
+- Adding many hosts (`ADD`, ADD HOSTS FILE, upload) shows "added N host(s) - please wait,
   pinging ..." until they appear with a state, then `done`.
 - Font size 6–28px (slider, `A−`/`A+`, `+`/`−` keys), stored in `localStorage`.
 - Column headers sort the list (IPv4-aware).
@@ -208,38 +226,46 @@ Single self-contained page, no external resources.
   - Row 1: view select (9 views), sort order select, SET REFERENCE, ZERO CHANGES,
     CLEAR ALL, address mode select, GET NAMES, ADV OPTIONS, RESET LOG, FILE OPERATIONS
     select, EXIT, font size.
-  - Row 2: match filter (SET/CLEAR), host field (ADD/DELETE), comment field (COMMENT),
-    ADD FILE select, GENERATE REPORT select.
+  - Row 2: match filter (SET/CLEAR), ADV FILTER, host field (ADD/DELETE), comment
+    field (COMMENT), GENERATE REPORT select.
   - View select, sort order select, address mode select and ADV OPTIONS all match the
-    CLI's `U`/`O`/`P`/`X` pickers exactly. FILE OPERATIONS and ADD FILE > FROM CLIENT/
-    FROM SERVER are web-gui-only (no CLI key - CLI already runs on the server's own
+    CLI's `U`/`O`/`P`/`X` pickers exactly. FILE OPERATIONS (incl. ADD HOSTS FILE FROM CLIENT/
+    FROM SERVER) is web-gui-only (no CLI key - CLI already runs on the server's own
     filesystem).
 - **FILE OPERATIONS** dropdown, in this order:
   | Entry | Does |
   |---|---|
-  | SAVE HOSTS FILE ON SERVER | confirmation, then saves the currently displayed hosts; blank name overwrites the active `-f` hostfile (first one, if eping.py was started with one) or, with none active, the default `eping-hosts.txt`; a typed name always saves as that new file instead, `.txt` appended once, active hostfile left untouched |
+  | ADD HOSTS FILE FROM SERVER | picks one or more `.txt` files or inventory `.csv` files already on the server, adds their hosts; a `.csv` without the inventory header, e.g. an eping log, is refused |
+  | ADD HOSTS FILE FROM CLIENT | local file picker (`.txt`/`.csv`), adds the hosts; a file can also be dropped anywhere on the page |
+  | SAVE HOSTS FILE ON SERVER | confirmation, then saves the currently displayed hosts; blank name overwrites the active `-f` hostfile (first one, if eping.py was started with one) or, with none active, the default `eping-hosts.txt`; a typed name always saves as that new file instead, `.txt` appended once, active hostfile left untouched. If the displayed hosts carry inventory values (CSV import) an inventory `.csv` is written instead (`;` delimited, columns as in *Inventory CSV import*); a `.txt` name or hostfile then becomes `.csv`, the default is `eping-hosts.csv`. The options that differ from the default are written first as `opt:` lines (see *Host file format*); for a `.csv` the checkboxes `include options (opt: lines)` (default on) and `save as .txt (hosts only, no inventory)` (default off) are offered |
   | UPLOAD FILE TO SERVER | picks a local `.txt`/`.csv`, saves as-is server-side, no host parsing; never overwrites, appends `-1`/`-2`/... |
-  | DOWNLOAD ALL HOSTS | full reference list, plain text |
-  | DOWNLOAD ACTIVE HOSTS | currently displayed hosts (view/address mode/filter applied), plain text |
+  | DOWNLOAD ALL HOSTS | full reference list: inventory `.csv` if the hosts carry inventory values, else `.txt`; non-default options first as `opt:` lines (`.csv`: checkboxes `include options`, default on, and `save as .txt`, default off) |
+  | DOWNLOAD ACTIVE HOSTS | currently displayed hosts (view/address mode/filter applied), same format and options as DOWNLOAD ALL HOSTS |
   | DOWNLOAD ACTIVE LOGFILE | active CSV log, zipped; disabled while logging off |
   | DOWNLOAD SELECTED FILES | picker: every `.csv`/`.txt`/`.html` in the working dir, table (name/size/date), extension filter, "select all", "no compression" checkbox (single-file selection only); multi-select bundles into one ZIP |
   | DELETE FILES FROM SERVER | same picker as DOWNLOAD SELECTED FILES, red DELETE button, confirms with file count; active logfile can't be deleted |
   | VIEW FILE FROM SERVER | picker: every `.csv`/`.txt` in the working dir, table (name/size/date), "select all"; opens each picked file read-only, raw content, COPY/DOWNLOAD buttons - see *VIEW FILE FROM SERVER* below |
-- **ADD FILE** dropdown: `FROM CLIENT` (local file picker) / `FROM SERVER` (picks one
-  or more `.txt` files or inventory `.csv` files already on the server, adds their
-  hosts; a `.csv` without the inventory header, e.g. an eping log, is refused).
 - Keyboard shortcuts (no modifier, only while no text field has focus; own quick
   variants, not the CLI's picker keys of the same letter): `U` cycles the original 3
   views (ALL HOSTS → CURRENTLY-UP → UP+FLAPPING → ALL HOSTS), the other 6 need the
   dropdown; `O` cycles all 5 sort orders one at a time; `P`/`I` toggle PREFER HOSTNAME /
   SWITCH TO IP ONLY directly, the address mode select reaches all 4 modes; `G`/`S`/`Z`/
   `C`/`L`/`E` click the matching button (`E`/`C`/`L` confirm); `A`/`D` focus host field;
-  `M`/`T` focus their field; `F` opens the file picker; `R` forces a status refresh;
+  `M`/`T` focus their field; `V` opens ADV FILTER; `F` opens the ADD HOSTS FILE FROM CLIENT picker; `R` forces a status refresh;
   `+`/`−` font size (works while typing). No keyboard shortcut for `X`/ADV OPTIONS or
   GENERATE REPORT - click required.
 - Host field feeds both ADD/DELETE; ENTER triggers the button used last, ESC clears.
 - Files can also be dropped anywhere on the page (max 16MB, see *Host file format*).
 - Commands acknowledge immediately; a click aborts the running round.
+- **Host popup**: hovering a host row (after ~350 ms) shows everything known about it:
+  state, previous state, RTT, last check, changes, time in the current state, resolved/CSV
+  IP, inventory values (Model, Location, sysLocation, Type, Comment, serial) and its
+  history (last up to 50 state changes, newest first, merged with the log `COMMENT`s
+  by time). The data is fetched per host on demand (`GET /api/host`), the polled status
+  stays small. A click on the row pins the popup: the text can be selected, `COPY` copies
+  all of it, `DELETE` removes the host immediately (no confirmation; not shown in `-wv`),
+  `×`/ESC/click elsewhere closes it. The history lives in memory only; it is cleared by
+  ZERO CHANGES and CLEAR ALL.
 
 ### Views and sort orders
 
@@ -311,7 +337,8 @@ Same bounds as the matching CLI flags (`-lms`/`-lmf` for the last two - see *Out
 |---|---|---|---|
 | GET | `/` | — | the page |
 | GET | `/api/status` | — | JSON: rows, counters, scan/phase info |
-| GET | `/api/logfiles` | — | JSON list of `.csv`/`.txt`/`.html` files (FILE OPERATIONS, ADD FILE > FROM SERVER) |
+| GET | `/api/host?name=...` | — | JSON: all known data and history of one host (mouse-over popup) |
+| GET | `/api/logfiles` | — | JSON list of `.csv`/`.txt`/`.html` files (FILE OPERATIONS > ADD HOSTS FILE FROM SERVER) |
 | GET | `/api/download/hosts_all` | — | full reference list, `.txt` |
 | GET | `/api/download/hosts_shown` | — | shown hosts, `.txt` |
 | GET | `/api/download/logfile` | — | active CSV log, zipped; `404` if logging off |
@@ -322,11 +349,14 @@ Same bounds as the matching CLI flags (`-lms`/`-lmf` for the last two - see *Out
 | POST | `/api/add_from_server` | `{"names":[...]}` | add hosts from listed `.txt` files |
 | GET | `/api/report` | — | last GENERATE REPORT HTML; `404` until done |
 | POST | `/api/command` | `{"cmd":"...","value":"..."}` | control (see cmd list below) |
+| POST | `/api/advvalues` | `{"filter":{...}}` | ADV FILTER: values still selectable for a draft selection (same format as `adv_filter`) |
 | POST | `/api/upload` | host list, text | add hosts |
 
 `cmd` values: `up_only`, `set_filter`, `addr_mode`, `get_names`, `match_filter`,
-`sort`, `add`, `del`, `set_ref`, `zero`, `add_comment`, `reset_log`, `clear`,
-`set_option`, `reset_options`, `run_report`, `save_hosts_file`, `exit`. `set_option`
+`adv_filter`, `sort`, `add`, `del`, `set_ref`, `zero`, `add_comment`, `reset_log`, `clear`,
+`set_option`, `reset_options`, `run_report`, `save_hosts_file`, `exit`. `adv_filter` value: JSON object `{"<field>":{"mode":"in|out","values":[...]}}` with the fields `model`,
+`location`, `sysloc`, `type`, `comment`; `\u0001none` as value = hosts without a value; `{}` = off
+(the old `{"<field>":"<value>"}` form is still accepted as `in` with one value). `set_option`
 value: `key=value`. `reset_log` value: logging off - optional custom file name (blank =
 auto-generated); logging on - `y` (clear) or `new`/`new=<name>` (new file, optional
 custom name). `run_report`: `value` = empty (active logfile) or one `.csv` filename; or
@@ -342,7 +372,9 @@ authentication. Default bind `0.0.0.0` — use `-bind 127.0.0.1` outside trusted
 1. Hostnames resolved once (32 parallel), cached around `-dns` seconds (randomized a
    bit so a large batch resolved together doesn't all expire - and need re-resolving -
    in the same round later). Same-address names share one probe. Unresolvable → NO-DNS,
-   no fping call. `-dns 0` = fping-side resolve.
+   no fping call. `-dns 0` = fping-side resolve. A command (filter, add, ...) cuts
+   the name resolution short as well, so it applies at once even with thousands of
+   hostnames.
 2. UP/new hosts get full `-re` retries; confirmed-DOWN hosts get `-dr` retries. Every
    `-fs`-th round probes everything with full retries.
 3. Only 1/`-ds` of DOWN hosts probed per round, strided.
@@ -546,6 +578,31 @@ value turns it off. CLI: replaces the version banner with `MATCH FILTER '<regex>
 active (N of M hosts shown, all still pinged)`. Invalid regex: error shown, previous
 filter unchanged.
 
+## ADV FILTER
+
+Excel-style display filter on the inventory values of a CSV import (*Inventory CSV
+import*) for `Model`, `Location`, `sysLocation`, `Type` and `Comment`. Display only -
+every host keeps being pinged. Needs hosts with inventory values; without them the
+dialog says so.
+
+- **Open**: CLI `V`, web GUI button `ADV FILTER` or key `V`. A separate window; the
+  filter only changes when applied.
+- **Per field**: check any number of values (with host count; `(empty)` = hosts without
+  a value) and choose the mode: `SHOW ONLY CHECKED` (include) or `HIDE CHECKED`
+  (exclude). Nothing checked = field not filtered.
+- **Combination**: values within a field are ORed, fields are ANDed with each other, with
+  the match filter (`M`) and the view. The lists narrow as you select: only values still
+  possible with the other fields' selection are offered.
+- **Web window**: one list per field with search box, `ALL`/`NONE` (act on the entries
+  matching the search), the mode toggle, APPLY, RESET ALL, CLOSE. Lists show the first
+  500 entries, the rest via search.
+- **CLI window**: `↑`/`↓` field, ENTER opens the value list (`SPACE` check, `I` show-only/hide,
+  `A` all, `N` none, ENTER ok, ESC cancel), then `A` APPLY, `R` RESET ALL, ESC CANCEL.
+  No search in the CLI list.
+- **Banner**: while active the CLI banner shows e.g. `ADV Type not in (Firewall, Switch)`.
+- **Reset**: SET REFERENCE and CLEAR ALL turn the filter off. It is not saved
+  with `SAVE HOSTS FILE`.
+
 ## IPv6
 
 IPv4/IPv6 mixed freely. Resolution follows `-4`/`-6` (preference, not restriction; A

{eping-3.65 → eping-3.84}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "eping"
-version = "3.65"
+version = "3.84"
 description = "Continuous ICMP reachability monitor built on fping, with a CSV logfile analyser (epinga)"
 readme = "README.md"
 license = { text = "GPL-3.0-or-later" }