feat: Ladder CLI and GUI for Click rung import/export

.claude/settings.local.json

@@ -7,7 +7,8 @@
       "WebFetch(domain:ragardner.github.io)",
       "WebFetch(domain:raw.githubusercontent.com)",
       "Bash(uv run pytest:*)",
-      "Bash(uv run repomapper:*)"
+      "Bash(uv run:*)",
+      "Bash(do uv:*)"
     ]
   }
 }

.github/workflows/ci.yml

@@ -31,16 +31,16 @@ jobs:
       # https://docs.astral.sh/uv/guides/integration/github/
 
       - name: Checkout (official GitHub action)
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           # Important for versioning plugins:
           fetch-depth: 0
 
       - name: Install uv (official Astral action)
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
           # Update this as needed:
-          version: "0.6.14"
+          version: "0.9.25"
           enable-cache: true
           python-version: ${{ matrix.python-version }}
 
@@ -54,7 +54,10 @@ jobs:
       #     python-version: ${{ matrix.python-version }}
 
       - name: Install all dependencies
-        run: uv sync --all-extras --dev
+        run: uv sync --locked --all-extras --dev
+
+      - name: Report locked tool versions
+        run: uv run python -c "import importlib.metadata as md; print('ruff', md.version('ruff')); print('ssort', md.version('ssort'))"
 
       - name: Run linting
-        run: uv run python devtools/lint.py
+        run: uv run python devtools/lint.py --check

.github/workflows/publish.yml

@@ -12,14 +12,14 @@ jobs:
     runs-on: windows-latest
     steps:
       - name: Checkout (official GitHub action)
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
       - name: Install uv (official Astral action)
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
-          version: "0.6.14"
+          version: "0.9.25"
           enable-cache: true
           python-version: "3.12"
 
@@ -28,7 +28,7 @@ jobs:
 
       - name: Install dependencies
         # This works now because we are on Windows
-        run: uv sync --all-extras --dev
+        run: uv sync --locked --all-extras --dev
 
       - name: Build package
         run: uv build
@@ -55,4 +55,4 @@ jobs:
           path: dist/
 
       - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+        uses: pypa/gh-action-pypi-publish@release/v1

Makefile

@@ -9,7 +9,7 @@
 default: install lint test
 
 install:
-	uv sync --all-extras --dev
+	uv sync --locked --all-extras --dev
 
 lint:
 	uv run python devtools/lint.py
@@ -18,7 +18,8 @@ test:
 	uv run pytest --quiet --tb=short
 
 upgrade:
-	uv sync --upgrade
+	uv lock --upgrade
+	uv sync --locked --all-extras --dev
 
 build:
 	uv build
@@ -50,4 +51,4 @@ clean:
 	$(RM) .pytest_cache/
 	$(RM) .mypy_cache/
 	$(RM) .venv/
-	$(FIND_PYCACHE)
+	$(FIND_PYCACHE)

README.md

@@ -12,6 +12,7 @@
 | **Address Editing** | One-by-one in app | ✅ **Bulk edit**, multi-window, search/replace |
 | **Tag View** | Flat list | ✅ **Color named blocks** + **tree outline** (hierarchy & arrays) |
 | **DataView** | Input raw addresses, limited reordering | ✅ **Autocomplete**, add entire grouped structures and blocks, drag and drop reordering |
+| **Ladder Portability** | Copy/paste within app | ✅ **Export** to CSV, **convert** to Python, paste between projects |
 | **Price** | Free (bundled) | Free (open source) |
 | **Best For** | Simple projects | Complex projects, productivity |
 
@@ -28,6 +29,7 @@ CLICK PLCs were my first PLC experience, but remembering addresses became painfu
 - **[📑 Tag Browser](#tag-browser)** – Tree view with automatic hierarchy and array grouping
 - **[📊 Dataview Editor](#dataview-editor)** – Tabbed interface, nickname lookup, unlimited reordering
 - **[🔌 Connectivity](#connectivity)** – CSV import and live ODBC database support
+- **[📐 Ladder Tools](#ladder-tools)** – Export ladder logic to CSV, convert to Python, paste between projects
 
 **Beta** – Review Address & Dataview changes before saving in CLICK. [Feedback welcome](https://github.com/ssweber/clicknick/issues).
 
@@ -143,6 +145,16 @@ Alm[1-2]
 
 ---
 
+### <a name="ladder-tools"></a>📐 Ladder Tools
+
+Access these from the **Ladder** menu:
+
+- **Export from Click** – Decode your connected Click project's ladder logic into readable CSV files (powered by [laddercodec](https://github.com/ssweber/laddercodec))
+- **Convert to pyrung** – Generate a [pyrung](https://github.com/ssweber/pyrung) Python project from an exported ladder folder, for unit testing and simulation
+- **Guided Paste** – Load an exported ladder project and walk through importing it into Click, file by file
+
+---
+
 <details>
 <summary><strong>Block Tag Specification</strong> (Advanced)</summary>
 

devtools/lint.py

@@ -1,51 +1,68 @@
+import argparse
 import subprocess
-
-from funlog import log_calls
-from rich import get_console, reconfigure
-from rich import print as rprint
+import sys
 
 # Update as needed.
 SRC_PATHS = ["src", "tests", "devtools"]
-DOC_PATHS = ["README.md"]
 
 
-reconfigure(emoji=not get_console().options.legacy_windows)  # No emojis on legacy windows.
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description="Run lint checks for the repository.")
+    parser.add_argument(
+        "--check",
+        action="store_true",
+        help="Run read-only checks suitable for CI (no autofix).",
+    )
+    return parser.parse_args()
 
 
-@log_calls(level="warning", show_timing_only=True)
 def run(cmd: list[str]) -> int:
-    rprint()
-    rprint(f"[bold green]:arrow_forward: {' '.join(cmd)}[/bold green]")
-    errcount = 0
+    print()
+    print(f"==> {' '.join(cmd)}")
     try:
         subprocess.run(cmd, text=True, check=True)
-    except subprocess.CalledProcessError as e:
-        rprint(f"[bold red]Error: {e}[/bold red]")
-        errcount = 1
+    except subprocess.CalledProcessError as exc:
+        print(f"Error: {exc}")
+        return 1
+    except FileNotFoundError as exc:
+        print(f"Executable not found: {exc}")
+        return 1
 
-    return errcount
+    return 0
 
 
-def main():
-    rprint()
+def main() -> int:
+    args = parse_args()
+    print()
 
     errcount = 0
-    errcount += run(["codespell", "--write-changes", *SRC_PATHS, *DOC_PATHS])
-    errcount += run(["ssort", *SRC_PATHS])
-    errcount += run(["ruff", "check", "--fix", *SRC_PATHS])
-    errcount += run(["ruff", "format", *SRC_PATHS])
+    if args.check:
+        errcount += run(["ssort", "--check", *SRC_PATHS])
+    else:
+        errcount += run(["ssort", *SRC_PATHS])
+
+    if args.check:
+        errcount += run(["ruff", "check", *SRC_PATHS])
+    else:
+        errcount += run(["ruff", "check", "--fix", *SRC_PATHS])
+
+    if args.check:
+        errcount += run(["ruff", "format", "--check", *SRC_PATHS])
+    else:
+        errcount += run(["ruff", "format", *SRC_PATHS])
+
     # errcount += run(["basedpyright", *SRC_PATHS])
 
-    rprint()
+    print()
 
     if errcount != 0:
-        rprint(f"[bold red]:x: Lint failed with {errcount} errors.[/bold red]")
+        print(f"Lint failed with {errcount} error(s).")
     else:
-        rprint("[bold green]:white_check_mark: Lint passed![/bold green]")
-    rprint()
+        print("Lint passed.")
+    print()
 
     return errcount
 
 
 if __name__ == "__main__":
-    exit(main())
+    sys.exit(main())