skit-cli 0.0.1__tar.gz → 0.1.0__tar.gz

{skit_cli-0.0.1 → skit_cli-0.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skit-cli
-Version: 0.0.1
+Version: 0.1.0
 Summary: Script launcher and parameter manager: pick a script, fill in a form, run — no more opening an IDE just to tweak constants.
 Keywords: script,launcher,uv,tui,pep723,script-manager
 Author: Yi-Ting Chiu
@@ -102,6 +102,15 @@ uv tool install git+https://github.com/t41372/skit          # latest development
 uvx --from git+https://github.com/t41372/skit skit --help   # try it without installing
 ```
 
+## Update
+
+```bash
+uv tool upgrade skit-cli   # update to the latest release — also how you "check": it says up to date if you are
+skit --version             # the version you're on
+```
+
+`uv tool upgrade` follows whatever source you installed from: PyPI installs track PyPI releases, `git+…` installs re-fetch the main branch.
+
 ## Uninstall
 
 ```bash

{skit_cli-0.0.1 → skit_cli-0.1.0}/README.md

@@ -72,6 +72,15 @@ uv tool install git+https://github.com/t41372/skit          # latest development
 uvx --from git+https://github.com/t41372/skit skit --help   # try it without installing
 ```
 
+## Update
+
+```bash
+uv tool upgrade skit-cli   # update to the latest release — also how you "check": it says up to date if you are
+skit --version             # the version you're on
+```
+
+`uv tool upgrade` follows whatever source you installed from: PyPI installs track PyPI releases, `git+…` installs re-fetch the main branch.
+
 ## Uninstall
 
 ```bash

{skit_cli-0.0.1 → skit_cli-0.1.0}/pyproject.toml

@@ -2,7 +2,7 @@
 # Distribution name only ("skit" is admin-prohibited on PyPI); the import package,
 # CLI command, and config dirs all stay "skit".
 name = "skit-cli"
-version = "0.0.1"
+version = "0.1.0"
 description = "Script launcher and parameter manager: pick a script, fill in a form, run — no more opening an IDE just to tweak constants."
 readme = "README.md"
 requires-python = ">=3.12"

skit_cli-0.1.0/src/skit/__init__.py

@@ -0,0 +1,20 @@
+"""skit — a launcher and parameter manager for your scripts."""
+
+import os
+from importlib.metadata import PackageNotFoundError, version
+
+# Textual ≥ 8.2.7 enables the kitty keyboard protocol's "report all keys" mode, which
+# iTerm2 (3.6.x) implements in a way that fights the macOS IME: candidate-selection
+# digits and Enter reach the app as raw key events and the composed CJK text is never
+# delivered at all (iTerm2 issue 12906) — Chinese/Japanese/Korean typing breaks. No
+# skit binding needs the protocol, so opt out before the first textual import
+# (textual.constants reads this at import time). setdefault keeps an explicit user
+# override (=0 re-enables) winning.
+os.environ.setdefault("TEXTUAL_DISABLE_KITTY_KEY", "1")
+
+# pyproject.toml is the single source of the version; installed distributions carry it
+# as metadata (a wheel doesn't ship pyproject.toml), so read it from there.
+try:
+    __version__ = version("skit-cli")
+except PackageNotFoundError:  # a bare checkout on sys.path, no installed dist
+    __version__ = "0.0.0+unknown"

{skit_cli-0.0.1 → skit_cli-0.1.0}/src/skit/cli.py

@@ -536,16 +536,40 @@ def add(
                         gettext("Can't read %(path)s: %(error)s")
                         % {"path": str(resolved), "error": exc.strerror or str(exc)}
                     ) from exc
-                entry, summary_deps, summary_managed, summary_secrets = _onboard_python(
-                    Path(path),
-                    text,
-                    name=name,
-                    description=description,
-                    ref=ref,
-                    deps_opt=dep,
-                    python_opt=python,
-                    no_input=no_input,
-                )
+                # Interactive + mini-form style: host the SAME review panel the TUI's
+                # `a` opens (flags prefill it). Pipes/CI/--no-input/form=plain keep the
+                # line-prompt path — the non-interactive contract is untouched.
+                if (
+                    not no_input
+                    and _is_interactive()
+                    and os.environ.get("TERM") != "dumb"
+                    and config.load_form() == "tui"
+                ):
+                    from .tui_add import run_add_review
+
+                    slug = run_add_review(
+                        Path(path),
+                        name=name,
+                        description=description,
+                        reference=ref,
+                        deps=dep,
+                        requires_python=python or "",
+                    )
+                    if slug is None:
+                        console.print(f"[dim]{gettext('Cancelled — nothing was added.')}[/dim]")
+                        raise typer.Exit(EXIT_CANCELLED)
+                    entry = store.resolve(slug)
+                else:
+                    entry, summary_deps, summary_managed, summary_secrets = _onboard_python(
+                        Path(path),
+                        text,
+                        name=name,
+                        description=description,
+                        ref=ref,
+                        deps_opt=dep,
+                        python_opt=python,
+                        no_input=no_input,
+                    )
     except store.StoreError as exc:
         raise _fail(str(exc), 1) from exc
     _print_add_summary(entry, summary_deps, summary_managed, summary_secrets)
@@ -772,13 +796,8 @@ def _collect_values(
 
 
 # How a flows.RunOutcome failure maps to skit's exit-code contract (docker convention).
-_FAILURE_EXIT = {
-    flows.FAIL_BAD_VALUE: EXIT_SKIT,
-    flows.FAIL_DRIFT: EXIT_SKIT,
-    flows.FAIL_LAUNCH: EXIT_SKIT,
-    flows.FAIL_NOT_EXECUTABLE: EXIT_NOT_EXECUTABLE,
-    flows.FAIL_MISSING: EXIT_NOT_FOUND,
-}
+# The numbers live in flows so the TUI's exit-after-run path shares them.
+_FAILURE_EXIT = flows.FAILURE_EXIT_CODES
 
 
 @app.command(
@@ -1461,7 +1480,7 @@ def doctor(
 # config (git-config grammar: bare = list, KEY = read, KEY VALUE = write)
 # --------------------------------------------------------------------------
 
-_CONFIG_KEYS = ("lang", "editor", "mirror", "form")
+_CONFIG_KEYS = ("lang", "editor", "mirror", "form", "after_run")
 
 
 def _config_value(key: str) -> str:
@@ -1475,7 +1494,9 @@ def _config_value(key: str) -> str:
     if key == "mirror":
         m = config.load_mirror()
         return m.pypi if m.enabled else "off"
-    return config.load_form()  # "form" — _CONFIG_KEYS guards the key set
+    if key == "form":
+        return config.load_form()
+    return config.load_after_run()  # "after_run" — _CONFIG_KEYS guards the key set
 
 
 def _config_set(key: str, value: str) -> None:
@@ -1499,22 +1520,33 @@ def _config_set(key: str, value: str) -> None:
                 f"[red]{gettext('Unknown mirror: %(name)s. Choose from: %(names)s') % {'name': escape(value), 'names': choices}}[/red]"
             )
             raise typer.Exit(EXIT_USAGE)
-    else:  # form
+    elif key == "form":
         if value not in config.FORM_STYLES:
             err_console.print(
                 f"[red]{gettext('Unknown form style: %(value)s. Choose from: tui, plain') % {'value': escape(value)}}[/red]"
             )
             raise typer.Exit(EXIT_USAGE)
         config.save_form(value)
+    else:  # after_run
+        if value not in config.AFTER_RUN_MODES:
+            err_console.print(
+                f"[red]{gettext('Unknown after-run behavior: %(value)s. Choose from: exit, stay') % {'value': escape(value)}}[/red]"
+            )
+            raise typer.Exit(EXIT_USAGE)
+        config.save_after_run(value)
 
 
 @app.command(
     "config",
-    help=gettext("Read or set skit's settings (language, editor, mirror, form style)."),
-    epilog=gettext("Examples:  skit config  ·  skit config lang zh-TW  ·  skit config form plain"),
+    help=gettext("Read or set skit's settings (language, editor, mirror, form style, after-run)."),
+    epilog=gettext(
+        "Examples:  skit config  ·  skit config lang zh-TW  ·  skit config after_run stay"
+    ),
 )
 def config_cmd(
-    key: str = typer.Argument(None, help=gettext("Setting name: lang / editor / mirror / form")),
+    key: str = typer.Argument(
+        None, help=gettext("Setting name: lang / editor / mirror / form / after_run")
+    ),
     value: str = typer.Argument(
         None, help=gettext('New value (omit to read; lang also accepts "auto")')
     ),

{skit_cli-0.0.1 → skit_cli-0.1.0}/src/skit/config.py

@@ -136,8 +136,10 @@ FORM_STYLES = ("tui", "plain")
 
 
 def load_form() -> str:
-    """Interactive-form style: "tui" (inline mini-form, the default) or "plain" (line
-    prompts). Governs every interactive flow (run form, add panel), not just run."""
+    """Interactive-form style: "tui" (inline mini-form / review panel, the default) or
+    "plain" (line prompts). Consumed by the CLI's interactive flows — `skit run`
+    parameter collection and `skit add`'s review panel; the TUI workbench always uses
+    its own full screens."""
     value = load_config().get("form", "")  # pragma: no mutate — normalized below
     return value if value in FORM_STYLES else "tui"
 
@@ -149,6 +151,24 @@ def save_form(style: str) -> None:
     save_config(doc)
 
 
+AFTER_RUN_MODES = ("exit", "stay")
+
+
+def load_after_run() -> str:
+    """What the TUI does when a launched script finishes: "exit" (the default — skit is
+    a launcher, so it quits and passes the script's exit code through) or "stay"
+    (banner + Enter returns to the Library, the workbench loop)."""
+    value = load_config().get("after_run", "")  # pragma: no mutate — normalized below
+    return value if value in AFTER_RUN_MODES else "exit"
+
+
+def save_after_run(mode: str) -> None:
+    """Persist the after-run behavior, preserving every other key."""
+    doc = _load_config_for_save()
+    doc["after_run"] = mode
+    save_config(doc)
+
+
 @dataclass(frozen=True)
 class MirrorConfig:
     enabled: bool = False

{skit_cli-0.0.1 → skit_cli-0.1.0}/src/skit/flows.py

@@ -485,6 +485,18 @@ FAIL_MISSING = "missing"  # the launch target is gone from disk
 FAIL_NOT_EXECUTABLE = "not_executable"  # an exe exists but isn't +x
 FAIL_LAUNCH = "launch"  # any other launch failure
 
+# Docker-convention process exit codes when the launch itself failed (the script's own
+# exit code passes through untouched whenever it did run): skit failures are 125, an
+# existing-but-unexecutable target 126, a missing target 127. Shared by `skit run` and
+# the TUI's exit-after-run path so the contract can't fork.
+FAILURE_EXIT_CODES = {
+    FAIL_BAD_VALUE: 125,
+    FAIL_DRIFT: 125,
+    FAIL_LAUNCH: 125,
+    FAIL_NOT_EXECUTABLE: 126,
+    FAIL_MISSING: 127,
+}
+
 
 @dataclass
 class RunOutcome: