Metadata-Version: 2.4
Name: tikeo
Version: 0.1.916
Summary: Python Worker SDK for tikeo
Author: tikeo contributors
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/yhyzgn/tikeo
Project-URL: Repository, https://github.com/yhyzgn/tikeo
Project-URL: Issues, https://github.com/yhyzgn/tikeo/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: grpcio>=1.76.0
Requires-Dist: grpcio-tools>=1.76.0
Requires-Dist: protobuf>=6.0.0
Requires-Dist: requests>=2.32.0
Provides-Extra: test
Requires-Dist: pytest>=9.0.0; extra == "test"

# Tikeo Python Worker SDK 🐍

[🇨🇳 中文 SDK 文档](../../../docs/zh-CN/sdk.md)

Python SDK aligned with the Java, Rust, Go, and Node.js Worker SDKs.

## Features

- Worker Tunnel client with structured capabilities.
- Task processors and precise task-scoped logs.
- Standard-library SDK diagnostics through `configure_logging(LogConfig.from_env())`.
- Optional SDK file output to `tikeo-sdk.log`.
- Management API client using `x-tikeo-api-key`.
- SRT/Deno/container/local script runners and fail-closed unavailable handlers.

## Usage

```python
from tikeo import Client, LogConfig, configure_logging, local_config

configure_logging(LogConfig.from_env())
config = local_config("http://127.0.0.1:9998", "orders-python-1")
config.namespace = "dev-alpha"
config.app = "orders"
config.add_sdk_processor("demo.echo")
client = Client(config)
```

## Operational cautions

- Do not log API keys or raw payloads through SDK diagnostics.
- Use task context logging for execution output that belongs in instance logs.
- Keep script runners fail-closed when sandbox tools are unavailable.

## Verification

```bash
python -m pip install -e .[test]
python -m pytest
```
