sprites-py 0.0.1a1__tar.gz

sprites_py-0.0.1a1/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: sprites-py
+Version: 0.0.1a1
+Summary: Python SDK for the Sprites API
+Author: Sprites Team
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+
+# Sprites Python SDK
+
+Python SDK for [Sprites](https://sprites.dev) - remote command execution platform.
+
+## Installation
+
+```bash
+pip install sprites-py
+```
+
+## Quick Start
+
+```python
+from sprites import SpritesClient
+
+# Create a client
+client = SpritesClient(token="your-token")
+
+# Get a sprite handle
+sprite = client.sprite("my-sprite")
+
+# Run a command
+result = sprite.run("echo", "hello", capture_output=True)
+print(result.stdout.decode())  # "hello\n"
+
+# Or use the Go-style API
+cmd = sprite.command("ls", "-la")
+output = cmd.output()
+print(output.decode())
+```
+
+## API Overview
+
+### SpritesClient
+
+```python
+from sprites import SpritesClient
+
+client = SpritesClient(
+    token="your-token",
+    base_url="https://api.sprites.dev",  # optional
+    timeout=30.0,  # optional
+)
+
+# Create a sprite
+sprite = client.create_sprite("my-sprite")
+
+# Get a sprite handle (doesn't create it)
+sprite = client.sprite("my-sprite")
+
+# Delete a sprite
+client.delete_sprite("my-sprite")
+```
+
+### Sprite
+
+```python
+# Run a command (subprocess.run style)
+result = sprite.run("echo", "hello", capture_output=True, timeout=30)
+print(result.returncode)
+print(result.stdout)
+
+# Create a command (Go exec.Cmd style)
+cmd = sprite.command("bash", "-c", "echo hello")
+output = cmd.output()  # Returns stdout
+combined = cmd.combined_output()  # Returns stdout + stderr
+
+# TTY mode
+cmd = sprite.command("bash", tty=True, tty_rows=24, tty_cols=80)
+cmd.run()
+```
+
+### Checkpoints
+
+```python
+# List checkpoints
+checkpoints = sprite.list_checkpoints()
+
+# Create a checkpoint
+stream = sprite.create_checkpoint("my checkpoint")
+for msg in stream:
+    print(msg.type, msg.data)
+
+# Restore a checkpoint
+stream = sprite.restore_checkpoint("checkpoint-id")
+for msg in stream:
+    print(msg.type, msg.data)
+```
+
+### Network Policy
+
+```python
+from sprites.types import NetworkPolicy, PolicyRule
+
+# Get current policy
+policy = sprite.get_network_policy()
+
+# Update policy
+new_policy = NetworkPolicy(rules=[
+    PolicyRule(domain="example.com", action="allow"),
+])
+sprite.update_network_policy(new_policy)
+```
+
+## Requirements
+
+- Python 3.11+
+- websockets
+- httpx
+
+## License
+
+MIT

sprites_py-0.0.1a1/README.md

@@ -0,0 +1,113 @@
+# Sprites Python SDK
+
+Python SDK for [Sprites](https://sprites.dev) - remote command execution platform.
+
+## Installation
+
+```bash
+pip install sprites-py
+```
+
+## Quick Start
+
+```python
+from sprites import SpritesClient
+
+# Create a client
+client = SpritesClient(token="your-token")
+
+# Get a sprite handle
+sprite = client.sprite("my-sprite")
+
+# Run a command
+result = sprite.run("echo", "hello", capture_output=True)
+print(result.stdout.decode())  # "hello\n"
+
+# Or use the Go-style API
+cmd = sprite.command("ls", "-la")
+output = cmd.output()
+print(output.decode())
+```
+
+## API Overview
+
+### SpritesClient
+
+```python
+from sprites import SpritesClient
+
+client = SpritesClient(
+    token="your-token",
+    base_url="https://api.sprites.dev",  # optional
+    timeout=30.0,  # optional
+)
+
+# Create a sprite
+sprite = client.create_sprite("my-sprite")
+
+# Get a sprite handle (doesn't create it)
+sprite = client.sprite("my-sprite")
+
+# Delete a sprite
+client.delete_sprite("my-sprite")
+```
+
+### Sprite
+
+```python
+# Run a command (subprocess.run style)
+result = sprite.run("echo", "hello", capture_output=True, timeout=30)
+print(result.returncode)
+print(result.stdout)
+
+# Create a command (Go exec.Cmd style)
+cmd = sprite.command("bash", "-c", "echo hello")
+output = cmd.output()  # Returns stdout
+combined = cmd.combined_output()  # Returns stdout + stderr
+
+# TTY mode
+cmd = sprite.command("bash", tty=True, tty_rows=24, tty_cols=80)
+cmd.run()
+```
+
+### Checkpoints
+
+```python
+# List checkpoints
+checkpoints = sprite.list_checkpoints()
+
+# Create a checkpoint
+stream = sprite.create_checkpoint("my checkpoint")
+for msg in stream:
+    print(msg.type, msg.data)
+
+# Restore a checkpoint
+stream = sprite.restore_checkpoint("checkpoint-id")
+for msg in stream:
+    print(msg.type, msg.data)
+```
+
+### Network Policy
+
+```python
+from sprites.types import NetworkPolicy, PolicyRule
+
+# Get current policy
+policy = sprite.get_network_policy()
+
+# Update policy
+new_policy = NetworkPolicy(rules=[
+    PolicyRule(domain="example.com", action="allow"),
+])
+sprite.update_network_policy(new_policy)
+```
+
+## Requirements
+
+- Python 3.11+
+- websockets
+- httpx
+
+## License
+
+MIT

sprites_py-0.0.1a1/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sprites-py"
+version = "0.0.1-alpha.1"
+description = "Python SDK for the Sprites API"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+authors = [
+    {name = "Sprites Team"}
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "httpx>=0.25.0",
+    "websockets>=12.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21.0",
+    "mypy>=1.0",
+]
+
+[project.scripts]
+sprites-cli = "sprites.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.mypy]
+python_version = "0.0.1-alpha.1"
+warn_return_any = true
+warn_unused_configs = true

sprites_py-0.0.1a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sprites_py-0.0.1a1/src/sprites/__init__.py

@@ -0,0 +1,109 @@
+"""
+Sprites SDK for Python
+
+A Python SDK for interacting with the Sprites API, providing filesystem,
+checkpoint, services, and network policy management.
+
+Usage:
+    from sprites import SpritesClient
+
+    client = SpritesClient(token="your-token")
+    sprite = client.sprite("my-sprite")
+
+    # Filesystem operations (pathlib.Path-like API)
+    fs = sprite.filesystem("/app")
+    config = (fs / "config.json").read_text()
+    (fs / "output.txt").write_text("Hello, World!")
+
+    # List directory contents
+    for entry in (fs / "data").iterdir():
+        print(entry.name)
+"""
+
+from .client import SpritesClient
+from .sprite import Sprite
+from .filesystem import SpriteFilesystem, SpritePath
+from .exceptions import (
+    SpriteError,
+    NetworkError,
+    AuthenticationError,
+    NotFoundError,
+    ExecError,
+    FilesystemError,
+    FileNotFoundError_,
+    IsADirectoryError_,
+    NotADirectoryError_,
+    PermissionError_,
+    DirectoryNotEmptyError,
+)
+from .types import (
+    ClientOptions,
+    URLSettings,
+    SpriteConfig,
+    SpawnOptions,
+    ExecOptions,
+    ExecResult,
+    SpriteInfo,
+    ListOptions,
+    SpriteList,
+    Session,
+    Checkpoint,
+    StreamMessage,
+    PortMapping,
+    Service,
+    ServiceState,
+    ServiceWithState,
+    ServiceRequest,
+    ServiceLogEvent,
+    PolicyRule,
+    NetworkPolicy,
+    FileStat,
+    DirEntry,
+)
+
+__version__ = "0.0.1-alpha.1"
+
+__all__ = [
+    # Main classes
+    "SpritesClient",
+    "Sprite",
+    "SpriteFilesystem",
+    "SpritePath",
+    # Exceptions
+    "SpriteError",
+    "NetworkError",
+    "AuthenticationError",
+    "NotFoundError",
+    "ExecError",
+    "FilesystemError",
+    "FileNotFoundError_",
+    "IsADirectoryError_",
+    "NotADirectoryError_",
+    "PermissionError_",
+    "DirectoryNotEmptyError",
+    # Types
+    "ClientOptions",
+    "URLSettings",
+    "SpriteConfig",
+    "SpawnOptions",
+    "ExecOptions",
+    "ExecResult",
+    "SpriteInfo",
+    "ListOptions",
+    "SpriteList",
+    "Session",
+    "Checkpoint",
+    "StreamMessage",
+    "PortMapping",
+    "Service",
+    "ServiceState",
+    "ServiceWithState",
+    "ServiceRequest",
+    "ServiceLogEvent",
+    "PolicyRule",
+    "NetworkPolicy",
+    "FileStat",
+    "DirEntry",
+    # Version
+    "__version__",
+]