minline 0.1.0__tar.gz

minline-0.1.0/LICENSE

@@ -0,0 +1,15 @@
+Minline License (Non-Commercial)
+
+Copyright (c) 2025 Bakirullit
+
+Permission is hereby granted to any person obtaining a copy of this software and associated documentation files (the "Software"), to use, copy, modify, and distribute the Software for **personal, educational, or non-commercial purposes**, subject to the following conditions:
+
+1. **Commercial use is strictly prohibited**. This includes use in paid products, SaaS platforms, enterprise software, or any application where the software contributes to generating revenue.
+
+2. Redistribution of modified versions must include attribution to the original author.
+
+3. The above copyright notice and this license must 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.
+
+For commercial licensing inquiries, contact: bakirullit@gmail.com

minline-0.1.0/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: minline
+Version: 0.1.0
+Summary: Menu-inline framework for Telegram bots
+Author: bakirullit
+Author-email: Bakdaulet <bakirullit@gmail.com>
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiogram>=3.3
+Requires-Dist: redis>=5.0.0
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-python
+
+# minline
+
+**Menu-inline framework for Telegram bots**
+
+Build Telegram inline menu systems with localized rendering, button logic separation, and extensible components.

minline-0.1.0/README.md

@@ -0,0 +1,5 @@
+# minline
+
+**Menu-inline framework for Telegram bots**
+
+Build Telegram inline menu systems with localized rendering, button logic separation, and extensible components.

minline-0.1.0/minline/__init__.py

@@ -0,0 +1,13 @@
+# Minline - Custom Telegram Menu Framework
+# Copyright (c) 2025 Bakirullit
+# License: Minline License (Non-Commercial) – see LICENSE file for details
+
+
+from .app import MinlineApp
+from .components.buttons.button import Button 
+from .components.activity.menu import Menu
+from .runtime import *
+
+__all__ = ["MinlineApp", "Menu", "Button", 
+           "LanguageManager", "RedisSessionManager", 
+           "render_menu", "RenderedMenu"]

minline-0.1.0/minline/app.py

@@ -0,0 +1,152 @@
+# Minline - Custom Telegram Menu Framework
+# Copyright (c) 2025 Bakirullit
+# License: Minline License (Non-Commercial) – see LICENSE file for details
+
+from aiogram import Bot, Dispatcher, Router
+from aiogram.types import Message, CallbackQuery
+from aiogram.filters import CommandStart
+from aiogram.fsm.storage.memory import MemoryStorage
+import asyncio
+from typing import Callable, Awaitable
+from .session.redis_manager import RedisSessionManager
+from .runtime.language_manager import LanguageManager
+from .components.buttons.button import Button  # assuming your Menu and Button classes are here
+from .components.activity.menu import Menu
+
+class MinlineApp:
+    def __init__(self, token: str, *, language_dir: str = "languages", default_lang: str = "en"):
+        self.token = token
+        self.dp = Dispatcher(storage=MemoryStorage())
+        self.bot = Bot(token=self.token)
+        self.router = Router()
+        self.default_lang = default_lang
+        self.menu_registry = {}
+        self.action_commands: dict[str, Callable[[CallbackQuery, str], Awaitable]] = {}
+        self.lang = LanguageManager(language_dir)
+        self.session = RedisSessionManager()
+        self.router.message(CommandStart())(self._menu_handler)
+        self.router.message()(self._delete_unknown)
+        self._register_callbacks() 
+        self.dp.include_router(self.router)
+
+    def action(self, name: str):
+        def decorator(func):
+            self.action_commands[name] = func
+            return func
+        return decorator
+
+    def menu(self, path: str):
+        def decorator(fn):
+            menu_instance = fn()
+            menu_instance.menu_id = path
+            if path != "/":
+                back_button = Button("back", f"#route://")
+                menu_instance.controls.insert(0, [back_button])
+            self.menu_registry[path] = menu_instance
+            return menu_instance
+        return decorator
+
+    async def _menu_handler(self, message: Message):
+        user_id = message.from_user.id
+        chat_id = message.chat.id
+        lang = self.default_lang
+        state = await self.session.get_state(user_id)
+        if state:
+            old_chat_id = state.get("chat_id")
+            old_message_id = state.get("message_id")
+            if old_chat_id and old_message_id:
+                try:
+                    await self.bot.delete_message(old_chat_id, old_message_id)
+                except Exception:
+                    pass
+        menu = self.menu_registry.get("/")
+        if not menu:
+            await self.bot.send_message(chat_id, "Menu '/' not found.")
+            return
+        _, _, message_id = await menu.render(chat_id, None, self.bot, lang)
+        await self.session.set_state(user_id, {
+            "chat_id": chat_id,
+            "message_id": message_id,
+            "lang": lang,
+            "menu_path": "/"
+        })
+
+        try:
+            await message.delete()
+        except Exception:
+            pass
+
+    def _register_callbacks(self):
+        @self.router.callback_query()
+        async def callback_handler(callback: CallbackQuery):
+            user_id = callback.from_user.id
+            data = callback.data
+            if not data or ":" not in data:
+                return
+            
+            parts = data.split(":", maxsplit=3)
+            if len(parts) < 3:
+                return
+            
+            lang, current_path, command = parts[0], parts[1], parts[2]
+            arg = parts[3] if len(parts) > 3 else ""
+            print(f"Callback received: lang={lang}, path={current_path}, command={command}, arg={arg}", parts)
+
+            if not command.startswith("#"):
+                return
+
+            if (command == "#route"):
+                state = await self.session.get_state(user_id)
+                if not state:
+                    return
+
+                chat_id = state["chat_id"]
+                message_id = state["message_id"]
+
+                if arg == "//":
+                    path_parts = current_path.rstrip("/").split("/")
+                    new_path = "/" if len(path_parts) <= 2 else "/".join(path_parts[:-1])
+                else:
+                    new_path = current_path.rstrip("/") + "/" + arg
+                menu = self.menu_registry.get(new_path)
+                if not menu:
+                    await callback.answer("Menu not found", show_alert=True)
+                    return
+
+                _, _, new_msg_id = await menu.render(chat_id, message_id, self.bot, lang)
+                await self.session.set_state(user_id, {
+                    "chat_id": chat_id,
+                    "message_id": new_msg_id,
+                    "lang": lang,
+                    "menu_path": new_path
+                })
+
+                await callback.answer()
+                return
+
+            if command in self.action_commands:
+                await self.action_commands[command](callback, command)
+                return
+
+            await callback.answer("Unknown action", show_alert=True)
+
+    async def _open_menu(self, user_id: int, menu: Menu, path: str):
+        state = await self.session.get_state(user_id)
+        if not state:
+            return
+
+        chat_id = state["chat_id"]
+        message_id = state["message_id"]
+        lang = state.get("lang", self.default_lang)
+        menu.lang = lang
+        await menu.render(chat_id, message_id, self.bot)
+
+        state["menu_path"] = path
+        await self.session.set_state(user_id, state)
+
+    async def _delete_unknown(self, message: Message):
+        await message.delete()
+
+    def run(self):
+        asyncio.run(self.dp.start_polling(self.bot))
+        

minline-0.1.0/minline/components/buttons/button.py

@@ -0,0 +1,7 @@
+from aiogram.types import InlineKeyboardButton
+
+class Button:
+    def __init__(self, text_id: str, action: str, data: dict = None):
+        self.text_id = text_id
+        self.action = action
+        self.data = data or {}

minline-0.1.0/minline/runtime/language_manager.py

@@ -0,0 +1,26 @@
+import os
+import json
+
+class LanguageManager:
+    _languages: dict[str, dict[str, str]] = {}
+
+    def __init__(self, directory: str = "languages"):
+        self.directory = directory
+        self.load_languages(directory)
+
+    @classmethod
+    def load_languages(cls, folder_path: str = "languages"):
+        for filename in os.listdir(folder_path):
+            if filename.endswith(".json"):
+                lang_code = filename.split(".")[0]
+                full_path = os.path.join(folder_path, filename)
+                with open(full_path, "r", encoding="utf-8") as f:
+                    cls._languages[lang_code] = json.load(f)
+
+    @classmethod
+    def get(cls, lang: str, key: str) -> str:
+        return cls._languages.get(lang, {}).get(key, key)
+
+
+# Load on import
+LanguageManager.load_languages()

minline-0.1.0/minline.egg-info/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: minline
+Version: 0.1.0
+Summary: Menu-inline framework for Telegram bots
+Author: bakirullit
+Author-email: Bakdaulet <bakirullit@gmail.com>
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiogram>=3.3
+Requires-Dist: redis>=5.0.0
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-python
+
+# minline
+
+**Menu-inline framework for Telegram bots**
+
+Build Telegram inline menu systems with localized rendering, button logic separation, and extensible components.

minline-0.1.0/minline.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+minline/__init__.py
+minline/app.py
+minline.egg-info/PKG-INFO
+minline.egg-info/SOURCES.txt
+minline.egg-info/dependency_links.txt
+minline.egg-info/requires.txt
+minline.egg-info/top_level.txt
+minline/components/__init__.py
+minline/components/buttons/button.py
+minline/runtime/__init__.py
+minline/runtime/language_manager.py

minline-0.1.0/minline.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

minline-0.1.0/minline.egg-info/requires.txt

@@ -0,0 +1,2 @@
+aiogram>=3.3
+redis>=5.0.0

minline-0.1.0/minline.egg-info/top_level.txt

@@ -0,0 +1 @@
+minline

minline-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[project]
+name = "minline"
+version = "0.1.0"
+description = "Menu-inline framework for Telegram bots"
+authors = [
+  { name="Bakdaulet", email="bakirullit@gmail.com" }
+]
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+dependencies = [
+    "aiogram>=3.3",
+    "redis>=5.0.0"
+]
+
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"

minline-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

minline-0.1.0/setup.py

@@ -0,0 +1,15 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="minline",
+    version="0.1.0",
+    description="Menu-inline framework for Telegram bots",
+    author="bakirullit",
+    packages=find_packages(),
+    include_package_data=True,
+    install_requires=[
+        "aiogram>=3.3",
+        "redis>=5.0.0"
+    ],
+    python_requires=">=3.10",
+)