hyprconf2lua 1.2.0__tar.gz

hyprconf2lua-1.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hyprconf2lua contributors
+
+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.

hyprconf2lua-1.2.0/PKG-INFO

@@ -0,0 +1,242 @@
+Metadata-Version: 2.4
+Name: hyprconf2lua
+Version: 1.2.0
+Summary: Convert Hyprland hyprlang .conf files to Lua .lua config format (v0.55+)
+Author: hyprconf2lua contributors
+License: MIT
+Project-URL: Homepage, https://github.com/Prateek-squadron/hyprconf2lua
+Project-URL: Repository, https://github.com/Prateek-squadron/hyprconf2lua
+Keywords: hyprland,hyprlang,lua,config,converter
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# hyprconf2lua
+
+**Your `hyprland.conf` is going away. Here's the one-liner to migrate.**
+
+Hyprland 0.55+ replaced the old hyprlang config with Lua. The old format will be dropped in a future release. **hyprconf2lua** converts your existing config automatically — no manual rewrite needed.
+
+```bash
+git clone https://github.com/Prateek-squadron/hyprconf2lua.git
+cd hyprconf2lua
+./install.sh
+hyprconf2lua ~/.config/hypr/hyprland.conf -o hyprland.lua
+```
+
+That's it. ~97% of your config converts cleanly. The rest gets flagged with `-- TODO` comments telling you exactly what to touch up.
+
+> **Not on PyPI yet** — the `pip install hyprconf2lua` command you might see in older posts doesn't work because the package hasn't been published there. Use the clone+install method above. It's zero-dependency, works on every distro, and sidesteps PEP 668 ("externally managed environment") completely. If your distro blocks pip, this is the way.
+
+---
+
+## What it looks like
+
+**Before** (old `hyprland.conf`):
+```ini
+$mainMod = SUPER
+
+general {
+    gaps_in = 5
+    gaps_out = 20
+}
+
+bind = $mainMod, Q, exec, kitty
+bind = $mainMod, F, fullscreen
+
+windowrule = float, ^(pavucontrol)$
+
+exec-once = waybar
+exec-once = mako
+```
+
+**After** (new `hyprland.lua`):
+```lua
+local mainMod = "SUPER"
+
+hl.config({
+    general = {
+        gaps_in = 5,
+        gaps_out = 20,
+    },
+})
+
+hl.bind(mainMod .. " + " .. "Q", hl.dsp.exec_cmd("kitty"))
+hl.bind(mainMod .. " + " .. "F", hl.dsp.window.fullscreen())
+
+hl.window_rule({
+    name  = "float",
+    match = { class = "^(pavucontrol)$" },
+    float = true,
+})
+
+hl.on("hyprland.start", function()
+    hl.exec_cmd("waybar")
+    hl.exec_cmd("mako")
+end)
+```
+
+---
+
+## Installation
+
+### Quick install (recommended)
+
+```bash
+git clone https://github.com/Prateek-squadron/hyprconf2lua.git
+cd hyprconf2lua
+./install.sh                    # symlinks hyprconf2lua -> ~/.local/bin
+hyprconf2lua ~/.config/hypr/hyprland.conf -o hyprland.lua
+```
+
+### One-shot (no install)
+
+```bash
+git clone https://github.com/Prateek-squadron/hyprconf2lua.git
+cd hyprconf2lua
+PYTHONPATH=src python3 -m hyprconf2lua ~/.config/hypr/hyprland.conf > hyprland.lua
+```
+
+### pip install (if your distro allows it)
+
+```bash
+pip install --user .
+# or
+pip install --break-system-packages .
+```
+
+> **"externally managed environment" error?** That's PEP 668 — modern distros protect the system Python from pip. Use the clone+install method above instead — zero pip required.
+
+---
+
+## Full migration guide
+
+1. **Backup** your current config:
+   ```bash
+   cp -r ~/.config/hypr ~/.config/hypr.bak
+   ```
+
+2. **Convert your main config**:
+   ```bash
+   hyprconf2lua ~/.config/hypr/hyprland.conf -o ~/.config/hypr/hyprland.lua
+   ```
+
+3. **Check for flags** — run with `--check` to find anything that needs manual review:
+   ```bash
+   hyprconf2lua --check ~/.config/hypr/hyprland.conf
+   # exits 0 if clean, 3 if anything flagged
+   ```
+
+4. **Convert sourced files** — if your config has `source = somefile.conf`, convert those too:
+   ```bash
+   hyprconf2lua --dir ~/.config/hypr --in-place
+   ```
+   This converts every `.conf` in the directory to `.lua`.
+
+5. **Review `-- TODO` markers** — search for these in the generated `.lua` files and handle them manually.
+
+6. **Test** — restart Hyprland and make sure everything works:
+   ```bash
+   hyprctl reload
+   ```
+
+---
+
+## What works
+
+| Category | Status |
+|----------|--------|
+| Keybinds (`bind`, `bindl`, `bindr`, `bindm`, `binde`, `bindd`, etc.) | ✅ All flags and combined forms |
+| Monitors | ✅ 100% |
+| Window rules (`windowrule`, `windowrulev2`) | ✅ Regex patterns, opacity, all rule types |
+| Autostart (`exec-once`, `exec`, `exec-shutdown`) | ✅ Preserves spaces, `&`, pipes |
+| Environment (`env`) | ✅ Commas in values preserved |
+| Animations and beziers | ✅ Named curves, animation presets |
+| Device sections (`device:name { }`) | ✅ |
+| Gestures | ✅ |
+| Workspace rules | ✅ default, monitor, gaps, etc. |
+| Layer rules | ✅ blur, ignorealpha, noanim |
+| Submap blocks (`submap = name` … `submap = reset`) | ✅ `hl.define_submap()` |
+| Config sections (`general`, `decoration`, `input`, …) | ✅ Includes nested subsections (shadow, blur, touchpad) |
+| Variables (`$var = value`) | ✅ Resolved in binds and execs |
+| Comments (`#`) | ✅ Preserved as `--` |
+| `plugin { }` | ⚠️ Flagged with TODO — plugin APIs are plugin-specific |
+| `source = *.conf` | ⚠️ Flagged with conversion reminder |
+| `$` glob patterns in sources | ⚠️ Needs manual handling |
+
+**Coverage:** ~97% on standard configs, 90%+ on complex setups like Omarchy, **0% false positives** — everything flagged genuinely needs attention.
+
+---
+
+## Why this over the Go tool?
+
+There's another converter (`hyprlang2lua` by EIonTusk) written in Go. Here's why this one exists:
+
+- **No compile step** — Go binaries need to be downloaded or compiled. This is `pip install` (or just `python3 -m`) and done. Arch ships Python, you already have it.
+- **Easier to contribute** — Python has a lower barrier. If your config hits an edge case, you or someone else can fix it in minutes without learning Go.
+- **Better coverage** — Handles Omarchy's `bindd` with description labels, nested config sections (shadow/blur inside decoration), combined bind flags (`bindle`, `bindm`), mouse binds, commas inside env values, and submap blocks. The Go tool is more basic.
+- **CI-friendly** — `--check` mode exits 3 if anything needs review. Great for git hooks and automated pipelines.
+
+---
+
+## Usage reference
+
+```bash
+# Convert a single file to stdout
+hyprconf2lua hyprland.conf > hyprland.lua
+
+# Convert and write to file
+hyprconf2lua hyprland.conf -o hyprland.lua
+
+# Convert from stdin
+cat hyprland.conf | hyprconf2lua > hyprland.lua
+
+# Convert all .conf files in a directory tree
+hyprconf2lua --dir ~/.config/hypr --in-place
+
+# Check mode (CI): exits 3 if anything needs manual review
+hyprconf2lua --check hyprland.conf
+
+# Show translation statistics
+hyprconf2lua hyprland.conf --report
+
+# Print version
+hyprconf2lua --version
+```
+
+If you didn't install via `./install.sh`, prefix commands with `PYTHONPATH=src python3 -m`:
+```bash
+cd hyprconf2lua
+PYTHONPATH=src python3 -m hyprconf2lua ~/.config/hypr/hyprland.conf -o ~/.config/hypr/hyprland.lua
+```
+
+---
+
+## Manual review checklist
+
+After conversion, search your `.lua` files for `TODO`:
+
+- **`plugin { }`** — these need `hl.plugin.*` APIs specific to each plugin. See your plugin docs.
+- **`source = path`** — each sourced `.conf` needs individual conversion. Run `hyprconf2lua` on each one.
+- **`submap` bindings** — now handled automatically with `hl.define_submap()`.
+- **Unknown dispatchers** — rare or custom dispatchers are flagged. Check the [Hyprland wiki](https://wiki.hyprland.org) for the Lua equivalent.
+
+---
+
+## Project
+
+- **GitHub:** [github.com/Prateek-squadron/hyprconf2lua](https://github.com/Prateek-squadron/hyprconf2lua)
+- **License:** MIT
+- **Contributions welcome** — Python, simple codebase, ~400 lines of core logic. If your config doesn't convert cleanly, open an issue or send a PR.
+
+---
+
+*Made because Hyprland 0.55 broke everyone's config and someone had to write the migration tool.*

hyprconf2lua-1.2.0/README.md

@@ -0,0 +1,221 @@
+# hyprconf2lua
+
+**Your `hyprland.conf` is going away. Here's the one-liner to migrate.**
+
+Hyprland 0.55+ replaced the old hyprlang config with Lua. The old format will be dropped in a future release. **hyprconf2lua** converts your existing config automatically — no manual rewrite needed.
+
+```bash
+git clone https://github.com/Prateek-squadron/hyprconf2lua.git
+cd hyprconf2lua
+./install.sh
+hyprconf2lua ~/.config/hypr/hyprland.conf -o hyprland.lua
+```
+
+That's it. ~97% of your config converts cleanly. The rest gets flagged with `-- TODO` comments telling you exactly what to touch up.
+
+> **Not on PyPI yet** — the `pip install hyprconf2lua` command you might see in older posts doesn't work because the package hasn't been published there. Use the clone+install method above. It's zero-dependency, works on every distro, and sidesteps PEP 668 ("externally managed environment") completely. If your distro blocks pip, this is the way.
+
+---
+
+## What it looks like
+
+**Before** (old `hyprland.conf`):
+```ini
+$mainMod = SUPER
+
+general {
+    gaps_in = 5
+    gaps_out = 20
+}
+
+bind = $mainMod, Q, exec, kitty
+bind = $mainMod, F, fullscreen
+
+windowrule = float, ^(pavucontrol)$
+
+exec-once = waybar
+exec-once = mako
+```
+
+**After** (new `hyprland.lua`):
+```lua
+local mainMod = "SUPER"
+
+hl.config({
+    general = {
+        gaps_in = 5,
+        gaps_out = 20,
+    },
+})
+
+hl.bind(mainMod .. " + " .. "Q", hl.dsp.exec_cmd("kitty"))
+hl.bind(mainMod .. " + " .. "F", hl.dsp.window.fullscreen())
+
+hl.window_rule({
+    name  = "float",
+    match = { class = "^(pavucontrol)$" },
+    float = true,
+})
+
+hl.on("hyprland.start", function()
+    hl.exec_cmd("waybar")
+    hl.exec_cmd("mako")
+end)
+```
+
+---
+
+## Installation
+
+### Quick install (recommended)
+
+```bash
+git clone https://github.com/Prateek-squadron/hyprconf2lua.git
+cd hyprconf2lua
+./install.sh                    # symlinks hyprconf2lua -> ~/.local/bin
+hyprconf2lua ~/.config/hypr/hyprland.conf -o hyprland.lua
+```
+
+### One-shot (no install)
+
+```bash
+git clone https://github.com/Prateek-squadron/hyprconf2lua.git
+cd hyprconf2lua
+PYTHONPATH=src python3 -m hyprconf2lua ~/.config/hypr/hyprland.conf > hyprland.lua
+```
+
+### pip install (if your distro allows it)
+
+```bash
+pip install --user .
+# or
+pip install --break-system-packages .
+```
+
+> **"externally managed environment" error?** That's PEP 668 — modern distros protect the system Python from pip. Use the clone+install method above instead — zero pip required.
+
+---
+
+## Full migration guide
+
+1. **Backup** your current config:
+   ```bash
+   cp -r ~/.config/hypr ~/.config/hypr.bak
+   ```
+
+2. **Convert your main config**:
+   ```bash
+   hyprconf2lua ~/.config/hypr/hyprland.conf -o ~/.config/hypr/hyprland.lua
+   ```
+
+3. **Check for flags** — run with `--check` to find anything that needs manual review:
+   ```bash
+   hyprconf2lua --check ~/.config/hypr/hyprland.conf
+   # exits 0 if clean, 3 if anything flagged
+   ```
+
+4. **Convert sourced files** — if your config has `source = somefile.conf`, convert those too:
+   ```bash
+   hyprconf2lua --dir ~/.config/hypr --in-place
+   ```
+   This converts every `.conf` in the directory to `.lua`.
+
+5. **Review `-- TODO` markers** — search for these in the generated `.lua` files and handle them manually.
+
+6. **Test** — restart Hyprland and make sure everything works:
+   ```bash
+   hyprctl reload
+   ```
+
+---
+
+## What works
+
+| Category | Status |
+|----------|--------|
+| Keybinds (`bind`, `bindl`, `bindr`, `bindm`, `binde`, `bindd`, etc.) | ✅ All flags and combined forms |
+| Monitors | ✅ 100% |
+| Window rules (`windowrule`, `windowrulev2`) | ✅ Regex patterns, opacity, all rule types |
+| Autostart (`exec-once`, `exec`, `exec-shutdown`) | ✅ Preserves spaces, `&`, pipes |
+| Environment (`env`) | ✅ Commas in values preserved |
+| Animations and beziers | ✅ Named curves, animation presets |
+| Device sections (`device:name { }`) | ✅ |
+| Gestures | ✅ |
+| Workspace rules | ✅ default, monitor, gaps, etc. |
+| Layer rules | ✅ blur, ignorealpha, noanim |
+| Submap blocks (`submap = name` … `submap = reset`) | ✅ `hl.define_submap()` |
+| Config sections (`general`, `decoration`, `input`, …) | ✅ Includes nested subsections (shadow, blur, touchpad) |
+| Variables (`$var = value`) | ✅ Resolved in binds and execs |
+| Comments (`#`) | ✅ Preserved as `--` |
+| `plugin { }` | ⚠️ Flagged with TODO — plugin APIs are plugin-specific |
+| `source = *.conf` | ⚠️ Flagged with conversion reminder |
+| `$` glob patterns in sources | ⚠️ Needs manual handling |
+
+**Coverage:** ~97% on standard configs, 90%+ on complex setups like Omarchy, **0% false positives** — everything flagged genuinely needs attention.
+
+---
+
+## Why this over the Go tool?
+
+There's another converter (`hyprlang2lua` by EIonTusk) written in Go. Here's why this one exists:
+
+- **No compile step** — Go binaries need to be downloaded or compiled. This is `pip install` (or just `python3 -m`) and done. Arch ships Python, you already have it.
+- **Easier to contribute** — Python has a lower barrier. If your config hits an edge case, you or someone else can fix it in minutes without learning Go.
+- **Better coverage** — Handles Omarchy's `bindd` with description labels, nested config sections (shadow/blur inside decoration), combined bind flags (`bindle`, `bindm`), mouse binds, commas inside env values, and submap blocks. The Go tool is more basic.
+- **CI-friendly** — `--check` mode exits 3 if anything needs review. Great for git hooks and automated pipelines.
+
+---
+
+## Usage reference
+
+```bash
+# Convert a single file to stdout
+hyprconf2lua hyprland.conf > hyprland.lua
+
+# Convert and write to file
+hyprconf2lua hyprland.conf -o hyprland.lua
+
+# Convert from stdin
+cat hyprland.conf | hyprconf2lua > hyprland.lua
+
+# Convert all .conf files in a directory tree
+hyprconf2lua --dir ~/.config/hypr --in-place
+
+# Check mode (CI): exits 3 if anything needs manual review
+hyprconf2lua --check hyprland.conf
+
+# Show translation statistics
+hyprconf2lua hyprland.conf --report
+
+# Print version
+hyprconf2lua --version
+```
+
+If you didn't install via `./install.sh`, prefix commands with `PYTHONPATH=src python3 -m`:
+```bash
+cd hyprconf2lua
+PYTHONPATH=src python3 -m hyprconf2lua ~/.config/hypr/hyprland.conf -o ~/.config/hypr/hyprland.lua
+```
+
+---
+
+## Manual review checklist
+
+After conversion, search your `.lua` files for `TODO`:
+
+- **`plugin { }`** — these need `hl.plugin.*` APIs specific to each plugin. See your plugin docs.
+- **`source = path`** — each sourced `.conf` needs individual conversion. Run `hyprconf2lua` on each one.
+- **`submap` bindings** — now handled automatically with `hl.define_submap()`.
+- **Unknown dispatchers** — rare or custom dispatchers are flagged. Check the [Hyprland wiki](https://wiki.hyprland.org) for the Lua equivalent.
+
+---
+
+## Project
+
+- **GitHub:** [github.com/Prateek-squadron/hyprconf2lua](https://github.com/Prateek-squadron/hyprconf2lua)
+- **License:** MIT
+- **Contributions welcome** — Python, simple codebase, ~400 lines of core logic. If your config doesn't convert cleanly, open an issue or send a PR.
+
+---
+
+*Made because Hyprland 0.55 broke everyone's config and someone had to write the migration tool.*

hyprconf2lua-1.2.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hyprconf2lua"
+version = "1.2.0"
+description = "Convert Hyprland hyprlang .conf files to Lua .lua config format (v0.55+)"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "hyprconf2lua contributors"}
+]
+requires-python = ">=3.10"
+keywords = ["hyprland", "hyprlang", "lua", "config", "converter"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/Prateek-squadron/hyprconf2lua"
+Repository = "https://github.com/Prateek-squadron/hyprconf2lua"
+
+[project.scripts]
+hyprconf2lua = "hyprconf2lua.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

hyprconf2lua-1.2.0/setup.cfg

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

hyprconf2lua-1.2.0/src/hyprconf2lua/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

hyprconf2lua-1.2.0/src/hyprconf2lua/__main__.py

@@ -0,0 +1,4 @@
+from hyprconf2lua.cli import main
+
+if __name__ == "__main__":
+    main()

hyprconf2lua-1.2.0/src/hyprconf2lua/ast.py

@@ -0,0 +1,171 @@
+from __future__ import annotations
+from dataclasses import dataclass, field
+from typing import Dict, List, Optional, Union
+
+
+Value = Union[str, List["Value"]]
+
+
+@dataclass
+class Comment:
+    text: str
+    line: int
+
+    def __str__(self) -> str:
+        return self.text
+
+
+@dataclass
+class Directive:
+    key: str
+    value: List[str]
+    line: int
+    col: int
+
+
+@dataclass
+class Section:
+    name: str
+    body: Block
+    line: int
+
+
+@dataclass
+class VariableDef:
+    name: str
+    value: str
+    line: int
+
+
+@dataclass
+class ExecDirective:
+    kind: str
+    command: str
+    line: int
+
+
+@dataclass
+class BindDirective:
+    mods: List[str]
+    key: str
+    dispatcher: str
+    params: List[str]
+    flags: str
+    line: int
+
+
+@dataclass
+class MonitorDirective:
+    name: str
+    mode: str
+    position: str
+    scale: str
+    line: int
+    extra: Dict[str, str] = field(default_factory=dict)
+
+
+@dataclass
+class WindowRule:
+    is_v2: bool
+    rule: str
+    match_params: List[str]
+    line: int
+
+
+@dataclass
+class AnimationDirective:
+    name: str
+    style: str
+    speed: str
+    curve: str
+    line: int
+
+
+@dataclass
+class BezierDirective:
+    name: str
+    p1x: str
+    p1y: str
+    p2x: str
+    p2y: str
+    line: int
+
+
+@dataclass
+class EnvDirective:
+    name: str
+    value: str
+    line: int
+
+
+@dataclass
+class SourceDirective:
+    path: str
+    line: int
+
+
+@dataclass
+class DeviceSection:
+    name: str
+    body: List[Directive]
+    line: int
+
+
+@dataclass
+class GestureDirective:
+    body: List[Directive]
+    line: int
+
+
+@dataclass
+class WorkspaceDirective:
+    name: str
+    params: List[str]
+    line: int
+
+
+@dataclass
+class LayerRuleDirective:
+    rule: str
+    namespace: str
+    line: int
+
+
+@dataclass
+class SubmapDef:
+    name: str
+    body: List[BlockStmt]
+    line: int
+
+
+@dataclass
+class WindowRuleBlock:
+    is_v2: bool
+    name: str
+    match: Dict[str, str]
+    effects: Dict[str, List[str]]
+    line: int
+
+
+@dataclass
+class LayerRuleBlock:
+    name: str
+    match: Dict[str, str]
+    effects: Dict[str, List[str]]
+    line: int
+
+
+BlockStmt = Union[
+    Directive, Section, VariableDef, ExecDirective, BindDirective,
+    MonitorDirective, WindowRule, AnimationDirective, BezierDirective,
+    EnvDirective, SourceDirective, DeviceSection, GestureDirective,
+    WorkspaceDirective, LayerRuleDirective, SubmapDef, Comment,
+    WindowRuleBlock, LayerRuleBlock,
+]
+
+Block = List[BlockStmt]
+
+
+@dataclass
+class ConfigFile:
+    body: Block