vibehub 1.0.0__tar.gz

vibehub-1.0.0/LICENSE

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

vibehub-1.0.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md LICENSE
+recursive-include src/Vibe py.typed
+prune tests
+prune docs
+prune examples
+prune assets

vibehub-1.0.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: vibehub
+Version: 1.0.0
+Summary: Small Python library for building Vibegram bots (import name: Vibe)
+Author: MrLunarDev
+License: MIT
+Project-URL: Homepage, https://github.com/VibeHub-ML
+Keywords: vibegram,bot,chatbot,messenger
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Dynamic: license-file
+
+# VibeHub
+
+Small Python library for building **Vibegram** bots. `import Vibe`, then `Vibe.Bot("TOKEN")`.
+
+```bash
+pip install vibehub          # Python 3.8+, only dependency: requests
+vibehub new mybot            # scaffold a project
+cd mybot && export VIBE_TOKEN=... && python bot.py
+```
+
+```python
+import Vibe
+from Vibe import Filters
+
+bot = Vibe.Bot("TOKEN")
+
+@bot.command("start", "Start the bot")
+def start(message):
+    message.reply("Hello!")
+
+@bot.on_message(Filters.text & ~Filters.command)
+def echo(message):
+    message.reply(message.text)
+
+bot.run()          # Ctrl+C to stop
+```
+
+## What is inside
+
+Long polling and webhook · commands, filters, handlers (message, edited, channel post, callback, join/leave) ·
+inline and reply keyboards · `Markdown` / `HTML` helpers · media upload · group admin calls ·
+FSM conversations · middleware (`Logging`, `Recovery`, `AntiFlood`) · `vibehub new` and `vibehub check`.
+
+Guide: `docs/guide.md`. Examples: `examples/`.
+
+## The API is a guess
+
+The Vibegram Bot API docs were not available when this was written, so everything about the server is a best guess
+and lives in `src/Vibe/config.py` (`ApiConfig`): base URL, token placement, method names,
+webhook secret header and reply style. `vibehub check` (with `VIBE_TOKEN` set) tries the guessed ways of calling
+the API and tells you what to change. It never prints the token.
+
+```python
+cfg = Vibe.ApiConfig(token_in_path=False)       # token in "Authorization: Bearer ..."
+bot = Vibe.Bot("TOKEN", config=cfg)
+```
+
+## Tests
+
+```bash
+python -m unittest discover -s tests     # offline, includes a local HTTP round-trip
+```
+
+MIT licensed.

vibehub-1.0.0/README.md

@@ -0,0 +1,54 @@
+# VibeHub
+
+Small Python library for building **Vibegram** bots. `import Vibe`, then `Vibe.Bot("TOKEN")`.
+
+```bash
+pip install vibehub          # Python 3.8+, only dependency: requests
+vibehub new mybot            # scaffold a project
+cd mybot && export VIBE_TOKEN=... && python bot.py
+```
+
+```python
+import Vibe
+from Vibe import Filters
+
+bot = Vibe.Bot("TOKEN")
+
+@bot.command("start", "Start the bot")
+def start(message):
+    message.reply("Hello!")
+
+@bot.on_message(Filters.text & ~Filters.command)
+def echo(message):
+    message.reply(message.text)
+
+bot.run()          # Ctrl+C to stop
+```
+
+## What is inside
+
+Long polling and webhook · commands, filters, handlers (message, edited, channel post, callback, join/leave) ·
+inline and reply keyboards · `Markdown` / `HTML` helpers · media upload · group admin calls ·
+FSM conversations · middleware (`Logging`, `Recovery`, `AntiFlood`) · `vibehub new` and `vibehub check`.
+
+Guide: `docs/guide.md`. Examples: `examples/`.
+
+## The API is a guess
+
+The Vibegram Bot API docs were not available when this was written, so everything about the server is a best guess
+and lives in `src/Vibe/config.py` (`ApiConfig`): base URL, token placement, method names,
+webhook secret header and reply style. `vibehub check` (with `VIBE_TOKEN` set) tries the guessed ways of calling
+the API and tells you what to change. It never prints the token.
+
+```python
+cfg = Vibe.ApiConfig(token_in_path=False)       # token in "Authorization: Bearer ..."
+bot = Vibe.Bot("TOKEN", config=cfg)
+```
+
+## Tests
+
+```bash
+python -m unittest discover -s tests     # offline, includes a local HTTP round-trip
+```
+
+MIT licensed.

vibehub-1.0.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vibehub"
+version = "1.0.0"
+description = "Small Python library for building Vibegram bots (import name: Vibe)"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "MrLunarDev" }]
+keywords = ["vibegram", "bot", "chatbot", "messenger"]
+dependencies = ["requests>=2.25"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/VibeHub-ML"
+
+[project.scripts]
+vibehub = "Vibe.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+Vibe = ["py.typed"]

vibehub-1.0.0/setup.cfg

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

vibehub-1.0.0/src/Vibe/__init__.py

@@ -0,0 +1,23 @@
+from .bot import Bot
+from .config import ApiConfig, DEFAULT_BASE_URL, DEFAULT_METHODS
+from .errors import (APIError, AuthError, HandlerError, NetworkError, RateLimitError, ValidationError,
+                     VibeError)
+from .filters import Filter, Filters
+from .formatting import HTML, Markdown, Markup
+from .fsm import Conversation, ConversationManager, State
+from .keyboard import Button, InlineKeyboard, ReplyKeyboard, remove_keyboard
+from .limits import Cooldown, RateLimit
+from .middleware import AntiFlood, BaseMiddleware, Logging, Recovery
+from .models import (CallbackQuery, Chat, ChatMember, ChatMemberUpdated, Document, Message, Photo, Update,
+                     User)
+
+__version__ = "1.0.0"
+
+__all__ = [
+    "Bot", "ApiConfig", "DEFAULT_BASE_URL", "DEFAULT_METHODS",
+    "VibeError", "APIError", "AuthError", "RateLimitError", "NetworkError", "ValidationError", "HandlerError",
+    "Filter", "Filters", "Markdown", "HTML", "Markup", "Button", "InlineKeyboard", "ReplyKeyboard", "remove_keyboard",
+    "BaseMiddleware", "Logging", "Recovery", "AntiFlood", "Cooldown", "RateLimit",
+    "Conversation", "ConversationManager", "State",
+    "CallbackQuery", "Chat", "ChatMember", "ChatMemberUpdated", "Document", "Message", "Photo", "Update", "User",
+]

vibehub-1.0.0/src/Vibe/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())