devspace 0.1.0__tar.gz → 0.1.1__tar.gz

{devspace-0.1.0 → devspace-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devspace
-Version: 0.1.0
+Version: 0.1.1
 Summary: A clean workflow and context orchestrator for minimalist Linux setups.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -13,7 +13,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devspace"
-version = "0.1.0"
+version = "0.1.1"
 description = "A clean workflow and context orchestrator for minimalist Linux setups."
 dependencies = [
     "customtkinter>=5.2.0",

{devspace-0.1.0 → devspace-0.1.1}/README.md

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devspace"
-version = "0.1.0"
+version = "0.1.1"
 description = "A clean workflow and context orchestrator for minimalist Linux setups."
 dependencies = [
     "customtkinter>=5.2.0",

{devspace-0.1.0 → devspace-0.1.1}/devspace/__init__.py

@@ -1,4 +1,4 @@
 """devspace package."""
 
 __all__ = ["__version__"]
-__version__ = "0.1.0"
+__version__ = "0.1.1"

{devspace-0.1.0 → devspace-0.1.1}/devspace/cli.py

@@ -6,7 +6,16 @@ import sys
 from pathlib import Path
 
 from .config import create_space, load_project_config
-from .orchestrator import launch_workspace, quick_run, run_session_launch, status_ribbon
+from .orchestrator import (
+    hotkey_snippet,
+    launch_workspace,
+    quick_run,
+    record_layout_loop,
+    restore_saved_layout,
+    run_session_launch,
+    save_current_layout,
+    status_ribbon,
+)
 
 
 def main(argv: list[str] | None = None) -> int:
@@ -16,6 +25,16 @@ def main(argv: list[str] | None = None) -> int:
     )
     subparsers = parser.add_subparsers(dest="command")
 
+    if argv is None:
+        argv = sys.argv[1:]
+    if not argv:
+        project = Path.cwd()
+        try:
+            return record_layout_loop(project, "default", interval=1.0)
+        except RuntimeError as exc:
+            print(f"Error: {exc}", file=sys.stderr)
+            return 1
+
     create_parser = subparsers.add_parser("create", help="Create a new devspace")
     create_parser.add_argument("name", help="Name of the devspace to create")
 
@@ -32,6 +51,16 @@ def main(argv: list[str] | None = None) -> int:
     quick_parser.add_argument("project", nargs="?", default=".", help="Project directory or space name")
     quick_parser.add_argument("index", nargs="?", default="0", help="Zero-based index of the quick run command")
 
+    record_parser = subparsers.add_parser("record", help="Record the current window arrangement to a layout file")
+    record_parser.add_argument("project", nargs="?", default=".", help="Project directory or space name")
+    record_parser.add_argument("name", nargs="?", default="default", help="Saved layout name")
+
+    restore_parser = subparsers.add_parser("restore", help="Restore a previously saved window arrangement")
+    restore_parser.add_argument("project", nargs="?", default=".", help="Project directory or space name")
+    restore_parser.add_argument("name", nargs="?", default="default", help="Saved layout name")
+
+    hotkey_parser = subparsers.add_parser("hotkey", help="Print a Ctrl+D+S shortcut snippet")
+
     args = parser.parse_args(argv)
 
     if args.command == "create":
@@ -80,6 +109,30 @@ def main(argv: list[str] | None = None) -> int:
             return 1
         return quick_run(project, config, int(args.index))
 
+    if args.command == "record":
+        project = Path(args.project)
+        try:
+            target = save_current_layout(project, args.name)
+            print(f"Saved layout '{args.name}' to {target}")
+            return 0
+        except RuntimeError as exc:
+            print(f"Error: {exc}", file=sys.stderr)
+            return 1
+
+    if args.command == "restore":
+        project = Path(args.project)
+        try:
+            layout = restore_saved_layout(project, args.name)
+            print(json.dumps(layout, indent=2, sort_keys=True))
+            return 0
+        except FileNotFoundError as exc:
+            print(f"Error: {exc}", file=sys.stderr)
+            return 1
+
+    if args.command == "hotkey":
+        print(hotkey_snippet())
+        return 0
+
     parser.print_help()
     return 0
 

{devspace-0.1.0 → devspace-0.1.1}/devspace/orchestrator.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import json
 import os
 import shutil
 import socket
@@ -158,3 +159,93 @@ def run_session_launch(project_dir: str | Path, config: dict[str, Any]) -> None:
             stderr=subprocess.DEVNULL,
             start_new_session=True,
         )
+
+
+def save_current_layout(project_dir: str | Path, name: str = "default") -> Path:
+    """Capture the current X11 window layout and save it for later restoration."""
+    project_path = Path(project_dir)
+    if shutil.which("wmctrl") is None:
+        raise RuntimeError("wmctrl is required to record window layouts on Linux")
+
+    result = subprocess.run(
+        ["wmctrl", "-lG"],
+        capture_output=True,
+        text=True,
+        check=False,
+    )
+    if result.returncode != 0:
+        raise RuntimeError(f"Unable to inspect windows: {result.stderr.strip() or result.stdout.strip()}")
+
+    rows = []
+    for line in result.stdout.splitlines():
+        parts = line.split()
+        if len(parts) < 6:
+            continue
+        win_id, desktop, x, y, width, height, *rest = parts[:7]
+        rows.append({
+            "window_id": win_id,
+            "desktop": desktop,
+            "x": int(x),
+            "y": int(y),
+            "width": int(width),
+            "height": int(height),
+            "label": " ".join(rest),
+        })
+
+    save_dir = project_path / ".devspace"
+    save_dir.mkdir(exist_ok=True)
+    target = save_dir / f"layout-{name}.json"
+    target.write_text(json.dumps({"name": name, "windows": rows}, indent=2), encoding="utf-8")
+    return target
+
+
+def load_saved_layout(project_dir: str | Path, name: str = "default") -> dict[str, Any]:
+    """Load a saved window layout from disk."""
+    project_path = Path(project_dir)
+    target = project_path / ".devspace" / f"layout-{name}.json"
+    if not target.exists():
+        raise FileNotFoundError(f"No saved layout named '{name}' found in {project_path}")
+    return json.loads(target.read_text(encoding="utf-8"))
+
+
+def restore_saved_layout(project_dir: str | Path, name: str = "default") -> dict[str, Any]:
+    """Restore a previously saved X11 layout with wmctrl."""
+    payload = load_saved_layout(project_dir, name)
+    for window in payload.get("windows", []):
+        if shutil.which("wmctrl") is None:
+            continue
+        subprocess.run(
+            [
+                "wmctrl",
+                "-i",
+                "-r",
+                window["window_id"],
+                "-e",
+                f"0,{window['x']},{window['y']},{window['width']},{window['height']}",
+            ],
+            check=False,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+        )
+    return payload
+
+
+def hotkey_snippet() -> str:
+    """Return a simple xbindkeys-style binding for Ctrl + D + S."""
+    return """
+# ~/.xbindkeysrc
+"control + d + s": /usr/bin/env python3 -m devspace.cli record
+""".strip()
+
+
+def record_layout_loop(project_dir: str | Path, name: str = "default", interval: float = 1.0) -> int:
+    """Continuously record the current layout while the user is working; used by the default devspace mode."""
+    project_path = Path(project_dir)
+    while True:
+        try:
+            save_current_layout(project_path, name)
+        except RuntimeError:
+            break
+        import time
+        time.sleep(interval)
+    return 0

{devspace-0.1.0 → devspace-0.1.1}/devspace.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devspace
-Version: 0.1.0
+Version: 0.1.1
 Summary: A clean workflow and context orchestrator for minimalist Linux setups.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -13,7 +13,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devspace"
-version = "0.1.0"
+version = "0.1.1"
 description = "A clean workflow and context orchestrator for minimalist Linux setups."
 dependencies = [
     "customtkinter>=5.2.0",

{devspace-0.1.0 → devspace-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devspace"
-version = "0.1.0"
+version = "0.1.1"
 description = "A clean workflow and context orchestrator for minimalist Linux setups."
 readme = "README.md"
 requires-python = ">=3.11"

{devspace-0.1.0 → devspace-0.1.1}/tests/test_devspace.py

@@ -1,6 +1,6 @@
 from devspace.cli import main
 from devspace.config import create_space, load_project_config
-from devspace.orchestrator import launch_workspace
+from devspace.orchestrator import launch_workspace, save_current_layout
 
 
 def test_load_project_config(tmp_path):
@@ -87,3 +87,42 @@ command = "bash -lc 'echo command-opened'"
 
     assert any("terminal-opened" in str(call[0]) for call in calls)
     assert any("example.com" in str(call[0]) for call in calls)
+
+
+def test_save_current_layout_writes_file(tmp_path, monkeypatch):
+    project_dir = create_space("demo", tmp_path)
+
+    def fake_run(args, **kwargs):
+        class Result:
+            returncode = 0
+            stdout = "0x1  0  10  20  200  100  terminal\n0x2  0  400  20  200  100  browser\n"
+
+        return Result()
+
+    monkeypatch.setattr("devspace.orchestrator.subprocess.run", fake_run)
+    monkeypatch.setattr("devspace.orchestrator.shutil.which", lambda name: "/usr/bin/wmctrl" if name == "wmctrl" else None)
+
+    path = save_current_layout(project_dir, "default")
+
+    assert path.exists()
+    assert "terminal" in path.read_text()
+    assert "browser" in path.read_text()
+
+
+def test_main_starts_recording_when_run_without_command(monkeypatch, tmp_path):
+    monkeypatch.chdir(tmp_path)
+    seen = {}
+
+    def fake_record(project_dir, name="default", interval=1.0):
+        seen["project_dir"] = str(project_dir)
+        seen["name"] = name
+        seen["interval"] = interval
+        return 7
+
+    monkeypatch.setattr("devspace.cli.record_layout_loop", fake_record)
+
+    exit_code = main([])
+
+    assert exit_code == 7
+    assert seen["project_dir"] == str(tmp_path)
+    assert seen["name"] == "default"