Metadata-Version: 2.4
Name: aliyun-log-producer
Version: 0.1.2
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: GraalPy
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Rust
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Logging
Classifier: Typing :: Typed
Requires-Dist: packaging>=23 ; extra == 'test'
Requires-Dist: pytest>=8 ; extra == 'test'
Requires-Dist: pytest-timeout>=2 ; extra == 'test'
Requires-Dist: zstandard>=0.23 ; extra == 'test'
Requires-Dist: lz4>=4 ; extra == 'test'
Provides-Extra: test
Summary: Python bindings for the Alibaba Cloud SLS Rust producer
License-Expression: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Issues, https://github.com/aliyun/aliyun-log-python-producer/issues
Project-URL: Repository, https://github.com/aliyun/aliyun-log-python-producer

# SLS Python Producer

简体中文 | [English](README_EN.md)

将日志发送到阿里云日志服务（SLS），支持批量发送、失败重试和结果回调。

构建目标包括 CPython 3.8+、PyPy 3.11 和 GraalPy / Python 3.12–3.13，覆盖 macOS、Windows、Linux；各解释器支持的架构有所不同。详细信息请参阅[平台支持](docs/platforms_cn.md)。

| 文档                                     | 内容                                     |
| ---------------------------------------- | ---------------------------------------- |
| [快速开始](docs/quickstart_cn.md)        | 安装、创建 Producer、发送日志和关闭      |
| [回调](docs/callbacks_cn.md)             | 用最简单的回调查看投递结果               |
| [使用示例](docs/examples_cn.md)          | 回调、flush、关闭、时间戳和多个 Logstore |
| [动态凭证](docs/credentials_cn.md)       | 配置凭证来源，自动缓存和刷新             |
| [开发与发布（英文）](docs/developing.md) | 本地构建、测试和发布                     |
| [配置参考](docs/configuration_cn.md)     | 配置项、默认值和取值范围                 |
| [错误处理](docs/errors_cn.md)            | 错误类型、含义和处理建议                 |

创建 Producer 后即可发送日志，不需要手动启动。程序运行期间复用 Producer 和 writer，退出前关闭。

日志在后台发送。需要确认是否成功时，请使用回调。日志可能乱序或重复；程序异常退出时，尚未发送的日志可能丢失。

[Rust 使用指南](https://github.com/aliyun/aliyun-log-rust-sdk/tree/master/producer)

