zlayer-sdk 0.1.0__tar.gz

zlayer_sdk-0.1.0/.gitignore

@@ -0,0 +1,23 @@
+# ---> Rust
+# Generated by Cargo
+# will have compiled files and executables
+debug/
+target/
+
+# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
+# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
+Cargo.lock
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# MSVC Windows builds of rustc generate these, which store debugging information
+*.pdb
+
+# RustRover
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+.claude/settings.local.json

zlayer_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: zlayer-sdk
+Version: 0.1.0
+Summary: ZLayer Plugin Development Kit for Python
+License-Expression: MIT
+Keywords: plugin,wasi,wasm,zlayer
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: componentize-py>=0.13; extra == 'dev'
+Requires-Dist: mypy>=1.8; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.3; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# ZLayer Python SDK
+
+Plugin Development Kit for building WASM plugins in Python targeting ZLayer.
+
+## Requirements
+
+- Python 3.11+
+- [componentize-py](https://github.com/bytecodealliance/componentize-py) for WASM compilation
+
+## Installation
+
+```bash
+# Using uv (recommended)
+uv add zlayer-sdk
+
+# Or with pip
+pip install zlayer-sdk
+```
+
+## Development Setup
+
+```bash
+# Clone and install in development mode
+cd clients/zlayer-sdk/python
+uv sync --all-extras
+
+# Install componentize-py for WASM compilation
+uv add --dev componentize-py
+```
+
+## Usage
+
+### Basic Plugin Structure
+
+```python
+from zlayer import kv, log
+
+def handle_request(request: bytes) -> bytes:
+    """Plugin entry point called by ZLayer runtime."""
+    # Access key-value storage
+    value = kv.get("my-key")
+
+    # Log messages to host
+    log.info("Processing request")
+
+    # Return response
+    return b"OK"
+```
+
+### Building WASM Component
+
+```bash
+# Generate WIT bindings and compile to WASM
+componentize-py -d ../../wit -w zlayer-plugin componentize my_plugin -o my_plugin.wasm
+```
+
+### Available Host Capabilities
+
+The SDK provides access to ZLayer host functions:
+
+- **kv** - Key-value storage operations
+- **log** - Structured logging
+- **http** - Outbound HTTP requests
+- **config** - Plugin configuration access
+
+## Project Structure
+
+```
+zlayer/
+  __init__.py      # Package root with version
+  py.typed         # PEP 561 type marker
+examples/
+  .gitkeep         # Example plugins (coming soon)
+```
+
+## Type Checking
+
+This package is fully typed and includes a `py.typed` marker for PEP 561 compliance.
+
+```bash
+# Run type checks
+uv run mypy zlayer/
+```
+
+## License
+
+MIT

zlayer_sdk-0.1.0/README.md

@@ -0,0 +1,87 @@
+# ZLayer Python SDK
+
+Plugin Development Kit for building WASM plugins in Python targeting ZLayer.
+
+## Requirements
+
+- Python 3.11+
+- [componentize-py](https://github.com/bytecodealliance/componentize-py) for WASM compilation
+
+## Installation
+
+```bash
+# Using uv (recommended)
+uv add zlayer-sdk
+
+# Or with pip
+pip install zlayer-sdk
+```
+
+## Development Setup
+
+```bash
+# Clone and install in development mode
+cd clients/zlayer-sdk/python
+uv sync --all-extras
+
+# Install componentize-py for WASM compilation
+uv add --dev componentize-py
+```
+
+## Usage
+
+### Basic Plugin Structure
+
+```python
+from zlayer import kv, log
+
+def handle_request(request: bytes) -> bytes:
+    """Plugin entry point called by ZLayer runtime."""
+    # Access key-value storage
+    value = kv.get("my-key")
+
+    # Log messages to host
+    log.info("Processing request")
+
+    # Return response
+    return b"OK"
+```
+
+### Building WASM Component
+
+```bash
+# Generate WIT bindings and compile to WASM
+componentize-py -d ../../wit -w zlayer-plugin componentize my_plugin -o my_plugin.wasm
+```
+
+### Available Host Capabilities
+
+The SDK provides access to ZLayer host functions:
+
+- **kv** - Key-value storage operations
+- **log** - Structured logging
+- **http** - Outbound HTTP requests
+- **config** - Plugin configuration access
+
+## Project Structure
+
+```
+zlayer/
+  __init__.py      # Package root with version
+  py.typed         # PEP 561 type marker
+examples/
+  .gitkeep         # Example plugins (coming soon)
+```
+
+## Type Checking
+
+This package is fully typed and includes a `py.typed` marker for PEP 561 compliance.
+
+```bash
+# Run type checks
+uv run mypy zlayer/
+```
+
+## License
+
+MIT

zlayer_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[project]
+name = "zlayer-sdk"
+version = "0.1.0"
+description = "ZLayer Plugin Development Kit for Python"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+keywords = ["wasm", "wasi", "plugin", "zlayer"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries",
+]
+
+[project.optional-dependencies]
+dev = [
+    "componentize-py>=0.13",
+    "mypy>=1.8",
+    "pytest>=8.0",
+    "ruff>=0.3",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["zlayer"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.mypy]
+python_version = "3.11"
+strict = true