capslockstep 0.1.0__tar.gz

capslockstep-0.1.0/PKG-INFO

@@ -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/pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "capslockstep"
+version = "0.1.0"
+description = "Add your description here"
+authors = [
+    { name = "Jonathan Ehwald", email = "github@ehwald.info" }
+]
+requires-python = ">=3.14"
+dependencies = [
+    "aiohttp>=3.13.3",
+    "libevdev>=0.13.1",
+    "pydantic>=2.12.5",
+]
+
+[project.scripts]
+capslockstep = "capslockstep.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.10.6,<0.11.0"]
+build-backend = "uv_build"

capslockstep-0.1.0/src/capslockstep/__init__.py

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

capslockstep-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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