update componentize-py and Spin WIT files (#129)

* update `componentize-py` and Spin WIT files

This updates to `componentize-py` 0.22.0, which includes support for component
model concurrency.  It also includes the WIT files for the upcoming Spin 4.0
release.

Other changes:

- Updated the bindings generation script and moved it into its own file
    - This includes passing the `--full-names` option to `componentize-py`, ensuring names remain stable for future releases
- Ran the above script to regenerate the bindings from the new WIT files
- Added a script to build all the examples and test some of them (just one so far)
- Added a GitHub workflow to run the above script
- Bumped the package version to 4.0.0 and generated docs/v4
- Updated the examples and template

Note that the `src/componentize_py_*` files are part of the `componentize-py
bindings` output, and I've only checked them in to make `pdoc3` happy.

Signed-off-by: Joel Dice <joel.dice@akamai.com>

* add `streaming-p3` example

Signed-off-by: Joel Dice <joel.dice@akamai.com>

* use Spin setup action to install canary in CI

Signed-off-by: Joel Dice <joel.dice@akamai.com>

* add .gitattributes file

Signed-off-by: Joel Dice <joel.dice@akamai.com>

---------

Signed-off-by: Joel Dice <joel.dice@akamai.com>

Author: dicej

.gitattributes

@@ -0,0 +1,4 @@
+docs/** linguist-generated=true
+src/spin_sdk/wit/** linguist-generated=true
+src/componentize_py_* linguist-generated=true
+src/componentize_py_*/** linguist-generated=true

.github/workflows/build.yml

@@ -0,0 +1,29 @@
+name: Build
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Spin
+        uses: fermyon/actions/spin/setup@v1
+        with:
+          # TODO: Switch to Spin 4.0 when it's available
+           version: "canary"
+
+      - name: Build examples and run tests
+        run: |
+          python -m venv venv
+          source venv/bin/activate
+          pip install componentize-py==0.22.0 http-router==4.1.2 build==1.4.2
+          python -m build
+          pip install dist/spin_sdk-4.0.0-py3-none-any.whl
+          bash run_tests.sh

.gitignore

@@ -1,7 +1,9 @@
 bindings
 *.wasm
+spin-dependencies.wit
+examples/matrix-math/numpy*
 __pycache__
 .spin
 src/spin_sdk.egg-info
 dist
-venv/
+venv/

CONTRIBUTING.md

@@ -4,32 +4,22 @@
 
 - Python
 - `pip`
-- `componentize-py` 0.17.2
+- `componentize-py` 0.22.0
 
 Once you have `pip` installed, you can install `componentize-py` using:
 
 ```bash
-pip install componentize-py==0.17.2
+pip install componentize-py==0.22.0
 ```
 
 ### Generating the bindings
 
-The bindings are generated from
-[src/spin_sdk/wit/spin.wit](./src/spin_sdk/wit/spin.wit).
+The bindings are generated from the WIT files under
+[src/spin_sdk/wit](./src/spin_sdk/wit).  You can use the `regenerate_bindings.sh`
+script to regenerate them:
 
 ```bash
-componentize-py \
-    -d src/spin_sdk/wit \
-    -w spin-all \
-    --import-interface-name fermyon:spin/postgres@2.0.0=postgres \
-    --import-interface-name spin:postgres/postgres@3.0.0=spin_postgres_postgres \
-    --import-interface-name fermyon:spin/sqlite@2.0.0=sqlite \
-    --world-module spin_sdk.wit \
-    bindings \
-    bindings
-rm -r src/spin_sdk/wit/imports src/spin_sdk/wit/exports
-mv bindings/spin_sdk/wit/* src/spin_sdk/wit/
-rm -r bindings
+bash regenerate_bindings.sh
 ```
 
 ### Updating docs

README.md

@@ -15,7 +15,7 @@ branch.
 - [Python 3.10 or later and pip](https://www.python.org/downloads/)
 - [componentize-py](https://pypi.org/project/componentize-py/)
 - [spin-sdk](https://pypi.org/project/spin-sdk/)
-- [Spin](https://github.com/spinframework/spin) 2.2 or later.
+- [Spin](https://github.com/spinframework/spin) 4.0 or later.
 - [MyPy](https://pypi.org/project/mypy/) -- This is optional, but useful for during development.
 
 Once you have Python and pip installed, you can use the latter to create and
@@ -24,7 +24,7 @@ enter a virtual environment and then install the desired packages
 ```shell
 python -m venv .venv
 source .venv/bin/activate
-pip install componentize-py==0.17.2 spin-sdk==3.4.1 mypy==1.8.0
+pip install componentize-py==0.22.0 spin-sdk==4.0.0 mypy==1.8.0
 ```
 
 ### Hello, World