pyodide/docs/api_reference.md

3.1 KiB

API Reference

pyodide version 0.1.0

Backward compatibility of the API is not guaranteed at this point.

Python API

pyodide.open_url(url)

Fetches a given url and returns a io.StringIO to access its contents.

Parameters

name type description
url str the URL to open

Returns

A io.StringIO object with the URL contents

pyodide.eval_code(code, ns)

Runs a string of code, the last part of which may be an expression.

Parameters

name type description
code str the code to evaluate
ns dict evaluation name space

Returns

Either the resulting object or None

Javascript API

pyodide.loadPackage(names)

Load a package or a list of packages

Parameters

name type description
names {str, Array} package name, or URL. Can be either a single element, or an array.

Returns

An evaluated promise.

pyodide.loadedPackage

Array with loaded packages.

Use Object.keys(pyodide.loadedPackage) to access the names of the loaded packages, and pyodide.loadedPackage[package_name] to access install location for a particular package_name.

pyodide.pyimport(name)

Import a Python package from Javascript.

Makes var foo = pyodide.pyimport('foo') work in Javascript.

Parameters

name type description
names str Python package name

Returns

name type description
package Object proxy for the imported Python package

pyodide.repr(obj)

Gets the string representation of an object

Parameters

name type description
obj Object Input object

Returns

name type description
str_repr str String representation of the input object

pyodide.runPython(code)

Gets the string representation of an object

Parameters

name type description
code str Python code to evaluate

Returns

name type description
jsresult Object Results, passed to Javascript

pyodide.version()

Returns the pyodide version.

It can be either the exact release version (e.g. 0.1.0), or the latest release version followed by the number of commits since, and the git hash of the current commit (e.g. 0.1.0-1-bd84646).

Parameters

None

Returns

name type description
version str Pyodide version string