eping 4.51__tar.gz → 4.76__tar.gz

{eping-4.51 → eping-4.76}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eping
-Version: 4.51
+Version: 4.76
 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,13 +17,25 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
 
-# eping.py 4.51
+# eping.py 4.76
 
 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.
 
 Written by Ewald Jeitler — <https://www.jeitler.cc>
 
+## Screenshots
+
+Web GUI (`-web`) - 61 demo hosts, mouse-over shows the host details and its state history:
+
+![eping web GUI](https://raw.githubusercontent.com/ewaldj/eping/main/docs/img/web-gui.png)
+
+![eping web GUI, host details](https://raw.githubusercontent.com/ewaldj/eping/main/docs/img/web-gui-host-details.png)
+
+Terminal (curses) mode:
+
+![eping CLI](https://raw.githubusercontent.com/ewaldj/eping/main/docs/img/cli.png)
+
 ## Requirements
 
 - Python 3.6+ (eping.py and epinga.py)
@@ -246,13 +258,13 @@ Single self-contained page, no external resources.
 - Toolbar, two rows (wraps if narrow):
   - Row 1: view select (9 views), sort order select, SET REFERENCE, ZERO CHANGES,
     CLEAR ALL, address mode select, GET NAMES, ADV OPTIONS, LOGGING, FILE OPERATIONS
-    select, EXIT, font size.
+    select, STOP, font size.
   - Row 2: match filter (SET/CLEAR), ADV FILTER, host field (ADD/DELETE), ADD/DEL LIST, comment
-    field (COMMENT), GENERATE REPORT select, STOP/START button.
-  - **STOP / START** (last button of row 2): `STOP` pauses the check - no pings are sent, the table, the
-    counters and the log stay as they are (header shows `PAUSED`, the button turns red and reads `START`).
+    field (COMMENT), GENERATE REPORT select, PAUSE/RESUME button.
+  - **PAUSE / RESUME** (last button of row 2): `PAUSE` pauses the check - no pings are sent, the table, the
+    counters and the log stay as they are (header shows `PAUSED`, the button turns red and reads `RESUME`).
     Commands (view, sort, filter, ADD/DELETE ...) keep working while paused; added hosts are pinged after
-    `START`. A round that is running when `STOP` is pressed is cut short. The log gets the comment rows
+    `RESUME`. A round that is running when `PAUSE` is pressed is cut short. The log gets the comment rows
     `CHECK PAUSED` / `CHECK RESUMED`; epinga.py shows the pause as a gap in the timeline
     (grey, like missing data) and does not count it as time in any state. Works in `-web` and `-wvc` (no CLI key); not in the read-only view (`-wv`).
   - View select, sort order select, address mode select and ADV OPTIONS all match the
@@ -342,13 +354,14 @@ directly, `D` resets the selected option to its default, `R` resets all, ESC/`X`
 
 | Option | Range | 0/-1 means |
 |---|---|---|
-| BACKOFF | 1 – 2 | — |
 | TIMEOUT | 10 – 5000 ms | — |
 | RETRIES | 0 – 5 | — |
 | INTERVAL | -1 – 250 ms | `-1` = auto (use RATE), `0` = no pacing |
 | THREADS | 0 – 32 | `0` = auto |
 | WAIT TIME | 0 – 600 s | — |
 | CONFIRM | 1 – 10 | — |
+| NEW HOST GRACE | 0 – 60 s | — |
+| SILENT LIMIT | 2 – 10 periods | — |
 | RATE | 10 – 25000 pps | — |
 | FLAP WINDOW | 1 – 72000 min | — |
 | DNS TTL | 0 – 3600 s | — |
@@ -379,12 +392,11 @@ Same bounds as the matching CLI flags (`-lms`/`-lmf` for the last two - see *Out
 | 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 |
-| POST | `/api/log_sources` | `{"names":[...],"upload":false}` | SOURCE values of the named logfiles (empty = active logfile; `upload:true` = files stored by `/api/reportupload`), for the jump host dialog of GENERATE REPORT |
 | POST | `/api/jumphost` | `{"action":"info|test|trust|connect|local","host":...,"port":...,"user":...,"secret":...,"hostkey":"ask|accept-new|off","key":...}` | JUMPHOST window (see *SSH source (JUMPHOST)*) |
 
 `cmd` values: `up_only`, `set_filter`, `addr_mode`, `get_names`, `match_filter`,
 `adv_filter`, `sort`, `add`, `del`, `set_ref`, `zero`, `add_comment`, `reset_log`, `clear`,
-`set_option`, `reset_options`, `run_report`, `pause` (value `1` = STOP, `0` = START), `save_hosts_file`, `exit`. `adv_filter` value: JSON object `{"<field>":{"mode":"in|out","values":[...]}}` with the fields `model`,
+`set_option`, `reset_options`, `run_report`, `pause` (value `1` = PAUSE, `0` = RESUME), `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
 `set_option`
 value: `key=value`. `reset_log` value: logging off - optional custom file name (blank =
@@ -406,11 +418,11 @@ on a router) and a jump host sees one command instead of one per round.
 - **Period:** fping pings every host once per period = `-w` (at least 200 ms), raised to
   `hosts x interval + timeout` so one pass fits. A round ends when every host delivered a new
   result (at most one period + timeout). RUNS counts only rounds in which hosts were checked.
-- **UP / DOWN:** a reply = UP at once. DOWN after `-re` + 1 timeouts in a row, or when fping
-  delivered nothing for a host for 3 periods. fping drops replies later than its timeout, so the
-  loop timeout is `-t` x `-B`^`-re`, at most 2000 ms. With `-cf` > 1 a host leaves UP only after that
-  many consecutive non-UP results (suppressed count in the log's TBD column).
-- **New hosts:** only an answer is reported during a grace period of (`-re` + 2) periods + 5 s - a slow first
+- **UP / DOWN:** a reply = UP at once. DOWN after `-re` + 1 timeouts in a row (fewer when the ping period is
+  long: the number is cut to what fits in 2 x `-t`, at least 2), or when fping delivered nothing for a host for
+  `-sp` periods. fping drops replies later than `-t`, so `-t` is the longest a reply may take. With `-cf` > 1 a
+  host leaves UP only after that many consecutive non-UP results (suppressed count in the log's TBD column).
+- **New hosts:** only an answer is reported during a grace period of (miss limit + 1) periods + `-ng` s (1 s) - a slow first
   contact (new NAT / firewall state) must not show up as DOWN.
 - **Names:** resolved by background threads (32 parallel, cached `-dns` seconds, randomized; an expired
   entry stays in use until its refresh is done). A name without an address yet joins as soon as it
@@ -425,7 +437,7 @@ on a router) and a jump host sees one command instead of one per round.
 - **Rate:** one process sends one packet per `-i` ms, `-ra` sets the packets/s. A pass over N hosts takes at
   least N / `-ra` s: 32 000 hosts at `-ra 1000` = about 34 s per round. Raise `-ra` for big lists (mind the
   router / NAT / jump host). `-i` floor is 1 ms; `-i 0` removes pacing.
-- STOP stops the processes, START starts them again.
+- PAUSE stops the processes, RESUME starts them again.
 
 ## Options
 
@@ -441,13 +453,14 @@ separated) · `-r` IP range (comma separated, shortened end)
 ### Probing
 | Option | Range | Default | Meaning |
 |---|---|---|---|
-| `-B` | 1 – 2 | 1.5 | backoff factor per retry |
-| `-t` | 10 – 5000 | 250 | timeout (ms); with `-B` and `-re` it gives the loop timeout |
-| `-re` | 0 – 5 | 3 | DOWN after `-re` + 1 timeouts in a row |
+| `-t` | 10 – 5000 | 1000 | ping timeout (ms): a reply later than this is lost |
+| `-re` | 0 – 5 | 3 | DOWN after up to `-re` + 1 timeouts in a row (see *How checking works*) |
 | `-i` | -1 – 250 | auto | send interval (ms), overrides `-ra`; `-1` auto, `0` unpaced |
 | `-p` | 0 – 32 | auto | fping processes per address family |
 | `-w` | 0 – 600 | 0.5 | ping period per host (s, at least 0.2) |
 | `-cf` | 1 – 10 | 2 | consecutive DOWN before leaving UP (`1` = off) |
+| `-ng` | 0 – 60 | 1 | seconds added to the grace period of new hosts |
+| `-sp` | 2 – 10 | 3 | silent ping periods (no fping output) until DOWN |
 | `-ra` | 10 – 25000 | 1000 | ICMP packets/s |
 | `-fw` | 1 – 72000 | 72000 | minutes to count as flapping |
 | `-dns` | 0 – 3600 | 300 | hostname cache TTL (s, `0` off) |
@@ -581,7 +594,7 @@ exit, a full notice prints once:
     https://github.com/ewaldj/eping
 ```
 
-Shown on any terminal-driven exit (CLI `[E]`/Ctrl-C, `-web`'s EXIT/Ctrl-C in its
+Shown on any terminal-driven exit (CLI `[E]`/Ctrl-C, `-web`'s STOP/Ctrl-C in its
 terminal). The web GUI's in-browser banner is separate and shorter.
 
 ## Run analysis on exit
@@ -594,7 +607,7 @@ Run an analysis of this logfile with epinga.py now? [y/N]:
 
 `y` (case-insensitive) runs `epinga.py -f <logfile>` before exit; anything else skips
 it. Only asked on a terminal-driven exit (CLI `[E]`/Ctrl-C, or `-wv`/`-wvc`'s own
-keyboard `[E]`/Ctrl-C); exiting via a browser's EXIT button never asks. No prompt if
+keyboard `[E]`/Ctrl-C); exiting via a browser's STOP button never asks. No prompt if
 logging is off or the logfile is empty/missing.
 
 ## GENERATE REPORT (web gui) / ANALYSE NOW (CLI `N`)
@@ -604,22 +617,16 @@ running - not just at exit. Web: GENERATE REPORT dropdown, four entries - `ACTIV
 LOGFILE` analyses the active CSV log (needs logging on, non-empty logfile, else the tab
 closes and a footer error is shown), `CHOOSE LOGFILE` picks one or more `.csv` files in
 the working dir - table (name/size/date), "select all" checkbox, nothing preselected;
-up to 25 files per report, checking a 26th is refused. If a log holds more than one source (`local` and jump hosts, log column `SOURCE`), a
-selection dialog follows automatically - all checked, ENTER = GENERATE; only the periods of the checked sources are calculated (see *Source filter* in the
-epinga.py section).
-
-All report entries (`ACTIVE LOGFILE`, `CHOOSE LOGFILE`, `UPLOAD FROM CLIENT`) check the selected log(s) first: if they hold more than one
-source (measuring host changed between local and jump hosts, or between jump hosts), a dialog offers to analyse all,
-one or several sources (all checked = default; CANCEL aborts the report). With one source the report starts directly.
-The report tab opens only after this choice; if the browser blocks it (e.g. after a long upload), a REPORT READY dialog with an OPEN REPORT button appears.
+up to 25 files per report, checking a 26th is refused. If a log holds more than one source (`local` and jump hosts, log column `SOURCE`), the report contains all of them and a
+source switch (see *Source switch in the HTML report*); no dialog.
+
+The report tab opens right away; if the browser blocks it (e.g. after a long upload), a REPORT READY dialog with an OPEN REPORT button appears.
 While the report is generated the waiting tab shows a progress bar with the step (merging files / analysing / analysing source N of M / writing report), the percentage and an estimated remaining time (extrapolated from the elapsed time, shown after a few seconds); without a tab the same text is shown in the footer. The percentage covers all passes (the main analysis plus one per source, see *Source switch*).
 
 `UPLOAD FROM CLIENT` picks one or more `.csv` logfiles on the computer running the browser (max 25, 1 GB each);
 they are uploaded to a server temp dir, merged like `CHOOSE LOGFILE` and analysed as one report. Temp files and
 report are removed when eping.py exits or on the next upload.
 
-![SELECT JUMPHOST](https://raw.githubusercontent.com/ewaldj/eping/main/docs/img/select-jumphost.png)
-
 More than one selected file is merged chronologically (by the row timestamps, streamed) into one temporary
 CSV, analysed as a single logfile, then the temp file is removed. Result opens in a new
 tab; if a selected file was invalid or has meanwhile been removed (e.g. by log rotation
@@ -733,7 +740,7 @@ With `-debug` a round longer than 10 s is also logged as a `SLOW ROUND` comment
 - `-p` > 1 and `-i 0` reduce accuracy (false DOWN) — defaults avoid both.
 - Needs an fping with `-l` and per-target sequence numbers (fping 4.3 or newer; the Windows / macOS packages have it).
 
-# epinga.py 2.45
+# epinga.py 2.47
 
 Analyses an eping.py CSV log: terminal summary + self-contained HTML report (no
 server, no external assets) with per-host detail, state-change timelines, and

{eping-4.51 → eping-4.76}/README.md

@@ -1,10 +1,22 @@
-# eping.py 4.51
+# eping.py 4.76
 
 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.
 
 Written by Ewald Jeitler — <https://www.jeitler.cc>
 
+## Screenshots
+
+Web GUI (`-web`) - 61 demo hosts, mouse-over shows the host details and its state history:
+
+![eping web GUI](https://raw.githubusercontent.com/ewaldj/eping/main/docs/img/web-gui.png)
+
+![eping web GUI, host details](https://raw.githubusercontent.com/ewaldj/eping/main/docs/img/web-gui-host-details.png)
+
+Terminal (curses) mode:
+
+![eping CLI](https://raw.githubusercontent.com/ewaldj/eping/main/docs/img/cli.png)
+
 ## Requirements
 
 - Python 3.6+ (eping.py and epinga.py)
@@ -227,13 +239,13 @@ Single self-contained page, no external resources.
 - Toolbar, two rows (wraps if narrow):
   - Row 1: view select (9 views), sort order select, SET REFERENCE, ZERO CHANGES,
     CLEAR ALL, address mode select, GET NAMES, ADV OPTIONS, LOGGING, FILE OPERATIONS
-    select, EXIT, font size.
+    select, STOP, font size.
   - Row 2: match filter (SET/CLEAR), ADV FILTER, host field (ADD/DELETE), ADD/DEL LIST, comment
-    field (COMMENT), GENERATE REPORT select, STOP/START button.
-  - **STOP / START** (last button of row 2): `STOP` pauses the check - no pings are sent, the table, the
-    counters and the log stay as they are (header shows `PAUSED`, the button turns red and reads `START`).
+    field (COMMENT), GENERATE REPORT select, PAUSE/RESUME button.
+  - **PAUSE / RESUME** (last button of row 2): `PAUSE` pauses the check - no pings are sent, the table, the
+    counters and the log stay as they are (header shows `PAUSED`, the button turns red and reads `RESUME`).
     Commands (view, sort, filter, ADD/DELETE ...) keep working while paused; added hosts are pinged after
-    `START`. A round that is running when `STOP` is pressed is cut short. The log gets the comment rows
+    `RESUME`. A round that is running when `PAUSE` is pressed is cut short. The log gets the comment rows
     `CHECK PAUSED` / `CHECK RESUMED`; epinga.py shows the pause as a gap in the timeline
     (grey, like missing data) and does not count it as time in any state. Works in `-web` and `-wvc` (no CLI key); not in the read-only view (`-wv`).
   - View select, sort order select, address mode select and ADV OPTIONS all match the
@@ -323,13 +335,14 @@ directly, `D` resets the selected option to its default, `R` resets all, ESC/`X`
 
 | Option | Range | 0/-1 means |
 |---|---|---|
-| BACKOFF | 1 – 2 | — |
 | TIMEOUT | 10 – 5000 ms | — |
 | RETRIES | 0 – 5 | — |
 | INTERVAL | -1 – 250 ms | `-1` = auto (use RATE), `0` = no pacing |
 | THREADS | 0 – 32 | `0` = auto |
 | WAIT TIME | 0 – 600 s | — |
 | CONFIRM | 1 – 10 | — |
+| NEW HOST GRACE | 0 – 60 s | — |
+| SILENT LIMIT | 2 – 10 periods | — |
 | RATE | 10 – 25000 pps | — |
 | FLAP WINDOW | 1 – 72000 min | — |
 | DNS TTL | 0 – 3600 s | — |
@@ -360,12 +373,11 @@ Same bounds as the matching CLI flags (`-lms`/`-lmf` for the last two - see *Out
 | 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 |
-| POST | `/api/log_sources` | `{"names":[...],"upload":false}` | SOURCE values of the named logfiles (empty = active logfile; `upload:true` = files stored by `/api/reportupload`), for the jump host dialog of GENERATE REPORT |
 | POST | `/api/jumphost` | `{"action":"info|test|trust|connect|local","host":...,"port":...,"user":...,"secret":...,"hostkey":"ask|accept-new|off","key":...}` | JUMPHOST window (see *SSH source (JUMPHOST)*) |
 
 `cmd` values: `up_only`, `set_filter`, `addr_mode`, `get_names`, `match_filter`,
 `adv_filter`, `sort`, `add`, `del`, `set_ref`, `zero`, `add_comment`, `reset_log`, `clear`,
-`set_option`, `reset_options`, `run_report`, `pause` (value `1` = STOP, `0` = START), `save_hosts_file`, `exit`. `adv_filter` value: JSON object `{"<field>":{"mode":"in|out","values":[...]}}` with the fields `model`,
+`set_option`, `reset_options`, `run_report`, `pause` (value `1` = PAUSE, `0` = RESUME), `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
 `set_option`
 value: `key=value`. `reset_log` value: logging off - optional custom file name (blank =
@@ -387,11 +399,11 @@ on a router) and a jump host sees one command instead of one per round.
 - **Period:** fping pings every host once per period = `-w` (at least 200 ms), raised to
   `hosts x interval + timeout` so one pass fits. A round ends when every host delivered a new
   result (at most one period + timeout). RUNS counts only rounds in which hosts were checked.
-- **UP / DOWN:** a reply = UP at once. DOWN after `-re` + 1 timeouts in a row, or when fping
-  delivered nothing for a host for 3 periods. fping drops replies later than its timeout, so the
-  loop timeout is `-t` x `-B`^`-re`, at most 2000 ms. With `-cf` > 1 a host leaves UP only after that
-  many consecutive non-UP results (suppressed count in the log's TBD column).
-- **New hosts:** only an answer is reported during a grace period of (`-re` + 2) periods + 5 s - a slow first
+- **UP / DOWN:** a reply = UP at once. DOWN after `-re` + 1 timeouts in a row (fewer when the ping period is
+  long: the number is cut to what fits in 2 x `-t`, at least 2), or when fping delivered nothing for a host for
+  `-sp` periods. fping drops replies later than `-t`, so `-t` is the longest a reply may take. With `-cf` > 1 a
+  host leaves UP only after that many consecutive non-UP results (suppressed count in the log's TBD column).
+- **New hosts:** only an answer is reported during a grace period of (miss limit + 1) periods + `-ng` s (1 s) - a slow first
   contact (new NAT / firewall state) must not show up as DOWN.
 - **Names:** resolved by background threads (32 parallel, cached `-dns` seconds, randomized; an expired
   entry stays in use until its refresh is done). A name without an address yet joins as soon as it
@@ -406,7 +418,7 @@ on a router) and a jump host sees one command instead of one per round.
 - **Rate:** one process sends one packet per `-i` ms, `-ra` sets the packets/s. A pass over N hosts takes at
   least N / `-ra` s: 32 000 hosts at `-ra 1000` = about 34 s per round. Raise `-ra` for big lists (mind the
   router / NAT / jump host). `-i` floor is 1 ms; `-i 0` removes pacing.
-- STOP stops the processes, START starts them again.
+- PAUSE stops the processes, RESUME starts them again.
 
 ## Options
 
@@ -422,13 +434,14 @@ separated) · `-r` IP range (comma separated, shortened end)
 ### Probing
 | Option | Range | Default | Meaning |
 |---|---|---|---|
-| `-B` | 1 – 2 | 1.5 | backoff factor per retry |
-| `-t` | 10 – 5000 | 250 | timeout (ms); with `-B` and `-re` it gives the loop timeout |
-| `-re` | 0 – 5 | 3 | DOWN after `-re` + 1 timeouts in a row |
+| `-t` | 10 – 5000 | 1000 | ping timeout (ms): a reply later than this is lost |
+| `-re` | 0 – 5 | 3 | DOWN after up to `-re` + 1 timeouts in a row (see *How checking works*) |
 | `-i` | -1 – 250 | auto | send interval (ms), overrides `-ra`; `-1` auto, `0` unpaced |
 | `-p` | 0 – 32 | auto | fping processes per address family |
 | `-w` | 0 – 600 | 0.5 | ping period per host (s, at least 0.2) |
 | `-cf` | 1 – 10 | 2 | consecutive DOWN before leaving UP (`1` = off) |
+| `-ng` | 0 – 60 | 1 | seconds added to the grace period of new hosts |
+| `-sp` | 2 – 10 | 3 | silent ping periods (no fping output) until DOWN |
 | `-ra` | 10 – 25000 | 1000 | ICMP packets/s |
 | `-fw` | 1 – 72000 | 72000 | minutes to count as flapping |
 | `-dns` | 0 – 3600 | 300 | hostname cache TTL (s, `0` off) |
@@ -562,7 +575,7 @@ exit, a full notice prints once:
     https://github.com/ewaldj/eping
 ```
 
-Shown on any terminal-driven exit (CLI `[E]`/Ctrl-C, `-web`'s EXIT/Ctrl-C in its
+Shown on any terminal-driven exit (CLI `[E]`/Ctrl-C, `-web`'s STOP/Ctrl-C in its
 terminal). The web GUI's in-browser banner is separate and shorter.
 
 ## Run analysis on exit
@@ -575,7 +588,7 @@ Run an analysis of this logfile with epinga.py now? [y/N]:
 
 `y` (case-insensitive) runs `epinga.py -f <logfile>` before exit; anything else skips
 it. Only asked on a terminal-driven exit (CLI `[E]`/Ctrl-C, or `-wv`/`-wvc`'s own
-keyboard `[E]`/Ctrl-C); exiting via a browser's EXIT button never asks. No prompt if
+keyboard `[E]`/Ctrl-C); exiting via a browser's STOP button never asks. No prompt if
 logging is off or the logfile is empty/missing.
 
 ## GENERATE REPORT (web gui) / ANALYSE NOW (CLI `N`)
@@ -585,22 +598,16 @@ running - not just at exit. Web: GENERATE REPORT dropdown, four entries - `ACTIV
 LOGFILE` analyses the active CSV log (needs logging on, non-empty logfile, else the tab
 closes and a footer error is shown), `CHOOSE LOGFILE` picks one or more `.csv` files in
 the working dir - table (name/size/date), "select all" checkbox, nothing preselected;
-up to 25 files per report, checking a 26th is refused. If a log holds more than one source (`local` and jump hosts, log column `SOURCE`), a
-selection dialog follows automatically - all checked, ENTER = GENERATE; only the periods of the checked sources are calculated (see *Source filter* in the
-epinga.py section).
-
-All report entries (`ACTIVE LOGFILE`, `CHOOSE LOGFILE`, `UPLOAD FROM CLIENT`) check the selected log(s) first: if they hold more than one
-source (measuring host changed between local and jump hosts, or between jump hosts), a dialog offers to analyse all,
-one or several sources (all checked = default; CANCEL aborts the report). With one source the report starts directly.
-The report tab opens only after this choice; if the browser blocks it (e.g. after a long upload), a REPORT READY dialog with an OPEN REPORT button appears.
+up to 25 files per report, checking a 26th is refused. If a log holds more than one source (`local` and jump hosts, log column `SOURCE`), the report contains all of them and a
+source switch (see *Source switch in the HTML report*); no dialog.
+
+The report tab opens right away; if the browser blocks it (e.g. after a long upload), a REPORT READY dialog with an OPEN REPORT button appears.
 While the report is generated the waiting tab shows a progress bar with the step (merging files / analysing / analysing source N of M / writing report), the percentage and an estimated remaining time (extrapolated from the elapsed time, shown after a few seconds); without a tab the same text is shown in the footer. The percentage covers all passes (the main analysis plus one per source, see *Source switch*).
 
 `UPLOAD FROM CLIENT` picks one or more `.csv` logfiles on the computer running the browser (max 25, 1 GB each);
 they are uploaded to a server temp dir, merged like `CHOOSE LOGFILE` and analysed as one report. Temp files and
 report are removed when eping.py exits or on the next upload.
 
-![SELECT JUMPHOST](https://raw.githubusercontent.com/ewaldj/eping/main/docs/img/select-jumphost.png)
-
 More than one selected file is merged chronologically (by the row timestamps, streamed) into one temporary
 CSV, analysed as a single logfile, then the temp file is removed. Result opens in a new
 tab; if a selected file was invalid or has meanwhile been removed (e.g. by log rotation
@@ -714,7 +721,7 @@ With `-debug` a round longer than 10 s is also logged as a `SLOW ROUND` comment
 - `-p` > 1 and `-i 0` reduce accuracy (false DOWN) — defaults avoid both.
 - Needs an fping with `-l` and per-target sequence numbers (fping 4.3 or newer; the Windows / macOS packages have it).
 
-# epinga.py 2.45
+# epinga.py 2.47
 
 Analyses an eping.py CSV log: terminal summary + self-contained HTML report (no
 server, no external assets) with per-host detail, state-change timelines, and

{eping-4.51 → eping-4.76}/pyproject.toml

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