$ show coze-dev/coze-py
The Coze Python SDK (coze-py) is a library that enables Python developers to interact with the Coze platform's APIs, providing both synchronous and asynchronous clients for services such as bot management, chat, workflows, conversations, datasets, audio processing, and more. It handles authentication (including PAT, OAuth variants), makes HTTP requests via httpx, and processes responses using Pydantic models for validation. The SDK follows a modular architecture with a main client class (`Coze`/`AsyncCoze`) that provides access to service-specific clients via properties. Key reusable components include a pluggable authentication system (supporting TokenAuth, JWTAuth, OAuth flows), a generic pagination system for list operations, streaming response handlers for Server-Sent Events and WebSocket messages, a centralized HTTP requester abstraction, and base classes for WebSocket clients. These components demonstrate non-obvious craftsmanship and could be extracted for use in other API clients. The SDK is actively maintained, as evidenced by recent commits and the deprecation of outdated modules in favor of newer alternatives (e.g., `cozepy.datasets` replacing `cozepy.knowledge`). However, it exhibits medium technical drift due to tight coupling to the Coze API (lacking API version abstraction) and potential susceptibility to changes in authentication flows or WebSocket dependencies. Despite these risks, the codebase maintains high quality through type hints, comprehensive testing, linting, and pre-commit hooks.
The LLM identified 4 files worth highlighting for reuse:
Implements a pluggable authentication strategy pattern supporting TokenAuth, JWTAuth, WebOAuthApp, DeviceOAuthApp, and PKCEOAuthApp. This allows the SDK to support multiple authentication methods (PAT, OAuth variants) through a common interface, making it easy to extend with new auth methods and decoupling auth logic from the HTTP requester.
Contains generic pagination classes (NumberPaged, AsyncNumberPaged, TokenPaged, LastIDPaged) and streaming response handlers (Stream, AsyncStream) that abstract away pagination and Server-Sent Events/WebSocket message processing. These components are decoupled from specific API endpoints and can be reused for any paginated or streaming API.
Provides centralized HTTP request handling via the Requester and AsyncRequester classes, including automatic header injection (authentication, logid), timeout management, error handling, and JSON response parsing into Pydantic models. This reduces boilerplate in service clients and ensures consistent error handling and logging.
Defines base classes for WebSocket clients and event handlers that manage connection lifecycle, event dispatching, and reconnection logic. This abstracts away the complexities of WebSocket communication, allowing service-specific WebSocket clients (like chat) to focus on event processing.