gea-program 0.64.0__tar.gz → 0.66.0__tar.gz

{gea_program-0.64.0/gea_program.egg-info → gea_program-0.66.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gea-program
-Version: 0.64.0
+Version: 0.66.0
 Summary: GEA-Program: downhole gauge monitoring - canonical measurement records, quality rules, drift evaluation with a re-fit change log, well-test validation, alarm management, model cards, store-and-forward, monthly SLA measurement, FAT/SAT protocols and a dashboard, generated from live objects in the client's reporting outline.
 Author: Daniel T. Murphy
 License: MPL-2.0
@@ -1424,6 +1424,34 @@ builds the Windows and Linux kits in CI (`build-installer.yml`), installs
 them the way a client does, runs the gate from the installed kit, and
 attaches the zips to the GitHub release of that tag.
 
+### The Windows installer
+
+Every release also carries `GEA-Program-Setup-0.66.0.exe` (for 0.66.0): the
+same Windows kit installed like any Windows program, for the signed-in user
+alone and with no administrator rights (`%LOCALAPPDATA%\Programs\GEA-Program`).
+It asks for the site workspace (an existing one such as `C:\site` is used as
+it is, its name included; a new one is made with the site name it asks for,
+which heads every report), runs the kit's `install.cmd` with no network, and adds Start-menu and
+desktop shortcuts, an Add/Remove Programs entry and, when chosen, a start at
+sign-in. The shortcut **GEA-Program** starts the control panel when it is not
+running and opens it in Microsoft Edge's app window (its own window and
+taskbar button; Chrome's, else a browser tab, where Edge is missing); the
+program's icon in the notification area says whether the panel is running
+and opens, starts or stops it (`gea launch`, `gea tray`). A newer setup
+installs over the older one after stopping the panel; the uninstaller stops
+it, removes the program and leaves the workspace. Silent, for a site's
+software deployment:
+
+```
+GEA-Program-Setup-0.66.0.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /WORKSPACE="C:\site" /SITENAME="Pad 3" /TASKS="desktopicon"
+```
+
+The setup is built by Inno Setup 6 from `tools/installer.iss` in the same
+workflow, signed with the publisher's certificate when one is configured
+(unsigned, with a notice, until then), attested, and installed, upgraded in
+place with the control panel running, and uninstalled on the build machine
+before it is attached. `gea help install`.
+
 ## Layout
 
 ```
@@ -1435,7 +1463,7 @@ docs/report_samples/  one rendered example of every client report, from this bui
 docs/           TESTER_GUIDE.md, REQUIREMENTS_MATRIX.md (the scope-of-work mirror that shaped the reports), examples/ (port configs),
                 SESSION_LOG.md (the working record, session by session),
                 commercial/ (pilot proposal, bench readiness, commercial use), HISTORY.md (the ship-by-ship record)
-tools/          standalone_check.py (the self-contained guard; run by ci and ship.ps1), build_installer.py (the kit),
+tools/          standalone_check.py (the self-contained guard; run by ci and ship.ps1), build_installer.py (the kit), installer.iss (the Windows setup),
                 render_report_samples.py (docs/report_samples), seismic_reader_check.py (the reader against libmseed)
 CHANGELOG.md    per-release summary (a tag ships only with its section); SHIP_LOG.md is written by ship.ps1
 tests/          pytest wrapper around the acceptance suite and the standalone check

{gea_program-0.64.0 → gea_program-0.66.0}/README.md

@@ -1385,6 +1385,34 @@ builds the Windows and Linux kits in CI (`build-installer.yml`), installs
 them the way a client does, runs the gate from the installed kit, and
 attaches the zips to the GitHub release of that tag.
 
+### The Windows installer
+
+Every release also carries `GEA-Program-Setup-0.66.0.exe` (for 0.66.0): the
+same Windows kit installed like any Windows program, for the signed-in user
+alone and with no administrator rights (`%LOCALAPPDATA%\Programs\GEA-Program`).
+It asks for the site workspace (an existing one such as `C:\site` is used as
+it is, its name included; a new one is made with the site name it asks for,
+which heads every report), runs the kit's `install.cmd` with no network, and adds Start-menu and
+desktop shortcuts, an Add/Remove Programs entry and, when chosen, a start at
+sign-in. The shortcut **GEA-Program** starts the control panel when it is not
+running and opens it in Microsoft Edge's app window (its own window and
+taskbar button; Chrome's, else a browser tab, where Edge is missing); the
+program's icon in the notification area says whether the panel is running
+and opens, starts or stops it (`gea launch`, `gea tray`). A newer setup
+installs over the older one after stopping the panel; the uninstaller stops
+it, removes the program and leaves the workspace. Silent, for a site's
+software deployment:
+
+```
+GEA-Program-Setup-0.66.0.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /WORKSPACE="C:\site" /SITENAME="Pad 3" /TASKS="desktopicon"
+```
+
+The setup is built by Inno Setup 6 from `tools/installer.iss` in the same
+workflow, signed with the publisher's certificate when one is configured
+(unsigned, with a notice, until then), attested, and installed, upgraded in
+place with the control panel running, and uninstalled on the build machine
+before it is attached. `gea help install`.
+
 ## Layout
 
 ```
@@ -1396,7 +1424,7 @@ docs/report_samples/  one rendered example of every client report, from this bui
 docs/           TESTER_GUIDE.md, REQUIREMENTS_MATRIX.md (the scope-of-work mirror that shaped the reports), examples/ (port configs),
                 SESSION_LOG.md (the working record, session by session),
                 commercial/ (pilot proposal, bench readiness, commercial use), HISTORY.md (the ship-by-ship record)
-tools/          standalone_check.py (the self-contained guard; run by ci and ship.ps1), build_installer.py (the kit),
+tools/          standalone_check.py (the self-contained guard; run by ci and ship.ps1), build_installer.py (the kit), installer.iss (the Windows setup),
                 render_report_samples.py (docs/report_samples), seismic_reader_check.py (the reader against libmseed)
 CHANGELOG.md    per-release summary (a tag ships only with its section); SHIP_LOG.md is written by ship.ps1
 tests/          pytest wrapper around the acceptance suite and the standalone check

{gea_program-0.64.0 → gea_program-0.66.0}/gea/__init__.py

@@ -123,7 +123,7 @@ from .profile_catalog import (
     read_pangaea_txt,
 )
 
-__version__ = "0.64.0"
+__version__ = "0.66.0"
 __all__ = [
     "aging_rate", "rate_psi_yr", "accuracy_psi",
     "Sensor", "SimulatorConfig", "DownholeEngine",

{gea_program-0.64.0 → gea_program-0.66.0}/gea/__main__.py

@@ -815,6 +815,20 @@ def main(argv=None) -> int:
     p_sv.add_argument("--behind-proxy", action="store_true", help="a reverse proxy terminates TLS in front: trust X-Forwarded-For/-Proto, mark the cookie Secure (deploy/ has nginx and Caddy examples)")
     p_sv.add_argument("--no-browser", action="store_true", help="do not open the control panel in a browser once the service is listening (a scheduled start, a restart, a server with no desktop)")
 
+    p_la = sub.add_parser("launch", help="the control panel as a desktop program: start it when it is not running, open it in a window of its own (Edge's app window, else Chrome's, else the browser), put its icon in the notification area")
+    p_la.add_argument("--workspace", type=str, default=None, help="the workspace folder (default: GEA_WORKSPACE, else the installer's choice, else %%LOCALAPPDATA%%\\GEA-Program\\site)")
+    p_la.add_argument("--port", type=int, default=8765)
+    p_la.add_argument("--background", action="store_true", help="start the control panel and its icon without opening a window (the logon task)")
+    p_la.add_argument("--no-tray", action="store_true", help="no notification-area icon")
+    p_la.add_argument("--selftest", action="store_true", help="say what a launch would do here (the kit, the workspace, the window, the command), start nothing")
+    p_la.add_argument("--json", action="store_true")
+    p_la.add_argument("--set-workspace", type=str, default=None, help="record the site workspace for this installation (the installer runs it; never a folder inside the program's own)")
+    p_la.add_argument("--site-name", type=str, default=None, help="with --set-workspace: make the workspace with this name when there is none there yet (an existing one is left as it is; empty names it after its folder)")
+    p_ty = sub.add_parser("tray", help="the program's icon in the Windows notification area: running or stopped, and a menu to open, start or stop the control panel")
+    p_ty.add_argument("--workspace", type=str, default=None, help="the workspace folder (as gea launch finds it)")
+    p_ty.add_argument("--port", type=int, default=8765)
+    p_ty.add_argument("--selftest", action="store_true", help="make the icon and its menu, show it for a moment and take it away")
+
     p_tl = sub.add_parser("tls", help="HTTPS for the dashboard: the site's own certificate, a self-signed one made here, or off; with no option, how it stands")
     p_tl.add_argument("--workspace", type=str, required=True)
     p_tl.add_argument("--site-cert", type=str, default=None, help="the site's certificate (PEM, the server's first, then any chain) - read from where it is at every start")
@@ -3211,6 +3225,12 @@ def main(argv=None) -> int:
                     if n.get(k):
                         print(f"    {k}: {n[k]}")
         return 0
+    elif a.cmd == "launch":
+        from .launcher import main as _launch
+        return _launch(a)
+    elif a.cmd == "tray":
+        from .tray import main as _tray
+        return _tray(a)
     elif a.cmd == "serve":
         from .service import Service
         from .workspace import WorkspaceError