monokeys

Клиент «Ключей» — маленьких умных функций, которые зовутся одним вызовом. Внутри только стандартная библиотека: зависимостей нет, один файл.

pip install monokeys

from monokeys import Keys

k = Keys()                                    # настраивать нечего

print(k.alive.text("@durov"))
# жив · channel · Pavel Durov · 10 998 851 subscribers

print(k.settle.text("аня:1200:аня,боря,вика; боря:600:боря,вика"))
# 2 перевода вместо 2 · вика → аня 700 · боря → аня 100

Ни регистрации, ни ключа доступа, ни лимита: клиент сам берёт публичный ключ, а он бессрочный и без счётчика.

Какие ключи есть

alive — жив ли канал Telegram

Без аккаунта, без Bot API, без токена: читается публичная превью-страница t.me, та самая, по которой мессенджеры рисуют картинку ссылки.

k.alive("@durov")                  # весь ответ объектом
k.alive.members_count("@durov")    # 11005185 — только число, уже числом
k.alive.kind("ru_python")          # group
k.alive.verified("@BotFather")     # True

Понимает любую форму ссылки: @durov, t.me/durov, t.me/durov/123, t.me/s/durov, t.me/+AbCdEf…, t.me/joinchat/…, DUROV.

Поля ответа: is_alive, kind (channel / group / bot / user), title, description, members_count, members_label, online_count, verified, is_private, needs_request, restricted, has_preview, avatar_url, deep_link, action, username, url, error.

Тонкость, из-за которой наивная проверка врёт: на удалённый канал Telegram отвечает 200 и рисует заглушку. Живой от мёртвого отличается разметкой, а не кодом ответа.

settle — кто кому сколько должен

k.settle.text("а:1000:а,б,в,г,д; б:500:а,б,в,г,д; в:250:а,б,в,г,д")
# 4 перевода вместо 6 · г → а 350 · д → а 300 · д → б 50 · в → б 100

k.settle.transfers_count("аня:900; боря:300; вика:0")   # 2

Формат: кто:сколько:на кого через точку с запятой. Если «на кого» не указать, трата делится на всех, кто упомянут.

Поля ответа: transfers, transfers_count, naive_count, balances, total, people, ok, error.

Три способа позвать любой ключ

k.alive("@durov")                    # весь ответ: объект с полями
k.alive.members_count("@durov")      # только одно поле, нужного типа
k.alive.text("@durov")               # строка для человека

Аргументы

Keys(...) — подключение

k = Keys(timeout=5, retries=2)

k.<ключ>(...) — вызов

k.alive("@durov", only="members_count")   # 11005185
k.alive("@durov", fmt="bool")             # 'true'
k.alive("@durov", timeout=3)              # не ждать дольше трёх секунд

Что можно спросить у клиента

Ответ

Answer — это словарь, который умеет отвечать и как объект:

res = k.alive("@durov")
res.title == res["title"]     # одно и то же
bool(res)                     # True, если ключ ответил утвердительно
dict(res)                     # обычный словарь

Опечатка не молчит:

res.tittle
# AttributeError: в ответе нет поля 'tittle'; есть: username, url, is_alive, ...

k.alive.members_cout("@durov")
# AttributeError: у ключа 'alive' нет поля 'members_cout'; есть: is_alive, kind, ...

Ошибки

У всех есть .status и .body. Первые два — потомки KeysError, ловятся одним except.

from monokeys import Keys, AccessDenied, Unavailable

try:
    res = k.alive("@durov")
except AccessDenied:
    print("ключ доступа не подошёл")
except Unavailable:
    print("сейчас занято, попробую позже")

Методы не зашиты в клиент

Список ключей и их полей приходит с сервера, поэтому новый ключ доступен сразу, без обновления пакета:

k.names()          # ['alive', 'settle']
k.несуществующий   # AttributeError со списком существующих

Ключ доступа

Заводить не нужно — публичный работает у всех и без счётчика. Свой нужен только тем, кому нужен собственный рубильник; его выдаёт владелец сервиса, и он тоже бессрочный. Положите в .env:

KEYS_API_KEY=kx_...

Отозвать свой ключ, если он утёк:

curl -X POST -H "Authorization: Bearer kx_..." https://monoblock.casa/keys/token/revoke

Если ставить пакет не хочется

Тот же самый файл можно просто скачать — из него и собран пакет:

curl https://monoblock.casa/keys/sdk/python > monokeys.py

А можно вообще без клиента — ключ это обычная ссылка:

https://monoblock.casa/keys/alive/@durov  ->  жив · channel · Pavel Durov · …

Документация целиком: https://monoblock.casa/keys/client

Исходники: https://github.com/monorez3/keys