breadq 0.1.0__tar.gz

breadq-0.1.0/PKG-INFO

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: breadq
+Version: 0.1.0
+Summary: Multiplayer client for QBReader
+Home-page: https://github.com/packjackisback/breadq
+Author: Jack
+Author-email: packjackisback@gmail.com
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: websockets>=11.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# breadq
+
+A QBReader multiplayer library.
+
+This is meant for making clients, bots are very easy to make and boring.
+(Coming soon (tm) a tui qbreader client)
+
+
+Please don't use this to cheat, it really just looks bad on you.
+
+TODO: 
+
+    Adding the rest of the outgoing events
+    Adding state
+    Adding ratelimiting
+    Documentation

breadq-0.1.0/README.md

@@ -0,0 +1,16 @@
+# breadq
+
+A QBReader multiplayer library.
+
+This is meant for making clients, bots are very easy to make and boring.
+(Coming soon (tm) a tui qbreader client)
+
+
+Please don't use this to cheat, it really just looks bad on you.
+
+TODO: 
+
+    Adding the rest of the outgoing events
+    Adding state
+    Adding ratelimiting
+    Documentation

breadq-0.1.0/breadq/__init__.py

@@ -0,0 +1,3 @@
+from .client import QBReaderClient
+
+__all__ = ["QBReaderClient"]

breadq-0.1.0/breadq/actions.py

@@ -0,0 +1,49 @@
+import asyncio
+
+def register(client):
+
+    async def pause(paused_time=0):
+        await client.emit("pause", pausedTime=paused_time)
+
+    async def buzz():
+        await client.emit("buzz")
+        await give_answer_live_update()
+
+    async def ban(userId, username):
+        await client.emit("ban", targetId=userId, targetUsername=username)
+
+    async def chat_live_update(message=""):
+        await client.emit("chat-live-update", message=message)
+
+    async def chat(message=""):
+        await chat-live-update("")
+        await client.emit("chat", message=message)
+
+    async def clear_stats():
+        await client.emit("clear-stats")
+
+    async def give_answer_live_update(message=""):
+        await client.emit("give-answer-live-update", givenAnswer=message)
+
+    async def give_answer(message=""):
+        await give_answer_live_update()
+        await client.emit("give-answer", givenAnswer=message)
+
+
+
+    client.pause = pause
+    client.buzz = buzz
+    client.ban = ban
+    client.chat_live_update = chat_live_update
+    client.chat = chat
+    client.clear_stats = clear_stats
+    client.give_answer_live_update = give_answer_live_update
+    client.give_answer = give_answer
+
+    async def do(action_name, **kwargs):
+        action = getattr(client, action_name, None)
+        if not action:
+            raise ValueError(f"Unknown action: {action_name}")
+        await action(**kwargs)
+
+    client.do = do

breadq-0.1.0/breadq/client.py

@@ -0,0 +1,115 @@
+import asyncio
+import json
+import uuid
+import websockets
+
+from . import actions
+
+# gotta enable that logging
+import logging
+
+class QBReaderClient:
+    def __init__(self, room, username, user_id=None, debug_mode=False):
+        if debug_mode:
+            logging.basicConfig(level=logging.DEBUG)
+            logging.getLogger("websockets").setLevel(logging.DEBUG)
+            print("Debug Mode ON")
+            print("Loading ", username)
+
+        
+
+        self.room = room
+        self.username = username
+        self.user_id = user_id or str(uuid.uuid4())
+
+        self.ws = None
+        self.handlers = {}
+        self.send_queue = asyncio.Queue()
+        self.running = False
+        self.debug_mode = debug_mode
+
+        actions.register(self)
+        if debug_mode:
+            print(username, " Loaded: ", hasattr(self, "buzz"))
+
+    def on(self, message_type, handler):
+        self.handlers[message_type] = handler
+
+    async def emit(self, event_type: str, **data):
+        payload = {"type": event_type, **data}
+        await self.send(payload)
+
+    async def send(self, payload: dict):
+        if self.debug_mode:
+            print(f"[{self.user_id}] SEND -> {payload}")
+        await self.send_queue.put(payload)
+
+    async def start(self):
+        url = (
+            f"wss://www.qbreader.org/play/mp/test"
+            f"?roomName={self.room}"
+            f"&userId={self.user_id}"
+            f"&username={self.username}"
+        )
+
+
+        try:
+            async with websockets.connect(
+                url,
+                origin="https://www.qbreader.org",
+                ping_interval=None
+            ) as ws:
+                self.ws = ws
+                self.running = True
+
+                await asyncio.gather(
+                    self._receiver_loop(),
+                    self._sender_loop(),
+                    self._heartbeat_loop(),
+                )
+
+        except websockets.exceptions.ConnectionClosed as e:
+            print(
+                f"[{self.user_id}] CLOSED "
+                f"code={e.code} reason={e.reason}"
+            )
+            raise
+
+        except Exception as e:
+            print(f"[{self.user_id}] START ERROR -> {e}")
+            raise
+
+
+ 
+    async def _receiver_loop(self):
+        try:
+            async for message in self.ws:
+                if self.debug_mode:
+                    print(f"[{self.user_id}] RECV RAW -> {message}")
+
+                try:
+                    data = json.loads(message)
+                except Exception as e:
+                    print(f"[{self.user_id}] JSON ERROR -> {e}")
+                    continue
+
+                msg_type = data.get("type")
+                handler = self.handlers.get(msg_type)
+
+                if handler:
+                    await handler(data)
+
+        except Exception as e:
+            print(f"[{self.user_id}] RECEIVER ERROR -> {e}")
+            raise
+
+
+    async def _sender_loop(self):
+        while self.running:
+            payload = await self.send_queue.get()
+            await self.ws.send(json.dumps(payload))
+
+    async def _heartbeat_loop(self):
+        while self.running:
+            await asyncio.sleep(20)
+            await self.emit("ping")

breadq-0.1.0/breadq/qbreader_client.py

@@ -0,0 +1,77 @@
+import asyncio
+import json
+import uuid
+import websockets
+
+
+class QBReaderClient:
+    def __init__(self, room, username, user_id=None):
+        self.room = room
+        self.username = username
+        self.user_id = user_id or str(uuid.uuid4())
+
+        self.ws = None
+        self.handlers = {}
+        self.send_queue = asyncio.Queue()
+        self.running = False
+
+    def on(self, message_type, handler):
+        """
+        Register a handler for a message type.
+        """
+        self.handlers[message_type] = handler
+
+    async def send(self, payload: dict):
+        """
+        Queue a message to be sent.
+        """
+        await self.send_queue.put(payload)
+
+    async def pause(self):
+        await self.send({"type": "pause", "pausedTime": 0})
+
+    async def start(self):
+        url = (
+            f"wss://www.qbreader.org/play/mp/test"
+            f"?roomName={self.room}"
+            f"&userId={self.user_id}"
+            f"&username={self.username}"
+        )
+
+        async with websockets.connect(
+            url,
+            origin="https://www.qbreader.org",
+            ping_interval=None
+        ) as ws:
+
+            self.ws = ws
+            self.running = True
+
+            await asyncio.gather(
+                self._receiver_loop(),
+                self._sender_loop(),
+                self._heartbeat_loop(),
+            )
+
+    async def _receiver_loop(self):
+        async for message in self.ws:
+            try:
+                data = json.loads(message)
+            except Exception:
+                continue
+
+            msg_type = data.get("type")
+            handler = self.handlers.get(msg_type)
+
+            if handler:
+                await handler(data)
+
+    async def _sender_loop(self):
+        while self.running:
+            payload = await self.send_queue.get()
+            await self.ws.send(json.dumps(payload))
+
+    async def _heartbeat_loop(self):
+        while self.running:
+            await asyncio.sleep(1)
+            await self.send({"type": "ping"})

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

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: breadq
+Version: 0.1.0
+Summary: Multiplayer client for QBReader
+Home-page: https://github.com/packjackisback/breadq
+Author: Jack
+Author-email: packjackisback@gmail.com
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: websockets>=11.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# breadq
+
+A QBReader multiplayer library.
+
+This is meant for making clients, bots are very easy to make and boring.
+(Coming soon (tm) a tui qbreader client)
+
+
+Please don't use this to cheat, it really just looks bad on you.
+
+TODO: 
+
+    Adding the rest of the outgoing events
+    Adding state
+    Adding ratelimiting
+    Documentation

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

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+setup.py
+breadq/__init__.py
+breadq/actions.py
+breadq/client.py
+breadq/qbreader_client.py
+breadq.egg-info/PKG-INFO
+breadq.egg-info/SOURCES.txt
+breadq.egg-info/dependency_links.txt
+breadq.egg-info/requires.txt
+breadq.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+websockets>=11.0

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

@@ -0,0 +1 @@
+breadq

breadq-0.1.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"

breadq-0.1.0/setup.cfg

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

breadq-0.1.0/setup.py

@@ -0,0 +1,21 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r") as fh:
+    long_description = fh.read()
+
+setup(
+    name="breadq",
+    version="0.1.0",
+    author="Jack",
+    author_email="packjackisback@gmail.com",
+    description="Multiplayer client for QBReader",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/packjackisback/breadq",
+    packages=find_packages(),
+    install_requires=[
+        "websockets>=11.0",
+    ],
+    python_requires=">=3.9",
+)
+