pylogging-ext 0.1.0__tar.gz

pylogging_ext-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2022] [QASP]
+
+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.

pylogging_ext-0.1.0/MANIFEST.in

@@ -0,0 +1,9 @@
+include LICENSE
+include README.md
+include MANIFEST.in
+
+include requirements.txt
+
+exclude tests/*
+recursive-exclude tests *
+prune tests

pylogging_ext-0.1.0/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: pylogging-ext
+Version: 0.1.0
+Summary: 一个支持 异步、批量、重试、多通道通知 的 logging 扩展库。
+Home-page: https://github.com/cnmax/pylogging-ext
+Author: chao
+Author-email: mr.qchao@gmail.com
+License: MIT
+Project-URL: Homepage, https://github.com/cnmax/pylogging-ext
+Project-URL: Bug Tracker, https://github.com/cnmax/pylogging-ext/issues
+Project-URL: Source Code, https://github.com/cnmax/pylogging-ext
+Keywords: logging,async logging,handler,cls,tencent cloud,wechat,telegram,notification,monitoring
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+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: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: System :: Logging
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Software Development :: Libraries
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: tencentcloud-cls-sdk-python
+Provides-Extra: socks
+Requires-Dist: requests[socks]; extra == "socks"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: summary
+
+# pylogging-ext
+
+[![PyPI](https://img.shields.io/pypi/v/pylogging-ext.svg)](https://pypi.python.org/pypi/pylogging-ext)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pylogging-ext)
+![PyPI - License](https://img.shields.io/pypi/l/pylogging-ext)
+![GitHub last commit](https://img.shields.io/github/last-commit/cnmaxqi/pylogging-ext)
+
+一个支持 异步、批量、重试、多通道通知 的 logging 扩展库。
+
+> 不只是 logging handler，更是通知基础设施
+
+## 安装
+
+```bash
+pip install pylogging-ext
+```
+可选（支持 socks 代理）：
+```bash
+pip install pylogging-ext[socks]
+```
+
+## 使用
+
+```python
+import logging
+from pylogging_ext import TelegramHandler
+
+logger = logging.getLogger('demo')
+logger.setLevel(logging.INFO)
+
+handler = TelegramHandler(
+    token='your-bot-token',
+    chat_id='your-chat-id',
+)
+
+logger.addHandler(handler)
+
+logger.error('发生错误了')
+```
+
+## API
+
+### Class: BaseHandler
+
+通用异步 Handler 基类，所有通知 Handler 均继承自此类。
+
+#### BaseHandler(...)
+
+- `batch_size` 批量发送大小
+- `flush_interval` 刷新间隔 (秒)
+- `queue_size` 队列大小
+- `retry` 重试次数
+
+#### 特性：
+- 异步发送（非阻塞）
+- 批量处理
+- 指数退避重试
+- 优雅关闭
+
+## 腾讯云 CLS
+### Class: TencentCloudCLSHandler
+
+```pycon
+from pylogging_ext import TencentCloudCLSHandler
+
+handler = TencentCloudCLSHandler(
+    endpoint='ap-shanghai.cls.tencentcs.com',
+    secret_id='your-secret-id',
+    secret_key='your-secret-key',
+    topic_id='your-topic-id',
+)
+```
+### 参数
+- `endpoint` CLS接入地址
+- `secret_id` 腾讯云密钥
+- `secret_key` 腾讯云密钥
+- `topic_id` 日志主题 ID
+
+## 微信机器人
+### Class: WeChatHandler
+
+```pycon
+from pylogging_ext import WeChatHandler
+
+handler = WeChatHandler(
+    webhook='https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx'
+)
+```
+
+### 参数
+- `webhook` 企业微信机器人地址
+
+## Telegram
+### Class: TelegramHandler
+
+```pycon
+from pylogging_ext import TelegramHandler
+
+handler = TelegramHandler(
+    token='your-bot-token',
+    chat_id='your-chat-id',
+    proxies={
+        'http': 'http://127.0.0.1:7890',
+        'https': 'http://127.0.0.1:7890',
+    }
+)
+```
+### 参数
+- `token` Telegram Bot Token
+- `chat_id` 聊天 ID
+- `proxies` 代理配置（可选）
+- `ssl_verify` SSL校验 (默认 True)
+
+## 支持的通知渠道
+- 腾讯云 CLS
+- 企业微信
+- Telegram
+
+持续扩展中...

pylogging_ext-0.1.0/README.md

@@ -0,0 +1,119 @@
+# pylogging-ext
+
+[![PyPI](https://img.shields.io/pypi/v/pylogging-ext.svg)](https://pypi.python.org/pypi/pylogging-ext)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pylogging-ext)
+![PyPI - License](https://img.shields.io/pypi/l/pylogging-ext)
+![GitHub last commit](https://img.shields.io/github/last-commit/cnmaxqi/pylogging-ext)
+
+一个支持 异步、批量、重试、多通道通知 的 logging 扩展库。
+
+> 不只是 logging handler，更是通知基础设施
+
+## 安装
+
+```bash
+pip install pylogging-ext
+```
+可选（支持 socks 代理）：
+```bash
+pip install pylogging-ext[socks]
+```
+
+## 使用
+
+```python
+import logging
+from pylogging_ext import TelegramHandler
+
+logger = logging.getLogger('demo')
+logger.setLevel(logging.INFO)
+
+handler = TelegramHandler(
+    token='your-bot-token',
+    chat_id='your-chat-id',
+)
+
+logger.addHandler(handler)
+
+logger.error('发生错误了')
+```
+
+## API
+
+### Class: BaseHandler
+
+通用异步 Handler 基类，所有通知 Handler 均继承自此类。
+
+#### BaseHandler(...)
+
+- `batch_size` 批量发送大小
+- `flush_interval` 刷新间隔 (秒)
+- `queue_size` 队列大小
+- `retry` 重试次数
+
+#### 特性：
+- 异步发送（非阻塞）
+- 批量处理
+- 指数退避重试
+- 优雅关闭
+
+## 腾讯云 CLS
+### Class: TencentCloudCLSHandler
+
+```pycon
+from pylogging_ext import TencentCloudCLSHandler
+
+handler = TencentCloudCLSHandler(
+    endpoint='ap-shanghai.cls.tencentcs.com',
+    secret_id='your-secret-id',
+    secret_key='your-secret-key',
+    topic_id='your-topic-id',
+)
+```
+### 参数
+- `endpoint` CLS接入地址
+- `secret_id` 腾讯云密钥
+- `secret_key` 腾讯云密钥
+- `topic_id` 日志主题 ID
+
+## 微信机器人
+### Class: WeChatHandler
+
+```pycon
+from pylogging_ext import WeChatHandler
+
+handler = WeChatHandler(
+    webhook='https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx'
+)
+```
+
+### 参数
+- `webhook` 企业微信机器人地址
+
+## Telegram
+### Class: TelegramHandler
+
+```pycon
+from pylogging_ext import TelegramHandler
+
+handler = TelegramHandler(
+    token='your-bot-token',
+    chat_id='your-chat-id',
+    proxies={
+        'http': 'http://127.0.0.1:7890',
+        'https': 'http://127.0.0.1:7890',
+    }
+)
+```
+### 参数
+- `token` Telegram Bot Token
+- `chat_id` 聊天 ID
+- `proxies` 代理配置（可选）
+- `ssl_verify` SSL校验 (默认 True)
+
+## 支持的通知渠道
+- 腾讯云 CLS
+- 企业微信
+- Telegram
+
+持续扩展中...

pylogging_ext-0.1.0/pylogging_ext/__init__.py

@@ -0,0 +1,6 @@
+from .base import BaseHandler
+from .cls import TencentCloudCLSHandler
+from .telegram import TelegramHandler
+from .wechat import WeChatHandler
+
+__all__ = ['BaseHandler', 'WeChatHandler', 'TelegramHandler', 'TencentCloudCLSHandler']

pylogging_ext-0.1.0/pylogging_ext/base.py

@@ -0,0 +1,199 @@
+import logging
+import queue
+import threading
+import time
+import traceback
+from datetime import datetime, timezone
+
+
+class BaseHandler(logging.Handler):
+    """
+    通用异步通知 Handler 基类
+    """
+
+    def __init__(
+        self,
+        level=logging.NOTSET,
+        batch_size=10,
+        flush_interval=3.0,
+        queue_size=1000,
+        retry=1,
+    ):
+        super().__init__(level)
+
+        # 内部日志
+        self._internal_logger = logging.getLogger('pylogging_ext.internal')
+        self._internal_logger.propagate = False
+
+        if not self._internal_logger.handlers:
+            handler = logging.StreamHandler()
+            formatter = logging.Formatter(
+                '%(asctime)s [%(levelname)s] %(name)s: %(message)s'
+            )
+            handler.setFormatter(formatter)
+            self._internal_logger.addHandler(handler)
+
+        # 批量参数
+        self.batch_size = batch_size
+        self.flush_interval = flush_interval
+
+        # 重试次数
+        self.retry = retry
+
+        # 丢弃统计
+        self._drop_count = 0
+
+        # 队列
+        self.queue = queue.Queue(maxsize=queue_size)
+
+        # 停止信号
+        self._stop_event = threading.Event()
+
+        # worker 线程
+        self.worker = threading.Thread(
+            target=self._worker,
+            name='BaseHandlerWorker',
+            daemon=True,
+        )
+        self.worker.start()
+
+    def emit(self, record):
+        """logging入口"""
+        try:
+            payload = self.build_payload(record)
+            self.queue.put_nowait(payload)
+
+        except queue.Full:
+            self._drop_count += 1
+
+            if self._drop_count % 100 == 0:
+                self._internal_logger.warning(
+                    'log dropped count=%s', self._drop_count
+                )
+
+        except Exception:
+            self.handleError(record)
+
+    def _worker(self):
+        """worker主循环"""
+        buffer = []
+        last_flush = time.monotonic()
+
+        while not self._stop_event.is_set() or not self.queue.empty():
+            try:
+                log = self.queue.get(timeout=1)
+
+                try:
+                    if log is None:
+                        # 收到退出信号
+                        break
+
+                    buffer.append(log)
+
+                finally:
+                    self.queue.task_done()
+
+            except queue.Empty:
+                pass
+
+            now = time.monotonic()
+
+            # flush条件：
+            # 1. 达到 batch_size
+            # 2. 超过 flush_interval
+            if (
+                len(buffer) >= self.batch_size
+                or (buffer and now - last_flush >= self.flush_interval)
+            ):
+                self._flush(buffer[:])
+                buffer.clear()
+                last_flush = now
+
+        # 兜底flush
+        if buffer:
+            self._flush(buffer)
+
+    def _flush(self, logs):
+        """
+        带重试的发送逻辑（指数退避）
+        """
+        for i in range(self.retry + 1):
+            attempt = i + 1
+
+            try:
+                self.send(logs)
+                return
+
+            except Exception as e:
+                self._handle_send_error(e, attempt=attempt)
+
+                if i < self.retry:
+                    if self._stop_event.wait(2 ** i):
+                        return
+
+                else:
+                    self._handle_final_failure(e)
+
+    def _handle_send_error(self, error, attempt):
+        self._internal_logger.warning(
+            'send failed attempt=%s error=%s',
+            attempt,
+            error,
+        )
+
+    def _handle_final_failure(self, error):
+        self._internal_logger.error(
+            'FINAL send failure error=%s',
+            error,
+        )
+
+    def build_payload(self, record):
+        """构建日志结构"""
+        payload = {
+            'level': record.levelname,
+            'location': f'{record.module}.{record.funcName}({record.pathname}:{record.lineno})',
+            'log': self.format(record),
+            'message': record.getMessage(),
+            'thread': record.threadName,
+            'time': datetime.fromtimestamp(
+                record.created,
+                tz=timezone.utc,
+            ).strftime('%Y-%m-%dT%H:%M:%S%z'),
+            'timestamp': record.created,
+        }
+
+        if record.exc_info:
+            payload['exc_info'] = ''.join(
+                traceback.format_exception(*record.exc_info)
+            )
+
+        return payload
+
+    def send(self, logs):
+        """
+        子类必须实现
+        :param logs: List[dict]
+        """
+        raise NotImplementedError
+
+    def close(self):
+        """优雅关闭"""
+        # 停止接收新任务
+        self._stop_event.set()
+
+        # 发送退出信号
+        while True:
+            try:
+                self.queue.put(None, timeout=1)
+                break
+
+            except queue.Full:
+                time.sleep(0.1)
+
+        # 等待队列消费完成
+        self.queue.join()
+
+        # 等待线程退出
+        self.worker.join(timeout=5)
+
+        super().close()

pylogging_ext-0.1.0/pylogging_ext/cls.py

@@ -0,0 +1,93 @@
+import logging
+
+from tencentcloud.log.cls_pb2 import LogGroupList, Log
+from tencentcloud.log.logclient import LogClient
+from tencentcloud.log.logexception import LogException
+
+from pylogging_ext import BaseHandler
+
+
+class TencentCloudCLSHandler(BaseHandler):
+    """腾讯云 CLS Handler"""
+
+    def __init__(
+        self,
+        endpoint,
+        secret_id,
+        secret_key,
+        topic_id,
+        security_token=None,
+        source=None,
+        region='',
+        is_https=False,
+        timeout=3,
+        batch_size=10,
+        flush_interval=3,
+        level=logging.NOTSET,
+        queue_size=1000,
+        retry=2,
+    ):
+        super().__init__(
+            level=level,
+            batch_size=batch_size,
+            flush_interval=flush_interval,
+            queue_size=queue_size,
+            retry=retry,
+        )
+
+        self.client = LogClient(
+            endpoint,
+            secret_id,
+            secret_key,
+            securityToken=security_token,
+            source=source,
+            region=region,
+            is_https=is_https,
+        )
+        self.client.timeout = timeout
+
+        self.topic_id = topic_id
+
+    @classmethod
+    def make_log(cls, log):
+        pb_log = Log()
+        pb_log.time = int(log.get('timestamp') * 1000000)
+
+        for key in [
+            'level',
+            'location',
+            'log',
+            'message',
+            'thread',
+            'time',
+        ]:
+            content = pb_log.contents.add()
+            content.key = key
+            content.value = str(log.get(key, ''))
+
+        if log.get('exc_info'):
+            content = pb_log.contents.add()
+            content.key = 'exc_info'
+            content.value = str(log.get('exc_info'))
+
+        return pb_log
+
+    def send(self, logs):
+        """批量发送到 CLS"""
+        log_group_list = LogGroupList()
+        log_group = log_group_list.logGroupList.add()
+
+        # metadata
+        log_group.filename = 'pylogging_ext.log'
+        log_group.source = getattr(self.client, '_source', '')
+
+        for log in logs:
+            log_group.logs.append(self.make_log(log))
+
+        try:
+            self.client.put_log_raw(self.topic_id, log_group_list)
+
+        except LogException as e:
+            raise Exception(
+                f'CLS API error [{e.get_error_code()}]: {e.get_error_message()}'
+            )

pylogging_ext-0.1.0/pylogging_ext/dingtalk.py

@@ -0,0 +1,5 @@
+from pylogging_ext import BaseHandler
+
+
+class DingTalkHandler(BaseHandler):
+    """钉钉机器人 Handler"""

pylogging_ext-0.1.0/pylogging_ext/telegram.py

@@ -0,0 +1,111 @@
+import logging
+
+from requests import Session
+
+from pylogging_ext import BaseHandler
+
+
+def _escape_html(text: str) -> str:
+    if not text:
+        return ''
+
+    return (
+        str(text).strip()
+        .replace('&', '&')
+        .replace('<', '&lt;')
+        .replace('>', '&gt;')
+    )
+
+
+class TelegramHandler(BaseHandler):
+    """Telegram机器人 Handler"""
+
+    def __init__(
+        self,
+        token,
+        chat_id,
+        timeout=3,
+        level=logging.NOTSET,
+        queue_size=1000,
+        retry=2,
+        proxies=None,
+        ssl_verify=True,
+        endpoint='https://api.telegram.org',
+    ):
+        super().__init__(
+            level=level,
+            batch_size=1,
+            queue_size=queue_size,
+            retry=retry,
+        )
+
+        self.chat_id = chat_id
+        self.api_url = f'{endpoint}/bot{token}/sendMessage'
+
+        self.session = Session()
+
+        if proxies:
+            self.session.proxies.update(proxies)
+
+        self.session.verify = ssl_verify
+        self.timeout = timeout
+
+    def make_html_message(self, log):
+        """
+        构建 Telegram HTML 消息
+
+        - 标题：level + message
+        - 正文：log / exc_info
+        - 附加信息：thread / location
+        """
+
+        level = log.get('level', 'INFO')
+        message = _escape_html(log.get('message'))
+
+        # 标题
+        content = f'<b>{level}: {message}</b>\n\n'
+
+        # 优先展示异常
+        if log.get('exc_info'):
+            content += (
+                f'<pre>'
+                f'{_escape_html(log["exc_info"])}'
+                f'</pre>'
+            )
+        else:
+            content += (
+                f'<pre>'
+                f'{_escape_html(log["log"])}'
+                f'</pre>'
+            )
+
+        # 附加信息
+        content += (
+            f'\n '
+            f'\n <i>Thread: {log["thread"]}</i>'
+            f'\n <i>Location: {log["location"]}</i>'
+        )
+
+        return {
+            'chat_id': self.chat_id,
+            'text': content,
+            'parse_mode': 'HTML',
+            'disable_web_page_preview': True,
+        }
+
+    def send(self, logs):
+        """发送到 Telegram"""
+        resp = self.session.post(
+            self.api_url,
+            timeout=self.timeout,
+            json=self.make_html_message(logs[0]),
+        )
+
+        # HTTP 错误
+        resp.raise_for_status()
+
+        result = resp.json()
+
+        # Telegram 返回错误
+        if not result.get('ok', False):
+            raise Exception('Telegram API error [{error_code}]: {description}'.format_map(result))

pylogging_ext-0.1.0/pylogging_ext/wechat.py

@@ -0,0 +1,100 @@
+import logging
+
+import requests
+
+from pylogging_ext import BaseHandler
+
+
+def _safe_text(text):
+    if not text:
+        return ''
+
+    return (
+        str(text).strip()
+        .replace('\\', '\\\\')
+    )
+
+
+class WeChatHandler(BaseHandler):
+    """企业微信机器人 Handler"""
+
+    def __init__(
+        self,
+        webhook,
+        timeout=3,
+        level=logging.NOTSET,
+        queue_size=1000,
+        retry=2,
+    ):
+        super().__init__(
+            level=level,
+            batch_size=1,
+            queue_size=queue_size,
+            retry=retry,
+        )
+
+        self.webhook = webhook
+        self.timeout = timeout
+
+    @classmethod
+    def make_markdown_message(cls, log):
+        """
+        构建企业微信 Markdown 消息
+
+        - 标题：level + message
+        - 正文：log / exc_info
+        - 附加信息：thread / location
+        """
+
+        level = log.get('level', 'INFO')
+        message = _safe_text(log.get('message'))
+
+        # 标题
+        content = f'**{level}: {message}**\n\n'
+
+        # 优先展示异常
+        if log.get('exc_info'):
+            content += (
+                f'\n> '
+                f'<font color=\"info\">'
+                f'{_safe_text(log["exc_info"])}'
+                f'</font>'
+            )
+        else:
+            content += (
+                f'\n> '
+                f'<font color=\"info\">'
+                f'{_safe_text(log["log"])}'
+                f'</font>'
+            )
+
+        # 附加信息
+        content += (
+            f'\n> '
+            f'\n> <font color=\"comment\">Thread: {log["thread"]}</font>'
+            f'\n> <font color=\"warning\">Location: {_safe_text(log["location"])}</font>'
+        )
+
+        return {
+            'msgtype': 'markdown',
+            'markdown': {
+                'content': content
+            }
+        }
+
+    def send(self, logs):
+        """发送到企业微信"""
+        resp = requests.post(
+            self.webhook,
+            timeout=self.timeout,
+            json=self.make_markdown_message(logs[0]),
+        )
+
+        # HTTP 错误
+        resp.raise_for_status()
+
+        result = resp.json()
+
+        # 企业微信返回错误
+        if result.get('errcode') != 0:
+            raise Exception('WeChat API error [{errcode}]: {errmsg}'.format_map(result))

pylogging_ext-0.1.0/pylogging_ext.egg-info/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: pylogging-ext
+Version: 0.1.0
+Summary: 一个支持 异步、批量、重试、多通道通知 的 logging 扩展库。
+Home-page: https://github.com/cnmax/pylogging-ext
+Author: chao
+Author-email: mr.qchao@gmail.com
+License: MIT
+Project-URL: Homepage, https://github.com/cnmax/pylogging-ext
+Project-URL: Bug Tracker, https://github.com/cnmax/pylogging-ext/issues
+Project-URL: Source Code, https://github.com/cnmax/pylogging-ext
+Keywords: logging,async logging,handler,cls,tencent cloud,wechat,telegram,notification,monitoring
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+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: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: System :: Logging
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Software Development :: Libraries
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: tencentcloud-cls-sdk-python
+Provides-Extra: socks
+Requires-Dist: requests[socks]; extra == "socks"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: summary
+
+# pylogging-ext
+
+[![PyPI](https://img.shields.io/pypi/v/pylogging-ext.svg)](https://pypi.python.org/pypi/pylogging-ext)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pylogging-ext)
+![PyPI - License](https://img.shields.io/pypi/l/pylogging-ext)
+![GitHub last commit](https://img.shields.io/github/last-commit/cnmaxqi/pylogging-ext)
+
+一个支持 异步、批量、重试、多通道通知 的 logging 扩展库。
+
+> 不只是 logging handler，更是通知基础设施
+
+## 安装
+
+```bash
+pip install pylogging-ext
+```
+可选（支持 socks 代理）：
+```bash
+pip install pylogging-ext[socks]
+```
+
+## 使用
+
+```python
+import logging
+from pylogging_ext import TelegramHandler
+
+logger = logging.getLogger('demo')
+logger.setLevel(logging.INFO)
+
+handler = TelegramHandler(
+    token='your-bot-token',
+    chat_id='your-chat-id',
+)
+
+logger.addHandler(handler)
+
+logger.error('发生错误了')
+```
+
+## API
+
+### Class: BaseHandler
+
+通用异步 Handler 基类，所有通知 Handler 均继承自此类。
+
+#### BaseHandler(...)
+
+- `batch_size` 批量发送大小
+- `flush_interval` 刷新间隔 (秒)
+- `queue_size` 队列大小
+- `retry` 重试次数
+
+#### 特性：
+- 异步发送（非阻塞）
+- 批量处理
+- 指数退避重试
+- 优雅关闭
+
+## 腾讯云 CLS
+### Class: TencentCloudCLSHandler
+
+```pycon
+from pylogging_ext import TencentCloudCLSHandler
+
+handler = TencentCloudCLSHandler(
+    endpoint='ap-shanghai.cls.tencentcs.com',
+    secret_id='your-secret-id',
+    secret_key='your-secret-key',
+    topic_id='your-topic-id',
+)
+```
+### 参数
+- `endpoint` CLS接入地址
+- `secret_id` 腾讯云密钥
+- `secret_key` 腾讯云密钥
+- `topic_id` 日志主题 ID
+
+## 微信机器人
+### Class: WeChatHandler
+
+```pycon
+from pylogging_ext import WeChatHandler
+
+handler = WeChatHandler(
+    webhook='https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx'
+)
+```
+
+### 参数
+- `webhook` 企业微信机器人地址
+
+## Telegram
+### Class: TelegramHandler
+
+```pycon
+from pylogging_ext import TelegramHandler
+
+handler = TelegramHandler(
+    token='your-bot-token',
+    chat_id='your-chat-id',
+    proxies={
+        'http': 'http://127.0.0.1:7890',
+        'https': 'http://127.0.0.1:7890',
+    }
+)
+```
+### 参数
+- `token` Telegram Bot Token
+- `chat_id` 聊天 ID
+- `proxies` 代理配置（可选）
+- `ssl_verify` SSL校验 (默认 True)
+
+## 支持的通知渠道
+- 腾讯云 CLS
+- 企业微信
+- Telegram
+
+持续扩展中...

pylogging_ext-0.1.0/pylogging_ext.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+MANIFEST.in
+README.md
+requirements.txt
+setup.py
+pylogging_ext/__init__.py
+pylogging_ext/base.py
+pylogging_ext/cls.py
+pylogging_ext/dingtalk.py
+pylogging_ext/telegram.py
+pylogging_ext/wechat.py
+pylogging_ext.egg-info/PKG-INFO
+pylogging_ext.egg-info/SOURCES.txt
+pylogging_ext.egg-info/dependency_links.txt
+pylogging_ext.egg-info/requires.txt
+pylogging_ext.egg-info/top_level.txt

pylogging_ext-0.1.0/pylogging_ext.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pylogging_ext-0.1.0/pylogging_ext.egg-info/requires.txt

@@ -0,0 +1,5 @@
+requests
+tencentcloud-cls-sdk-python
+
+[socks]
+requests[socks]

pylogging_ext-0.1.0/pylogging_ext.egg-info/top_level.txt

@@ -0,0 +1 @@
+pylogging_ext

pylogging_ext-0.1.0/requirements.txt

@@ -0,0 +1,2 @@
+requests
+tencentcloud-cls-sdk-python

pylogging_ext-0.1.0/setup.cfg

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

pylogging_ext-0.1.0/setup.py

@@ -0,0 +1,57 @@
+from setuptools import setup, find_packages
+
+with open('README.md', 'r', encoding='utf-8') as fh:
+    long_description = fh.read()
+
+setup(
+    name='pylogging-ext',
+    version='0.1.0',
+    author='chao',
+    author_email='mr.qchao@gmail.com',
+    description='一个支持 异步、批量、重试、多通道通知 的 logging 扩展库。',
+    long_description=long_description,
+    long_description_content_type='text/markdown',
+    url='https://github.com/cnmax/pylogging-ext',
+    project_urls={
+        'Homepage': 'https://github.com/cnmax/pylogging-ext',
+        'Bug Tracker': 'https://github.com/cnmax/pylogging-ext/issues',
+        'Source Code': "https://github.com/cnmax/pylogging-ext",
+    },
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Programming Language :: Python :: 3.8',
+        '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',
+        'Programming Language :: Python :: 3.14',
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: OS Independent',
+        'Topic :: System :: Logging',
+        'Topic :: System :: Monitoring',
+        'Topic :: Software Development :: Libraries',
+    ],
+    keywords=[
+        'logging',
+        'async logging',
+        'handler',
+        'cls',
+        'tencent cloud',
+        'wechat',
+        'telegram',
+        'notification',
+        'monitoring',
+    ],
+    license='MIT',
+    packages=find_packages(exclude=('tests', 'tests.*')),
+    install_requires=[
+        'requests',
+        'tencentcloud-cls-sdk-python',
+    ],
+    extras_require={
+        'socks': ['requests[socks]'],
+    },
+)