funpaybotengine 0.1.1.dev1__tar.gz

funpaybotengine-0.1.1.dev1/.env

@@ -0,0 +1,8 @@
+PROXY=socks5://user148430o3869r670825:dgej93@pool.proxys.io:10851
+GOLDEN_KEY=ub4ui4fyjyukbovprql1hgdhzzf9ow8u
+
+GOLDEN_KEY2=1ehxhs07yjocv1uchhjfqr98ydzuenpq
+PROXY2=socks5://user148430o7342r250433:dgej93@pool.proxys.io:10699
+
+PROXY_MAIN=socks5://user148429:dgej93@45.39.104.142:19392
+GOLDEN_KEY_MAIN=js65bi9hojgguh8q7jb8f48wdhx0mmaq

funpaybotengine-0.1.1.dev1/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @qvvonk

funpaybotengine-0.1.1.dev1/.gitignore

@@ -0,0 +1,20 @@
+/.venv/
+/env/
+/venv/
+
+/.idea/
+/.vscode/
+
+__pycache__/
+*.py[cod]
+*$py.class
+
+build/
+dist/
+*.egg-info/
+
+uv.lock
+*.uv*
+
+*.log
+*.tmp

funpaybotengine-0.1.1.dev1/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: funpaybotengine
+Version: 0.1.1.dev1
+Summary: Framework for creating FunPay bots.
+Project-URL: Telegram Channel, https://t.me/funpay_hub
+Project-URL: Repository, https://github.com/funpayhub/funpaybotengine
+Project-URL: Issues, https://github.com/funpyahub/funpaybotengine/issues
+Author-email: Qvvonk <qvvonk@gmail.com>
+Maintainer-email: Qvvonk <qvvonk@gmail.com>
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Requires-Python: >=3.10
+Requires-Dist: aiohttp-socks~=0.10.1
+Requires-Dist: aiohttp~=3.12.14
+Requires-Dist: eventry~=0.2.0
+Requires-Dist: funpayparsers~=0.5.6
+Requires-Dist: pydantic~=2.11.7
+Provides-Extra: dev
+Requires-Dist: mypy>=1.17.0; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: pydata-sphinx-theme>=0.16.1; extra == 'docs'
+Requires-Dist: sphinx-design>=0.6.1; extra == 'docs'
+Requires-Dist: sphinx>=8.1.3; extra == 'docs'
+Provides-Extra: tests
+Requires-Dist: pytest; extra == 'tests'
+Requires-Dist: pytest-asyncio>=1.1.0; extra == 'tests'

funpaybotengine-0.1.1.dev1/funpaybotengine/__init__.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+import funpaybotengine.dispatching.events as events
+import funpaybotengine.dispatching.filters as filters
+from funpaybotengine.client.bot import Bot
+from funpaybotengine.client.session import BaseSession, AioHttpSession
+from funpaybotengine.dispatching.routers.base import Router
+from funpaybotengine.dispatching.routers.dispatcher import Dispatcher
+
+
+__all__ = [
+    'Bot',
+    'BaseSession',
+    'AioHttpSession',
+    'Router',
+    'Dispatcher',
+    'events',
+    'filters',
+]

funpaybotengine-0.1.1.dev1/funpaybotengine/base.py

@@ -0,0 +1,64 @@
+from __future__ import annotations
+
+
+__all__ = ('BindableObject', 'check_bound')
+
+
+from typing import TYPE_CHECKING, Any, TypeVar
+from collections.abc import Callable
+
+from pydantic import BaseModel, PrivateAttr
+from typing_extensions import Self
+
+from funpaybotengine.exceptions import BotNotBoundError
+
+
+if TYPE_CHECKING:
+    from funpaybotengine.client.bot import Bot
+
+
+F = TypeVar('F', bound=Callable[..., Any])
+
+
+class BindableObject(BaseModel):
+    _bot: Bot | None = PrivateAttr(None)
+
+    def model_post_init(self, context: dict[Any, Any]) -> None:
+        self._bot = context.get('bot') if context else None
+
+    def as_(self, bot: Bot | None, /) -> Self:
+        self.bind_to(bot)
+        return self
+
+    def unbind(self) -> None:
+        self._bot = None
+
+    def bind_to(self, bot: Bot | None, /) -> None:
+        self._bot = bot
+
+    @property
+    def bot(self) -> Bot | None:
+        return self._bot
+
+    def get_bound_bot(self) -> Bot:
+        if not self.bot:
+            raise BotNotBoundError(self)
+        return self.bot
+
+
+def check_bound(func: F) -> F:
+    """
+    Decorator for instance methods to ensure the object is bound to any Bot instance.
+    """
+
+    def wrapper(*args: Any, **kwargs: Any) -> Any:
+        if not args:
+            raise RuntimeError('Can be used only with instance methods.')
+
+        if not isinstance(args[0], BindableObject):
+            raise ValueError(f'{args[0].__class__.__name__} is not a bindable object.')
+        if args[0].bot is None:
+            raise RuntimeError(f'{args[0]} is not bound to any `Bot` instance.')
+        return func(*args, **kwargs)
+
+    return wrapper  # type: ignore

funpaybotengine-0.1.1.dev1/funpaybotengine/client/__init__.py

@@ -0,0 +1,4 @@
+from __future__ import annotations
+
+from .bot import *
+from .session import *