totp-client — одноразовые коды (TOTP) для любых сервисов
Одно шифрованное хранилище вторых факторов на все сервисы: PyPI, GitHub, Bitrix24, что угодно. Другие проекты берут коды из того же стора одной строкой, не заводя собственных копий секретов.
Это клиент, и только клиент: библиотека плюс CLI. Фронтендов он не
содержит — Telegram-бот выдачи кодов живёт отдельным проектом
totp-bot, серверная часть с общим стором и журналом выдач —
totp-service. Граница проведена намеренно: клиент
ставится в окружение каждого навыка, которому нужен код, и тащить туда
aiogram с обработчиками чужого интерфейса — плохая сделка.
Установка
uv add s-totp-client # как зависимость
uv run python scripts/self_check.py
Быстрый старт
totp entry add --uri "otpauth://totp/PyPI:alice?secret=…&issuer=PyPI"
totp list
totp code pypi # {"code": "366845", "seconds_left": 20}
Вывод — JSON по умолчанию; --text переключает на человекочитаемый.
Из своего кода
from totp_client import provider_for
login(username, password, totp_provider=provider_for("pypi"))
Провайдер отдаёт код по сигнатуре (попытка, прошлая ошибка) -> код и сам
разбирается с границей 30-секундного окна: ждёт ротацию, когда коду осталось
жить меньше трёх секунд, и никогда не отдаёт дважды один и тот же код — иначе
повторная попытка входа сгорает на коде, который сервис уже отверг.
Модель хранения
Запись — это сервис + аккаунт + иконка + группа. Ключ строится как
сервис или сервис:аккаунт и служит тем, что вы набираете руками: пока
аккаунт один, работает короткое totp code pypi; когда их стало два, короткая
форма даёт ошибку со списком вариантов, а не выдаёт код наугад.
Групп по умолчанию нет — всё лежит одним плоским списком, пока группу не задали.
Секреты пишутся в системное хранилище (keyring). Если рабочего бэкенда нет, кит
честно предупреждает и уходит в файл — проверить можно командой
totp store status. Длинные сторы режутся на куски: у Windows Credential
Manager есть жёсткий потолок на размер значения, и без нарезки хранилище молча
деградировало бы в открытый файл ровно тогда, когда записей стало много.
Коды на телефоне
Кнопка в Telegram — это отдельный проект totp-bot: он ставит себе этот
клиент зависимостью и берёт коды тем же provider_for. Здесь про него только
одно: иконку сервиса и подписи кнопок в любом фронтенде задаёт провайдер —
плагин навыка, объявленный entry-point'ом totpkit.providers (имя группы
осталось прежним после переименования пакета, чтобы уже написанные плагины
продолжали находиться). Провайдер отдаёт готовые строки и ничего не знает ни
про Telegram, ни про aiogram — потому и живёт в клиенте, а не во фронтенде.
Лицензия
MIT
Metadata
Release files for s-totp-client 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| s_totp_client-0.3.0.tar.gz | 83.3 kB | Without provenance | Details for s_totp_client-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| s_totp_client-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for s_totp_client-0.3.0-py3-none-any.whl |
Total release size: 117.6 kB
Release files / s_totp_client-0.3.0.tar.gz
| Download URL | s_totp_client-0.3.0.tar.gz |
|---|---|
| Size | 83.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5a5648447348584939867de19c8f57451caaa5f6adbdd27cb82f2dc648a8371c
|
|
BLAKE2b-256 checksum How to use checksums |
c476bf136b69590048c229d49c1772728366a466a84663ee9b2bb8a39a3b905e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / s_totp_client-0.3.0-py3-none-any.whl
| Download URL | s_totp_client-0.3.0-py3-none-any.whl |
|---|---|
| Size | 34.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1dbdfcb1b15fb0b3c32134cff6a1e528386c8a1e8fe9ec10e88e0b384995b68c
|
|
BLAKE2b-256 checksum How to use checksums |
a183a23c287357fac28acacfbea2a697a0b70e8acb4d5b606710b785cbe55474
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for s-totp-client 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.