funpaybotengine 0.1.0.dev1__tar.gz

funpaybotengine-0.1.0.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.0.dev1/.github/CODEOWNERS

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

funpaybotengine-0.1.0.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.0.dev1/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: funpaybotengine
+Version: 0.1.0.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.0.dev1/funpaybotengine/.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

funpaybotengine-0.1.0.dev1/funpaybotengine/.idea/MypyPlugin.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="MypySettings">
+    <option name="arguments" value="--follow-imports silent --exclude \.pyi$" />
+    <option name="projectDirectory" value="$PROJECT_DIR$" />
+  </component>
+</project>

funpaybotengine-0.1.0.dev1/funpaybotengine/.idea/funpaybotengine.iml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="jdk" jdkName="Python 3.13" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+  <component name="PyDocumentationSettings">
+    <option name="format" value="PLAIN" />
+    <option name="myDocStringFormat" value="Plain" />
+  </component>
+</module>

funpaybotengine-0.1.0.dev1/funpaybotengine/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,18 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="PyCompatibilityInspection" enabled="false" level="WARNING" enabled_by_default="false">
+      <option name="ourVersions">
+        <value>
+          <list size="5">
+            <item index="0" class="java.lang.String" itemvalue="3.13" />
+            <item index="1" class="java.lang.String" itemvalue="3.12" />
+            <item index="2" class="java.lang.String" itemvalue="3.11" />
+            <item index="3" class="java.lang.String" itemvalue="3.10" />
+            <item index="4" class="java.lang.String" itemvalue="3.9" />
+          </list>
+        </value>
+      </option>
+    </inspection_tool>
+  </profile>
+</component>

funpaybotengine-0.1.0.dev1/funpaybotengine/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

funpaybotengine-0.1.0.dev1/funpaybotengine/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.13" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.13" project-jdk-type="Python SDK" />
+</project>

funpaybotengine-0.1.0.dev1/funpaybotengine/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/funpaybotengine.iml" filepath="$PROJECT_DIR$/.idea/funpaybotengine.iml" />
+    </modules>
+  </component>
+</project>

funpaybotengine-0.1.0.dev1/funpaybotengine/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$/.." vcs="Git" />
+  </component>
+</project>

funpaybotengine-0.1.0.dev1/funpaybotengine/.idea/workspace.xml

@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="be6c7dab-f721-4460-b7b4-0d8768c318dc" name="Changes" comment="" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$/.." />
+  </component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 0
+}</component>
+  <component name="ProjectId" id="30KOzQtxp8XPapuqSjaGsPeZsax" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252": "true",
+    "RunOnceActivity.git.unshallow": "true",
+    "git-widget-placeholder": "dev",
+    "last_opened_file_path": "/home/qvvonk/projects/funpaybotengine",
+    "node.js.detected.package.eslint": "true",
+    "node.js.detected.package.tslint": "true",
+    "node.js.selected.package.eslint": "(autodetect)",
+    "node.js.selected.package.tslint": "(autodetect)",
+    "nodejs_package_manager_path": "npm",
+    "settings.editor.selected.configurable": "preferences.lookFeel",
+    "vue.rearranger.settings.migration": "true"
+  }
+}]]></component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-js-predefined-d6986cc7102b-b598e85cdad2-JavaScript-PY-252.25557.178" />
+        <option value="bundled-python-sdk-ce6832f46686-7b97d883f26b-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-252.25557.178" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="be6c7dab-f721-4460-b7b4-0d8768c318dc" name="Changes" comment="" />
+      <created>1753373060154</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1753373060154</updated>
+      <workItem from="1753373061197" duration="27000" />
+      <workItem from="1763209333536" duration="897000" />
+      <workItem from="1763558110149" duration="3121000" />
+      <workItem from="1763591533259" duration="538000" />
+      <workItem from="1765123562076" duration="554000" />
+      <workItem from="1765124126231" duration="25000" />
+      <workItem from="1765136987976" duration="77000" />
+      <workItem from="1765225184113" duration="5000" />
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+</project>

funpaybotengine-0.1.0.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.0.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.0.dev1/funpaybotengine/client/__init__.py

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