capslockstep 0.1.0__py3-none-any.whl

capslockstep/__init__.py

@@ -0,0 +1,2 @@
+def hello() -> str:
+    return "Hello from capslockstep!"

capslockstep/cli.py

@@ -0,0 +1,49 @@
+import argparse
+import asyncio
+import platform
+from contextlib import suppress
+
+import aiohttp
+
+from capslockstep.key import CapsLock, CapsLockLinux
+from capslockstep.models import CapsLockEvent, CapsLockState
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("room_id", help="The ID of the room to join")
+    parser.add_argument("--api-url", default="capslockstep.fastapicloud.dev")
+    args = parser.parse_args()
+
+    match platform.system():
+        case "Linux":
+            caps_lock = CapsLockLinux()
+        case _:
+            raise NotImplementedError(f"Unsupported system: {platform.system()}")
+
+    asyncio.run(stay_lock_step(caps_lock, args.api_url, args.room_id))
+
+
+async def stay_lock_step(caps_lock: CapsLock, api_url: str, room_id: str) -> None:
+    async with aiohttp.ClientSession() as session:
+        async with session.ws_connect(f"wss://{api_url}/caps-lock/{room_id}") as ws:
+
+            async def writer():
+                with suppress(asyncio.CancelledError):
+                    async for new_value in caps_lock.watch():
+                        event = CapsLockEvent(value=new_value)
+                        await ws.send_str(event.model_dump_json())
+
+            writer_task = asyncio.create_task(writer())
+
+            try:
+                async for message in ws:
+                    if message.type == aiohttp.WSMsgType.TEXT:
+                        serialized_state = message.data
+                        state = CapsLockState.model_validate_json(serialized_state)
+                        caps_lock.set(state.value)
+            except asyncio.CancelledError:
+                pass
+            finally:
+                writer_task.cancel()
+                await writer_task

capslockstep/key.py

@@ -0,0 +1,55 @@
+import asyncio
+from abc import ABC, abstractmethod
+from collections.abc import AsyncGenerator
+from pathlib import Path
+
+import libevdev
+
+
+class CapsLock(ABC):
+    @abstractmethod
+    def watch(self) -> AsyncGenerator[bool]:
+        """Watch for changes to the Caps Lock key state"""
+
+    @abstractmethod
+    def set(self, value: bool) -> None:
+        """Set the state of the Caps Lock key to the given value."""
+
+
+class CapsLockLinux(CapsLock):
+    def __init__(self) -> None:
+        self.dev = libevdev.Device()
+        self.dev.name = "Caps Lock Step Device"
+        self.dev.enable(libevdev.KEY_CAPSLOCK)
+        self.uinput = self.dev.create_uinput_device()
+        self.old_value = self.get_current_value()
+
+    async def watch(self) -> AsyncGenerator[bool]:
+        while True:
+            new_value = self.get_current_value()
+
+            if new_value != self.old_value:
+                yield new_value
+                self.old_value = new_value
+
+            await asyncio.sleep(0.1)
+
+    def set(self, value: bool) -> None:
+        if value != self.get_current_value():
+            self.toggle()
+
+    def toggle(self) -> None:
+        self.uinput.send_events(
+            [
+                libevdev.InputEvent(libevdev.KEY_CAPSLOCK, 1),
+                libevdev.InputEvent(libevdev.SYN_REPORT, 0),
+                libevdev.InputEvent(libevdev.KEY_CAPSLOCK, 0),
+                libevdev.InputEvent(libevdev.SYN_REPORT, 0),
+            ]
+        )
+
+    def get_current_value(self) -> bool:
+        return any(
+            path.read_text().strip() == "1"
+            for path in Path("/sys/class/leds").glob("input*::capslock/brightness")
+        )

capslockstep/models.py

@@ -0,0 +1,12 @@
+from datetime import datetime
+
+from pydantic import BaseModel
+
+
+class CapsLockEvent(BaseModel):
+    value: bool
+
+
+class CapsLockState(BaseModel):
+    value: bool
+    date: datetime

capslockstep-0.1.0.dist-info/METADATA

@@ -0,0 +1,10 @@
+Metadata-Version: 2.3
+Name: capslockstep
+Version: 0.1.0
+Summary: Add your description here
+Author: Jonathan Ehwald
+Author-email: Jonathan Ehwald <github@ehwald.info>
+Requires-Dist: aiohttp>=3.13.3
+Requires-Dist: libevdev>=0.13.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Python: >=3.14

capslockstep-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+capslockstep/__init__.py,sha256=fmP3oPXZUQmBTKVNUnby5jiUHJKvZZ9fOwaWWe_NUG4,58
+capslockstep/cli.py,sha256=6iERETurPy7xZLKn0rfHs5sVf-mHfHn-i3NecMwX2ho,1731
+capslockstep/key.py,sha256=k69BFU_SWniSNrI2xc5qAwyKFy-ZJzcACf-BKGtyaj8,1656
+capslockstep/models.py,sha256=fch_0CvcKEi47kUuYnTIhwWbVOO9ONdlaACp1pOvssg,181
+capslockstep/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+capslockstep-0.1.0.dist-info/WHEEL,sha256=hbX8mDThv1n7VEIpQRy6c2yAFTw4iAQlEC53gDAhHSo,80
+capslockstep-0.1.0.dist-info/entry_points.txt,sha256=HgoXWCLvgoztpIV6rsDwW-WI70TSCVZC8gM5pZ6YHYM,56
+capslockstep-0.1.0.dist-info/METADATA,sha256=f5nH6cyqAKH9paX5t6IF9j1ebIp6XDmnhcu06qooWBA,285
+capslockstep-0.1.0.dist-info/RECORD,,

capslockstep-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.10.6
+Root-Is-Purelib: true
+Tag: py3-none-any

capslockstep-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+capslockstep = capslockstep.cli:main
+