Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
66 lines (45 loc) · 1.31 KB

CONTRIBUTING.md

File metadata and controls

66 lines (45 loc) · 1.31 KB
Raw

Building

Prerequisites

  • Python
  • pip
  • componentize-py 0.22.0

Once you have pip installed, you can install componentize-py using:

pip install componentize-py==0.22.0

Generating the bindings

The bindings are generated from the WIT files under src/spin_sdk/wit. You can use the regenerate_bindings.sh script to regenerate them:

bash regenerate_bindings.sh

Updating docs

Any time you regenerate the bindings or edit files by hand, you'll want to regenerate the HTML docs to match. First, install pdoc using pip install pdoc3. Then, update the docs using:

./scripts/generate_docs.py

Building the distribution

First, make sure you have an up-to-date version of the build package installed:

pip install --upgrade build

Then, build the distribution:

rm -rf dist
python -m build

Publishing the distribution

First, make sure you have an up-to-date version of the twine package installed:

pip install --upgrade twine

Then, publish the distribution:

twine upload dist/*

This first time you run that, it will ask for a username and password. Enter __token__ for the username and specify a valid PyPI token as the password. Contact Joel Dice for a token if you don't have one.