ianux 0.2.0__py3-none-any.whl

ianux/__init__.py

@@ -0,0 +1,3 @@
+"""ianux — spin up a named tmux development session with multiple panes."""
+
+__version__ = "0.2.0"

ianux/__main__.py

@@ -0,0 +1,63 @@
+#!/usr/bin/env python3.11
+"""Entry point for `python -m ianux`.
+
+main() accepts an optional argv list so callers (tests, scripts) can drive
+the tool without touching sys.argv.  entrypoint() wraps main() with error
+handling and is what the shell shim and __name__ == "__main__" both call.
+"""
+
+import sys
+
+from .attacher import SessionAttacher
+from .cli import build_resolver, parse_args
+from .config import AttachConfig, DumpConfig, KillConfig, LoadConfig, RunConfig, ListConfig
+from .dumper import SessionDumper
+from .exceptions import AppError
+from .killer import SessionKiller
+from .loader import load_session_config
+from .runner import SessionRunner
+from .session import SessionManager
+from .tmux import TmuxClient
+from .lister import SessionLister
+
+
+def main(argv: list[str] | None = None) -> int:
+    """Parse *argv*, dispatch to the matching manager, and return its exit code."""
+    config = parse_args(argv)
+    client = TmuxClient()
+
+    if isinstance(config, AttachConfig):
+        return SessionAttacher(client).attach(config)
+
+    if isinstance(config, KillConfig):
+        return SessionKiller(client).kill(config)
+
+    if isinstance(config, RunConfig):
+        return SessionRunner(client).run(config)
+
+    if isinstance(config,ListConfig):
+        return SessionLister(client).list(config)
+
+    if isinstance(config, DumpConfig):
+        return SessionDumper(client).dump(config)
+
+    if isinstance(config, LoadConfig):
+        config = load_session_config(config)
+        # Falls through to the SessionConfig flow below.
+
+    # SessionConfig — existing multi-pane dev session flow.
+    resolver = build_resolver(config)
+    return SessionManager(client).setup(config, resolver)
+
+
+def entrypoint() -> int:
+    """Run main(), converting an AppError into a printed message and exit code 1."""
+    try:
+        return main()
+    except AppError as exc:
+        print(f"Error: {exc}", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(entrypoint())

ianux/attacher.py

@@ -0,0 +1,65 @@
+"""SessionAttacher — list open sessions and attach to one interactively.
+
+Two usage modes:
+
+  Interactive (session_name is None)
+      Lists all open tmux sessions with numeric IDs (1-based, matching the
+      'list' subcommand), prompts the user to choose one, then attaches.
+
+  Direct (session_name is provided)
+      Accepts a tmux-style address: ``SESSION``, ``SESSION:WINDOW`` or
+      ``SESSION:WINDOW.PANE`` (mirrors the 'kill' subcommand's target
+      format).  SESSION may be a literal name or one of the numeric IDs
+      shown by 'list'/the picker; WINDOW and PANE are tmux's own indices,
+      as displayed in 'list'.  Validates the session exists and attaches
+      immediately, skipping the picker.
+"""
+
+from typing import Callable
+
+from .config import AttachConfig
+from .exceptions import AppError
+from .killer import _Target, _parse_target, resolve_session_id
+from .picker import pick_session
+from .tmux import TmuxClient
+
+
+class SessionAttacher:
+    """Handles the 'attach' subcommand: direct-target and interactive modes."""
+
+    def __init__(
+        self,
+        client: TmuxClient,
+        prompt_fn: Callable[[str], str] = input,
+    ) -> None:
+        self._client = client
+        self._prompt = prompt_fn
+
+    def attach(self, config: AttachConfig) -> int:
+        if config.session_name is not None:
+            return self._attach_direct(config.session_name)
+        return self._attach_interactive()
+
+    # ------------------------------------------------------------------
+    # Internals
+    # ------------------------------------------------------------------
+
+    def _attach_direct(self, address: str) -> int:
+        t = _parse_target(address)
+        session = resolve_session_id(self._client, t.session)
+        if not self._client.session_exists(session):
+            raise AppError(f"Session '{session}' does not exist.")
+        self._client.attach(self._build_target(session, t))
+        return 0
+
+    def _build_target(self, session: str, t: _Target) -> str:
+        """Combine the resolved session name with the window/pane part of *t*."""
+        if t.kind == "pane":
+            return f"{session}:{t.window}.{t.pane}"
+        if t.kind in ("window", "panes_all"):
+            return f"{session}:{t.window}"
+        return session
+
+    def _attach_interactive(self) -> int:
+        self._client.attach(pick_session(self._client, self._prompt))
+        return 0