Metadata-Version: 2.4
Name: pymergetic-wasmmod-tools
Version: 0.2.0a2
Summary: Host-side wasmmod tooling: pack, sign, inspect, ELF, CDN
Author-email: Rouven Raudzus <raudzus@pymergetic.com>
License: MIT
Project-URL: Homepage, https://github.com/pymergetic-wasmmod/wasmmod-tools
Project-URL: Documentation, https://github.com/pymergetic-wasmmod/wasmmod-tools#readme
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Provides-Extra: cdn
Requires-Dist: pymergetic-wasmmod-cdn-client>=0.2.0a1; extra == "cdn"
Provides-Extra: inspect
Requires-Dist: pyelftools>=0.31; extra == "inspect"
Requires-Dist: capstone>=5.0; extra == "inspect"
Provides-Extra: dev
Requires-Dist: pytest>=8.3.0; extra == "dev"
Requires-Dist: ruff>=0.8.0; extra == "dev"
Requires-Dist: pymergetic-wasmmod-cdn-client>=0.2.0a1; extra == "dev"
Requires-Dist: pyelftools>=0.31; extra == "dev"
Requires-Dist: capstone>=5.0; extra == "dev"

# wasmmod-tools

Host-side tooling for [wasmmod](https://github.com/pymergetic-wasmmod/wasmmod): pack, sign,
ELF helpers, inspect, publish, CDN CLI.

PyPI: **`pymergetic-wasmmod-tools`** · import: **`pymergetic.wasmmod.tools`**

| Component | Role | Repo |
|-----------|------|------|
| wasmmod | Runtime + pack tree (`pymergetic-wasmmod`) | [pymergetic-wasmmod/wasmmod](https://github.com/pymergetic-wasmmod/wasmmod) · `main` |
| **wasmmod-tools** | **This repo** — host CLI | [pymergetic-wasmmod/wasmmod-tools](https://github.com/pymergetic-wasmmod/wasmmod-tools) · `main` |
| wasmmod-test | External pack/CDN consumer sample | [pymergetic-wasmmod/wasmmod-test](https://github.com/pymergetic-wasmmod/wasmmod-test) · `main` |
| wasmmod-cdn | CDN server + client | [pymergetic-wasmmod/wasmmod-cdn](https://github.com/pymergetic-wasmmod/wasmmod-cdn) · `main` |
| metalpython | Metal product µPy — rebuilt on the wasmmod engine | [pymergetic/metalpython](https://github.com/pymergetic/metalpython) · `main` |

```sh
# current releases are alphas — always use --pre
pip install --pre 'pymergetic-wasmmod-tools[cdn,inspect]'
export WASMMOD_ROOT=/path/to/wasmmod   # for pack / read / examples
wasmmod pack examples/hello -o hello.wasm
wasmmod inspect hello.wasm
wasmmod --help
```

Editable (os-sdk):

```sh
pip install -e '../wasmmod-tools[cdn,inspect]'
```

PEP 420: `pymergetic` / `wasmmod` are namespaces; `tools` is the leaf package.

## Trusted Publishing

| Field | Value |
|-------|--------|
| PyPI Project Name | `pymergetic-wasmmod-tools` |
| Owner | `pymergetic` |
| Repository | `wasmmod-tools` |
| Workflow name | `publish-pypi-tools.yml` |
| Environment | *(empty / any)* |
