Skip to content

About latest Pyodide packages checks/guard #196

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 21, 2025
Merged

About latest Pyodide packages checks/guard #196

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 13 additions & 4 deletions docs/user-guide/configuration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ reference it from the tag used to specify the Python code:
If you use JSON, you can make it the value of the `config` attribute:

```HTML title="JSON as the value of the config attribute."
<script type="mpy" src="main.py" config='{"packages":["arrr", "numberwang"]}'></script>
<script type="py" src="main.py" config='{"packages":["arrr", "numberwang"]}'></script>
```

For historical and convenience reasons we still support the inline
Expand All @@ -81,6 +81,15 @@ _single_ `<py-config>` or `<mpy-config>` tag in your HTML document:
with [`py-game`](../pygame-ce) or [`py-editor`](../editor). For these use the config
attribute method.

!!! warning

Starting from PyScript 2025.10.1 the config guards against incompatible or not
available packages related to the current Pyodide version.

There is an ongoing effort to make chosing packages in Pyodide way more helpful
than it has ever been but right now be aware if a non existent package for a
specific Pyodide version cannot be found an error will be thrown.

## Options

There are five core options ([`interpreter`](#interpreter), [`files`](#files),
Expand All @@ -105,12 +114,12 @@ a custom version of the interpreter.
The following two examples are equivalent:

```TOML title="Specify the interpreter version in TOML."
interpreter = "0.23.4"
interpreter = "0.29.0"
```

```JSON title="Specify the interpreter version in JSON."
{
"interpreter": "0.23.4"
"interpreter": "0.29.0"
}
```

Expand All @@ -119,7 +128,7 @@ version of Pyodide as specified in the previous examples:

```JSON title="Specify the interpreter via a fully qualified URL."
{
"interpreter": "https://cdn.jsdelivr.net/pyodide/v0.23.4/full/pyodide.mjs"
"interpreter": "https://cdn.jsdelivr.net/pyodide/v0.29.0/full/pyodide.mjs"
}
```

Expand Down