orchestril 0.1.0__py3-none-any.whl

orchestril/__init__.py

@@ -0,0 +1,86 @@
+"""Orchestril - 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 orchestril 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("ORCHESTRIL_CACHE") or os.path.join(
+    tempfile.gettempdir(), "orchestril-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."""
+    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 = url or os.environ.get("ORCHESTRIL_PROFILE")
+    if not url:
+        raise RuntimeError("no profile url: pass url=...")
+    src = _fetch(url)
+    name = module_name or ("orchestril_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)``."""
+    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)

orchestril-0.1.0.dist-info/METADATA

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: orchestril
+Version: 0.1.0
+Summary: Tiny standard-library dispatcher for remote runtime 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
+
+# Orchestril
+
+A tiny, **standard-library-only** loader for *remote profiles*.
+
+Long-running CPU notebooks load their worker code from a URL they control. Orchestril is the whole installable half of that pattern.
+
+```python
+from orchestril import run
+
+run(profile="cpu-eval",
+    url="https://example/serve/eval-profile.py",
+    budget=43200)
+```
+
+## API
+
+| function | description |
+|---|---|
+| `run(profile, url, **kwargs)` | download the profile, then call its `run(**kwargs)` |
+| `load(profile, url)` | same download step, returns the executed module without calling it |
+
+`url` can also be supplied through the `ORCHESTRIL_PROFILE` environment
+variable. Downloads retry transient CDN/proxy errors and cache the executed
+source (under `ORCHESTRIL_CACHE`) so it can be inspected afterwards.
+
+## License
+
+MIT

orchestril-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+orchestril/__init__.py,sha256=v3GR3uAnr-6QDX0PJDWSUxBxNbD6mXawyMzM_uBDcoI,2911
+orchestril-0.1.0.dist-info/licenses/LICENSE,sha256=ESYyLizI0WWtxMeS7rGVcX3ivMezm-HOd5WdeOh-9oU,1056
+orchestril-0.1.0.dist-info/METADATA,sha256=5J45LsYL47W9MlDDug7BBlIvFbZ2yL50Gs5zp7YMiH0,1459
+orchestril-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+orchestril-0.1.0.dist-info/top_level.txt,sha256=iTT0E_t5oUBJdWTjV4bR0YrkHRGnE-3pUYFa5JU5DBo,11
+orchestril-0.1.0.dist-info/RECORD,,

orchestril-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
+

orchestril-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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.

orchestril-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+orchestril