hyprland-socket 0.1.0__tar.gz

hyprland_socket-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: uv sync
+      - run: uv run ruff check src/ tests/
+      - run: uv run ruff format --check src/ tests/
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: uv python install ${{ matrix.python-version }}
+      - run: uv sync --python ${{ matrix.python-version }}
+      - run: uv run pytest tests/ -v

hyprland_socket-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,18 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1

hyprland_socket-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+.idea/
+__pycache__/
+*.pyc
+dist/
+*.egg-info/
+.venv/
+.pytest_cache/

hyprland_socket-0.1.0/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 Ivo Šmerek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

hyprland_socket-0.1.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: hyprland-socket
+Version: 0.1.0
+Summary: Typed Python library for Hyprland IPC via Unix sockets
+Project-URL: Repository, https://github.com/BlueManCZ/hyprland-socket
+License-Expression: MIT
+License-File: LICENSE
+Keywords: compositor,hyprland,ipc,wayland
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Desktop Environment
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# hyprland-socket
+
+Typed Python library for [Hyprland](https://hyprland.org/) IPC via Unix sockets.
+
+Covers both read and write operations — querying state, applying settings live,
+batch commands, and monitoring events.
+
+## Installation
+
+```
+pip install hyprland-socket
+```
+
+## Usage
+
+### Query state
+
+```python
+import hyprland_socket
+
+# Check if Hyprland is running
+if hyprland_socket.is_running():
+    # Read monitors
+    for mon in hyprland_socket.get_monitors():
+        print(f"{mon.name}: {mon.width}x{mon.height} @ {mon.refresh_rate}Hz")
+
+    # Read a live option
+    option = hyprland_socket.getoption("general:gaps_in")
+    print(option)
+
+    # Read keybinds
+    for bind in hyprland_socket.get_binds():
+        print(f"{bind.key} -> {bind.dispatcher} {bind.arg}")
+```
+
+### Apply settings
+
+```python
+import hyprland_socket
+
+# Set a single option
+hyprland_socket.keyword("general:gaps_in", 5)
+
+# Batch multiple settings (single IPC call)
+hyprland_socket.keyword_batch([
+    ("general:gaps_in", "5"),
+    ("general:gaps_out", "10"),
+    ("decoration:rounding", "8"),
+])
+
+# Reload config from disk
+hyprland_socket.reload()
+```
+
+### Monitor events
+
+```python
+import hyprland_socket
+
+# Blocking iterator over compositor events
+for event in hyprland_socket.events():
+    print(f"{event.name}: {event.data}")
+    # e.g. "workspace: 2", "monitoradded: DP-3"
+```
+
+For integration with GTK/GLib event loops, use the raw socket:
+
+```python
+sock = hyprland_socket.connect_event_socket()
+fd = sock.fileno()
+# Use GLib.io_add_watch(fd, ...) or similar
+```
+
+## Error handling
+
+All functions raise typed exceptions instead of returning `None`:
+
+```python
+from hyprland_socket import ConnectionError, CommandError
+
+try:
+    hyprland_socket.keyword("invalid:option", "value")
+except ConnectionError:
+    print("Hyprland is not running")
+except CommandError as e:
+    print(f"Rejected: {e}")
+```
+
+## Models
+
+| Function | Returns |
+|---|---|
+| `get_monitors()` | `list[Monitor]` |
+| `get_binds()` | `list[Bind]` |
+| `get_animations()` | `tuple[list[Animation], list[dict]]` |
+| `getoption(key)` | `dict` |
+
+All models are mutable dataclasses with a `from_dict()` classmethod for
+construction from Hyprland's JSON responses.
+
+## Requirements
+
+- Python >= 3.12
+- A running Hyprland session (the `HYPRLAND_INSTANCE_SIGNATURE` environment variable must be set)
+
+## License
+
+MIT

hyprland_socket-0.1.0/README.md

@@ -0,0 +1,108 @@
+# hyprland-socket
+
+Typed Python library for [Hyprland](https://hyprland.org/) IPC via Unix sockets.
+
+Covers both read and write operations — querying state, applying settings live,
+batch commands, and monitoring events.
+
+## Installation
+
+```
+pip install hyprland-socket
+```
+
+## Usage
+
+### Query state
+
+```python
+import hyprland_socket
+
+# Check if Hyprland is running
+if hyprland_socket.is_running():
+    # Read monitors
+    for mon in hyprland_socket.get_monitors():
+        print(f"{mon.name}: {mon.width}x{mon.height} @ {mon.refresh_rate}Hz")
+
+    # Read a live option
+    option = hyprland_socket.getoption("general:gaps_in")
+    print(option)
+
+    # Read keybinds
+    for bind in hyprland_socket.get_binds():
+        print(f"{bind.key} -> {bind.dispatcher} {bind.arg}")
+```
+
+### Apply settings
+
+```python
+import hyprland_socket
+
+# Set a single option
+hyprland_socket.keyword("general:gaps_in", 5)
+
+# Batch multiple settings (single IPC call)
+hyprland_socket.keyword_batch([
+    ("general:gaps_in", "5"),
+    ("general:gaps_out", "10"),
+    ("decoration:rounding", "8"),
+])
+
+# Reload config from disk
+hyprland_socket.reload()
+```
+
+### Monitor events
+
+```python
+import hyprland_socket
+
+# Blocking iterator over compositor events
+for event in hyprland_socket.events():
+    print(f"{event.name}: {event.data}")
+    # e.g. "workspace: 2", "monitoradded: DP-3"
+```
+
+For integration with GTK/GLib event loops, use the raw socket:
+
+```python
+sock = hyprland_socket.connect_event_socket()
+fd = sock.fileno()
+# Use GLib.io_add_watch(fd, ...) or similar
+```
+
+## Error handling
+
+All functions raise typed exceptions instead of returning `None`:
+
+```python
+from hyprland_socket import ConnectionError, CommandError
+
+try:
+    hyprland_socket.keyword("invalid:option", "value")
+except ConnectionError:
+    print("Hyprland is not running")
+except CommandError as e:
+    print(f"Rejected: {e}")
+```
+
+## Models
+
+| Function | Returns |
+|---|---|
+| `get_monitors()` | `list[Monitor]` |
+| `get_binds()` | `list[Bind]` |
+| `get_animations()` | `tuple[list[Animation], list[dict]]` |
+| `getoption(key)` | `dict` |
+
+All models are mutable dataclasses with a `from_dict()` classmethod for
+construction from Hyprland's JSON responses.
+
+## Requirements
+
+- Python >= 3.12
+- A running Hyprland session (the `HYPRLAND_INSTANCE_SIGNATURE` environment variable must be set)
+
+## License
+
+MIT

hyprland_socket-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "hyprland-socket"
+version = "0.1.0"
+description = "Typed Python library for Hyprland IPC via Unix sockets"
+requires-python = ">=3.12"
+license = "MIT"
+readme = "README.md"
+keywords = ["hyprland", "ipc", "wayland", "compositor"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Desktop Environment",
+]
+
+[project.urls]
+Repository = "https://github.com/BlueManCZ/hyprland-socket"
+
+[dependency-groups]
+dev = ["pytest>=9.0", "ruff>=0.11"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

hyprland_socket-0.1.0/src/hyprland_socket/__init__.py

@@ -0,0 +1,35 @@
+"""hyprland-socket — Typed Python library for Hyprland IPC."""
+
+from .commands import (
+    get_animations,
+    get_binds,
+    get_monitors,
+    getoption,
+    is_running,
+    keyword,
+    keyword_batch,
+    reload,
+)
+from .errors import CommandError, ConnectionError, HyprlandError
+from .events import Event, connect_event_socket, events
+from .models import Animation, Bind, Monitor
+
+__all__ = [
+    "Animation",
+    "Bind",
+    "CommandError",
+    "ConnectionError",
+    "Event",
+    "HyprlandError",
+    "Monitor",
+    "connect_event_socket",
+    "events",
+    "get_animations",
+    "get_binds",
+    "get_monitors",
+    "getoption",
+    "is_running",
+    "keyword",
+    "keyword_batch",
+    "reload",
+]

hyprland_socket-0.1.0/src/hyprland_socket/_socket.py

@@ -0,0 +1,48 @@
+"""Low-level Unix socket communication with Hyprland."""
+
+import os
+import socket
+
+from .errors import ConnectionError
+
+
+def _socket_path() -> str:
+    """Return the Hyprland command socket path."""
+    runtime = os.environ.get("XDG_RUNTIME_DIR", f"/run/user/{os.getuid()}")
+    sig = os.environ["HYPRLAND_INSTANCE_SIGNATURE"]
+    return f"{runtime}/hypr/{sig}/.socket.sock"
+
+
+def _event_socket_path() -> str:
+    """Return the Hyprland event socket path (socket2)."""
+    runtime = os.environ.get("XDG_RUNTIME_DIR", f"/run/user/{os.getuid()}")
+    sig = os.environ["HYPRLAND_INSTANCE_SIGNATURE"]
+    return f"{runtime}/hypr/{sig}/.socket2.sock"
+
+
+def _send(command: str, timeout: float = 2.0) -> str:
+    """Send a command to Hyprland's Unix socket and return the response.
+
+    Opens a fresh connection for each command and closes immediately
+    after reading — Hyprland processes connections synchronously and
+    an unclosed socket will freeze the compositor.
+
+    Raises ConnectionError if the socket is unreachable.
+    """
+    try:
+        sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
+        sock.settimeout(timeout)
+        sock.connect(_socket_path())
+        try:
+            sock.sendall(command.encode())
+            chunks = []
+            while True:
+                chunk = sock.recv(8192)
+                if not chunk:
+                    break
+                chunks.append(chunk)
+            return b"".join(chunks).decode()
+        finally:
+            sock.close()
+    except Exception as e:
+        raise ConnectionError(f"Cannot reach Hyprland socket: {e}") from e

hyprland_socket-0.1.0/src/hyprland_socket/commands.py

@@ -0,0 +1,90 @@
+"""High-level command functions for Hyprland IPC."""
+
+import json
+from typing import Any
+
+from ._socket import _send
+from .errors import CommandError, ConnectionError
+from .models import Animation, Bind, Monitor
+
+
+def _query_json(command: str) -> Any:
+    """Send a JSON query and return parsed result."""
+    response = _send(f"j/{command}")
+    try:
+        return json.loads(response)
+    except (json.JSONDecodeError, ValueError) as e:
+        raise CommandError(f"Invalid JSON response for '{command}': {e}") from e
+
+
+def getoption(key: str) -> dict:
+    """Read a live option value from Hyprland.
+
+    Raises ConnectionError or CommandError on failure.
+    """
+    return _query_json(f"getoption {key}")
+
+
+def keyword(key: str, value: Any) -> None:
+    """Apply a setting live to the running compositor.
+
+    Raises CommandError if Hyprland rejects the command.
+    """
+    if isinstance(value, bool):
+        value = int(value)
+    response = _send(f"/keyword {key} {value}")
+    output = response.strip().lower()
+    if output != "ok" and output != "":
+        raise CommandError(f"keyword '{key} {value}' rejected: {response.strip()}")
+
+
+def keyword_batch(commands: list[tuple[str, str]]) -> None:
+    """Apply multiple keyword settings in a single batch call.
+
+    Raises CommandError on failure.
+    """
+    if not commands:
+        return
+    batch = ";".join(f"keyword {key} {value}" for key, value in commands)
+    _send(f"[[BATCH]]{batch}", timeout=5.0)
+
+
+def reload() -> None:
+    """Tell Hyprland to reload its config.
+
+    Raises ConnectionError if unreachable.
+    """
+    _send("/reload")
+
+
+def get_binds() -> list[Bind]:
+    """Read all keybinds from Hyprland."""
+    data = _query_json("binds")
+    return [Bind.from_dict(b) for b in data]
+
+
+def get_monitors() -> list[Monitor]:
+    """Read all monitors from Hyprland."""
+    data = _query_json("monitors")
+    return [Monitor.from_dict(m) for m in data]
+
+
+def get_animations() -> tuple[list[Animation], list[dict]]:
+    """Read all animations and bezier curves from Hyprland.
+
+    Returns (animations_list, curves_list).
+    """
+    data = _query_json("animations")
+    if not isinstance(data, list) or len(data) != 2:
+        raise CommandError(f"Unexpected animations response format: {type(data)}")
+    animations = [Animation.from_dict(a) for a in data[0]]
+    return animations, data[1]
+
+
+def is_running() -> bool:
+    """Check if a Hyprland instance is reachable."""
+    try:
+        getoption("general:gaps_in")
+        return True
+    except (ConnectionError, CommandError):
+        return False

hyprland_socket-0.1.0/src/hyprland_socket/errors.py

@@ -0,0 +1,13 @@
+"""Exception hierarchy for Hyprland IPC errors."""
+
+
+class HyprlandError(Exception):
+    """Base exception for all Hyprland IPC errors."""
+
+
+class ConnectionError(HyprlandError):
+    """Cannot reach the Hyprland socket."""
+
+
+class CommandError(HyprlandError):
+    """Hyprland rejected a command."""

hyprland_socket-0.1.0/src/hyprland_socket/events.py

@@ -0,0 +1,63 @@
+"""Hyprland event monitoring via socket2."""
+
+import socket
+from collections.abc import Iterator
+from dataclasses import dataclass
+
+from ._socket import _event_socket_path
+from .errors import ConnectionError
+
+
+@dataclass
+class Event:
+    name: str
+    data: str
+
+
+def connect_event_socket(timeout: float | None = None) -> socket.socket:
+    """Connect to Hyprland's event socket and return the raw socket.
+
+    The caller owns the socket and must close it. The raw fd can be
+    used with external event loops (e.g. GLib.io_add_watch).
+    """
+    try:
+        sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
+        if timeout is not None:
+            sock.settimeout(timeout)
+        sock.connect(_event_socket_path())
+        return sock
+    except Exception as e:
+        raise ConnectionError(f"Cannot reach Hyprland event socket: {e}") from e
+
+
+def _parse_event_line(line: str) -> Event | None:
+    """Parse a single event line into an Event."""
+    line = line.strip()
+    if not line:
+        return None
+    if ">>" in line:
+        name, data = line.split(">>", 1)
+        return Event(name=name, data=data)
+    return Event(name=line, data="")
+
+
+def events(timeout: float | None = None) -> Iterator[Event]:
+    """Yield events from Hyprland's event socket. Blocking iterator."""
+    sock = connect_event_socket(timeout)
+    try:
+        buf = ""
+        while True:
+            try:
+                chunk = sock.recv(4096)
+            except TimeoutError:
+                return
+            if not chunk:
+                break
+            buf += chunk.decode()
+            while "\n" in buf:
+                line, buf = buf.split("\n", 1)
+                event = _parse_event_line(line)
+                if event is not None:
+                    yield event
+    finally:
+        sock.close()

hyprland_socket-0.1.0/src/hyprland_socket/models.py

@@ -0,0 +1,96 @@
+"""Typed dataclasses for Hyprland IPC responses."""
+
+from dataclasses import dataclass, field
+
+
+@dataclass
+class Monitor:
+    name: str
+    make: str
+    model: str
+    width: int
+    height: int
+    refresh_rate: float
+    x: int
+    y: int
+    scale: float
+    transform: int = 0
+    focused: bool = False
+    current_format: str = ""
+    available_modes: list[str] = field(default_factory=list)
+    bitdepth: str | None = None
+    vrr: str | None = None
+    cm: str | None = None
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "Monitor":
+        # Infer bitdepth from pixel format
+        fmt = data.get("currentFormat", "")
+        bitdepth = None
+        if "2101010" in fmt or "16161616" in fmt:
+            bitdepth = "10"
+
+        # Color management preset
+        cm_raw = data.get("colorManagementPreset")
+        cm = cm_raw if cm_raw and cm_raw not in ("default", "srgb") else None
+
+        return cls(
+            name=data["name"],
+            make=data.get("make", ""),
+            model=data.get("model", ""),
+            width=data["width"],
+            height=data["height"],
+            refresh_rate=data["refreshRate"],
+            x=data["x"],
+            y=data["y"],
+            scale=data["scale"],
+            transform=data.get("transform", 0),
+            focused=data.get("focused", False),
+            current_format=data.get("currentFormat", ""),
+            available_modes=[
+                m
+                if isinstance(m, str)
+                else f"{m['width']}x{m['height']}@{m['refreshRate']:.2f}Hz"
+                for m in data.get("availableModes", [])
+            ],
+            bitdepth=bitdepth,
+            cm=cm,
+        )
+
+
+@dataclass
+class Bind:
+    modmask: int
+    key: str
+    dispatcher: str
+    arg: str
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "Bind":
+        return cls(
+            modmask=data["modmask"],
+            key=data["key"],
+            dispatcher=data["dispatcher"],
+            arg=data["arg"],
+        )
+
+
+@dataclass
+class Animation:
+    name: str
+    overridden: bool
+    enabled: bool
+    speed: float
+    bezier: str
+    style: str = ""
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "Animation":
+        return cls(
+            name=data["name"],
+            overridden=data["overridden"],
+            enabled=data["enabled"],
+            speed=data["speed"],
+            bezier=data["bezier"],
+            style=data.get("style", ""),
+        )

hyprland_socket-0.1.0/tests/test_events.py

@@ -0,0 +1,32 @@
+"""Tests for event parsing."""
+
+from hyprland_socket.events import Event, _parse_event_line
+
+
+class TestParseEventLine:
+    def test_basic_event(self):
+        event = _parse_event_line("workspace>>2")
+        assert event == Event(name="workspace", data="2")
+
+    def test_monitor_added(self):
+        event = _parse_event_line("monitoradded>>DP-3")
+        assert event == Event(name="monitoradded", data="DP-3")
+
+    def test_event_with_comma_data(self):
+        event = _parse_event_line("openwindow>>80abc,2,kitty,Alacritty")
+        assert event.name == "openwindow"
+        assert event.data == "80abc,2,kitty,Alacritty"
+
+    def test_empty_data(self):
+        event = _parse_event_line("configreloaded>>")
+        assert event == Event(name="configreloaded", data="")
+
+    def test_empty_line(self):
+        assert _parse_event_line("") is None
+
+    def test_whitespace_only(self):
+        assert _parse_event_line("   ") is None
+
+    def test_no_separator(self):
+        event = _parse_event_line("someevent")
+        assert event == Event(name="someevent", data="")

hyprland_socket-0.1.0/tests/test_models.py

@@ -0,0 +1,149 @@
+"""Tests for model construction from Hyprland JSON dicts."""
+
+from hyprland_socket.models import Animation, Bind, Monitor
+
+
+class TestMonitorFromDict:
+    SAMPLE = {
+        "name": "DP-2",
+        "make": "Samsung",
+        "model": "Odyssey G9",
+        "width": 3440,
+        "height": 1440,
+        "refreshRate": 99.98,
+        "x": 0,
+        "y": 0,
+        "scale": 1.6,
+        "transform": 0,
+        "focused": True,
+        "currentFormat": "XRGB8888",
+        "availableModes": ["3440x1440@99.98Hz", "2560x1440@60.00Hz"],
+    }
+
+    def test_basic_fields(self):
+        m = Monitor.from_dict(self.SAMPLE)
+        assert m.name == "DP-2"
+        assert m.width == 3440
+        assert m.height == 1440
+        assert m.refresh_rate == 99.98
+        assert m.scale == 1.6
+
+    def test_optional_fields(self):
+        m = Monitor.from_dict(self.SAMPLE)
+        assert m.focused is True
+        assert m.current_format == "XRGB8888"
+        assert m.transform == 0
+
+    def test_available_modes(self):
+        m = Monitor.from_dict(self.SAMPLE)
+        assert m.available_modes == ["3440x1440@99.98Hz", "2560x1440@60.00Hz"]
+
+    def test_missing_optional_fields(self):
+        minimal = {
+            "name": "eDP-1",
+            "width": 1920,
+            "height": 1080,
+            "refreshRate": 60.0,
+            "x": 0,
+            "y": 0,
+            "scale": 1.0,
+        }
+        m = Monitor.from_dict(minimal)
+        assert m.make == ""
+        assert m.model == ""
+        assert m.transform == 0
+        assert m.focused is False
+        assert m.current_format == ""
+        assert m.available_modes == []
+        assert m.bitdepth is None
+        assert m.vrr is None
+        assert m.cm is None
+
+    def test_bitdepth_inferred_from_format(self):
+        data = {**self.SAMPLE, "currentFormat": "XRGB2101010"}
+        m = Monitor.from_dict(data)
+        assert m.bitdepth == "10"
+
+    def test_bitdepth_none_for_8bit(self):
+        data = {**self.SAMPLE, "currentFormat": "XRGB8888"}
+        m = Monitor.from_dict(data)
+        assert m.bitdepth is None
+
+    def test_cm_from_preset(self):
+        data = {**self.SAMPLE, "colorManagementPreset": "hdr"}
+        m = Monitor.from_dict(data)
+        assert m.cm == "hdr"
+
+    def test_cm_none_for_default(self):
+        data = {**self.SAMPLE, "colorManagementPreset": "srgb"}
+        m = Monitor.from_dict(data)
+        assert m.cm is None
+
+    def test_available_modes_as_dicts(self):
+        data = {
+            **self.SAMPLE,
+            "availableModes": [
+                {"width": 1920, "height": 1080, "refreshRate": 60.0},
+            ],
+        }
+        m = Monitor.from_dict(data)
+        assert m.available_modes == ["1920x1080@60.00Hz"]
+
+
+class TestBindFromDict:
+    def test_basic(self):
+        b = Bind.from_dict(
+            {
+                "modmask": 64,
+                "key": "Q",
+                "dispatcher": "killactive",
+                "arg": "",
+            }
+        )
+        assert b.modmask == 64
+        assert b.key == "Q"
+        assert b.dispatcher == "killactive"
+        assert b.arg == ""
+
+    def test_with_arg(self):
+        b = Bind.from_dict(
+            {
+                "modmask": 64,
+                "key": "1",
+                "dispatcher": "workspace",
+                "arg": "1",
+            }
+        )
+        assert b.arg == "1"
+
+
+class TestAnimationFromDict:
+    def test_basic(self):
+        a = Animation.from_dict(
+            {
+                "name": "windows",
+                "overridden": True,
+                "enabled": True,
+                "speed": 6.0,
+                "bezier": "default",
+                "style": "slide",
+            }
+        )
+        assert a.name == "windows"
+        assert a.overridden is True
+        assert a.enabled is True
+        assert a.speed == 6.0
+        assert a.bezier == "default"
+        assert a.style == "slide"
+
+    def test_missing_style(self):
+        a = Animation.from_dict(
+            {
+                "name": "fade",
+                "overridden": False,
+                "enabled": True,
+                "speed": 7.0,
+                "bezier": "default",
+            }
+        )
+        assert a.style == ""

hyprland_socket-0.1.0/uv.lock

@@ -0,0 +1,108 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "hyprland-socket"
+version = "0.1.0"
+source = { editable = "." }
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest" },
+    { name = "ruff" },
+]
+
+[package.metadata]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "pytest", specifier = ">=9.0" },
+    { name = "ruff", specifier = ">=0.11" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/65/ee/299d360cdc32edc7d2cf530f3accf79c4fca01e96ffc950d8a52213bd8e4/packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4", size = 143416, upload-time = "2026-01-21T20:50:39.064Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/b9/c538f279a4e237a006a2c98387d081e9eb060d203d8ed34467cc0f0b9b53/packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529", size = 74366, upload-time = "2026-01-21T20:50:37.788Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.19.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.0.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d1/db/7ef3487e0fb0049ddb5ce41d3a49c235bf9ad299b6a25d5780a89f19230f/pytest-9.0.2.tar.gz", hash = "sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11", size = 1568901, upload-time = "2025-12-06T21:30:51.014Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3b/ab/b3226f0bd7cdcf710fbede2b3548584366da3b19b5021e74f5bde2a8fa3f/pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b", size = 374801, upload-time = "2025-12-06T21:30:49.154Z" },
+]
+
+[[package]]
+name = "ruff"
+version = "0.15.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/51/df/f8629c19c5318601d3121e230f74cbee7a3732339c52b21daa2b82ef9c7d/ruff-0.15.6.tar.gz", hash = "sha256:8394c7bb153a4e3811a4ecdacd4a8e6a4fa8097028119160dffecdcdf9b56ae4", size = 4597916, upload-time = "2026-03-12T23:05:47.51Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9e/2f/4e03a7e5ce99b517e98d3b4951f411de2b0fa8348d39cf446671adcce9a2/ruff-0.15.6-py3-none-linux_armv6l.whl", hash = "sha256:7c98c3b16407b2cf3d0f2b80c80187384bc92c6774d85fefa913ecd941256fff", size = 10508953, upload-time = "2026-03-12T23:05:17.246Z" },
+    { url = "https://files.pythonhosted.org/packages/70/60/55bcdc3e9f80bcf39edf0cd272da6fa511a3d94d5a0dd9e0adf76ceebdb4/ruff-0.15.6-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:ee7dcfaad8b282a284df4aa6ddc2741b3f4a18b0555d626805555a820ea181c3", size = 10942257, upload-time = "2026-03-12T23:05:23.076Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/f9/005c29bd1726c0f492bfa215e95154cf480574140cb5f867c797c18c790b/ruff-0.15.6-py3-none-macosx_11_0_arm64.whl", hash = "sha256:3bd9967851a25f038fc8b9ae88a7fbd1b609f30349231dffaa37b6804923c4bb", size = 10322683, upload-time = "2026-03-12T23:05:33.738Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/74/2f861f5fd7cbb2146bddb5501450300ce41562da36d21868c69b7a828169/ruff-0.15.6-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:13f4594b04e42cd24a41da653886b04d2ff87adbf57497ed4f728b0e8a4866f8", size = 10660986, upload-time = "2026-03-12T23:05:53.245Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/a1/309f2364a424eccb763cdafc49df843c282609f47fe53aa83f38272389e0/ruff-0.15.6-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e2ed8aea2f3fe57886d3f00ea5b8aae5bf68d5e195f487f037a955ff9fbaac9e", size = 10332177, upload-time = "2026-03-12T23:05:56.145Z" },
+    { url = "https://files.pythonhosted.org/packages/30/41/7ebf1d32658b4bab20f8ac80972fb19cd4e2c6b78552be263a680edc55ac/ruff-0.15.6-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:70789d3e7830b848b548aae96766431c0dc01a6c78c13381f423bf7076c66d15", size = 11170783, upload-time = "2026-03-12T23:06:01.742Z" },
+    { url = "https://files.pythonhosted.org/packages/76/be/6d488f6adca047df82cd62c304638bcb00821c36bd4881cfca221561fdfc/ruff-0.15.6-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:542aaf1de3154cea088ced5a819ce872611256ffe2498e750bbae5247a8114e9", size = 12044201, upload-time = "2026-03-12T23:05:28.697Z" },
+    { url = "https://files.pythonhosted.org/packages/71/68/e6f125df4af7e6d0b498f8d373274794bc5156b324e8ab4bf5c1b4fc0ec7/ruff-0.15.6-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:1c22e6f02c16cfac3888aa636e9eba857254d15bbacc9906c9689fdecb1953ab", size = 11421561, upload-time = "2026-03-12T23:05:31.236Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/9f/f85ef5fd01a52e0b472b26dc1b4bd228b8f6f0435975442ffa4741278703/ruff-0.15.6-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:98893c4c0aadc8e448cfa315bd0cc343a5323d740fe5f28ef8a3f9e21b381f7e", size = 11310928, upload-time = "2026-03-12T23:05:45.288Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/26/b75f8c421f5654304b89471ed384ae8c7f42b4dff58fa6ce1626d7f2b59a/ruff-0.15.6-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:70d263770d234912374493e8cc1e7385c5d49376e41dfa51c5c3453169dc581c", size = 11235186, upload-time = "2026-03-12T23:05:50.677Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/d4/d5a6d065962ff7a68a86c9b4f5500f7d101a0792078de636526c0edd40da/ruff-0.15.6-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:55a1ad63c5a6e54b1f21b7514dfadc0c7fb40093fa22e95143cf3f64ebdcd512", size = 10635231, upload-time = "2026-03-12T23:05:37.044Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/56/7c3acf3d50910375349016cf33de24be021532042afbed87942858992491/ruff-0.15.6-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:8dc473ba093c5ec238bb1e7429ee676dca24643c471e11fbaa8a857925b061c0", size = 10340357, upload-time = "2026-03-12T23:06:04.748Z" },
+    { url = "https://files.pythonhosted.org/packages/06/54/6faa39e9c1033ff6a3b6e76b5df536931cd30caf64988e112bbf91ef5ce5/ruff-0.15.6-py3-none-musllinux_1_2_i686.whl", hash = "sha256:85b042377c2a5561131767974617006f99f7e13c63c111b998f29fc1e58a4cfb", size = 10860583, upload-time = "2026-03-12T23:05:58.978Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/1e/509a201b843b4dfb0b32acdedf68d951d3377988cae43949ba4c4133a96a/ruff-0.15.6-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:cef49e30bc5a86a6a92098a7fbf6e467a234d90b63305d6f3ec01225a9d092e0", size = 11410976, upload-time = "2026-03-12T23:05:39.955Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/25/3fc9114abf979a41673ce877c08016f8e660ad6cf508c3957f537d2e9fa9/ruff-0.15.6-py3-none-win32.whl", hash = "sha256:bbf67d39832404812a2d23020dda68fee7f18ce15654e96fb1d3ad21a5fe436c", size = 10616872, upload-time = "2026-03-12T23:05:42.451Z" },
+    { url = "https://files.pythonhosted.org/packages/89/7a/09ece68445ceac348df06e08bf75db72d0e8427765b96c9c0ffabc1be1d9/ruff-0.15.6-py3-none-win_amd64.whl", hash = "sha256:aee25bc84c2f1007ecb5037dff75cef00414fdf17c23f07dc13e577883dca406", size = 11787271, upload-time = "2026-03-12T23:05:20.168Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/d0/578c47dd68152ddddddf31cd7fc67dc30b7cdf639a86275fda821b0d9d98/ruff-0.15.6-py3-none-win_arm64.whl", hash = "sha256:c34de3dd0b0ba203be50ae70f5910b17188556630e2178fd7d79fc030eb0d837", size = 11060497, upload-time = "2026-03-12T23:05:25.968Z" },
+]