Update versions for 0.2.0 release (#74)

* bump a bunch of versions

* update some docs

* update more versions, links, style

Author: bollwyvl

.readthedocs.yml

@@ -4,7 +4,7 @@ build:
   os: ubuntu-22.04
   tools:
     python: '3.11'
-    nodejs: '18'
+    nodejs: '20'
   apt_packages:
     - libarchive-dev
 

.yarnrc.yml

@@ -6,16 +6,17 @@ nodeLinker: node-modules
 npmRegistryServer: https://registry.npmjs.org/
 installStatePath: ./build/.cache/yarn/install-state.gz
 cacheFolder: ./build/.cache/yarn/cache
+# these messages provide no actionable information, and make non-TTY output
+# almost unreadable, masking real dependency-related information
+# see: https://yarnpkg.com/advanced/error-codes
 logFilters:
-  - code: YN0006
+  - code: YN0006 # SOFT_LINK_BUILD
     level: discard
-  - code: YN0002
+  - code: YN0007 # MUST_BUILD
     level: discard
-  - code: YN0007
+  - code: YN0008 # MUST_REBUILD
     level: discard
-  - code: YN0013
+  - code: YN0013 # FETCH_NOT_CACHED
     level: discard
-  - code: YN0019
-    level: discard
-  - code: YN0008
+  - code: YN0019 # UNUSED_CACHE_ENTRY
     level: discard

CONTRIBUTING.md

@@ -2,7 +2,7 @@
 
 The final, user-facing products of `jupyterlite-pyodide-kernel` are:
 
-- the [distribution](#distributions) on `pyp.org` and `npmjs.org`
+- the [distribution](#distributions) on `pypi.org` and `npmjs.org`
 - the [documentation](#documentation) on ReadTheDocs
 
 Preparing for a [release], however, requires a number of intermediate steps.
@@ -18,7 +18,7 @@ and watch what it does to files on disk and in the terminal log.
 
 - `git`
 - `python >=3.8`
-- `nodejs >=18,<19`
+- `nodejs >=20,<21`
 
 ### Setup
 

README.md

@@ -19,10 +19,10 @@
 
 ### Compatibility
 
-|            status             | `jupyterlite-pyodide-kernel` | `jupyterlite-core` | `jupyterlab` | `notebook` | `retrolab` |
-| :---------------------------: | :--------------------------: | :----------------: | :----------: | :--------: | ---------- |
-| [alpha](#prerelease-versions) |           `0.2.*`            |      `0.2.*`       |   `4.0.*`    |  `7.0.*`   | -          |
-|            stable             |           `0.1.*`            |      `0.1.*`       |   `3.5.*`    |     -      | `0.3.*`    |
+| status | `jupyterlite-pyodide-kernel` | `jupyterlite-core` | `jupyterlab` |  `notebook`  |  `retrolab`  |
+| :----: | :--------------------------: | :----------------: | :----------: | :----------: | :----------: |
+| stable |           `0.2.*`            |    `>=0.2,<0.3`    | `>=4.0.7,<5` | `>=7.0.5,<8` |      -       |
+| stable |           `0.1.*`            |    `>=0.1,<0.2`    | `>=3.5,<3.6` |      -       | `>=0.3,<0.4` |
 
 Installing the matching version of JupyterLab with your package manager can help ensure
 matching labextension assets and kernel dependencies, even though this kernel does not
@@ -89,7 +89,7 @@ documentation site:
 To remove the extension, run:
 
 ```bash
-pip uninstall jupyterlite-pyodide-kernel  # or howver you installed it
+pip uninstall jupyterlite-pyodide-kernel  # or however you installed it
 ```
 
 ## Prerelease Versions

docs/_static/variables.css

@@ -0,0 +1,3 @@
+.table {
+    --bs-table-bg: transparent;
+}

docs/conf.py

@@ -32,18 +32,20 @@
 
 # theme
 html_theme = "pydata_sphinx_theme"
+html_logo =  "../packages/pyodide-kernel-extension/style/img/pyodide.svg"
+html_favicon = html_logo
 html_theme_options = {
     "github_url": P["urls"]["Source"],
-    "use_edit_page_button": True,
     "icon_links": [
-        {
-            "name": "PyPI",
-            "url": P["urls"]["PyPI"],
-            "icon": "fa-solid fa-box",
-        },
+       {"name": "PyPI", "url": P["urls"]["PyPI"], "icon": "fa-solid fa-box"}
     ],
+    "logo": {
+        "text": P["name"]
+    },
+    "navigation_with_keys": False,
     "pygment_light_style": "github-light",
-    "pygment_dark_style": "github-dark"
+    "pygment_dark_style": "github-dark",
+    "use_edit_page_button": True,
 }
 
 github_user, github_repo = P["urls"]["Source"].split("/")[-2:]
@@ -56,16 +58,13 @@
 }
 # rely on the order of these to patch json, labextensions correctly
 html_static_path = [
+    "./_static",
     # as-built assets for testing "hot" downstreams against a PR without rebuilding
     "../dist",
     # as-built application, extensions, contents, and patched jupyter-lite.json
     "../build/docs-app",
 ]
 
-# TODO: add the pyodide logo
-# html_theme_options = {
-#    "logo": {
-#       "image_light": "TODO",
-#       "image_dark": "TODO",
-#    }
-# }
+html_css_files = [
+    "variables.css",
+]

docs/contributing.md

@@ -1,2 +1,5 @@
 ```{include} ../CONTRIBUTING.md
 ```
+
+```{include} ../RELEASE.md
+```

docs/index.md

@@ -47,7 +47,7 @@
 </style>
 
 <iframe
-    src="./_static/retro/notebooks/index.html?path=intro.ipynb"
+    src="./_static/notebooks/index.html?path=intro.ipynb"
     style="width: 99%; border: solid 1px #999; height: 500px"
 ></iframe>
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jupyterlite/pyodide-kernel-root",
-  "version": "0.2.0-alpha.4",
+  "version": "0.2.0",
   "private": true,
   "workspaces": {
     "packages": [

packages/pyodide-kernel-extension/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jupyterlite/pyodide-kernel-extension",
-  "version": "0.2.0-alpha.2",
+  "version": "0.2.0",
   "description": "JupyterLite - Pyodide Kernel Extension",
   "homepage": "https://github.com/jupyterlite/pyodide-kernel",
   "bugs": {
@@ -48,13 +48,13 @@
   },
   "dependencies": {
     "@jupyterlab/coreutils": "^6.0.6",
-    "@jupyterlite/contents": "^0.2.0-alpha.4",
-    "@jupyterlite/kernel": "^0.2.0-alpha.4",
-    "@jupyterlite/pyodide-kernel": "^0.2.0-alpha.2",
-    "@jupyterlite/server": "^0.2.0-alpha.4"
+    "@jupyterlite/contents": "^0.2.0",
+    "@jupyterlite/kernel": "^0.2.0",
+    "@jupyterlite/pyodide-kernel": "^0.2.0",
+    "@jupyterlite/server": "^0.2.0"
   },
   "devDependencies": {
-    "@jupyterlab/builder": "~4.0.6",
+    "@jupyterlab/builder": "~4.0.7",
     "rimraf": "^5.0.1",
     "typescript": "~5.2.2"
   },