hyprconf2lua 1.2.0__py3-none-any.whl

hyprconf2lua-1.2.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,15 @@
+hyprconf2lua/__init__.py,sha256=J-j-u0itpEFT6irdmWmixQqYMadNl1X91TxUmoiLHMI,22
+hyprconf2lua/__main__.py,sha256=yL7JuAodb4maYAl2zmMpO9fzBMazPEa-jeS1l1yPQXY,73
+hyprconf2lua/ast.py,sha256=cJ0FSC9k6KnHq-OFbr4wyjZZ_-xyAuILPDVgN1DJMxU,2454
+hyprconf2lua/cli.py,sha256=KbXGLBwO8NauSCTlcwc8RC914nAbet45m3Mm3GgL7BM,5583
+hyprconf2lua/codegen.py,sha256=43cKDBd6Pu-vFKv3n27eMVIxOtJGHiD55CZX8jkmQKQ,35702
+hyprconf2lua/converter.py,sha256=G0iw_T-KxJTP23IyX7ZnTRs_L40LiUcDAt-3UGtFShI,1831
+hyprconf2lua/lexer.py,sha256=0SG8iR3DJPMLXlVasHrMrdlcFHZRncV-iV-p5JfQibQ,1965
+hyprconf2lua/mappings.py,sha256=hy1nqnqb_LMNrtY5dkC-w_VjvBWuTNguOFwyImqri70,5440
+hyprconf2lua/parser.py,sha256=3RoYJqBIlQGdHrUH1O-X0-OLg1EDea-IEBg3AwQ36yU,18254
+hyprconf2lua-1.2.0.dist-info/licenses/LICENSE,sha256=9u-l5DeotnovTmctRGUbLQsKlsOpPoe2sfEcn70Uxp4,1082
+hyprconf2lua-1.2.0.dist-info/METADATA,sha256=w4msOZnaJMraEZlZH695PsnVATFhf3_OPuxLIpq6UlY,8024
+hyprconf2lua-1.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+hyprconf2lua-1.2.0.dist-info/entry_points.txt,sha256=sYbmxMM-cfHT2tMZEFiRoNxIuj5Geh7EK3Xwkh80zlk,55
+hyprconf2lua-1.2.0.dist-info/top_level.txt,sha256=khOSfo2D_1Ryij_NL7idrUPrA4PXzgBZVXWjRERlEek,13
+hyprconf2lua-1.2.0.dist-info/RECORD,,

hyprconf2lua-1.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

hyprconf2lua-1.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hyprconf2lua = hyprconf2lua.cli:main

hyprconf2lua-1.2.0.dist-info/licenses/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.dist-info/top_level.txt

@@ -0,0 +1 @@
+hyprconf2lua