Metadata-Version: 2.5
Name: telyx
Version: 0.0.1
Summary: Premium Telegram icons for developers
Project-URL: Owner, https://t.me/nnolyk
Project-URL: Telegram, https://core.telegram.org/bots/api
Author: nnolyk
License-Expression: MIT
License-File: LICENSE
Keywords: custom-emoji,emoji,icons,telegram
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Telyx

Premium Telegram icons for developers.

## Установить сейчас — одной командой

Из корневой папки этого проекта (Python 3.10+):

```bash
pip install ./python
```

Или скачайте готовый wheel со страницы `/docs#installation`, откройте терминал в папке с файлом и выполните:

```bash
pip install telyx-0.0.1-py3-none-any.whl
```

Команда `pip install telyx` станет командой установки этого проекта после его первой публикации в PyPI. Пакет пока не опубликован. Библиотека работает отдельно от сайта и не требует запущенного Next.js.

## Сообщения

```python
import telyx as tx

await bot.send_message(chat_id, f"{tx.circle_check} Готово!", parse_mode="HTML")
```

## Инлайн-кнопки — без ручных ID

Установите выбранную библиотеку для бота отдельно, например `pip install -U aiogram`.

```python
import telyx as tx
from aiogram.types import InlineKeyboardButton, InlineKeyboardMarkup

keyboard = InlineKeyboardMarkup(inline_keyboard=[
    [InlineKeyboardButton(**tx.wallet.button("Баланс", callback_data="balance"))],
    [InlineKeyboardButton(**tx.crown.button("Premium", url="https://t.me/nnolyk"))],
])
await bot.send_message(chat_id, "Выберите действие", reply_markup=keyboard)
```

В кнопках `text` — обычный текст, не HTML. `.button()` подставляет техническое поле иконки самостоятельно. Для кнопки выберите ровно одно действие: `callback_data` (1–64 UTF-8 байта) или `url`. Полный бот с обработчиком нажатий: `examples/aiogram_buttons.py`. Запуск: задайте `BOT_TOKEN`, затем `python examples/aiogram_buttons.py`.

Для обычной emoji в тексте кнопки передайте `custom_emoji=False`. Telegram custom emoji зависят от условий Bot API: https://core.telegram.org/bots/api#inlinekeyboardbutton. Пакет не предоставляет Premium-возможности сам по себе.

`from telyx.telegram import inline_button, keyboard_button` — независимые от фреймворка функции для словарей Bot API. Актуальные aiogram, telebot и python-telegram-bot принимают поля через `**`.

---

## API

`tx.get`, `tx.exists`, `tx.search`, `tx.render`, `tx.load_registry`. Именованные импорты: `from telyx import wallet, crown`. Объекты иконок неизменяемые; строковое представление — Telegram HTML.

MIT — код; данные иконок сохраняют собственные права. Автор: https://t.me/nnolyk
