python-telegram-handler 2.2.1

安装

通过点子：

pip install python-telegram-handler

用法

注册一个新的电报机器人并获得一个身份验证令牌。（此处的说明https://core.telegram.org/bots#3-how-do-i-create-a-bot）

之后，您必须获得一个chat_id。您可以使用包含的简单脚本来做到这一点。与新创建的机器人开始新的对话，给它写点东西（首先发起对话很重要）。

此外，处理程序可以自动检索chat_id。这将在处理程序初始化时完成。但是您仍然必须开始与机器人对话。请注意：如果程序停止、服务器重新启动或发生其他事情 - 处理程序将尝试从电报中检索聊天 ID，如果找不到来自您的新消息，则可能会失败。所以我建议你使用下面的脚本来获取聊天 ID。

然后运行一个命令：

python -m telegram_handler <your token here>

如果一切正常，一个chat_id将被打印到标准输出。

使用token和chat_id，以您想要的方式配置日志处理程序。例如，使用 dictConfig：

{
    'version': 1,
    'handlers': {
        'telegram': {
            'class': 'telegram_handler.TelegramHandler',
            'token': 'your token',
            'chat_id': 'chat id'
        }
    },
    'loggers': {
        'my_logger': {
            'handlers': ['telegram'],
            'level': 'DEBUG'
        }
    }
}

格式化

目前发送消息的格式很简单：<code>%(asctime)s</code> <b>%(levelname)s</b>\nFrom %(name)s:%(funcName)s\n% (message)s 异常回溯将被格式化为预先格式化的固定宽度代码块。（https://core.telegram.org/bots/api#html-style）

如果要调整它，请使用所需的格式字符串配置电报处理程序.HtmlFormatter。使用 dictConfig：

...
{
    'formatters': {
        'telegram': {
            'class': 'telegram_handler.HtmlFormatter',
            'fmt': '%(levelname)s %(message)s'
        }
    }
    'handlers': {
        'telegram': {
            'class': 'telegram_handler.TelegramHandler',
            'formatter': 'telegram',
            'token': 'your token',
            'chat_id': 'chat id'
        }
    }
}
...

如果您愿意，可以在 HtmlFormatter 中启用表情符号。只需在 HtmlFormatter 设置中指定use_emoji=True 即可。这将在 levelname 中添加一个 :white_circle: 用于 DEBUG，:large_blue_circle: 用于 INFO，以及 :red_circle: 用于 WARNING 和 ERROR 级别。

代理人

如果您必须在 Telegram 服务器被 gowrnment 阻止的国家/地区使用此软件包，您可以在 config.xml 中指定代理 url。使用 dictConfig：

...
{
    'handlers': {
        'telegram': {
            'class': 'telegram_handler.TelegramHandler',
            'formatter': 'telegram',
            'token': 'your token',
            'chat_id': 'chat id',
            'proxies': {
                'http': 'socks5://user:pass@host:port',
                'https': 'socks5://user:pass@host:port'
            }
        }
    }
}
...

重要的！如果您打算使用socks代理，请确保您安装了带有socks支持的requests包：

pip install requests[socks]