ianux 0.2.0__tar.gz

ianux-0.2.0/LICENSE

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

ianux-0.2.0/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: ianux
+Version: 0.2.0
+Summary: A quick-to-use tmux wrapper for managing sessions.
+License-Expression: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+<div align="center">
+  <img src="assets/ianux-logo.png" alt="Ianux logo" width="180">
+  <h1>Ianux</h1>
+  <p>A quick-to-use tmux wrapper for managing sessions.</p>
+</div>
+
+Ianux is a quick-to-use Python command-line tool for creating and restoring
+multi-window, multi-pane tmux sessions, running detached jobs, and listing,
+attaching to, or closing sessions. It requires Python 3.11+,
+[uv](https://docs.astral.sh/uv/), and `tmux` on `PATH`.
+
+## Quick start
+
+Install Ianux as a standalone command:
+
+```bash
+uv tool install .
+ianux --help
+ianux session --panes 4
+```
+
+Or run it from a checkout:
+
+```bash
+uv sync
+uv run ianux --help
+uv run ianux session --panes 4
+```
+
+## Commands
+
+| Command | Alias | Purpose |
+|---|---|---|
+| `session` | `s` | Create and attach to a multi-window, multi-pane session (default) |
+| `run` | `r` | Run commands in a detached session |
+| `list` | `ls` | List open sessions |
+| `attach` | `a` | Attach to a session, window, or pane |
+| `kill` | `k` | Close a session, window, or pane |
+| `load` | `l` | Create a session from TOML |
+| `dump` | `d` | Save a session's pane directories to TOML |
+
+Run `ianux <command> --help` for options and examples. See the [wiki](wiki/Home.md)
+for the [full command reference](wiki/Commands.md), [TOML configuration guide](wiki/Configuration.md),
+and [architecture](wiki/Architecture.md).
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv build
+```
+
+End-to-end tests use a real tmux server and skip when `tmux` is unavailable.
+See [Development and testing](wiki/Development.md) for details.

ianux-0.2.0/README.md

@@ -0,0 +1,55 @@
+<div align="center">
+  <img src="assets/ianux-logo.png" alt="Ianux logo" width="180">
+  <h1>Ianux</h1>
+  <p>A quick-to-use tmux wrapper for managing sessions.</p>
+</div>
+
+Ianux is a quick-to-use Python command-line tool for creating and restoring
+multi-window, multi-pane tmux sessions, running detached jobs, and listing,
+attaching to, or closing sessions. It requires Python 3.11+,
+[uv](https://docs.astral.sh/uv/), and `tmux` on `PATH`.
+
+## Quick start
+
+Install Ianux as a standalone command:
+
+```bash
+uv tool install .
+ianux --help
+ianux session --panes 4
+```
+
+Or run it from a checkout:
+
+```bash
+uv sync
+uv run ianux --help
+uv run ianux session --panes 4
+```
+
+## Commands
+
+| Command | Alias | Purpose |
+|---|---|---|
+| `session` | `s` | Create and attach to a multi-window, multi-pane session (default) |
+| `run` | `r` | Run commands in a detached session |
+| `list` | `ls` | List open sessions |
+| `attach` | `a` | Attach to a session, window, or pane |
+| `kill` | `k` | Close a session, window, or pane |
+| `load` | `l` | Create a session from TOML |
+| `dump` | `d` | Save a session's pane directories to TOML |
+
+Run `ianux <command> --help` for options and examples. See the [wiki](wiki/Home.md)
+for the [full command reference](wiki/Commands.md), [TOML configuration guide](wiki/Configuration.md),
+and [architecture](wiki/Architecture.md).
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv build
+```
+
+End-to-end tests use a real tmux server and skip when `tmux` is unavailable.
+See [Development and testing](wiki/Development.md) for details.

ianux-0.2.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ianux"
+dynamic = ["version"]
+description = "A quick-to-use tmux wrapper for managing sessions."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+
+[project.scripts]
+ianux = "ianux.__main__:entrypoint"
+
+[dependency-groups]
+dev = ["pytest>=8"]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+version = {attr = "ianux.__version__"}

ianux-0.2.0/setup.cfg

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

ianux-0.2.0/src/ianux/__init__.py

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

ianux-0.2.0/src/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-0.2.0/src/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