gea-program 0.63.0__tar.gz → 0.65.0__tar.gz

{gea_program-0.63.0/gea_program.egg-info → gea_program-0.65.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gea-program
-Version: 0.63.0
+Version: 0.65.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
@@ -695,6 +695,10 @@ http://timestamp.digicert.com --timestamp on`; `gea help dossier`.
 
 ### Casing design and kick tolerance
 
+A well's casing is declared once, as its casing program (the Casing &
+kick tolerance tab, `gea casing`, or the declarations sheet's `[casing]`):
+rig time, hydraulics and torque and drag read the same strings, and a
+string needs only its size and shoe until it is to be checked.
 Each casing string's burst, collapse and tension ratings by API TR 5C3,
 from its size, weight and grade, against the loads the hole can put on it
 - gas to the surface held by the shoe, an emptied string, the buoyed
@@ -1420,6 +1424,33 @@ 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.65.0.exe` (for 0.65.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), 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.65.0.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /WORKSPACE="C:\site" /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
 
 ```
@@ -1431,7 +1462,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.63.0 → gea_program-0.65.0}/README.md

@@ -656,6 +656,10 @@ http://timestamp.digicert.com --timestamp on`; `gea help dossier`.
 
 ### Casing design and kick tolerance
 
+A well's casing is declared once, as its casing program (the Casing &
+kick tolerance tab, `gea casing`, or the declarations sheet's `[casing]`):
+rig time, hydraulics and torque and drag read the same strings, and a
+string needs only its size and shoe until it is to be checked.
 Each casing string's burst, collapse and tension ratings by API TR 5C3,
 from its size, weight and grade, against the loads the hole can put on it
 - gas to the surface held by the shoe, an emptied string, the buoyed
@@ -1381,6 +1385,33 @@ 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.65.0.exe` (for 0.65.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), 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.65.0.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /WORKSPACE="C:\site" /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
 
 ```
@@ -1392,7 +1423,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.63.0 → gea_program-0.65.0}/gea/__init__.py

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

{gea_program-0.63.0 → gea_program-0.65.0}/gea/__main__.py

@@ -815,6 +815,19 @@ 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_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")
@@ -2972,7 +2985,7 @@ def main(argv=None) -> int:
                 if not a.well:
                     raise ValueError("--casing needs --well")
                 c_ = _RS.set_casing(ws, a.actor, a.well, a.casing, a.shoe_md, a.source, a.set_time)
-                print(f"casing {c_['size']} in, shoe at {c_['shoe_md_ft']:,.0f} ft MD ({c_['source']})")
+                print(f"casing {c_['size']} in, shoe at {c_['shoe_md_ft']:,.0f} ft MD ({c_['source']}) - in the well's casing program (gea casing)")
                 return 0
             if a.w2w_min is not None or a.trip_in is not None or a.trip_out is not None or a.block_weight is not None:
                 if a.block_weight is not None and not a.well:
@@ -3211,6 +3224,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