pyodide 0.24.1 → 0.25.0-alpha.2

package/README.md

@@ -50,30 +50,6 @@ undefined
 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 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:

package/console.html

@@ -90,6 +90,8 @@
           }
         }
         const { loadPyodide } = await import(indexURL + "pyodide.mjs");
+        // to facilitate debugging
+        globalThis.loadPyodide = loadPyodide;
 
         let term;
         globalThis.pyodide = await loadPyodide({

package/ffi.d.ts

@@ -1,4 +1,4 @@
-// Generated by dts-bundle-generator v6.13.0
+// Generated by dts-bundle-generator v8.1.1
 
 interface PyProxy {
 	[x: string]: any;
@@ -13,11 +13,10 @@ declare class PyProxy {
 	/** @private */
 	static [Symbol.hasInstance](obj: any): obj is PyProxy;
 	/**
-	 * @private
 	 * @hideconstructor
 	 */
 	constructor();
-	/** @private */
+	/** @hidden */
 	get [Symbol.toStringTag](): string;
 	/**
 	 * The name of the type of the object.
@@ -35,6 +34,10 @@ declare class PyProxy {
 	 *
 	 */
 	get type(): string;
+	/**
+	 * Returns `str(o)` (unless `pyproxyToStringRepr: true` was passed to
+	 * :js:func:`loadPyodide` in which case it will return `repr(o)`)
+	 */
 	toString(): string;
 	/**
 	 * Destroy the :js:class:`~pyodide.ffi.PyProxy`. This will release the memory. Any further attempt
@@ -413,6 +416,10 @@ declare class PyAsyncGeneratorMethods {
 	 */
 	return(v: any): Promise<IteratorResult<any, any>>;
 }
+/**
+ * A :js:class:`~pyodide.ffi.PyProxy` whose proxied Python object is an
+ * :py:class:`~collections.abc.Sequence` (i.e., a :py:class:`list`)
+ */
 declare class PySequence extends PyProxy {
 	/** @private */
 	static [Symbol.hasInstance](obj: any): obj is PyProxy;
@@ -420,6 +427,7 @@ declare class PySequence extends PyProxy {
 interface PySequence extends PySequenceMethods {
 }
 declare class PySequenceMethods {
+	/** @hidden */
 	get [Symbol.isConcatSpreadable](): boolean;
 	/**
 	 * See :js:meth:`Array.join`. The :js:meth:`Array.join` method creates and
@@ -477,7 +485,7 @@ declare class PySequenceMethods {
 	 * return value is added as a single element in the new array.
 	 * @param thisArg A value to use as ``this`` when executing ``callbackFn``.
 	 */
-	map(callbackfn: (elt: any, index: number, array: any) => void, thisArg?: any): unknown[];
+	map<U>(callbackfn: (elt: any, index: number, array: any) => U, thisArg?: any): U[];
 	/**
 	 * See :js:meth:`Array.filter`. Creates a shallow copy of a portion of a given
 	 * ``Sequence``, filtered down to just the elements from the given array that pass
@@ -594,6 +602,10 @@ declare class PySequenceMethods {
 	 */
 	findIndex(predicate: (value: any, index: number, obj: any[]) => any, thisArg?: any): number;
 }
+/**
+ * A :js:class:`~pyodide.ffi.PyProxy` whose proxied Python object is an
+ * :py:class:`~collections.abc.MutableSequence` (i.e., a :py:class:`list`)
+ */
 declare class PyMutableSequence extends PyProxy {
 	/** @private */
 	static [Symbol.hasInstance](obj: any): obj is PyProxy;
@@ -602,68 +614,68 @@ interface PyMutableSequence extends PyMutableSequenceMethods {
 }
 declare class PyMutableSequenceMethods {
 	/**
-	 * The :js:meth:`Array.reverse` method reverses a ``MutableSequence`` in
+	 * The :js:meth:`Array.reverse` method reverses a :js:class:`PyMutableSequence` in
 	 * place.
-	 * @returns A reference to the same ``MutableSequence``
+	 * @returns A reference to the same :js:class:`PyMutableSequence`
 	 */
-	reverse(): this;
+	reverse(): PyMutableSequence;
 	/**
 	 * The :js:meth:`Array.sort` method sorts the elements of a
-	 * ``MutableSequence`` in place.
+	 * :js:class:`PyMutableSequence` in place.
 	 * @param compareFn A function that defines the sort order.
-	 * @returns A reference to the same ``MutableSequence``
+	 * @returns A reference to the same :js:class:`PyMutableSequence`
 	 */
-	sort(compareFn?: (a: any, b: any) => number): this;
+	sort(compareFn?: (a: any, b: any) => number): PyMutableSequence;
 	/**
 	 * The :js:meth:`Array.splice` method changes the contents of a
-	 * ``MutableSequence`` by removing or replacing existing elements and/or
+	 * :js:class:`PyMutableSequence` by removing or replacing existing elements and/or
 	 * adding new elements in place.
 	 * @param start Zero-based index at which to start changing the
-	 * ``MutableSequence``.
+	 * :js:class:`PyMutableSequence`.
 	 * @param deleteCount An integer indicating the number of elements in the
-	 * ``MutableSequence`` to remove from ``start``.
-	 * @param items The elements to add to the ``MutableSequence``, beginning from
+	 * :js:class:`PyMutableSequence` to remove from ``start``.
+	 * @param items The elements to add to the :js:class:`PyMutableSequence`, beginning from
 	 * ``start``.
 	 * @returns An array containing the deleted elements.
 	 */
-	splice(start: number, deleteCount?: number, ...items: any[]): void;
+	splice(start: number, deleteCount?: number, ...items: any[]): any[];
 	/**
 	 * The :js:meth:`Array.push` method adds the specified elements to the end of
-	 * a ``MutableSequence``.
-	 * @param elts The element(s) to add to the end of the ``MutableSequence``.
+	 * a :js:class:`PyMutableSequence`.
+	 * @param elts The element(s) to add to the end of the :js:class:`PyMutableSequence`.
 	 * @returns The new length property of the object upon which the method was
 	 * called.
 	 */
 	push(...elts: any[]): any;
 	/**
 	 * The :js:meth:`Array.pop` method removes the last element from a
-	 * ``MutableSequence``.
-	 * @returns The removed element from the ``MutableSequence``; undefined if the
-	 * ``MutableSequence`` is empty.
+	 * :js:class:`PyMutableSequence`.
+	 * @returns The removed element from the :js:class:`PyMutableSequence`; undefined if the
+	 * :js:class:`PyMutableSequence` is empty.
 	 */
-	pop(): void;
+	pop(): any;
 	/**
 	 * The :js:meth:`Array.shift` method removes the first element from a
-	 * ``MutableSequence``.
-	 * @returns The removed element from the ``MutableSequence``; undefined if the
-	 * ``MutableSequence`` is empty.
+	 * :js:class:`PyMutableSequence`.
+	 * @returns The removed element from the :js:class:`PyMutableSequence`; undefined if the
+	 * :js:class:`PyMutableSequence` is empty.
 	 */
-	shift(): void;
+	shift(): any;
 	/**
 	 * The :js:meth:`Array.unshift` method adds the specified elements to the
-	 * beginning of a ``MutableSequence``.
-	 * @param elts The elements to add to the front of the ``MutableSequence``.
-	 * @returns The new length of the ``MutableSequence``.
+	 * beginning of a :js:class:`PyMutableSequence`.
+	 * @param elts The elements to add to the front of the :js:class:`PyMutableSequence`.
+	 * @returns The new length of the :js:class:`PyMutableSequence`.
 	 */
 	unshift(...elts: any[]): any;
 	/**
 	 * The :js:meth:`Array.copyWithin` method shallow copies part of a
-	 * ``MutableSequence`` to another location in the same ``MutableSequence``
+	 * :js:class:`PyMutableSequence` to another location in the same :js:class:`PyMutableSequence`
 	 * without modifying its length.
 	 * @param target Zero-based index at which to copy the sequence to.
 	 * @param start Zero-based index at which to start copying elements from.
 	 * @param end Zero-based index at which to end copying elements from.
-	 * @returns The modified ``MutableSequence``.
+	 * @returns The modified :js:class:`PyMutableSequence`.
 	 */
 	copyWithin(target: number, start?: number, end?: number): any;
 	/**
@@ -689,7 +701,7 @@ interface PyAwaitable extends Promise<any> {
 }
 /**
  * A :js:class:`~pyodide.ffi.PyProxy` whose proxied Python object is
- * :std:term:`callable` (i.e., has an :py:meth:`~operator.__call__` method).
+ * :std:term:`callable` (i.e., has an :py:meth:`~object.__call__` method).
  */
 declare class PyCallable extends PyProxy {
 	/** @private */
@@ -729,6 +741,7 @@ declare class PyCallableMethods {
 	 * object with the keyword arguments.
 	 */
 	callKwargs(...jsargs: any): any;
+	callSyncifying(...jsargs: any): Promise<any>;
 	/**
 	 * The ``bind()`` method creates a new function that, when called, has its
 	 * ``this`` keyword set to the provided value, with a given sequence of
@@ -819,7 +832,6 @@ declare class PyBufferMethods {
 	 */
 	getBuffer(type?: string): PyBufferView;
 }
-export declare type TypedArray = Int8Array | Uint8Array | Int16Array | Uint16Array | Int32Array | Uint32Array | Uint8ClampedArray | Float32Array | Float64Array;
 /**
  * A :js:class:`~pyodide.ffi.PyProxy` whose proxied Python object is a :py:class:`dict`.
  */
@@ -960,9 +972,7 @@ declare class PyBufferView {
 	 * Is it Fortran contiguous? See :py:attr:`memoryview.f_contiguous`.
 	 */
 	f_contiguous: boolean;
-	/** @private */
 	_released: boolean;
-	/** @private */
 	_view_ptr: number;
 	/** @private */
 	constructor();
@@ -971,10 +981,11 @@ declare class PyBufferView {
 	 */
 	release(): void;
 }
+export type TypedArray = Int8Array | Uint8Array | Int16Array | Uint16Array | Int32Array | Uint32Array | Uint8ClampedArray | Float32Array | Float64Array;
 /**
  * A JavaScript error caused by a Python exception.
  *
- * In order to reduce the risk of large memory leaks, the :py:exc:`PythonError`
+ * In order to reduce the risk of large memory leaks, the :js:class:`PythonError`
  * contains no reference to the Python exception that caused it. You can find
  * the actual Python exception that caused this error as
  * :py:data:`sys.last_value`.
@@ -1037,4 +1048,4 @@ declare const ffi: {
 };
 
 export type {};
-export type {PyAsyncGenerator, PyAsyncIterable, PyAsyncIterator, PyAwaitable, PyBuffer, PyBufferView, PyCallable, PyDict, PyGenerator, PyIterable, PyIterator, PyProxy, PyProxyWithGet, PyProxyWithHas, PyProxyWithLength, PyProxyWithSet, PythonError};
+export type {PyAsyncGenerator, PyAsyncIterable, PyAsyncIterator, PyAwaitable, PyBuffer, PyBufferView, PyCallable, PyDict, PyGenerator, PyIterable, PyIterator, PyMutableSequence, PyProxy, PyProxyWithGet, PyProxyWithHas, PyProxyWithLength, PyProxyWithSet, PySequence, PythonError};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pyodide",
-  "version": "0.24.1",
+  "version": "0.25.0-alpha.2",
   "description": "The Pyodide JavaScript package",
   "keywords": [
     "python",
@@ -17,15 +17,14 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "@types/assert": "^1.5.6",
-    "@types/emscripten": "^1.39.5",
     "@types/expect": "^24.3.0",
     "@types/mocha": "^9.1.0",
-    "@types/node": "^17.0.25",
+    "@types/node": "^20.8.4",
     "@types/ws": "^8.5.3",
     "chai": "^4.3.6",
     "chai-as-promised": "^7.1.1",
     "cross-env": "^7.0.3",
-    "dts-bundle-generator": "^6.7.0",
+    "dts-bundle-generator": "^8.1.1",
     "error-stack-parser": "^2.1.4",
     "esbuild": "^0.17.12",
     "express": "^4.17.3",
@@ -35,8 +34,9 @@
     "prettier": "^2.2.1",
     "ts-mocha": "^9.0.2",
     "tsd": "^0.24.1",
-    "typedoc": "^0.22.15",
-    "typescript": "^4.6.4"
+    "typedoc": "^0.25.1",
+    "typescript": "^4.6.4",
+    "wabt": "^1.0.32"
   },
   "main": "pyodide.js",
   "exports": {
@@ -45,6 +45,9 @@
       "import": "./pyodide.mjs",
       "types": "./pyodide.d.ts"
     },
+    "./ffi": {
+      "types": "./ffi.d.ts"
+    },
     "./pyodide.asm.wasm": "./pyodide.asm.wasm",
     "./pyodide.asm.js": "./pyodide.asm.js",
     "./python_stdlib.zip": "./python_stdlib.zip",
@@ -76,8 +79,9 @@
     "ws": false
   },
   "scripts": {
+    "build": "tsc --noEmit && node esbuild.config.mjs",
     "test": "npm-run-all test:*",
-    "test:unit": "cross-env TEST_NODE=1 ts-mocha -p tsconfig.test.json test/unit/**/*.test.ts",
+    "test:unit": "cross-env TEST_NODE=1 ts-mocha --node-option=experimental-loader=./test/loader.mjs --node-option=experimental-wasm-stack-switching -p tsconfig.test.json test/unit/**/*.test.*",
     "test:node": "cross-env TEST_NODE=1 mocha test/integration/**/*.test.js",
     "test:browser": "mocha test/integration/**/*.test.js",
     "tsc": "tsc --noEmit",
@@ -94,9 +98,6 @@
       "pyodide",
       "page",
       "chai"
-    ],
-    "file": [
-      "test/conftest.js"
     ]
   },
   "nyc": {