telyx 0.0.1__tar.gz

telyx-0.0.1/.gitignore

@@ -0,0 +1,16 @@
+node_modules/
+.next/
+dist/
+build/
+*.tgz
+*.egg-info/
+__pycache__/
+.venv/
+.env*
+!.env.example
+*.tsbuildinfo
+.registry-lock
+*.tmp
+artifacts/
+
+.python-tools/

telyx-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nnolyk
+
+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.

telyx-0.0.1/PKG-INFO

@@ -0,0 +1,72 @@
+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

telyx-0.0.1/README.md

@@ -0,0 +1,56 @@
+# 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

telyx-0.0.1/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+[project]
+name = "telyx"
+version = "0.0.1"
+description = "Premium Telegram icons for developers"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "nnolyk"}]
+keywords = ["telegram", "emoji", "icons", "custom-emoji"]
+classifiers = ["Programming Language :: Python :: 3", "Typing :: Typed", "Operating System :: OS Independent"]
+[project.urls]
+Owner = "https://t.me/nnolyk"
+Telegram = "https://core.telegram.org/bots/api"
+[tool.hatch.build.targets.wheel]
+packages = ["telyx"]

telyx-0.0.1/telyx/__init__.py

@@ -0,0 +1,13 @@
+from .model import Icon, Registry
+from .api import get, exists, search, render, load_registry
+
+def __getattr__(name: str) -> Icon:
+    try:
+        return get(name)
+    except KeyError:
+        raise AttributeError(f"Unknown Telyx icon: {name}") from None
+
+def __dir__():
+    return sorted(set(globals()) | {icon.slug[3:].replace('-','_') for icon in search('')})
+
+__all__ = ['Icon','Registry','get','exists','search','render','load_registry'] + [icon.slug[3:].replace('-','_') for icon in search('')]