pyodide 0.21.0-alpha.1 → 0.21.0

package/README.md

@@ -0,0 +1,93 @@
+# Pyodide JavaScript package
+
+<a href="https://www.npmjs.com/package/pyodide"><img src="https://img.shields.io/npm/v/pyodide" alt="npm"></a>
+
+## Usage
+
+Download and extract Pyodide packages from [Github
+releases](https://github.com/pyodide/pyodide/releases)
+(`pyodide-build-*.tar.bz2`). The version of the release needs to match exactly the version of this package.
+
+Then you can load Pyodide in Node.js as follows,
+
+```js
+// hello_python.js
+const { loadPyodide } = require("pyodide");
+
+async function hello_python() {
+  let pyodide = await loadPyodide({
+    indexURL: "<pyodide artifacts folder>",
+  });
+  return pyodide.runPythonAsync("1+1");
+}
+
+hello_python().then((result) => {
+  console.log("Python says that 1+1 =", result);
+});
+```
+
+```
+$ node hello_python.js
+Loading distutils
+Loaded distutils
+Python initialization complete
+Python says that 1+1= 2
+```
+
+Or you can use the REPL. To start the Node.js REPL with support for top level
+await, use `node --experimental-repl-await`:
+
+```
+$ node --experimental-repl-await
+Welcome to Node.js v18.5.0.
+Type ".help" for more information.
+> const { loadPyodide } = require("pyodide");
+undefined
+> let pyodide = await loadPyodide();
+Loading distutils
+Loaded distutils
+Python initialization complete
+undefined
+> await pyodide.runPythonAsync("1+1");
+2
+```
+
+### Node.js versions <0.17
+
+- `Node.js` versions 14.x and 16.x: to use certain features of Pyodide you
+  need to manually install `node-fetch`, e.g. by doing `npm install node-fetch`.
+
+- `Node.js v14.x`: you need to pass the option `--experimental-wasm-bigint`
+  when starting Node. Note that this flag is not documented by `node --help`
+  and moreover, if you pass `--experimental-wasm-bigint` to node >14 it is an
+  error:
+
+```
+$ node -v
+v14.20.0
+
+$ node --experimental-wasm-bigint hello_python.js
+warning: no blob constructor, cannot create blobs with mimetypes
+warning: no BlobBuilder
+Loading distutils
+Loaded distutils
+Python initialization complete
+Python says that 1+1= 2
+```
+
+See the [documentation](https://pyodide.org/en/stable/) fore more details.
+
+## Details
+
+The JavaScript code in this package is responsible for the following tasks:
+
+1. Defines the public [JavaScript API](https://pyodide.org/en/stable/usage/api/js-api.html)
+   - Package loading code to allow loading of other Python packages.
+   - Can load
+     [micropip](https://pyodide.org/en/stable/usage/api/micropip-api.html) to
+     bootstrap loading of pure Python wheels
+2. Loads the CPython interpreter and the core/pyodide emscripten application
+   which embeds the interpreter.
+3. Injects the `js/pyodide` JavaScript API into `sys.modules`. This is the
+   final runtime dependency for `core/pyodide` & `py/pyodide`, so after this step
+   the interpreter is fully up and running.

package/console.html

@@ -84,7 +84,7 @@
         pyodide.runPython(
           `
             import sys
-            from pyodide import to_js
+            from pyodide.ffi import to_js
             from pyodide.console import PyodideConsole, repr_shorten, BANNER
             import __main__
             BANNER = "Welcome to the Pyodide terminal emulator 🐍\\n" + BANNER
@@ -107,7 +107,9 @@
         let clear_console = namespace.get("clear_console");
         const echo = (msg, ...opts) =>
           term.echo(
-            msg.replace("]]", "]]").replace("[[", "[["),
+            msg
+              .replaceAll("]]", "]]")
+              .replaceAll("[[", "[["),
             ...opts
           );
         namespace.destroy();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pyodide",
-  "version": "0.21.0-alpha.1",
+  "version": "0.21.0",
   "description": "The Pyodide JavaScript package",
   "keywords": [
     "python",
@@ -29,7 +29,7 @@
     "chai-as-promised": "^7.1.1",
     "cross-env": "^7.0.3",
     "dts-bundle-generator": "^6.7.0",
-    "error-stack-parser": "^2.0.6",
+    "error-stack-parser": "^2.1.4",
     "express": "^4.17.3",
     "mocha": "^9.0.2",
     "npm-run-all": "^4.1.5",
@@ -53,11 +53,12 @@
     },
     "./pyodide.mjs": "./pyodide.mjs",
     "./pyodide.js": "./pyodide.js",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./repodata.json": "./repodata.json"
   },
   "files": [
     "pyodide*",
-    "packages.json",
+    "repodata.json",
     "distutils.tar",
     "console.html"
   ],