fudster 0.1.0__tar.gz

fudster-0.1.0/.flake8

@@ -0,0 +1,11 @@
+[flake8]
+exclude =
+	.git,
+	__pycache__,
+	build,
+	dist,
+	.tox,
+	venv,
+	.venv,
+	.pytest_cache
+max-line-length = 120

fudster-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

fudster-0.1.0/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: fudster
+Version: 0.1.0
+Summary: Fudster - A composable ML library for haystack-ai and pgvector integrations
+License-Expression: LicenseRef-Proprietary
+Requires-Python: <3.14,>=3.12
+Requires-Dist: aiohappyeyeballs==2.6.1
+Requires-Dist: aiohttp==3.13.3
+Requires-Dist: aiosignal==1.4.0
+Requires-Dist: annotated-doc==0.0.4
+Requires-Dist: annotated-types==0.7.0
+Requires-Dist: anyio==4.12.1
+Requires-Dist: attrs==25.4.0
+Requires-Dist: beautifulsoup4==4.14.3
+Requires-Dist: broadcaster==0.3.1
+Requires-Dist: certifi==2026.1.4
+Requires-Dist: charset-normalizer==3.4.4
+Requires-Dist: fastapi==0.128.7
+Requires-Dist: frozenlist==1.8.0
+Requires-Dist: idna==3.11
+Requires-Dist: jinja2==3.1.6
+Requires-Dist: lxml==5.4.0
+Requires-Dist: markupsafe==3.0.3
+Requires-Dist: multidict==6.7.1
+Requires-Dist: propcache==0.4.1
+Requires-Dist: pydantic-core==2.41.5
+Requires-Dist: pydantic==2.12.5
+Requires-Dist: requests==2.32.5
+Requires-Dist: soupsieve==2.8.3
+Requires-Dist: starlette==0.52.1
+Requires-Dist: typing-extensions==4.15.0
+Requires-Dist: typing-inspection==0.4.2
+Requires-Dist: urllib3==2.6.3
+Requires-Dist: yarl==1.22.0
+Provides-Extra: all
+Requires-Dist: behave==1.2.6; extra == 'all'
+Requires-Dist: chardet==5.2.0; extra == 'all'
+Requires-Dist: colorama==0.4.6; extra == 'all'
+Requires-Dist: cssselect==1.4.0; extra == 'all'
+Requires-Dist: exceptiongroup==1.3.1; extra == 'all'
+Requires-Dist: execnet==2.1.2; extra == 'all'
+Requires-Dist: fasteners==0.20; extra == 'all'
+Requires-Dist: filelock==3.20.3; extra == 'all'
+Requires-Dist: h11==0.16.0; extra == 'all'
+Requires-Dist: humancursor==1.1.5; extra == 'all'
+Requires-Dist: iniconfig==2.3.0; extra == 'all'
+Requires-Dist: jwcrypto==1.5.6; extra == 'all'
+Requires-Dist: markdown-it-py==4.0.0; extra == 'all'
+Requires-Dist: mdurl==0.1.2; extra == 'all'
+Requires-Dist: mouseinfo==0.1.3; extra == 'all'
+Requires-Dist: mycdp==1.3.2; extra == 'all'
+Requires-Dist: nest-asyncio==1.6.0; extra == 'all'
+Requires-Dist: numpy==2.4.2; extra == 'all'
+Requires-Dist: opencv-python==4.13.0.92; extra == 'all'
+Requires-Dist: outcome==1.3.0.post0; extra == 'all'
+Requires-Dist: packaging==26.0; extra == 'all'
+Requires-Dist: parameterized==0.9.0; extra == 'all'
+Requires-Dist: parse-type==0.6.6; extra == 'all'
+Requires-Dist: parse==1.21.0; extra == 'all'
+Requires-Dist: pdbp==1.8.2; extra == 'all'
+Requires-Dist: pillow==11.3.0; extra == 'all'
+Requires-Dist: pip==26.0.1; extra == 'all'
+Requires-Dist: platformdirs==4.5.1; extra == 'all'
+Requires-Dist: pluggy==1.6.0; extra == 'all'
+Requires-Dist: pyautogui==0.9.54; extra == 'all'
+Requires-Dist: pygetwindow==0.0.9; extra == 'all'
+Requires-Dist: pygments==2.19.2; extra == 'all'
+Requires-Dist: pymsgbox==2.0.1; extra == 'all'
+Requires-Dist: pynose==1.5.5; extra == 'all'
+Requires-Dist: pyobjc-core==12.1; extra == 'all'
+Requires-Dist: pyobjc-framework-quartz==12.1; extra == 'all'
+Requires-Dist: pyotp==2.9.0; extra == 'all'
+Requires-Dist: pyreadline3==3.5.4; extra == 'all'
+Requires-Dist: pyscreeze==1.0.1; extra == 'all'
+Requires-Dist: pytest-html==4.0.2; extra == 'all'
+Requires-Dist: pytest-metadata==3.1.1; extra == 'all'
+Requires-Dist: pytest-ordering==0.6; extra == 'all'
+Requires-Dist: pytest-rerunfailures==16.1; extra == 'all'
+Requires-Dist: pytest-xdist==3.8.0; extra == 'all'
+Requires-Dist: pytest==9.0.2; extra == 'all'
+Requires-Dist: python-xlib==0.33; extra == 'all'
+Requires-Dist: python3-xlib==0.15; extra == 'all'
+Requires-Dist: pytweening==1.2.0; extra == 'all'
+Requires-Dist: pyyaml==6.0.3; extra == 'all'
+Requires-Dist: redis==7.1.1; extra == 'all'
+Requires-Dist: rich==14.3.2; extra == 'all'
+Requires-Dist: sbvirtualdisplay==1.4.0; extra == 'all'
+Requires-Dist: selenium==4.40.0; extra == 'all'
+Requires-Dist: seleniumbase==4.46.5; extra == 'all'
+Requires-Dist: setuptools==82.0.0; extra == 'all'
+Requires-Dist: six==1.17.0; extra == 'all'
+Requires-Dist: sniffio==1.3.1; extra == 'all'
+Requires-Dist: sortedcontainers==2.4.0; extra == 'all'
+Requires-Dist: tabcompleter==1.4.0; extra == 'all'
+Requires-Dist: trio-websocket==0.12.2; extra == 'all'
+Requires-Dist: trio==0.32.0; extra == 'all'
+Requires-Dist: websocket-client==1.9.0; extra == 'all'
+Requires-Dist: websockets==16.0; extra == 'all'
+Requires-Dist: websockify==0.13.0; extra == 'all'
+Requires-Dist: wheel==0.46.3; extra == 'all'
+Requires-Dist: wsproto==1.3.2; extra == 'all'
+Provides-Extra: automation
+Requires-Dist: humancursor==1.1.5; extra == 'automation'
+Requires-Dist: mouseinfo==0.1.3; extra == 'automation'
+Requires-Dist: numpy==2.4.2; extra == 'automation'
+Requires-Dist: opencv-python==4.13.0.92; extra == 'automation'
+Requires-Dist: pillow==11.3.0; extra == 'automation'
+Requires-Dist: pyautogui==0.9.54; extra == 'automation'
+Requires-Dist: pygetwindow==0.0.9; extra == 'automation'
+Requires-Dist: pymsgbox==2.0.1; extra == 'automation'
+Requires-Dist: pyobjc-core==12.1; extra == 'automation'
+Requires-Dist: pyobjc-framework-quartz==12.1; extra == 'automation'
+Requires-Dist: pyscreeze==1.0.1; extra == 'automation'
+Requires-Dist: python3-xlib==0.15; extra == 'automation'
+Requires-Dist: pytweening==1.2.0; extra == 'automation'
+Requires-Dist: selenium==4.40.0; extra == 'automation'
+Provides-Extra: browser
+Requires-Dist: behave==1.2.6; extra == 'browser'
+Requires-Dist: chardet==5.2.0; extra == 'browser'
+Requires-Dist: colorama==0.4.6; extra == 'browser'
+Requires-Dist: cssselect==1.4.0; extra == 'browser'
+Requires-Dist: exceptiongroup==1.3.1; extra == 'browser'
+Requires-Dist: execnet==2.1.2; extra == 'browser'
+Requires-Dist: fasteners==0.20; extra == 'browser'
+Requires-Dist: filelock==3.20.3; extra == 'browser'
+Requires-Dist: h11==0.16.0; extra == 'browser'
+Requires-Dist: iniconfig==2.3.0; extra == 'browser'
+Requires-Dist: markdown-it-py==4.0.0; extra == 'browser'
+Requires-Dist: mdurl==0.1.2; extra == 'browser'
+Requires-Dist: mycdp==1.3.2; extra == 'browser'
+Requires-Dist: nest-asyncio==1.6.0; extra == 'browser'
+Requires-Dist: outcome==1.3.0.post0; extra == 'browser'
+Requires-Dist: packaging==26.0; extra == 'browser'
+Requires-Dist: parameterized==0.9.0; extra == 'browser'
+Requires-Dist: parse-type==0.6.6; extra == 'browser'
+Requires-Dist: parse==1.21.0; extra == 'browser'
+Requires-Dist: pdbp==1.8.2; extra == 'browser'
+Requires-Dist: pip==26.0.1; extra == 'browser'
+Requires-Dist: platformdirs==4.5.1; extra == 'browser'
+Requires-Dist: pluggy==1.6.0; extra == 'browser'
+Requires-Dist: pyautogui==0.9.54; extra == 'browser'
+Requires-Dist: pygments==2.19.2; extra == 'browser'
+Requires-Dist: pynose==1.5.5; extra == 'browser'
+Requires-Dist: pyotp==2.9.0; extra == 'browser'
+Requires-Dist: pyreadline3==3.5.4; extra == 'browser'
+Requires-Dist: pytest-html==4.0.2; extra == 'browser'
+Requires-Dist: pytest-metadata==3.1.1; extra == 'browser'
+Requires-Dist: pytest-ordering==0.6; extra == 'browser'
+Requires-Dist: pytest-rerunfailures==16.1; extra == 'browser'
+Requires-Dist: pytest-xdist==3.8.0; extra == 'browser'
+Requires-Dist: pytest==9.0.2; extra == 'browser'
+Requires-Dist: python-xlib==0.33; extra == 'browser'
+Requires-Dist: pyyaml==6.0.3; extra == 'browser'
+Requires-Dist: rich==14.3.2; extra == 'browser'
+Requires-Dist: sbvirtualdisplay==1.4.0; extra == 'browser'
+Requires-Dist: selenium==4.40.0; extra == 'browser'
+Requires-Dist: seleniumbase==4.46.5; extra == 'browser'
+Requires-Dist: setuptools==82.0.0; extra == 'browser'
+Requires-Dist: six==1.17.0; extra == 'browser'
+Requires-Dist: sniffio==1.3.1; extra == 'browser'
+Requires-Dist: sortedcontainers==2.4.0; extra == 'browser'
+Requires-Dist: tabcompleter==1.4.0; extra == 'browser'
+Requires-Dist: trio-websocket==0.12.2; extra == 'browser'
+Requires-Dist: trio==0.32.0; extra == 'browser'
+Requires-Dist: websocket-client==1.9.0; extra == 'browser'
+Requires-Dist: websockets==16.0; extra == 'browser'
+Requires-Dist: wheel==0.46.3; extra == 'browser'
+Requires-Dist: wsproto==1.3.2; extra == 'browser'
+Provides-Extra: vnc
+Requires-Dist: jwcrypto==1.5.6; extra == 'vnc'
+Requires-Dist: numpy==2.4.2; extra == 'vnc'
+Requires-Dist: redis==7.1.1; extra == 'vnc'
+Requires-Dist: websockets==16.0; extra == 'vnc'
+Requires-Dist: websockify==0.13.0; extra == 'vnc'
+Description-Content-Type: text/markdown
+
+# fudster
+
+A composable ML library for haystack-ai and pgvector integrations.
+
+## Installation
+
+```bash
+pip install fudster
+```
+
+## Development
+
+This package is part of the [KBVE](https://github.com/kbve/kbve) monorepo, managed with Nx and Poetry.
+
+```bash
+pnpm nx test python-fudster
+pnpm nx lint python-fudster
+pnpm nx build python-fudster
+```

fudster-0.1.0/README.md

@@ -0,0 +1,19 @@
+# fudster
+
+A composable ML library for haystack-ai and pgvector integrations.
+
+## Installation
+
+```bash
+pip install fudster
+```
+
+## Development
+
+This package is part of the [KBVE](https://github.com/kbve/kbve) monorepo, managed with Nx and Poetry.
+
+```bash
+pnpm nx test python-fudster
+pnpm nx lint python-fudster
+pnpm nx build python-fudster
+```

fudster-0.1.0/fudster/__init__.py

@@ -0,0 +1,41 @@
+"""Fudster - A composable ML library for haystack-ai and pgvector integrations."""
+
+import logging as _logging
+
+_logger = _logging.getLogger(__name__)
+
+# Broadcast models
+from .models import (  # noqa: F401, E402
+    CommandModel, LoggerModel, BroadcastModel, KBVELoginModel, HandshakeModel, model_map,
+)
+
+# API models
+from .models.rss import RssItem, RssFeed  # noqa: F401, E402
+from .models.poem import PoemDB  # noqa: F401, E402
+from .models.coindesk import CoinDeskAPIResponse  # noqa: F401, E402
+from .models.groq import AiGroqPayload, GroqResponse  # noqa: F401, E402
+from .models.rsps import GameEvent, GameStat, GameInventory  # noqa: F401, E402
+
+# Core API
+from .api import Routes, CORS, WS, APIConnector  # noqa: F401, E402
+
+# API clients
+from .api.clients import CoinDeskClient, PoetryDBClient, GroqClient, WebsocketEchoClient  # noqa: F401, E402
+
+# API utils
+from .api.utils import RSSUtility, KRDecorator, DynamicEndpoint  # noqa: F401, E402
+
+try:
+    from .api.utils import ImageUtility  # noqa: F401, E402
+except ImportError:
+    _logger.debug("ImageUtility unavailable — install fudster[image] for image processing support")
+
+# Apps
+from .apps import RuneLiteClient  # noqa: F401, E402
+
+try:
+    from .apps import ScreenClient, ChromeClient, DiscordClient, NoVNCClient  # noqa: F401, E402
+except ImportError:
+    _logger.debug("Optional app clients unavailable — install fudster[browser,automation,vnc] as needed")
+
+__version__ = "0.1.0"

fudster-0.1.0/fudster/api/__init__.py

@@ -0,0 +1,4 @@
+from .routes import Routes  # noqa: F401
+from .cors import CORS  # noqa: F401
+from .websockets import WS  # noqa: F401
+from .api_connector import APIConnector  # noqa: F401

fudster-0.1.0/fudster/api/api_connector.py

@@ -0,0 +1,99 @@
+import aiohttp
+from aiohttp import ClientTimeout
+
+import asyncio
+from typing import Optional, Any
+
+
+class APIConnector:
+    def __init__(self, base_url: str, key: Optional[str] = None, websocket=None, timeout: int = 30):
+        self.base_url = base_url
+        self.key = key
+        self.session = aiohttp.ClientSession(timeout=ClientTimeout(total=timeout))
+        self.websocket = websocket
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, exc_type, exc_val, exc_tb):
+        await self.close()
+        return False
+
+    async def _request(self, method: str, endpoint: str, **kwargs) -> Any:
+        url = f"{self.base_url}/{endpoint}"
+        headers = self._prepare_headers(kwargs.pop('auth', None))
+        async with self.session.request(method, url, headers=headers, **kwargs) as response:
+            response.raise_for_status()
+            return await response.json()
+
+    async def _get_session(self):
+        if not self.session:
+            self.session = aiohttp.ClientSession()
+        return self.session
+
+    async def get(self, endpoint: str, **kwargs) -> Any:
+        return await self._request('GET', endpoint, **kwargs)
+
+    async def post(self, endpoint: str, **kwargs) -> Any:
+        return await self._request('POST', endpoint, **kwargs)
+
+    async def delete(self, endpoint: str, **kwargs) -> Any:
+        return await self._request('DELETE', endpoint, **kwargs)
+
+    async def close(self):
+        if self.websocket is not None and not self.websocket.closed:
+            await self.websocket.close()
+        await self.session.close()
+
+    async def connect_websocket(self, endpoint: Optional[str] = None) -> aiohttp.ClientWebSocketResponse:
+        headers = {}
+        if self.key:
+            headers['Authorization'] = f"Bearer {self.key}"
+        if endpoint:
+            websocket_url = f"{self.base_url}/{endpoint}"
+        else:
+            websocket_url = self.base_url
+
+        self.websocket = await self.session.ws_connect(websocket_url, headers=headers)
+        return self.websocket
+
+    async def ensure_websocket_connected(self):
+        """Ensure that the WebSocket connection is established."""
+        if self.websocket is None or self.websocket.closed:
+            self.websocket = await self.session.ws_connect(f"{self.base_url}", headers=self._prepare_headers())
+        return self.websocket
+
+    async def send_websocket_message(self, message: str, timeout: float = 30.0):
+        """Send a message through the WebSocket connection."""
+        await self.ensure_websocket_connected()
+        await asyncio.wait_for(self.websocket.send_str(message), timeout=timeout)
+
+    async def receive_websocket_message(self, timeout: float = 30.0) -> str:
+        """Receive a message from the WebSocket connection."""
+        await self.ensure_websocket_connected()
+        msg = await asyncio.wait_for(self.websocket.receive(), timeout=timeout)
+        if msg.type == aiohttp.WSMsgType.TEXT:
+            return msg.data
+        elif msg.type in (aiohttp.WSMsgType.CLOSED, aiohttp.WSMsgType.ERROR):
+            raise Exception("WebSocket connection closed or encountered an error.")
+        raise Exception(f"Unexpected WebSocket message type: {msg.type}")
+
+    def _prepare_headers(self, auth: Optional[str] = None) -> dict:
+        """Prepare headers for HTTP or WebSocket connection."""
+        headers = {}
+        if self.key and auth == 'header':
+            headers['Authorization'] = f"Bearer {self.key}"
+        return headers
+
+    async def get_raw_content(self, endpoint: str) -> bytes:
+        """
+        Performs a GET request to the specified endpoint and returns the raw response content.
+
+        :param endpoint: The API endpoint to fetch.
+        :return: Raw content of the response as bytes.
+        """
+        session = await self._get_session()
+        url = f"{self.base_url}/{endpoint}"
+        async with session.get(url) as response:
+            response.raise_for_status()
+            return await response.read()

fudster-0.1.0/fudster/api/clients/__init__.py

@@ -0,0 +1,5 @@
+"""API Clients"""
+from .coindesk_client import CoinDeskClient  # noqa: F401
+from .poetry_db_client import PoetryDBClient  # noqa: F401
+from .groq_client import GroqClient  # noqa: F401
+from .websocket_echo_client import WebsocketEchoClient  # noqa: F401

fudster-0.1.0/fudster/api/clients/coindesk_client.py

@@ -0,0 +1,32 @@
+from pydantic import TypeAdapter, ValidationError
+from ..api_connector import APIConnector
+from ...models.coindesk import CoinDeskAPIResponse
+import logging
+
+logger = logging.getLogger("uvicorn")
+
+
+class CoinDeskClient(APIConnector):
+    """
+    A client for fetching Bitcoin price data from the CoinDesk API.
+    """
+
+    def __init__(self):
+        super().__init__("https://api.coindesk.com/v1")
+
+    async def get_current_bitcoin_price(self):
+        """
+        Fetches the current Bitcoin price in USD from the CoinDesk API.
+
+        Returns:
+            str: A string that states the current USD price of Bitcoin.
+        """
+        response = await self.get("bpi/currentprice.json")
+        adapter = TypeAdapter(CoinDeskAPIResponse)
+        try:
+            price_info = adapter.validate_python(response)
+        except ValidationError as ve:
+            logger.error(f"Validation error while parsing the API response: {ve}")
+            raise
+        usd_price = price_info.bpi.USD.rate
+        return f"The current USD price for Bitcoin is: ${usd_price}"

fudster-0.1.0/fudster/api/clients/groq_client.py

@@ -0,0 +1,59 @@
+import re
+import json
+from pydantic import TypeAdapter, ValidationError
+from ..api_connector import APIConnector
+from ...models.groq import GroqResponse, AiGroqPayload
+import logging
+
+logger = logging.getLogger("uvicorn")
+
+
+class GroqClient(APIConnector):
+    def __init__(self, api_key: str = None):
+        super().__init__("https://rust.kbve.com/api/v1")
+        self.api_key = api_key
+
+    def escape_message(self, message: str) -> str:
+        return json.dumps(message)[1:-1]
+
+    async def call_groq(self, payload: AiGroqPayload) -> GroqResponse:
+        headers = {"Content-Type": "application/json"}
+        if self.api_key:
+            headers["Authorization"] = f"Bearer {self.api_key}"
+
+        payload.message = self.escape_message(payload.message)
+
+        response = await self.post("call_groq", json=payload.dict(), headers=headers)
+        adapter = TypeAdapter(GroqResponse)
+        try:
+            groq_response = adapter.validate_python(response)
+        except ValidationError as ve:
+            logger.error(f"Validation error while parsing the API response: {ve}")
+            raise
+        return groq_response
+
+    async def groq_process_pathways(
+        self, pathways: dict, pathway: str,
+        payload: AiGroqPayload, max_calls: int = 5
+    ) -> GroqResponse:
+        current_pathway = pathway
+        for _ in range(max_calls):
+            if current_pathway not in pathways:
+                logger.error(f"Pathway {current_pathway} not defined")
+                break
+
+            current_config = pathways[current_pathway]
+            payload.message = current_config["prompt"]
+            response = await self.call_groq(payload)
+
+            next_pathway = None
+            for condition in current_config["next"]:
+                if re.search(condition["condition"], response.message):
+                    next_pathway = condition["action"]
+                    break
+
+            if next_pathway:
+                current_pathway = next_pathway
+            else:
+                return response
+        return response

fudster-0.1.0/fudster/api/clients/poetry_db_client.py

@@ -0,0 +1,23 @@
+import aiohttp
+
+from ..api_connector import APIConnector
+from ...models.poem import PoemDB
+
+
+class PoetryDBClient(APIConnector):
+    def __init__(self):
+        """
+        Initializes the PoetryDBClient with the base URL for the PoetryDB API.
+        """
+        super().__init__("https://poetrydb.org", key=None)
+
+    async def get_random_poem(self) -> PoemDB:
+        """
+        Fetches a random poem from the PoetryDB API and returns it as a PoemDB model instance.
+        """
+        response = await self.get("random", auth=None)
+        if response:
+            poem = PoemDB.model_validate(response[0])
+            return poem
+        else:
+            raise aiohttp.ClientResponseError("Failed to fetch a random poem.")

fudster-0.1.0/fudster/api/clients/websocket_echo_client.py

@@ -0,0 +1,32 @@
+from ..api_connector import APIConnector
+
+
+class WebsocketEchoClient(APIConnector):
+    """
+    A client for interacting with a WebSocket echo server.
+    """
+
+    def __init__(self):
+        super().__init__("wss://echo.websocket.org", key=None, websocket=None)
+
+    async def example(self):
+        """
+        Demonstrates the use of the WebSocket echo client.
+        """
+        try:
+            self.websocket = await self.connect_websocket()
+
+            initial_message = await self.receive_websocket_message()
+            print("Initial server response:", initial_message)
+
+            await self.send_websocket_message(message="Hello, WebSocket!")
+            echo1 = await self.receive_websocket_message()
+            print("Echo of first message:", echo1)
+
+            await self.send_websocket_message(message="This is a second message.")
+            echo2 = await self.receive_websocket_message()
+            print("Echo of second message:", echo2)
+
+        finally:
+            if self.websocket:
+                await self.websocket.close()

fudster-0.1.0/fudster/api/cors.py

@@ -0,0 +1,38 @@
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from typing import List
+
+
+class CORS:
+    def __init__(
+        self,
+        app: FastAPI,
+        origins: List[str] = [
+            "http://localhost:8086",
+            "http://localhost:4321",
+            "http://localhost:1337",
+            "http://localhost",
+            "http://localhost:8080",
+            "https://automation.kbve.com",
+            "https://rust.kbve.com",
+            "https://kbve.com",
+        ],
+        allow_credentials: bool = True,
+        allow_methods: List[str] = ["*"],
+        allow_headers: List[str] = ["*"],
+    ):
+        self.app = app
+        self.origins = origins
+        self.allow_credentials = allow_credentials
+        self.allow_methods = allow_methods
+        self.allow_headers = allow_headers
+        self.add_cors_middleware()
+
+    def add_cors_middleware(self):
+        self.app.add_middleware(
+            CORSMiddleware,
+            allow_origins=self.origins,
+            allow_credentials=self.allow_credentials,
+            allow_methods=self.allow_methods,
+            allow_headers=self.allow_headers,
+        )

fudster-0.1.0/fudster/api/routes.py

@@ -0,0 +1,51 @@
+from fastapi import FastAPI, HTTPException, Request
+from fastapi.templating import Jinja2Templates
+from typing import Type
+from pydantic import ValidationError
+
+
+class Routes:
+    def __init__(self, app: FastAPI, templates_dir: str = "templates"):
+        self.app = app
+        self.templates = Jinja2Templates(directory=templates_dir)
+
+    async def parse_json_body(self, request: Request):
+        try:
+            return await request.json()
+        except (ValueError, ValidationError):
+            raise HTTPException(status_code=400, detail="Invalid JSON payload")
+
+    def get_client_method(self, client, method_name: str):
+        method = getattr(client, method_name, None)
+        if not callable(method):
+            raise HTTPException(status_code=500, detail="Method not callable")
+        return method
+
+    def add_route(self, path: str, client_class: Type, method_name: str, methods=["GET"]):
+        async def wrapper(request: Request = None):
+            client = client_class()
+            try:
+                method = self.get_client_method(client, method_name)
+                if request and request.method == "POST":
+                    body = await self.parse_json_body(request)
+                    result = await method(body)
+                else:
+                    result = await method()
+
+                return result if isinstance(result, (dict, list)) else {"data": str(result)}
+            finally:
+                await client.close()
+
+        self.app.add_api_route(path, wrapper, methods=methods)
+
+    def render(self, path: str, template_name: str):
+        async def wrapper(request: Request):
+            return self.templates.TemplateResponse(template_name, {"request": request})
+
+        self.app.add_api_route(path, wrapper, methods=["GET"])
+
+    def get(self, path: str, client_class: Type, method_name: str):
+        self.add_route(path, client_class, method_name, methods=["GET"])
+
+    def post(self, path: str, client_class: Type, method_name: str):
+        self.add_route(path, client_class, method_name, methods=["POST"])

fudster-0.1.0/fudster/api/utils/__init__.py

@@ -0,0 +1,13 @@
+"""API Utilities"""
+import logging as _logging
+
+_logger = _logging.getLogger(__name__)
+
+from .rss_utils import RSSUtility  # noqa: F401, E402
+from .kr_decorator import KRDecorator  # noqa: F401, E402
+from .dynamic_endpoint_utils import DynamicEndpoint  # noqa: F401, E402
+
+try:
+    from .image_utils import ImageUtility  # noqa: F401, E402
+except ImportError:
+    _logger.debug("ImageUtility unavailable — install Pillow for image processing support")

fudster-0.1.0/fudster/api/utils/dynamic_endpoint_utils.py

@@ -0,0 +1,25 @@
+import importlib
+from fastapi import FastAPI, HTTPException
+
+
+class DynamicEndpoint:
+    def __init__(self, app: FastAPI):
+        self.app = app
+
+    def add_dynamic_route(self, path: str):
+        async def dynamic_handler(module_name: str, function_name: str):
+            try:
+                module = importlib.import_module(f"plugins.{module_name}")
+                method = getattr(module, function_name)
+                if not callable(method):
+                    raise HTTPException(status_code=500, detail="Function not callable")
+                result = await method()
+                return {"result": result}
+            except ModuleNotFoundError:
+                raise HTTPException(status_code=404, detail=f"Module '{module_name}' not found")
+            except AttributeError:
+                raise HTTPException(status_code=404, detail=f"Function '{function_name}' not found")
+            except Exception as e:
+                raise HTTPException(status_code=500, detail=str(e))
+
+        self.app.add_api_route(path, dynamic_handler, methods=["GET"])