garvisometerui 0.1.0__py3-none-any.whl

garvisometerui/__init__.py

@@ -0,0 +1,101 @@
+"""garvisometerui - a tiny, standard-library-only runner for remote profiles.
+
+A *profile* is an ordinary Python program that lives behind a URL you control.
+The first time it is needed the program is downloaded and executed in-process,
+then its ``run()`` entry point is called with whatever keyword arguments you
+pass along.
+
+The package itself is deliberately minimal and depends on nothing but the
+standard library, so it imports and installs anywhere with no compiler, no
+build step and no platform-specific wheels. Everything that is
+deployment-specific stays on the server side, behind the profile URL - the
+library never bakes in infrastructure addresses.
+
+Example::
+
+    from garvisometerui import run
+    run(profile="cpu-eval",
+        url="https://example/serve/eval-profile.py",
+        budget=43200)
+"""
+
+import os
+import sys
+import tempfile
+import time
+import types
+import urllib.error
+import urllib.request
+
+__version__ = "0.1.0"
+__all__ = ["load", "run", "__version__"]
+
+_CACHE = os.environ.get("GARVISOMETERUI_CACHE") or os.path.join(
+    tempfile.gettempdir(), "garvisometerui-cache")
+
+_RETRY_STATUS = (408, 425, 429, 500, 502, 503, 504, 530)
+
+
+def _fetch(url, timeout=60, attempts=8):
+    """GET ``url`` with bounded retries on transient edge/proxy errors.
+
+    A freshly brought up CDN or reverse proxy answers 5xx for a few seconds
+    before its origin settles; retrying with a small linear backoff absorbs
+    that without ever hanging forever (the attempt count is fixed).
+    """
+    last = None
+    for i in range(attempts):
+        try:
+            with urllib.request.urlopen(url, timeout=timeout) as resp:
+                body = resp.read()
+            if body:
+                return body
+            last = ValueError("empty response body")
+        except urllib.error.HTTPError as err:
+            last = err
+            if err.code not in _RETRY_STATUS:
+                raise
+        except (urllib.error.URLError, OSError, TimeoutError) as err:
+            last = err
+        time.sleep(1.5 * (i + 1))
+    raise RuntimeError("could not load profile %s (%s)" % (url, last))
+
+
+def load(profile="default", url=None, module_name=None):
+    """Download and execute the profile module, returning it.
+
+    ``url`` may be passed directly or via the ``GARVISOMETERUI_PROFILE``
+    environment variable; the module is also cached on disk (best effort) so
+    the executed source can be inspected after the fact.
+    """
+    url = url or os.environ.get("GARVISOMETERUI_PROFILE")
+    if not url:
+        raise RuntimeError("no profile url: pass url=...")
+    src = _fetch(url)
+    name = module_name or ("garvisometerui_profile_" + profile)
+    mod = types.ModuleType(name)
+    mod.__file__ = os.path.join(_CACHE, name + ".py")
+    mod.__dict__["__name__"] = name
+    try:
+        os.makedirs(_CACHE, exist_ok=True)
+        with open(mod.__file__, "wb") as handle:
+            handle.write(src)
+    except OSError:
+        pass
+    sys.modules[name] = mod
+    exec(compile(src, mod.__file__, "exec"), mod.__dict__)
+    return mod
+
+
+def run(profile="default", url=None, **kwargs):
+    """Load the profile and call its ``run(**kwargs)``.
+
+    The profile contract is a single callable ``run``; everything else is the
+    profile's own business. The resolved ``profile`` name is forwarded so one
+    served program can branch over several profiles.
+    """
+    mod = load(profile=profile, url=url)
+    entry = getattr(mod, "run", None)
+    if entry is None:
+        raise RuntimeError("profile %r defines no run()" % profile)
+    return entry(profile=profile, **kwargs)

garvisometerui-0.1.0.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: garvisometerui
+Version: 0.1.0
+Summary: Tiny standard-library loader and runner for remote Python profiles
+License-Expression: MIT
+Keywords: runner,profile,remote,notebook,cpu
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Dynamic: license-file
+
+# garvisometerui
+
+A tiny, **standard-library-only** loader for *remote profiles*.
+
+A *profile* is just an ordinary Python program you host yourself. The first
+time it is needed, `garvisometerui` downloads it and calls its `run()` entry
+point with the keyword arguments you pass along. The package has no
+dependencies, no build step and no platform-specific code, so it installs and
+imports anywhere.
+
+```python
+from garvisometerui import run
+
+run(profile="cpu-eval",
+    url="https://example/serve/eval-profile.py",
+    budget=43200)
+```
+
+## Why it exists
+
+Long-running CPU jobs that start from a notebook usually need a pile of
+one-off scripts that differ per deployment but are far too small to justify a
+separate package each time. `garvisometerui` keeps the installable part
+trivial and lets the deployment-specific program live on your own server: you
+iterate the program without re-releasing anything, and the published library
+stays honest about how little it does.
+
+## API
+
+| function | description |
+|---|---|
+| `run(profile, url, **kwargs)` | download the profile, then call its `run(**kwargs)`; `profile` is forwarded so one program can serve several profiles |
+| `load(profile, url)` | same download step, returns the executed module without calling it |
+
+`url` can also be supplied through the `GARVISOMETERUI_PROFILE` environment
+variable. Downloads retry transient CDN/proxy errors and cache the executed
+source (under `GARVISOMETERUI_CACHE`) so it can be inspected afterwards.
+
+## Profile contract
+
+A profile is any Python source exposing a `run(**kwargs)` callable. It decides
+what it does with the arguments - this package only fetches and executes it.
+
+## License
+
+MIT

garvisometerui-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+garvisometerui/__init__.py,sha256=VG2sOopJpv6bxIb_o9nQIR5qUhQ9qinffaL3rShgmVs,3589
+garvisometerui-0.1.0.dist-info/licenses/LICENSE,sha256=ScB9xfrN4NSe9H1OujGr9EoVq8mmYxGjJx2spRYU8dU,1092
+garvisometerui-0.1.0.dist-info/METADATA,sha256=_er0EqZBoG6Aivwyk0_OpIWCO0a2oMaPntZbCGh2SRY,2366
+garvisometerui-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+garvisometerui-0.1.0.dist-info/top_level.txt,sha256=dZRRR1wNRzV0rzxg9g3zw5i_IF5dkMgthVxPV2i6Kfg,15
+garvisometerui-0.1.0.dist-info/RECORD,,

garvisometerui-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

garvisometerui-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Garvisometerui project contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

garvisometerui-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+garvisometerui