Cleanup PyScript renderer & use Bun for building JS (#254)

- Switch to `Bun` for building JS
- Minor cleanup to pyscript renderer
- Revert pyscript version to 0.5 due to [bugs](pyscript/pyscript#2228)

Author: Archmonger

.editorconfig

@@ -14,10 +14,14 @@ end_of_line = lf
 indent_size = 4
 max_line_length = 120
 
+[*.yml]
+indent_size = 4
+
 [*.md]
 indent_size = 4
 
 [*.html]
+indent_size = 4
 max_line_length = off
 
 [*.js]

.github/workflows/publish-develop-docs.yml

@@ -11,6 +11,9 @@ jobs:
             - uses: actions/checkout@v4
               with:
                   fetch-depth: 0
+            - uses: oven-sh/setup-bun@v2
+              with:
+                  bun-version: latest
             - uses: actions/setup-python@v5
               with:
                   python-version: 3.x

.github/workflows/publish-py.yml

@@ -12,6 +12,9 @@ jobs:
         runs-on: ubuntu-latest
         steps:
             - uses: actions/checkout@v4
+            - uses: oven-sh/setup-bun@v2
+              with:
+                  bun-version: latest
             - name: Set up Python
               uses: actions/setup-python@v5
               with:

.github/workflows/publish-release-docs.yml

@@ -11,6 +11,9 @@ jobs:
             - uses: actions/checkout@v4
               with:
                   fetch-depth: 0
+            - uses: oven-sh/setup-bun@v2
+              with:
+                  bun-version: latest
             - uses: actions/setup-python@v5
               with:
                   python-version: 3.x

.github/workflows/test-docs.yml

@@ -17,6 +17,9 @@ jobs:
             - uses: actions/checkout@v4
               with:
                   fetch-depth: 0
+            - uses: oven-sh/setup-bun@v2
+              with:
+                  bun-version: latest
             - uses: actions/setup-python@v5
               with:
                   python-version: 3.x

.github/workflows/test-src.yml

@@ -18,6 +18,9 @@ jobs:
                 python-version: ["3.9", "3.10", "3.11", "3.12"]
         steps:
             - uses: actions/checkout@v4
+            - uses: oven-sh/setup-bun@v2
+              with:
+                  bun-version: latest
             - name: Use Python ${{ matrix.python-version }}
               uses: actions/setup-python@v5
               with:

docs/examples/html/pyscript-setup-local-interpreter.html

@@ -0,0 +1 @@
+{% pyscript_setup config='{"interpreter":"/static/pyodide/pyodide.mjs"}' %}

docs/src/about/code.md

@@ -19,6 +19,7 @@
 If you plan to make code changes to this repository, you will need to install the following dependencies first:
 
 -   [Python 3.9+](https://www.python.org/downloads/)
+-   [Bun](https://bun.sh/)
 -   [Git](https://git-scm.com/downloads)
 
 Once done, you should clone this repository:

docs/src/reference/template-tag.md

@@ -391,3 +391,17 @@ You can optionally use this tag to configure the current PyScript environment. F
         ```python
         {% include "../../examples/python/pyscript-setup-config-object.py" %}
         ```
+
+??? question "Can I use a local interpreter for PyScript?"
+
+    Yes, you can set up a local interpreter by following PyScript's [standard documentation](https://docs.pyscript.net/latest/user-guide/offline/#local-pyodide-packages).
+
+    To summarize,
+
+    1. Download the latest Pyodide bundle from the [Pyodide GitHub releases page](https://github.com/pyodide/pyodide/releases) (for example `pyodide-0.26.3.tar.bz2`).
+    2. Extract the contents of the bundle to your project's static files.
+    3. Configure your `#!jinja {% pyscript_setup %}` template tag to use `pyodide` as an interpreter.
+
+        ```jinja linenums="0"
+        {% include "../../examples/html/pyscript-setup-local-interpreter.html" %}
+        ```

noxfile.py

@@ -31,14 +31,14 @@ def test_python(session: Session) -> None:
     settings_files = glob(settings_glob)
     assert settings_files, f"No Django settings files found at '{settings_glob}'!"
     for settings_file in settings_files:
-        settings_module = settings_file.strip(".py").replace("/", ".").replace("\\", ".")
+        settings_module = (
+            settings_file.strip(".py").replace("/", ".").replace("\\", ".")
+        )
         session.run(
             "python",
             "manage.py",
             "test",
             *posargs,
-            "-v",
-            "2",
             "--settings",
             settings_module,
         )
@@ -62,8 +62,8 @@ def test_style(session: Session) -> None:
 def test_javascript(session: Session) -> None:
     install_requirements_file(session, "test-env")
     session.chdir(ROOT_DIR / "src" / "js")
-    session.run("python", "-m", "nodejs.npm", "install", external=True)
-    session.run("python", "-m", "nodejs.npm", "run", "check")
+    session.run("bun", "install", external=True)
+    session.run("bun", "run", "check", external=True)
 
 
 def install_requirements_file(session: Session, name: str) -> None: