Merge pull request #184 from pyscript/2025-7-1

ntoll · web-flow · commit 99d9e3f1c01e · 2025-07-01T13:44:37.000+01:00
Bump docs to version 2025-7-1
diff --git a/docs/beginning-pyscript.md b/docs/beginning-pyscript.md
@@ -117,8 +117,8 @@ module in the document's `<head>` tag:
       <meta charset="utf-8" />
       <meta name="viewport" content="width=device-width,initial-scale=1" />
       <title>🦜 Polyglot - Piratical PyScript</title>
-      <link rel="stylesheet" href="https://pyscript.net/releases/2025.5.1/core.css">
-      <script type="module" src="https://pyscript.net/releases/2025.5.1/core.js"></script>
+      <link rel="stylesheet" href="https://pyscript.net/releases/2025.7.1/core.css">
+      <script type="module" src="https://pyscript.net/releases/2025.7.1/core.js"></script>
   </head>
   <body>
 
@@ -168,8 +168,8 @@ In the end, our HTML should look like this:
       <meta charset="utf-8" />
       <meta name="viewport" content="width=device-width,initial-scale=1" />
       <title>🦜 Polyglot - Piratical PyScript</title>
-      <link rel="stylesheet" href="https://pyscript.net/releases/2025.5.1/core.css">
-      <script type="module" src="https://pyscript.net/releases/2025.5.1/core.js"></script>
+      <link rel="stylesheet" href="https://pyscript.net/releases/2025.7.1/core.css">
+      <script type="module" src="https://pyscript.net/releases/2025.7.1/core.js"></script>
   </head>
   <body>
     <h1>Polyglot 🦜 💬 🇬🇧 ➡️ 🏴‍☠️</h1>
diff --git a/docs/user-guide/configuration.md b/docs/user-guide/configuration.md
@@ -318,6 +318,22 @@ following valid forms:
 * An arbitrary URL to a Python package: `"https://.../package.whl"`
 * A file copied onto the browser based file system: `"emfs://.../package.whl"`
 
+#### Package Cache
+
+For performance reasons, PyScript caches packages so that a delay resulting
+from downloading the packages is only noticable on first load - after which,
+PyScript will fall back on packages previously downloaded and held in the
+browser's local cache.
+
+The behaviour of caching can be configured via the `packages_cache` setting. If
+this setting is not used, PyScript will cache packages. Otherwise, override
+PyScript's behaviour by setting `packages_cache` to one of these two values:
+
+* `never` - PyScript will not cache packages.
+* `passthrough` - this only works with Pyodide (see [this wiki](https://deepwiki.com/cloudflare/pyodide/3-package-system)),
+  and will cause Pyodide to download packages in a parallel manner rather than
+  the default linear fashion. However, these packages will not be cached.
+
 ### Plugins
 
 The `plugins` option allows user to either augment, or exclude, the list of
@@ -518,6 +534,32 @@ experimental_create_proxy = "auto"
     [raise an issue](https://github.com/pyscript/pyscript/issues) with a
     reproducable example, and we'll investigate.
 
+### experimental_ffi_timeout
+
+When bootstrapping a worker, the worker is told to use a cache for round-trip
+operations (for example, `window.my_object.foo.bar.baz` causes a round-trip to
+the main thread for each dot `.` in this chain of references). By caching the
+dotted references performance can be improved by reducing the number of
+round trips PyScript makes.
+
+However, not everything can be cached (those APIs or objects with side-effects
+won't work; for example DOM element based APIs etc).
+
+The `experimental_ffi_timeout` setting defines the maximum lifetime of that
+cache. If it's less than 0 (the default), there is no cache whatsoever. Zero
+means to clean up the cache on the next iteration of the event loop. A positive
+number is the maximum number of milliseconds the cache will be kept alive.
+
+In this experimental phase, we suggest trying `0`, `30` or a value that won't
+likely bypass the browser rendering of 60fps. Of course, `1000` (i.e. a second)
+would be a fun, if greedy, experiment.
+
+### debug
+
+When using Pyodide, if the `debug` setting is set to `true`, then Pyodide will
+run in debug mode. See Pyodide's documentation for details of what this
+entails.
+
 ### Custom 
 
 Sometimes plugins or apps need bespoke configuration options.
diff --git a/docs/user-guide/first-steps.md b/docs/user-guide/first-steps.md
@@ -20,9 +20,9 @@ CSS:
         <meta charset="UTF-8">
         <meta name="viewport" content="width=device-width,initial-scale=1.0">
         <!-- PyScript CSS -->
-        <link rel="stylesheet" href="https://pyscript.net/releases/2025.5.1/core.css">
+        <link rel="stylesheet" href="https://pyscript.net/releases/2025.7.1/core.css">
         <!-- This script tag bootstraps PyScript -->
-        <script type="module" src="https://pyscript.net/releases/2025.5.1/core.js"></script>
+        <script type="module" src="https://pyscript.net/releases/2025.7.1/core.js"></script>
     </head>
     <body>
         <!-- your code goes here... -->
diff --git a/docs/user-guide/plugins.md b/docs/user-guide/plugins.md
@@ -100,7 +100,7 @@ For example, this will work because all references are contained within the
 registered function:
 
 ```js
-import { hooks } from "https://pyscript.net/releases/2025.5.1/core.js";
+import { hooks } from "https://pyscript.net/releases/2025.7.1/core.js";
 
 hooks.worker.onReady.add(() => {
     // NOT suggested, just an example!
@@ -114,7 +114,7 @@ hooks.worker.onReady.add(() => {
 However, due to the outer reference to the variable `i`, this will fail:
 
 ```js
-import { hooks } from "https://pyscript.net/releases/2025.5.1/core.js";
+import { hooks } from "https://pyscript.net/releases/2025.7.1/core.js";
 
 // NO NO NO NO NO! ☠️
 let i = 0;
@@ -147,7 +147,7 @@ the page.
 
 ```js title="log.js - a plugin that simply logs to the console."
 // import the hooks from PyScript first...
-import { hooks } from "https://pyscript.net/releases/2025.5.1/core.js";
+import { hooks } from "https://pyscript.net/releases/2025.7.1/core.js";
 
 // The `hooks.main` attribute defines plugins that run on the main thread.
 hooks.main.onReady.add((wrap, element) => {
@@ -197,8 +197,8 @@ hooks.worker.onAfterRun.add(() => {
         <!-- JS plugins should be available before PyScript bootstraps -->
         <script type="module" src="./log.js"></script>
         <!-- PyScript -->
-        <link rel="stylesheet" href="https://pyscript.net/releases/2025.5.1/core.css">
-        <script type="module" src="https://pyscript.net/releases/2025.5.1/core.js"></script>
+        <link rel="stylesheet" href="https://pyscript.net/releases/2025.7.1/core.css">
+        <script type="module" src="https://pyscript.net/releases/2025.7.1/core.js"></script>
     </head>
     <body>
         <script type="mpy">
diff --git a/docs/user-guide/pygame-ce.md b/docs/user-guide/pygame-ce.md
@@ -106,8 +106,8 @@ will be placed. Make sure to update the pyscript release to the latest version.
   <title>PyScript Pygame-CE Quickstart</title>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width,initial-scale=1.0">
-  <link rel="stylesheet" href="https://pyscript.net/releases/2025.5.1/core.css">
-  <script type="module" src="https://pyscript.net/releases/2025.5.1/core.js"></script>
+  <link rel="stylesheet" href="https://pyscript.net/releases/2025.7.1/core.css">
+  <script type="module" src="https://pyscript.net/releases/2025.7.1/core.js"></script>
 </head>
 <body>
 <canvas id="canvas" style="image-rendering: pixelated"></canvas>
diff --git a/docs/user-guide/workers.md b/docs/user-guide/workers.md
@@ -282,9 +282,9 @@ Here's how:
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
     <!-- PyScript CSS -->
-    <link rel="stylesheet" href="https://pyscript.net/releases/2025.5.1/core.css">
+    <link rel="stylesheet" href="https://pyscript.net/releases/2025.7.1/core.css">
     <!-- This script tag bootstraps PyScript -->
-    <script type="module" src="https://pyscript.net/releases/2025.5.1/core.js"></script>
+    <script type="module" src="https://pyscript.net/releases/2025.7.1/core.js"></script>
     <title>PyWorker - mpy bootstrapping pyodide example</title>
     <script type="mpy" src="main.py"></script>
   </head>
diff --git a/version.json b/version.json
@@ -1,3 +1,3 @@
 {
-    "version": "2025.5.1"
+    "version": "2025.7.1"
 }

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- "version": "2025.5.1"`
	`2`	`+ "version": "2025.7.1"`
`3`	`3`	`}`