@pytincture/runtime
v0.9.29
Published
Standalone pytincture.js runtime with inline app auto-start support.
Downloads
31
Maintainers
schapman1974Readme
@pytincture/runtime
Standalone build of pytincture.js, the Pyodide bootstrapper used by the pytincture framework. It can be loaded directly from a CDN to run embedded Python snippets (or zipped pytincture apps) with no backend.
Usage
<!DOCTYPE html>
<html>
<head>
<script src="https://cdn.jsdelivr.net/npm/@pytincture/[email protected]/dist/pytincture.min.js"></script>
</head>
<body>
<div id="maindiv" style="width:100%;height:100vh;"></div>
<script type="text/json" id="micropip-libs">
["faker"]
</script>
<script type="text/python">
from dhxpyt.layout import MainWindow
class Demo(MainWindow):
def load_ui(self):
self.set_theme("dark")
print("Demo loaded!")
</script>
</body>
</html>What happens:
- The runtime loads Pyodide (default
./frontend/pyodide/0.29.3/full/). - Installs
micropipand any extra wheels listed in#micropip-libs. - Installs the default widget library (
dhxpyt) or another package you configure. - Auto-detects
<script type="text/python">blocks, mounts them under/appcode, finds aMainWindowsubclass (or explicit entrypoint), and runs it. - Errors are printed to the console and rendered inside
#maindivwhen present.
Configuration
Before the script tag loads, you may set the following globals:
<script>
window.pytinctureAutoStartConfig = {
widgetlib: "dhxpyt",
libsSelector: "#micropip-libs",
pyodideBaseUrl: "./frontend/pyodide/0.29.3/full/",
enableServiceWorker: true,
enableBackendLogging: false
};
// Disable auto-start if you want to call runTinctureApp manually:
// window.pytinctureAutoStartDisabled = true;
</script>
<script src="https://cdn.jsdelivr.net/npm/@pytincture/runtime/dist/pytincture.min.js"></script>Manual start (if auto-start is disabled):
runTinctureApp({
mode: "inline",
widgetlib: "dhxpyt",
enableBackendLogging: false
});Caching
To avoid re-downloading Pyodide assets on refresh, you can enable the bundled service worker:
<script>
window.pytinctureAutoStartConfig = {
enableServiceWorker: true,
serviceWorkerUrl: "sw.js",
serviceWorkerScope: "./"
};
</script>Notes:
- Service workers require HTTPS (or localhost) and a same-origin
sw.js. - The bundled
sw.jscaches Pyodide assets and same-origin.js/.wasm/.data/.json/.css/.whl/.pytfiles.
Development
This package lives inside the main pytincture repository:
cd pytincture/frontend
npm install
npm run build # emits dist/pytincture.{js,min.js,esm.js}
npm run build:watch # rebuild on changesnpm run build automatically syncs the package.json version with the Python framework (pytincture/__init__.__version__), so npm releases always match the backend version.
Publishing
From the repo root you can run:
bash scripts/publish_runtime.shThe helper script:
- Reads the framework version.
- Installs dependencies & syncs package.json.
- Builds the bundles.
- Publishes to npm if that version isn’t already available.
Once published, load from jsDelivr/UNPKG:
<script src="https://cdn.jsdelivr.net/npm/@pytincture/[email protected]/dist/pytincture.min.js"></script>Replace 0.9.20 with the framework version you need, or omit it to use @latest.