cozeloop 0.1.25__tar.gz

cozeloop-0.1.25/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cozeloop-0.1.25/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: cozeloop
+Version: 0.1.25
+Summary: coze loop sdk
+License: MIT
+License-File: LICENSE
+Author: JiangQi715
+Author-email: jiangqi.rrt@bytedance.com
+Requires-Python: >=3.8,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: apscheduler (>=3.11.0,<4.0.0)
+Requires-Dist: authlib (>=1.2.0,<2.0.0)
+Requires-Dist: cachetools (>=5.5.2,<7.0.0)
+Requires-Dist: httpx (>=0.23.0,<1.0.0)
+Requires-Dist: jinja2 (>=3.1.6,<4.0.0)
+Requires-Dist: pydantic (>=1.10.12,<3.0.0)
+Description-Content-Type: text/markdown
+
+# CozeLoop Python SDK
+English | [简体中文](README.zh_CN.md)
+
+## Overview
+
+The CozeLoop SDK is a Python client for interacting with [CozeLoop platform](https://loop.coze.cn).
+Key features:
+- Report trace
+- Get and format prompt
+- Execute Prompt as a Service (PTaaS)
+
+## Requirements
+- Python 3.8 or higher
+
+## Installation
+
+`pip install CozeLoop`
+
+## Usage
+
+### Initialize
+
+To get started, visit https://www.coze.cn/open/oauth/apps and create an OAuth app.
+Then you can get your owner appid, public key and private key.
+
+Set your environment variables:
+```bash
+export COZELOOP_WORKSPACE_ID=your workspace id
+export COZELOOP_JWT_OAUTH_CLIENT_ID=your client id
+export COZELOOP_JWT_OAUTH_PRIVATE_KEY=your private key
+export COZELOOP_JWT_OAUTH_PUBLIC_KEY_ID=your public key id
+```
+
+### Report Trace
+
+```python
+def main():
+    span = cozeloop.start_span("root", "custom")
+
+    span.set_input("Hello") 
+    span.set_output("World") 
+	
+    span.finish()
+	
+    cozeloop.close()
+```
+
+### Get Prompt
+```python
+def main():
+    prompt = cozeloop.get_prompt(prompt_key="your_prompt_key")
+    messages = cozeloop.prompt_format(
+        prompt,
+        {"var1": "your content"},
+    )
+```
+
+You can see more examples [here](examples).
+
+## Contribution
+
+Please check [Contributing](CONTRIBUTING.md) for more details.
+
+## Security
+
+If you discover a potential security issue in this project, or think you may
+have discovered a security issue, we ask that you notify Bytedance Security via our [security center](https://security.bytedance.com/src) or [vulnerability reporting email](sec@bytedance.com).
+
+Please do **not** create a public GitHub issue.
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).
+

cozeloop-0.1.25/README.md

@@ -0,0 +1,73 @@
+# CozeLoop Python SDK
+English | [简体中文](README.zh_CN.md)
+
+## Overview
+
+The CozeLoop SDK is a Python client for interacting with [CozeLoop platform](https://loop.coze.cn).
+Key features:
+- Report trace
+- Get and format prompt
+- Execute Prompt as a Service (PTaaS)
+
+## Requirements
+- Python 3.8 or higher
+
+## Installation
+
+`pip install CozeLoop`
+
+## Usage
+
+### Initialize
+
+To get started, visit https://www.coze.cn/open/oauth/apps and create an OAuth app.
+Then you can get your owner appid, public key and private key.
+
+Set your environment variables:
+```bash
+export COZELOOP_WORKSPACE_ID=your workspace id
+export COZELOOP_JWT_OAUTH_CLIENT_ID=your client id
+export COZELOOP_JWT_OAUTH_PRIVATE_KEY=your private key
+export COZELOOP_JWT_OAUTH_PUBLIC_KEY_ID=your public key id
+```
+
+### Report Trace
+
+```python
+def main():
+    span = cozeloop.start_span("root", "custom")
+
+    span.set_input("Hello") 
+    span.set_output("World") 
+	
+    span.finish()
+	
+    cozeloop.close()
+```
+
+### Get Prompt
+```python
+def main():
+    prompt = cozeloop.get_prompt(prompt_key="your_prompt_key")
+    messages = cozeloop.prompt_format(
+        prompt,
+        {"var1": "your content"},
+    )
+```
+
+You can see more examples [here](examples).
+
+## Contribution
+
+Please check [Contributing](CONTRIBUTING.md) for more details.
+
+## Security
+
+If you discover a potential security issue in this project, or think you may
+have discovered a security issue, we ask that you notify Bytedance Security via our [security center](https://security.bytedance.com/src) or [vulnerability reporting email](sec@bytedance.com).
+
+Please do **not** create a public GitHub issue.
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

cozeloop-0.1.25/cozeloop/__init__.py

@@ -0,0 +1,35 @@
+# Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+# SPDX-License-Identifier: MIT
+
+from .entities.prompt import Prompt, Message
+from .logger import set_log_level, add_log_handler
+
+from .internal import __version__
+from .internal.consts import (
+    CN_BASE_URL,
+)
+from .internal.consts.error import *
+
+from .client import Client
+from ._client import (
+    new_client,
+    set_default_client,
+    workspace_id,
+    close,
+    get_prompt,
+    prompt_format,
+    execute_prompt,
+    aexecute_prompt,
+    start_span,
+    get_span_from_context,
+    get_span_from_header,
+    flush,
+    ENV_API_BASE_URL,
+    ENV_WORKSPACE_ID,
+    ENV_API_TOKEN,
+    ENV_JWT_OAUTH_CLIENT_ID,
+    ENV_JWT_OAUTH_PRIVATE_KEY,
+    ENV_JWT_OAUTH_PUBLIC_KEY_ID
+)
+
+from .span import SpanContext, Span