123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476 |
- // Generated by dts-bundle-generator v8.1.1
- /**
- *
- * The Pyodide version.
- *
- * The version here is a Python version, following :pep:`440`. This is different
- * from the version in ``package.json`` which follows the node package manager
- * version convention.
- */
- export declare const version: string;
- /** @deprecated Use `import type { PyProxy } from "pyodide/ffi"` instead */
- interface PyProxy {
- [x: string]: any;
- }
- declare class PyProxy {
- /** @private */
- $$flags: number;
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- /**
- * @hideconstructor
- */
- constructor();
- /** @hidden */
- get [Symbol.toStringTag](): string;
- /**
- * The name of the type of the object.
- *
- * Usually the value is ``"module.name"`` but for builtins or
- * interpreter-defined types it is just ``"name"``. As pseudocode this is:
- *
- * .. code-block:: python
- *
- * ty = type(x)
- * if ty.__module__ == 'builtins' or ty.__module__ == "__main__":
- * return ty.__name__
- * else:
- * ty.__module__ + "." + ty.__name__
- *
- */
- 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
- * to use the object will raise an error.
- *
- * In a browser supporting :js:data:`FinalizationRegistry`, Pyodide will
- * automatically destroy the :js:class:`~pyodide.ffi.PyProxy` when it is garbage collected, however
- * there is no guarantee that the finalizer will be run in a timely manner so
- * it is better to destroy the proxy explicitly.
- *
- * @param options
- * @param options.message The error message to print if use is attempted after
- * destroying. Defaults to "Object has already been destroyed".
- *
- */
- destroy(options?: {
- message?: string;
- destroyRoundtrip?: boolean;
- }): void;
- /**
- * Make a new :js:class:`~pyodide.ffi.PyProxy` pointing to the same Python object.
- * Useful if the :js:class:`~pyodide.ffi.PyProxy` is destroyed somewhere else.
- */
- copy(): PyProxy;
- /**
- * Converts the :js:class:`~pyodide.ffi.PyProxy` into a JavaScript object as best as possible. By
- * default does a deep conversion, if a shallow conversion is desired, you can
- * use ``proxy.toJs({depth : 1})``. See :ref:`Explicit Conversion of PyProxy
- * <type-translations-pyproxy-to-js>` for more info.
- * @param options
- * @return The JavaScript object resulting from the conversion.
- */
- toJs({ depth, pyproxies, create_pyproxies, dict_converter, default_converter, }?: {
- /** How many layers deep to perform the conversion. Defaults to infinite */
- depth?: number;
- /**
- * If provided, :js:meth:`toJs` will store all PyProxies created in this
- * list. This allows you to easily destroy all the PyProxies by iterating
- * the list without having to recurse over the generated structure. The most
- * common use case is to create a new empty list, pass the list as
- * ``pyproxies``, and then later iterate over ``pyproxies`` to destroy all of
- * created proxies.
- */
- pyproxies?: PyProxy[];
- /**
- * If false, :js:meth:`toJs` will throw a
- * :py:exc:`~pyodide.ffi.ConversionError` rather than producing a
- * :js:class:`~pyodide.ffi.PyProxy`.
- */
- create_pyproxies?: boolean;
- /**
- * A function to be called on an iterable of pairs ``[key, value]``. Convert
- * this iterable of pairs to the desired output. For instance,
- * :js:func:`Object.fromEntries` would convert the dict to an object,
- * :js:func:`Array.from` converts it to an :js:class:`Array` of pairs, and
- * ``(it) => new Map(it)`` converts it to a :js:class:`Map` (which is the
- * default behavior).
- */
- dict_converter?: (array: Iterable<[
- key: string,
- value: any
- ]>) => any;
- /**
- * Optional argument to convert objects with no default conversion. See the
- * documentation of :meth:`~pyodide.ffi.to_js`.
- */
- default_converter?: (obj: PyProxy, convert: (obj: PyProxy) => any, cacheConversion: (obj: PyProxy, result: any) => void) => any;
- }): any;
- }
- declare class PyProxyWithLength extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PyProxyWithLength } from "pyodide/ffi"` instead */
- interface PyProxyWithLength extends PyLengthMethods {
- }
- declare class PyLengthMethods {
- /**
- * The length of the object.
- */
- get length(): number;
- }
- declare class PyProxyWithGet extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PyProxyWithGet } from "pyodide/ffi"` instead */
- interface PyProxyWithGet extends PyGetItemMethods {
- }
- declare class PyGetItemMethods {
- /**
- * This translates to the Python code ``obj[key]``.
- *
- * @param key The key to look up.
- * @returns The corresponding value.
- */
- get(key: any): any;
- }
- declare class PyProxyWithSet extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PyProxyWithSet } from "pyodide/ffi"` instead */
- interface PyProxyWithSet extends PySetItemMethods {
- }
- declare class PySetItemMethods {
- /**
- * This translates to the Python code ``obj[key] = value``.
- *
- * @param key The key to set.
- * @param value The value to set it to.
- */
- set(key: any, value: any): void;
- /**
- * This translates to the Python code ``del obj[key]``.
- *
- * @param key The key to delete.
- */
- delete(key: any): void;
- }
- declare class PyProxyWithHas extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PyProxyWithHas } from "pyodide/ffi"` instead */
- interface PyProxyWithHas extends PyContainsMethods {
- }
- declare class PyContainsMethods {
- /**
- * This translates to the Python code ``key in obj``.
- *
- * @param key The key to check for.
- * @returns Is ``key`` present?
- */
- has(key: any): boolean;
- }
- declare class PyIterable extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PyIterable } from "pyodide/ffi"` instead */
- interface PyIterable extends PyIterableMethods {
- }
- declare class PyIterableMethods {
- /**
- * This translates to the Python code ``iter(obj)``. Return an iterator
- * associated to the proxy. See the documentation for
- * :js:data:`Symbol.iterator`.
- *
- * This will be used implicitly by ``for(let x of proxy){}``.
- */
- [Symbol.iterator](): Iterator<any, any, any>;
- }
- declare class PyAsyncIterable extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PyAsyncIterable } from "pyodide/ffi"` instead */
- interface PyAsyncIterable extends PyAsyncIterableMethods {
- }
- declare class PyAsyncIterableMethods {
- /**
- * This translates to the Python code ``aiter(obj)``. Return an async iterator
- * associated to the proxy. See the documentation for :js:data:`Symbol.asyncIterator`.
- *
- * This will be used implicitly by ``for(await let x of proxy){}``.
- */
- [Symbol.asyncIterator](): AsyncIterator<any, any, any>;
- }
- declare class PyIterator extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PyIterator } from "pyodide/ffi"` instead */
- interface PyIterator extends PyIteratorMethods {
- }
- declare class PyIteratorMethods {
- /** @private */
- [Symbol.iterator](): this;
- /**
- * This translates to the Python code ``next(obj)``. Returns the next value of
- * the generator. See the documentation for :js:meth:`Generator.next` The
- * argument will be sent to the Python generator.
- *
- * This will be used implicitly by ``for(let x of proxy){}``.
- *
- * @param any The value to send to the generator. The value will be assigned
- * as a result of a yield expression.
- * @returns An Object with two properties: ``done`` and ``value``. When the
- * generator yields ``some_value``, ``next`` returns ``{done : false, value :
- * some_value}``. When the generator raises a :py:exc:`StopIteration`
- * exception, ``next`` returns ``{done : true, value : result_value}``.
- */
- next(arg?: any): IteratorResult<any, any>;
- }
- declare class PyGenerator extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PyGenerator } from "pyodide/ffi"` instead */
- interface PyGenerator extends PyGeneratorMethods {
- }
- declare class PyGeneratorMethods {
- /**
- * Throws an exception into the Generator.
- *
- * See the documentation for :js:meth:`Generator.throw`.
- *
- * @param exception Error The error to throw into the generator. Must be an
- * instanceof ``Error``.
- * @returns An Object with two properties: ``done`` and ``value``. When the
- * generator yields ``some_value``, ``return`` returns ``{done : false, value
- * : some_value}``. When the generator raises a
- * ``StopIteration(result_value)`` exception, ``return`` returns ``{done :
- * true, value : result_value}``.
- */
- throw(exc: any): IteratorResult<any, any>;
- /**
- * Throws a :py:exc:`GeneratorExit` into the generator and if the
- * :py:exc:`GeneratorExit` is not caught returns the argument value ``{done:
- * true, value: v}``. If the generator catches the :py:exc:`GeneratorExit` and
- * returns or yields another value the next value of the generator this is
- * returned in the normal way. If it throws some error other than
- * :py:exc:`GeneratorExit` or :py:exc:`StopIteration`, that error is propagated. See
- * the documentation for :js:meth:`Generator.return`.
- *
- * @param any The value to return from the generator.
- * @returns An Object with two properties: ``done`` and ``value``. When the
- * generator yields ``some_value``, ``return`` returns ``{done : false, value
- * : some_value}``. When the generator raises a
- * ``StopIteration(result_value)`` exception, ``return`` returns ``{done :
- * true, value : result_value}``.
- */
- return(v: any): IteratorResult<any, any>;
- }
- declare class PyAsyncIterator extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PyAsyncIterator } from "pyodide/ffi"` instead */
- interface PyAsyncIterator extends PyAsyncIteratorMethods {
- }
- declare class PyAsyncIteratorMethods {
- /** @private */
- [Symbol.asyncIterator](): this;
- /**
- * This translates to the Python code ``anext(obj)``. Returns the next value
- * of the asynchronous iterator. The argument will be sent to the Python
- * iterator (if it's a generator for instance).
- *
- * This will be used implicitly by ``for(let x of proxy){}``.
- *
- * @param any The value to send to a generator. The value will be assigned as
- * a result of a yield expression.
- * @returns An Object with two properties: ``done`` and ``value``. When the
- * iterator yields ``some_value``, ``next`` returns ``{done : false, value :
- * some_value}``. When the giterator is done, ``next`` returns
- * ``{done : true }``.
- */
- next(arg?: any): Promise<IteratorResult<any, any>>;
- }
- declare class PyAsyncGenerator extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PyAsyncGenerator } from "pyodide/ffi"` instead */
- interface PyAsyncGenerator extends PyAsyncGeneratorMethods {
- }
- declare class PyAsyncGeneratorMethods {
- /**
- * Throws an exception into the Generator.
- *
- * See the documentation for :js:meth:`AsyncGenerator.throw`.
- *
- * @param exception Error The error to throw into the generator. Must be an
- * instanceof ``Error``.
- * @returns An Object with two properties: ``done`` and ``value``. When the
- * generator yields ``some_value``, ``return`` returns ``{done : false, value
- * : some_value}``. When the generator raises a
- * ``StopIteration(result_value)`` exception, ``return`` returns ``{done :
- * true, value : result_value}``.
- */
- throw(exc: any): Promise<IteratorResult<any, any>>;
- /**
- * Throws a :py:exc:`GeneratorExit` into the generator and if the
- * :py:exc:`GeneratorExit` is not caught returns the argument value ``{done:
- * true, value: v}``. If the generator catches the :py:exc:`GeneratorExit` and
- * returns or yields another value the next value of the generator this is
- * returned in the normal way. If it throws some error other than
- * :py:exc:`GeneratorExit` or :py:exc:`StopAsyncIteration`, that error is
- * propagated. See the documentation for :js:meth:`AsyncGenerator.throw`
- *
- * @param any The value to return from the generator.
- * @returns An Object with two properties: ``done`` and ``value``. When the
- * generator yields ``some_value``, ``return`` returns ``{done : false, value
- * : some_value}``. When the generator raises a :py:exc:`StopAsyncIteration`
- * exception, ``return`` returns ``{done : true, value : result_value}``.
- */
- return(v: any): Promise<IteratorResult<any, any>>;
- }
- declare class PySequence extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PySequence } from "pyodide/ffi"` instead */
- 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
- * returns a new string by concatenating all of the elements in the
- * :py:class:`~collections.abc.Sequence`.
- *
- * @param separator A string to separate each pair of adjacent elements of the
- * Sequence.
- *
- * @returns A string with all Sequence elements joined.
- */
- join(separator?: string): string;
- /**
- * See :js:meth:`Array.slice`. The :js:meth:`Array.slice` method returns a
- * shallow copy of a portion of a :py:class:`~collections.abc.Sequence` into a
- * new array object selected from ``start`` to ``stop`` (`stop` not included)
- * @param start Zero-based index at which to start extraction. Negative index
- * counts back from the end of the Sequence.
- * @param stop Zero-based index at which to end extraction. Negative index
- * counts back from the end of the Sequence.
- * @returns A new array containing the extracted elements.
- */
- slice(start?: number, stop?: number): any;
- /**
- * See :js:meth:`Array.lastIndexOf`. Returns the last index at which a given
- * element can be found in the Sequence, or -1 if it is not present.
- * @param elt Element to locate in the Sequence.
- * @param fromIndex Zero-based index at which to start searching backwards,
- * converted to an integer. Negative index counts back from the end of the
- * Sequence.
- * @returns The last index of the element in the Sequence; -1 if not found.
- */
- lastIndexOf(elt: any, fromIndex?: number): number;
- /**
- * See :js:meth:`Array.indexOf`. Returns the first index at which a given
- * element can be found in the Sequence, or -1 if it is not present.
- * @param elt Element to locate in the Sequence.
- * @param fromIndex Zero-based index at which to start searching, converted to
- * an integer. Negative index counts back from the end of the Sequence.
- * @returns The first index of the element in the Sequence; -1 if not found.
- */
- indexOf(elt: any, fromIndex?: number): number;
- /**
- * See :js:meth:`Array.forEach`. Executes a provided function once for each
- * ``Sequence`` element.
- * @param callbackfn A function to execute for each element in the ``Sequence``. Its
- * return value is discarded.
- * @param thisArg A value to use as ``this`` when executing ``callbackFn``.
- */
- forEach(callbackfn: (elt: any) => void, thisArg?: any): void;
- /**
- * See :js:meth:`Array.map`. Creates a new array populated with the results of
- * calling a provided function on every element in the calling ``Sequence``.
- * @param callbackfn A function to execute for each element in the ``Sequence``. Its
- * return value is added as a single element in the new array.
- * @param thisArg A value to use as ``this`` when executing ``callbackFn``.
- */
- 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
- * the test implemented by the provided function.
- * @param callbackfn A function to execute for each element in the array. It
- * should return a truthy value to keep the element in the resulting array,
- * and a falsy value otherwise.
- * @param thisArg A value to use as ``this`` when executing ``predicate``.
- */
- filter(predicate: (elt: any, index: number, array: any) => boolean, thisArg?: any): any[];
- /**
- * See :js:meth:`Array.some`. Tests whether at least one element in the
- * ``Sequence`` passes the test implemented by the provided function.
- * @param callbackfn A function to execute for each element in the
- * ``Sequence``. It should return a truthy value to indicate the element
- * passes the test, and a falsy value otherwise.
- * @param thisArg A value to use as ``this`` when executing ``predicate``.
- */
- some(predicate: (value: any, index: number, array: any[]) => unknown, thisArg?: any): boolean;
- /**
- * See :js:meth:`Array.every`. Tests whether every element in the ``Sequence``
- * passes the test implemented by the provided function.
- * @param callbackfn A function to execute for each element in the
- * ``Sequence``. It should return a truthy value to indicate the element
- * passes the test, and a falsy value otherwise.
- * @param thisArg A value to use as ``this`` when executing ``predicate``.
- */
- every(predicate: (value: any, index: number, array: any[]) => unknown, thisArg?: any): boolean;
- /**
- * See :js:meth:`Array.reduce`. Executes a user-supplied "reducer" callback
- * function on each element of the Sequence, in order, passing in the return
- * value from the calculation on the preceding element. The final result of
- * running the reducer across all elements of the Sequence is a single value.
- * @param callbackfn A function to execute for each element in the ``Sequence``. Its
- * return value is discarded.
- * @param thisArg A value to use as ``this`` when executing ``callbackfn``.
- */
- reduce(callbackfn: (previousValue: any, currentValue: any, currentIndex: number, array: any) => any, initialValue?: any): any;
- /**
- * See :js:meth:`Array.reduceRight`. Applies a function against an accumulator
- * and each value of the Sequence (from right to left) to reduce it to a
- * single value.
- * @param callbackfn A function to execute for each element in the Sequence.
- * Its return value is discarded.
- * @param thisArg A value to use as ``this`` when executing ``callbackFn``.
- */
- reduceRight(callbackfn: (previousValue: any, currentValue: any, currentIndex: number, array: any) => any, initialValue: any): any;
- /**
- * See :js:meth:`Array.at`. Takes an integer value and returns the item at
- * that index.
- * @param index Zero-based index of the Sequence element to be returned,
- * converted to an integer. Negative index counts back from the end of the
- * Sequence.
- * @returns The element in the Sequence matching the given index.
- */
- at(index: number): any;
- /**
- * The :js:meth:`Array.concat` method is used to merge two or more arrays.
- * This method does not change the existing arrays, but instead returns a new
- * array.
- * @param rest Arrays and/or values to concatenate into a new array.
- * @returns A new Array instance.
- */
- concat(...rest: ConcatArray<any>[]): any[];
- /**
- * The :js:meth:`Array.includes` method determines whether a Sequence
- * includes a certain value among its entries, returning true or false as
- * appropriate.
- * @param elt
- * @returns
- */
- includes(elt: any): any;
- /**
- * The :js:meth:`Array.entries` method returns a new iterator object that
- * contains the key/value pairs for each index in the ``Sequence``.
- * @returns A new iterator object.
- */
- entries(): IterableIterator<[
- number,
- any
- ]>;
- /**
- * The :js:meth:`Array.keys` method returns a new iterator object that
- * contains the keys for each index in the ``Sequence``.
- * @returns A new iterator object.
- */
- keys(): IterableIterator<number>;
- /**
- * The :js:meth:`Array.values` method returns a new iterator object that
- * contains the values for each index in the ``Sequence``.
- * @returns A new iterator object.
- */
- values(): IterableIterator<any>;
- /**
- * The :js:meth:`Array.find` method returns the first element in the provided
- * array that satisfies the provided testing function.
- * @param predicate A function to execute for each element in the
- * ``Sequence``. It should return a truthy value to indicate a matching
- * element has been found, and a falsy value otherwise.
- * @param thisArg A value to use as ``this`` when executing ``predicate``.
- * @returns The first element in the ``Sequence`` that satisfies the provided
- * testing function.
- */
- find(predicate: (value: any, index: number, obj: any[]) => any, thisArg?: any): any;
- /**
- * The :js:meth:`Array.findIndex` method returns the index of the first
- * element in the provided array that satisfies the provided testing function.
- * @param predicate A function to execute for each element in the
- * ``Sequence``. It should return a truthy value to indicate a matching
- * element has been found, and a falsy value otherwise.
- * @param thisArg A value to use as ``this`` when executing ``predicate``.
- * @returns The index of the first element in the ``Sequence`` that satisfies
- * the provided testing function.
- */
- findIndex(predicate: (value: any, index: number, obj: any[]) => any, thisArg?: any): number;
- }
- declare class PyMutableSequence extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PyMutableSequence } from "pyodide/ffi"` instead */
- interface PyMutableSequence extends PyMutableSequenceMethods {
- }
- declare class PyMutableSequenceMethods {
- /**
- * The :js:meth:`Array.reverse` method reverses a :js:class:`PyMutableSequence` in
- * place.
- * @returns A reference to the same :js:class:`PyMutableSequence`
- */
- reverse(): PyMutableSequence;
- /**
- * The :js:meth:`Array.sort` method sorts the elements of a
- * :js:class:`PyMutableSequence` in place.
- * @param compareFn A function that defines the sort order.
- * @returns A reference to the same :js:class:`PyMutableSequence`
- */
- sort(compareFn?: (a: any, b: any) => number): PyMutableSequence;
- /**
- * The :js:meth:`Array.splice` method changes the contents of a
- * :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
- * :js:class:`PyMutableSequence`.
- * @param deleteCount An integer indicating the number of elements in the
- * :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[]): any[];
- /**
- * The :js:meth:`Array.push` method adds the specified elements to the end of
- * 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
- * :js:class:`PyMutableSequence`.
- * @returns The removed element from the :js:class:`PyMutableSequence`; undefined if the
- * :js:class:`PyMutableSequence` is empty.
- */
- pop(): any;
- /**
- * The :js:meth:`Array.shift` method removes the first element from a
- * :js:class:`PyMutableSequence`.
- * @returns The removed element from the :js:class:`PyMutableSequence`; undefined if the
- * :js:class:`PyMutableSequence` is empty.
- */
- shift(): any;
- /**
- * The :js:meth:`Array.unshift` method adds the specified elements to the
- * 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
- * :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 :js:class:`PyMutableSequence`.
- */
- copyWithin(target: number, start?: number, end?: number): any;
- /**
- * The :js:meth:`Array.fill` method changes all elements in an array to a
- * static value, from a start index to an end index.
- * @param value Value to fill the array with.
- * @param start Zero-based index at which to start filling. Default 0.
- * @param end Zero-based index at which to end filling. Default
- * ``list.length``.
- * @returns
- */
- fill(value: any, start?: number, end?: number): any;
- }
- declare class PyAwaitable extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PyAwaitable } from "pyodide/ffi"` instead */
- interface PyAwaitable extends Promise<any> {
- }
- declare class PyCallable extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyCallable;
- }
- /** @deprecated Use `import type { PyCallable } from "pyodide/ffi"` instead */
- interface PyCallable extends PyCallableMethods {
- (...args: any[]): any;
- }
- declare class PyCallableMethods {
- /**
- * The ``apply()`` method calls the specified function with a given this
- * value, and arguments provided as an array (or an array-like object). Like
- * :js:meth:`Function.apply`.
- *
- * @param thisArg The ``this`` argument. Has no effect unless the
- * :js:class:`~pyodide.ffi.PyCallable` has :js:meth:`captureThis` set. If
- * :js:meth:`captureThis` is set, it will be passed as the first argument to
- * the Python function.
- * @param jsargs The array of arguments
- * @returns The result from the function call.
- */
- apply(thisArg: any, jsargs: any): any;
- /**
- * Calls the function with a given this value and arguments provided
- * individually. See :js:meth:`Function.call`.
- *
- * @param thisArg The ``this`` argument. Has no effect unless the
- * :js:class:`~pyodide.ffi.PyCallable` has :js:meth:`captureThis` set. If
- * :js:meth:`captureThis` is set, it will be passed as the first argument to
- * the Python function.
- * @param jsargs The arguments
- * @returns The result from the function call.
- */
- call(thisArg: any, ...jsargs: any): any;
- /**
- * Call the function with key word arguments. The last argument must be an
- * object with the keyword arguments.
- */
- callKwargs(...jsargs: any): any;
- /**
- * Call the function with stack switching enabled. Functions called this way
- * can use
- * :py:meth:`PyodideFuture.syncify() <pyodide.webloop.PyodideFuture.syncify>`
- * to block until a :py:class:`~asyncio.Future` or :js:class:`Promise` is
- * resolved. Only works in runtimes with JS Promise integration.
- *
- * .. admonition:: Experimental
- * :class: warning
- *
- * This feature is not yet stable.
- *
- * @experimental
- */
- callSyncifying(...jsargs: any): Promise<any>;
- /**
- * Call the function with stack switching enabled. The last argument must be
- * an object with the keyword arguments. Functions called this way can use
- * :py:meth:`PyodideFuture.syncify() <pyodide.webloop.PyodideFuture.syncify>`
- * to block until a :py:class:`~asyncio.Future` or :js:class:`Promise` is
- * resolved. Only works in runtimes with JS Promise integration.
- *
- * .. admonition:: Experimental
- * :class: warning
- *
- * This feature is not yet stable.
- *
- * @experimental
- */
- callSyncifyingKwargs(...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
- * arguments preceding any provided when the new function is called. See
- * :js:meth:`Function.bind`.
- *
- * If the :js:class:`~pyodide.ffi.PyCallable` does not have
- * :js:meth:`captureThis` set, the ``this`` parameter will be discarded. If it
- * does have :js:meth:`captureThis` set, ``thisArg`` will be set to the first
- * argument of the Python function. The returned proxy and the original proxy
- * have the same lifetime so destroying either destroys both.
- *
- * @param thisArg The value to be passed as the ``this`` parameter to the
- * target function ``func`` when the bound function is called.
- * @param jsargs Extra arguments to prepend to arguments provided to the bound
- * function when invoking ``func``.
- * @returns
- */
- bind(thisArg: any, ...jsargs: any): PyProxy;
- /**
- * Returns a :js:class:`~pyodide.ffi.PyProxy` that passes ``this`` as the first argument to the
- * Python function. The returned :js:class:`~pyodide.ffi.PyProxy` has the internal ``captureThis``
- * property set.
- *
- * It can then be used as a method on a JavaScript object. The returned proxy
- * and the original proxy have the same lifetime so destroying either destroys
- * both.
- *
- * For example:
- *
- * .. code-block:: pyodide
- *
- * let obj = { a : 7 };
- * pyodide.runPython(`
- * def f(self):
- * return self.a
- * `);
- * // Without captureThis, it doesn't work to use f as a method for obj:
- * obj.f = pyodide.globals.get("f");
- * obj.f(); // raises "TypeError: f() missing 1 required positional argument: 'self'"
- * // With captureThis, it works fine:
- * obj.f = pyodide.globals.get("f").captureThis();
- * obj.f(); // returns 7
- *
- * @returns The resulting :js:class:`~pyodide.ffi.PyProxy`. It has the same lifetime as the
- * original :js:class:`~pyodide.ffi.PyProxy` but passes ``this`` to the wrapped function.
- *
- */
- captureThis(): PyProxy;
- }
- declare class PyBuffer extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyBuffer;
- }
- /** @deprecated Use `import type { PyBuffer } from "pyodide/ffi"` instead */
- interface PyBuffer extends PyBufferMethods {
- }
- declare class PyBufferMethods {
- /**
- * Get a view of the buffer data which is usable from JavaScript. No copy is
- * ever performed.
- *
- * We do not support suboffsets, if the buffer requires suboffsets we will
- * throw an error. JavaScript nd array libraries can't handle suboffsets
- * anyways. In this case, you should use the :js:meth:`~PyProxy.toJs` api or
- * copy the buffer to one that doesn't use suboffsets (using e.g.,
- * :py:func:`numpy.ascontiguousarray`).
- *
- * If the buffer stores big endian data or half floats, this function will
- * fail without an explicit type argument. For big endian data you can use
- * :js:meth:`~PyProxy.toJs`. :js:class:`DataView` has support for big endian
- * data, so you might want to pass ``'dataview'`` as the type argument in that
- * case.
- *
- * @param type The type of the :js:attr:`~pyodide.ffi.PyBufferView.data` field
- * in the output. Should be one of: ``"i8"``, ``"u8"``, ``"u8clamped"``,
- * ``"i16"``, ``"u16"``, ``"i32"``, ``"u32"``, ``"i32"``, ``"u32"``,
- * ``"i64"``, ``"u64"``, ``"f32"``, ``"f64``, or ``"dataview"``. This argument
- * is optional, if absent :js:meth:`~pyodide.ffi.PyBuffer.getBuffer` will try
- * to determine the appropriate output type based on the buffer format string
- * (see :std:ref:`struct-format-strings`).
- */
- getBuffer(type?: string): PyBufferView;
- }
- declare class PyDict extends PyProxy {
- /** @private */
- static [Symbol.hasInstance](obj: any): obj is PyProxy;
- }
- /** @deprecated Use `import type { PyDict } from "pyodide/ffi"` instead */
- interface PyDict extends PyProxyWithGet, PyProxyWithSet, PyProxyWithHas, PyProxyWithLength, PyIterable {
- }
- /** @deprecated Use `import type { PyBufferView } from "pyodide/ffi"` instead */
- declare class PyBufferView {
- /**
- * The offset of the first entry of the array. For instance if our array
- * is 3d, then you will find ``array[0,0,0]`` at
- * ``pybuf.data[pybuf.offset]``
- */
- offset: number;
- /**
- * If the data is read only, you should not modify it. There is no way for us
- * to enforce this, but it may cause very weird behavior. See
- * :py:attr:`memoryview.readonly`.
- */
- readonly: boolean;
- /**
- * The format string for the buffer. See :ref:`struct-format-strings`
- * and :py:attr:`memoryview.format`.
- */
- format: string;
- /**
- * How large is each entry in bytes? See :py:attr:`memoryview.itemsize`.
- */
- itemsize: number;
- /**
- * The number of dimensions of the buffer. If ``ndim`` is 0, the buffer
- * represents a single scalar or struct. Otherwise, it represents an
- * array. See :py:attr:`memoryview.ndim`.
- */
- ndim: number;
- /**
- * The total number of bytes the buffer takes up. This is equal to
- * :js:attr:`buff.data.byteLength <TypedArray.byteLength>`. See :py:attr:`memoryview.nbytes`.
- */
- nbytes: number;
- /**
- * The shape of the buffer, that is how long it is in each dimension.
- * The length will be equal to ``ndim``. For instance, a 2x3x4 array
- * would have shape ``[2, 3, 4]``. See :py:attr:`memoryview.shape`.
- */
- shape: number[];
- /**
- * An array of of length ``ndim`` giving the number of elements to skip
- * to get to a new element in each dimension. See the example definition
- * of a ``multiIndexToIndex`` function above. See :py:attr:`memoryview.strides`.
- */
- strides: number[];
- /**
- * The actual data. A typed array of an appropriate size backed by a segment
- * of the WASM memory.
- *
- * The ``type`` argument of :js:meth:`~pyodide.ffi.PyBuffer.getBuffer` determines
- * which sort of :js:class:`TypedArray` or :js:class:`DataView` to return. By
- * default :js:meth:`~pyodide.ffi.PyBuffer.getBuffer` will look at the format string
- * to determine the most appropriate option. Most often the result is a
- * :js:class:`Uint8Array`.
- *
- * .. admonition:: Contiguity
- * :class: warning
- *
- * If the buffer is not contiguous, the :js:attr:`~PyBufferView.readonly`
- * TypedArray will contain data that is not part of the buffer. Modifying
- * this data leads to undefined behavior.
- *
- * .. admonition:: Read only buffers
- * :class: warning
- *
- * If :js:attr:`buffer.readonly <PyBufferView.readonly>` is ``true``, you
- * should not modify the buffer. Modifying a read only buffer leads to
- * undefined behavior.
- *
- */
- data: TypedArray;
- /**
- * Is it C contiguous? See :py:attr:`memoryview.c_contiguous`.
- */
- c_contiguous: boolean;
- /**
- * Is it Fortran contiguous? See :py:attr:`memoryview.f_contiguous`.
- */
- f_contiguous: boolean;
- _released: boolean;
- _view_ptr: number;
- /** @private */
- constructor();
- /**
- * Release the buffer. This allows the memory to be reclaimed.
- */
- release(): void;
- }
- type InFuncType = () => null | undefined | string | ArrayBuffer | Uint8Array | number;
- declare function setStdin(options?: {
- stdin?: InFuncType;
- read?: (buffer: Uint8Array) => number;
- error?: boolean;
- isatty?: boolean;
- autoEOF?: boolean;
- }): void;
- declare function setStdout(options?: {
- batched?: (output: string) => void;
- raw?: (charCode: number) => void;
- write?: (buffer: Uint8Array) => number;
- isatty?: boolean;
- }): void;
- declare function setStderr(options?: {
- batched?: (output: string) => void;
- raw?: (charCode: number) => void;
- write?: (buffer: Uint8Array) => number;
- isatty?: boolean;
- }): void;
- type PackageType = "package" | "cpython_module" | "shared_library" | "static_library";
- export type PackageData = {
- name: string;
- version: string;
- fileName: string;
- /** @experimental */
- packageType: PackageType;
- };
- declare function loadPackage(names: string | PyProxy | Array<string>, options?: {
- messageCallback?: (message: string) => void;
- errorCallback?: (message: string) => void;
- checkIntegrity?: boolean;
- }): Promise<Array<PackageData>>;
- /** @deprecated Use `import type { TypedArray } from "pyodide/ffi"` instead */
- export type TypedArray = Int8Array | Uint8Array | Int16Array | Uint16Array | Int32Array | Uint32Array | Uint8ClampedArray | Float32Array | Float64Array;
- interface CanvasInterface {
- setCanvas2D(canvas: HTMLCanvasElement): void;
- getCanvas2D(): HTMLCanvasElement | undefined;
- setCanvas3D(canvas: HTMLCanvasElement): void;
- getCanvas3D(): HTMLCanvasElement | undefined;
- }
- declare class PythonError extends Error {
- /**
- * The address of the error we are wrapping. We may later compare this
- * against sys.last_value.
- * WARNING: we don't own a reference to this pointer, dereferencing it
- * may be a use-after-free error!
- * @private
- */
- __error_address: number;
- /**
- * The name of the Python error class, e.g, :py:exc:`RuntimeError` or
- * :py:exc:`KeyError`.
- */
- type: string;
- constructor(type: string, message: string, error_address: number);
- }
- type NativeFS = {
- syncfs: () => Promise<void>;
- };
- declare class PyodideAPI {
- /** @hidden */
- static version: string;
- /** @hidden */
- static loadPackage: typeof loadPackage;
- /** @hidden */
- static loadedPackages: {
- [key: string]: string;
- };
- /** @hidden */
- static ffi: {
- PyProxy: typeof PyProxy;
- PyProxyWithLength: typeof PyProxyWithLength;
- PyProxyWithGet: typeof PyProxyWithGet;
- PyProxyWithSet: typeof PyProxyWithSet;
- PyProxyWithHas: typeof PyProxyWithHas;
- PyDict: typeof PyDict;
- PyIterable: typeof PyIterable;
- PyAsyncIterable: typeof PyAsyncIterable;
- PyIterator: typeof PyIterator;
- PyAsyncIterator: typeof PyAsyncIterator;
- PyGenerator: typeof PyGenerator;
- PyAsyncGenerator: typeof PyAsyncGenerator;
- PyAwaitable: typeof PyAwaitable;
- PyCallable: typeof PyCallable;
- PyBuffer: typeof PyBuffer;
- PyBufferView: typeof PyBufferView;
- PythonError: typeof PythonError;
- PySequence: typeof PySequence;
- PyMutableSequence: typeof PyMutableSequence;
- };
- /** @hidden */
- static setStdin: typeof setStdin;
- /** @hidden */
- static setStdout: typeof setStdout;
- /** @hidden */
- static setStderr: typeof setStderr;
- /**
- *
- * An alias to the global Python namespace.
- *
- * For example, to access a variable called ``foo`` in the Python global
- * scope, use ``pyodide.globals.get("foo")``
- */
- static globals: PyProxy;
- /**
- * An alias to the `Emscripten File System API
- * <https://emscripten.org/docs/api_reference/Filesystem-API.html>`_.
- *
- * This provides a wide range of POSIX-`like` file/device operations, including
- * `mount
- * <https://emscripten.org/docs/api_reference/Filesystem-API.html#FS.mount>`_
- * which can be used to extend the in-memory filesystem with features like `persistence
- * <https://emscripten.org/docs/api_reference/Filesystem-API.html#persistent-data>`_.
- *
- * While all the file systems implementations are enabled, only the default
- * ``MEMFS`` is guaranteed to work in all runtime settings. The implementations
- * are available as members of ``FS.filesystems``:
- * ``IDBFS``, ``NODEFS``, ``PROXYFS``, ``WORKERFS``.
- */
- static FS: any;
- /**
- * An alias to the `Emscripten Path API
- * <https://github.com/emscripten-core/emscripten/blob/main/src/library_path.js>`_.
- *
- * This provides a variety of operations for working with file system paths, such as
- * ``dirname``, ``normalize``, and ``splitPath``.
- */
- static PATH: any;
- /**
- * See :ref:`js-api-pyodide-canvas`.
- * @hidetype
- */
- static canvas: CanvasInterface;
- /**
- * A map from posix error names to error codes.
- */
- static ERRNO_CODES: {
- [code: string]: number;
- };
- /**
- * An alias to the Python :ref:`pyodide <python-api>` package.
- *
- * You can use this to call functions defined in the Pyodide Python package
- * from JavaScript.
- */
- static pyodide_py: PyProxy;
- /**
- * Inspect a Python code chunk and use :js:func:`pyodide.loadPackage` to install
- * any known packages that the code chunk imports. Uses the Python API
- * :func:`pyodide.code.find\_imports` to inspect the code.
- *
- * For example, given the following code as input
- *
- * .. code-block:: python
- *
- * import numpy as np
- * x = np.array([1, 2, 3])
- *
- * :js:func:`loadPackagesFromImports` will call
- * ``pyodide.loadPackage(['numpy'])``.
- *
- * @param code The code to inspect.
- * @param options Options passed to :js:func:`pyodide.loadPackage`.
- * @param options.messageCallback A callback, called with progress messages
- * (optional)
- * @param options.errorCallback A callback, called with error/warning messages
- * (optional)
- * @param options.checkIntegrity If true, check the integrity of the downloaded
- * packages (default: true)
- * @async
- */
- static loadPackagesFromImports(code: string, options?: {
- messageCallback?: (message: string) => void;
- errorCallback?: (message: string) => void;
- checkIntegrity?: boolean;
- }): Promise<Array<PackageData>>;
- /**
- * Runs a string of Python code from JavaScript, using :py:func:`~pyodide.code.eval_code`
- * to evaluate the code. If the last statement in the Python code is an
- * expression (and the code doesn't end with a semicolon), the value of the
- * expression is returned.
- *
- * @param code The Python code to run
- * @param options
- * @param options.globals An optional Python dictionary to use as the globals.
- * Defaults to :js:attr:`pyodide.globals`.
- * @param options.locals An optional Python dictionary to use as the locals.
- * Defaults to the same as ``globals``.
- * @param options.filename An optional string to use as the file name.
- * Defaults to ``"<exec>"``. If a custom file name is given, the
- * traceback for any exception that is thrown will show source lines
- * (unless the given file name starts with ``<`` and ends with ``>``).
- * @returns The result of the Python code translated to JavaScript. See the
- * documentation for :py:func:`~pyodide.code.eval_code` for more info.
- * @example
- * async function main(){
- * const pyodide = await loadPyodide();
- * console.log(pyodide.runPython("1 + 2"));
- * // 3
- *
- * const globals = pyodide.toPy({ x: 3 });
- * console.log(pyodide.runPython("x + 1", { globals }));
- * // 4
- *
- * const locals = pyodide.toPy({ arr: [1, 2, 3] });
- * console.log(pyodide.runPython("sum(arr)", { locals }));
- * // 6
- * }
- * main();
- */
- static runPython(code: string, options?: {
- globals?: PyProxy;
- locals?: PyProxy;
- filename?: string;
- }): any;
- /**
- * Run a Python code string with top level await using
- * :py:func:`~pyodide.code.eval_code_async` to evaluate the code. Returns a promise which
- * resolves when execution completes. If the last statement in the Python code
- * is an expression (and the code doesn't end with a semicolon), the returned
- * promise will resolve to the value of this expression.
- *
- * For example:
- *
- * .. code-block:: pyodide
- *
- * let result = await pyodide.runPythonAsync(`
- * from js import fetch
- * response = await fetch("./pyodide-lock.json")
- * packages = await response.json()
- * # If final statement is an expression, its value is returned to JavaScript
- * len(packages.packages.object_keys())
- * `);
- * console.log(result); // 79
- *
- * .. admonition:: Python imports
- * :class: warning
- *
- * Since pyodide 0.18.0, you must call :js:func:`loadPackagesFromImports` to
- * import any python packages referenced via ``import`` statements in your
- * code. This function will no longer do it for you.
- *
- * @param code The Python code to run
- * @param options
- * @param options.globals An optional Python dictionary to use as the globals.
- * Defaults to :js:attr:`pyodide.globals`.
- * @param options.locals An optional Python dictionary to use as the locals.
- * Defaults to the same as ``globals``.
- * @param options.filename An optional string to use as the file name.
- * Defaults to ``"<exec>"``. If a custom file name is given, the
- * traceback for any exception that is thrown will show source lines
- * (unless the given file name starts with ``<`` and ends with ``>``).
- * @returns The result of the Python code translated to JavaScript.
- * @async
- */
- static runPythonAsync(code: string, options?: {
- globals?: PyProxy;
- locals?: PyProxy;
- filename?: string;
- }): Promise<any>;
- /**
- * Runs a Python code string like :js:func:`pyodide.runPython` but with stack
- * switching enabled. Code executed in this way can use
- * :py:meth:`PyodideFuture.syncify() <pyodide.webloop.PyodideFuture.syncify>`
- * to block until a :py:class:`~asyncio.Future` or :js:class:`Promise` is
- * resolved. Only works in runtimes with JS Promise Integration enabled.
- *
- * .. admonition:: Experimental
- * :class: warning
- *
- * This feature is not yet stable.
- *
- * @experimental
- * @param code The Python code to run
- * @param options
- * @param options.globals An optional Python dictionary to use as the globals.
- * Defaults to :js:attr:`pyodide.globals`.
- * @param options.locals An optional Python dictionary to use as the locals.
- * Defaults to the same as ``globals``.
- * @param options.filename An optional string to use as the file name.
- * Defaults to ``"<exec>"``. If a custom file name is given, the
- * traceback for any exception that is thrown will show source lines
- * (unless the given file name starts with ``<`` and ends with ``>``).
- * @returns The result of the Python code translated to JavaScript.
- */
- static runPythonSyncifying(code: string, options?: {
- globals?: PyProxy;
- locals?: PyProxy;
- filename?: string;
- }): Promise<any>;
- /**
- * Registers the JavaScript object ``module`` as a JavaScript module named
- * ``name``. This module can then be imported from Python using the standard
- * Python import system. If another module by the same name has already been
- * imported, this won't have much effect unless you also delete the imported
- * module from :py:data:`sys.modules`. This calls
- * :func:`~pyodide.ffi.register_js_module`.
- *
- * Any attributes of the JavaScript objects which are themselves objects will
- * be treated as submodules:
- * ```pyodide
- * pyodide.registerJsModule("mymodule", { submodule: { value: 7 } });
- * pyodide.runPython(`
- * from mymodule.submodule import value
- * assert value == 7
- * `);
- * ```
- * If you wish to prevent this, try the following instead:
- * ```pyodide
- * const sys = pyodide.pyimport("sys");
- * sys.modules.set("mymodule", { obj: { value: 7 } });
- * pyodide.runPython(`
- * from mymodule import obj
- * assert obj.value == 7
- * # attempting to treat obj as a submodule raises ModuleNotFoundError:
- * # "No module named 'mymodule.obj'; 'mymodule' is not a package"
- * from mymodule.obj import value
- * `);
- * ```
- *
- * @param name Name of the JavaScript module to add
- * @param module JavaScript object backing the module
- */
- static registerJsModule(name: string, module: object): void;
- /**
- * Unregisters a JavaScript module with given name that has been previously
- * registered with :js:func:`pyodide.registerJsModule` or
- * :func:`~pyodide.ffi.register_js_module`. If a JavaScript module with that
- * name does not already exist, will throw an error. Note that if the module has
- * already been imported, this won't have much effect unless you also delete the
- * imported module from :py:data:`sys.modules`. This calls
- * :func:`~pyodide.ffi.unregister_js_module`.
- *
- * @param name Name of the JavaScript module to remove
- */
- static unregisterJsModule(name: string): void;
- /**
- * Convert a JavaScript object to a Python object as best as possible.
- *
- * This is similar to :py:meth:`~pyodide.ffi.JsProxy.to_py` but for use from
- * JavaScript. If the object is immutable or a :js:class:`~pyodide.ffi.PyProxy`,
- * it will be returned unchanged. If the object cannot be converted into Python,
- * it will be returned unchanged.
- *
- * See :ref:`type-translations-jsproxy-to-py` for more information.
- *
- * @param obj The object to convert.
- * @param options
- * @returns The object converted to Python.
- */
- static toPy(obj: any, { depth, defaultConverter, }?: {
- /**
- * Optional argument to limit the depth of the conversion.
- */
- depth: number;
- /**
- * Optional argument to convert objects with no default conversion. See the
- * documentation of :py:meth:`~pyodide.ffi.JsProxy.to_py`.
- */
- defaultConverter?: (value: any, converter: (value: any) => any, cacheConversion: (input: any, output: any) => void) => any;
- }): any;
- /**
- * Imports a module and returns it.
- *
- * .. admonition:: Warning
- * :class: warning
- *
- * This function has a completely different behavior than the old removed pyimport function!
- *
- * ``pyimport`` is roughly equivalent to:
- *
- * .. code-block:: js
- *
- * pyodide.runPython(`import ${pkgname}; ${pkgname}`);
- *
- * except that the global namespace will not change.
- *
- * Example:
- *
- * .. code-block:: js
- *
- * let sysmodule = pyodide.pyimport("sys");
- * let recursionLimit = sysmodule.getrecursionlimit();
- *
- * @param mod_name The name of the module to import
- * @returns A PyProxy for the imported module
- */
- static pyimport(mod_name: string): PyProxy;
- /**
- * Unpack an archive into a target directory.
- *
- * @param buffer The archive as an :js:class:`ArrayBuffer` or :js:class:`TypedArray`.
- * @param format The format of the archive. Should be one of the formats
- * recognized by :py:func:`shutil.unpack_archive`. By default the options are
- * ``'bztar'``, ``'gztar'``, ``'tar'``, ``'zip'``, and ``'wheel'``. Several
- * synonyms are accepted for each format, e.g., for ``'gztar'`` any of
- * ``'.gztar'``, ``'.tar.gz'``, ``'.tgz'``, ``'tar.gz'`` or ``'tgz'`` are
- * considered to be
- * synonyms.
- *
- * @param options
- * @param options.extractDir The directory to unpack the archive into. Defaults
- * to the working directory.
- */
- static unpackArchive(buffer: TypedArray | ArrayBuffer, format: string, options?: {
- extractDir?: string;
- }): void;
- /**
- * Mounts a :js:class:`FileSystemDirectoryHandle` into the target directory.
- *
- * @param path The absolute path in the Emscripten file system to mount the
- * native directory. If the directory does not exist, it will be created. If it
- * does exist, it must be empty.
- * @param fileSystemHandle A handle returned by :js:func:`navigator.storage.getDirectory() <getDirectory>`
- * or :js:func:`window.showDirectoryPicker() <showDirectoryPicker>`.
- */
- static mountNativeFS(path: string, fileSystemHandle: FileSystemDirectoryHandle): Promise<NativeFS>;
- /**
- * Tell Pyodide about Comlink.
- * Necessary to enable importing Comlink proxies into Python.
- */
- static registerComlink(Comlink: any): void;
- /**
- * Sets the interrupt buffer to be ``interrupt_buffer``. This is only useful
- * when Pyodide is used in a webworker. The buffer should be a
- * :js:class:`SharedArrayBuffer` shared with the main browser thread (or another
- * worker). In that case, signal ``signum`` may be sent by writing ``signum``
- * into the interrupt buffer. If ``signum`` does not satisfy 0 < ``signum`` < 65
- * it will be silently ignored.
- *
- * You can disable interrupts by calling ``setInterruptBuffer(undefined)``.
- *
- * If you wish to trigger a :py:exc:`KeyboardInterrupt`, write ``SIGINT`` (a 2)
- * into the interrupt buffer.
- *
- * By default ``SIGINT`` raises a :py:exc:`KeyboardInterrupt` and all other signals
- * are ignored. You can install custom signal handlers with the signal module.
- * Even signals that normally have special meaning and can't be overridden like
- * ``SIGKILL`` and ``SIGSEGV`` are ignored by default and can be used for any
- * purpose you like.
- */
- static setInterruptBuffer(interrupt_buffer: TypedArray): void;
- /**
- * Throws a :py:exc:`KeyboardInterrupt` error if a :py:exc:`KeyboardInterrupt` has
- * been requested via the interrupt buffer.
- *
- * This can be used to enable keyboard interrupts during execution of JavaScript
- * code, just as :c:func:`PyErr_CheckSignals` is used to enable keyboard interrupts
- * during execution of C code.
- */
- static checkInterrupt(): void;
- /**
- * Turn on or off debug mode. In debug mode, some error messages are improved
- * at a performance cost.
- * @param debug If true, turn debug mode on. If false, turn debug mode off.
- * @returns The old value of the debug flag.
- */
- static setDebug(debug: boolean): boolean;
- }
- /** @hidetype */
- export type PyodideInterface = typeof PyodideAPI;
- /**
- * See documentation for loadPyodide.
- * @private
- */
- type ConfigType = {
- indexURL: string;
- packageCacheDir: string;
- lockFileURL: string;
- fullStdLib?: boolean;
- stdLibURL?: string;
- stdin?: () => string;
- stdout?: (msg: string) => void;
- stderr?: (msg: string) => void;
- jsglobals?: object;
- args: string[];
- _node_mounts: string[];
- env: {
- [key: string]: string;
- };
- packages: string[];
- };
- /**
- * Load the main Pyodide wasm module and initialize it.
- *
- * @returns The :ref:`js-api-pyodide` module.
- * @memberof globalThis
- * @async
- * @example
- * async function main() {
- * const pyodide = await loadPyodide({
- * fullStdLib: true,
- * stdout: (msg) => console.log(`Pyodide: ${msg}`),
- * });
- * console.log("Loaded Pyodide");
- * }
- * main();
- */
- export declare function loadPyodide(options?: {
- /**
- * The URL from which Pyodide will load the main Pyodide runtime and
- * packages. It is recommended that you leave this unchanged, providing an
- * incorrect value can cause broken behavior.
- *
- * Default: The url that Pyodide is loaded from with the file name
- * (``pyodide.js`` or ``pyodide.mjs``) removed.
- */
- indexURL?: string;
- /**
- * The file path where packages will be cached in node. If a package
- * exists in ``packageCacheDir`` it is loaded from there, otherwise it is
- * downloaded from the JsDelivr CDN and then cached into ``packageCacheDir``.
- * Only applies when running in node; ignored in browsers.
- *
- * Default: same as indexURL
- */
- packageCacheDir?: string;
- /**
- * The URL from which Pyodide will load the Pyodide ``pyodide-lock.json`` lock
- * file. You can produce custom lock files with :py:func:`micropip.freeze`.
- * Default: ```${indexURL}/pyodide-lock.json```
- */
- lockFileURL?: string;
- /**
- * Load the full Python standard library. Setting this to false excludes
- * unvendored modules from the standard library.
- * Default: ``false``
- */
- fullStdLib?: boolean;
- /**
- * The URL from which to load the standard library ``python_stdlib.zip``
- * file. This URL includes the most of the Python standard library. Some
- * stdlib modules were unvendored, and can be loaded separately
- * with ``fullStdLib: true`` option or by their package name.
- * Default: ```${indexURL}/python_stdlib.zip```
- */
- stdLibURL?: string;
- /**
- * Override the standard input callback. Should ask the user for one line of
- * input. The :js:func:`pyodide.setStdin` function is more flexible and
- * should be preferred.
- */
- stdin?: () => string;
- /**
- * Override the standard output callback. The :js:func:`pyodide.setStdout`
- * function is more flexible and should be preferred in most cases, but
- * depending on the ``args`` passed to ``loadPyodide``, Pyodide may write to
- * stdout on startup, which can only be controlled by passing a custom
- * ``stdout`` function.
- */
- stdout?: (msg: string) => void;
- /**
- * Override the standard error output callback. The
- * :js:func:`pyodide.setStderr` function is more flexible and should be
- * preferred in most cases, but depending on the ``args`` passed to
- * ``loadPyodide``, Pyodide may write to stdout on startup, which can only
- * be controlled by passing a custom ``stdout`` function.
- */
- stderr?: (msg: string) => void;
- /**
- * The object that Pyodide will use for the ``js`` module.
- * Default: ``globalThis``
- */
- jsglobals?: object;
- /**
- * Command line arguments to pass to Python on startup. See `Python command
- * line interface options
- * <https://docs.python.org/3.10/using/cmdline.html#interface-options>`_ for
- * more details. Default: ``[]``
- */
- args?: string[];
- /**
- * Environment variables to pass to Python. This can be accessed inside of
- * Python at runtime via :py:data:`os.environ`. Certain environment variables change
- * the way that Python loads:
- * https://docs.python.org/3.10/using/cmdline.html#environment-variables
- * Default: ``{}``.
- * If ``env.HOME`` is undefined, it will be set to a default value of
- * ``"/home/pyodide"``
- */
- env?: {
- [key: string]: string;
- };
- /**
- * A list of packages to load as Pyodide is initializing.
- *
- * This is the same as loading the packages with
- * :js:func:`pyodide.loadPackage` after Pyodide is loaded except using the
- * ``packages`` option is more efficient because the packages are downloaded
- * while Pyodide bootstraps itself.
- */
- packages?: string[];
- /**
- * Opt into the old behavior where PyProxy.toString calls `repr` and not
- * `str`.
- * @deprecated
- */
- pyproxyToStringRepr?: boolean;
- /**
- * @ignore
- */
- _node_mounts?: string[];
- }): Promise<PyodideInterface>;
- export type {};
- export type {};
|