gitnc 0.1.2__py3-none-any.whl

gitnc/terminal.py

@@ -0,0 +1,230 @@
+"""Terminal screen session management and git display helpers."""
+
+from __future__ import annotations
+
+import os
+import shlex
+import shutil
+import sys
+from collections.abc import Callable, Mapping
+
+from .git import GIT, GitCode, GitEntry, GitFilelist, GitStatus
+
+PREVIOUS_SCREEN_TOGGLE_KEY = "\x0f"
+
+# Midnight Commander exports `MC_SID` into the subshell it runs commands in,
+# and `MC_TMPDIR` into its own environment, which a command started with the
+# subshell disabled (`mc -u`) inherits. Either one means mc is our ancestor.
+MIDNIGHT_COMMANDER_ENV_VARS = ("MC_SID", "MC_TMPDIR")
+
+
+def started_from_midnight_commander(environ: Mapping[str, str] | None = None) -> bool:
+    """Whether the process runs under Midnight Commander.
+
+    Under mc's subshell the keyboard doesn't reach us directly: mc reads the
+    terminal and forwards the keys to the subshell's pty, and it keeps its own
+    `Ctrl+O` — the key that toggles our previous screen — to switch back to
+    its panels, leaving this app running out of sight.
+    """
+    env = os.environ if environ is None else environ
+    return any(env.get(name) for name in MIDNIGHT_COMMANDER_ENV_VARS)
+
+
+class Terminal:
+    """Utility class for terminal screen management and git display helpers."""
+
+    def load_commits(self, path: str = ".") -> list:
+        return GIT(path).load_commits()
+
+    def load_file_diff(self, path: str, entry: GitEntry) -> str:
+        return GIT(path).load_file_diff(entry)
+
+    def load_status(self, path: str = ".") -> GitFilelist:
+        return GIT(path).load_status()
+
+    def status_markup(self, code: GitCode, filename: str) -> str:
+        label = code.value
+        if code.is_untracked:
+            color = "dim"
+        elif code.contains(GitStatus.ADDED):
+            color = "green"
+        elif code.contains(GitStatus.DELETED):
+            color = "red"
+        elif code.contains(GitStatus.RENAMED):
+            color = "cyan"
+        else:
+            color = "yellow"
+        return f"[{color}]{label}[/{color}]  {filename}"
+
+    def _wait_for_toggle_key(
+        self, read_key: Callable[[], str], toggle_key: str = PREVIOUS_SCREEN_TOGGLE_KEY
+    ) -> None:
+        while read_key() != toggle_key:
+            pass
+
+    def _read_key_posix(self) -> str:
+        if not sys.stdin.isatty():
+            raise OSError("stdin is not a tty")
+
+        import termios
+        import tty
+
+        fd = sys.stdin.fileno()
+        saved = termios.tcgetattr(fd)
+        try:
+            tty.setraw(fd)
+            while True:
+                key = os.read(fd, 1)
+                if key:
+                    return key.decode(errors="ignore")
+        finally:
+            termios.tcsetattr(fd, termios.TCSADRAIN, saved)
+
+    def _read_key_windows(self) -> str:
+        # Only reached when os.name == "nt"; the assert tells the type checker so,
+        # since msvcrt's stubs are Windows-only.
+        assert sys.platform == "win32"
+        import msvcrt
+
+        getwch = msvcrt.getwch
+        while True:
+            key = getwch()
+            if key in ("\x00", "\xe0"):
+                getwch()
+                continue
+            return key
+
+    def wait_for_previous_screen_toggle(self) -> None:
+        read_key = self._read_key_windows if os.name == "nt" else self._read_key_posix
+        self._wait_for_toggle_key(read_key)
+
+    def write_previous_screen(self, text: str) -> None:
+        """Write `text` to the terminal the TUI was started from.
+
+        Only meaningful while the app is suspended: Textual has left the
+        alternate screen buffer by then, so the text lands on the previous
+        screen and stays in its scrollback — which is what makes it readable
+        again later, when `Ctrl+O` puts a shell on that same screen.
+
+        `sys.stdout` is read per call rather than captured, because
+        `App.suspend()` rebinds it to the real stdout for the length of the
+        block. A closed or redirected stream isn't worth failing the caller
+        over, so the write is best-effort.
+        """
+        try:
+            sys.stdout.write(text)
+            sys.stdout.flush()
+        except (OSError, ValueError):
+            pass
+
+    def previous_screen_shell_command(self) -> list[str]:
+        env_var = "COMSPEC" if os.name == "nt" else "SHELL"
+        raw_shell = os.environ.get(env_var) or ("cmd.exe" if os.name == "nt" else "/bin/sh")
+        argv = shlex.split(raw_shell, posix=os.name != "nt")
+        if not argv:
+            raise OSError(f"{env_var} does not define a shell")
+        argv[0] = shutil.which(argv[0]) or argv[0]
+        if os.name != "nt" and "-i" not in argv[1:]:
+            argv.append("-i")
+        return argv
+
+    def _terminate_previous_screen_shell(self, pid: int) -> None:
+        import signal
+        import time
+
+        signals = (signal.SIGHUP, signal.SIGTERM, signal.SIGKILL)
+        for sig in signals:
+            try:
+                os.killpg(pid, sig)
+            except ProcessLookupError:
+                break
+
+            deadline = time.monotonic() + 0.2
+            while time.monotonic() < deadline:
+                waited_pid, _ = os.waitpid(pid, os.WNOHANG)
+                if waited_pid == pid:
+                    return
+                time.sleep(0.01)
+
+        try:
+            os.waitpid(pid, 0)
+        except ChildProcessError:
+            pass
+
+    def _run_previous_screen_shell_posix(
+        self, toggle_key: str = PREVIOUS_SCREEN_TOGGLE_KEY
+    ) -> None:
+        import fcntl
+        import pty
+        import select
+        import termios
+        import tty
+
+        if not sys.stdin.isatty() or not sys.stdout.isatty():
+            raise OSError("stdin/stdout are not tty devices")
+
+        argv = self.previous_screen_shell_command()
+        pid, master_fd = pty.fork()
+        if pid == 0:
+            try:
+                os.execvpe(argv[0], argv, os.environ.copy())
+            except OSError as exc:
+                print(f"Unable to launch shell: {exc}", file=sys.stderr)
+            os._exit(1)
+
+        stdin_fd = sys.stdin.fileno()
+        stdout_fd = sys.stdout.fileno()
+        saved = termios.tcgetattr(stdin_fd)
+        toggle = toggle_key.encode()
+        toggled = False
+
+        try:
+            try:
+                window_size = fcntl.ioctl(stdin_fd, termios.TIOCGWINSZ, b"\x00" * 8)
+                fcntl.ioctl(master_fd, termios.TIOCSWINSZ, window_size)
+            except OSError:
+                pass
+
+            tty.setraw(stdin_fd)
+            while True:
+                ready, _, _ = select.select([stdin_fd, master_fd], [], [])
+                if stdin_fd in ready:
+                    try:
+                        data = os.read(stdin_fd, 1024)
+                    except OSError:
+                        break
+                    if not data:
+                        break
+                    toggle_at = data.find(toggle)
+                    if toggle_at != -1:
+                        if toggle_at:
+                            os.write(master_fd, data[:toggle_at])
+                        toggled = True
+                        break
+                    os.write(master_fd, data)
+                if master_fd in ready:
+                    try:
+                        output = os.read(master_fd, 4096)
+                    except OSError:
+                        break
+                    if not output:
+                        break
+                    os.write(stdout_fd, output)
+        finally:
+            termios.tcsetattr(stdin_fd, termios.TCSADRAIN, saved)
+            os.close(master_fd)
+
+        if toggled:
+            self._terminate_previous_screen_shell(pid)
+            return
+
+        try:
+            os.waitpid(pid, 0)
+        except ChildProcessError:
+            pass
+
+    def run_previous_screen_session(self) -> None:
+        if os.name == "nt":
+            self.wait_for_previous_screen_toggle()
+            return
+        self._run_previous_screen_shell_posix()

gitnc/themes/__init__.py

@@ -0,0 +1,25 @@
+"""Theme definitions, one YAML file per theme.
+
+Each ``*.yaml`` file in this package describes a single UITheme. The file
+name (without extension) matches the theme's ``name`` field. ``load_all``
+discovers every YAML file in the package directory and returns the
+resulting ``UITheme`` instances.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from ..ui_theme import UITheme
+
+THEMES_DIR = Path(__file__).resolve().parent
+
+
+def theme_files() -> list[Path]:
+    """Return every theme YAML file in declaration-stable order."""
+    return sorted(THEMES_DIR.glob("*.yaml"))
+
+
+def load_all() -> list[UITheme]:
+    """Load every theme YAML file as a UITheme instance."""
+    return [UITheme.load(path) for path in theme_files()]

gitnc/themes/atom-one-dark.yaml

@@ -0,0 +1,100 @@
+# Textual theme palette. These fields are forwarded to textual.theme.Theme,
+# which colors the application chrome (borders, buttons, headers, scrollbars).
+# `name` is the identifier shown in the Theme menu and persisted in settings.json.
+# Color values accept any CSS-style color (hex, ansi_*, rgb()).
+name: atom-one-dark
+primary: '#61AFEF'
+secondary: '#C678DD'
+warning: '#DEB25B'
+error: '#F06262'
+success: '#62F062'
+accent: '#A378C2'
+foreground: '#ABB2BF'
+background: '#282C34'
+surface: '#3B414D'
+panel: '#4F5666'
+boost: null
+
+# Theme behavior flags.
+# `dark` selects dark-mode contrast defaults inside Textual.
+# `luminosity_spread` / `text_alpha` tune Textual's automatic shade derivation.
+# `variables` are passed through to Textual's CSS variable table
+# (use kebab-case keys, e.g. `block-cursor-foreground`).
+# `ansi: true` opts the theme into the terminal's own ANSI palette
+# instead of fixed hex colors.
+dark: true
+luminosity_spread: 0.15
+text_alpha: 0.95
+variables: {}
+ansi: false
+
+# Status-code colors painted in the Status column of the file list.
+# Values are Rich style strings (e.g. "bold yellow", "#ff8800").
+status_modified: bold yellow
+status_type_changed: 'bold #ff8800'
+status_added: bold green
+status_deleted: bold red
+status_renamed: bold cyan
+status_copied: bold blue
+status_unmerged: 'bold #ff5555'
+status_untracked: bold white
+status_ignored: '#888888'
+status_submodule: bold magenta
+
+# Diff line rendering inside FileDiff.
+# Added/removed lines get a foreground color and a dimmer matching line-number gutter.
+diff_added_line: green
+diff_added_line_number: green dim
+diff_removed_line: red
+diff_removed_line_number: red dim
+diff_context_line_number: dim
+
+# Commit detail rendering inside CommitDetail (git show output).
+# The commit/Author/Date header block, and the @@ hunk markers of a patch.
+commit_header_line: bold
+diff_hunk_header: cyan
+
+# Y/N hint shown at the bottom of the confirm dialog.
+confirm_yes_key: b green
+confirm_no_key: b red
+
+# Warning text shown above the file list (e.g. submodule branch mismatches).
+warning_text: bold red
+
+# Faint hint text at the bottom of dialogs (e.g. "(Esc cancels)").
+dialog_hint: dim
+
+# Accelerator letter highlighted in the menu bar and in dropdown entries.
+# Must stay readable on the menu bar ($menu-bar-background) and dropdown ($panel)
+# backgrounds.
+menu_mnemonic: bold underline
+
+# Settings dialog checkbox mark color.
+checkbox_mark: green
+
+# Settings dialog text caret. It is drawn on the cell it sits on, so it
+# swaps that cell's colors instead of painting one of its own.
+text_caret: reverse
+
+# Selected text in the commit message box (Shift+arrows). Empty keeps
+# Textual's default: $primary lightened at 40% opacity over the background.
+text_selection_background: ''
+text_selection_foreground: ''
+
+# Chrome colors for the menu bar and the footer. The defaults are Textual's
+# own Header/Footer palette, so the bars match every other Textual app.
+# Values may reference this theme's palette fields with `$name`.
+menu_bar_background: $panel
+menu_bar_foreground: $foreground
+footer_background: $panel
+footer_foreground: $foreground
+
+# CSS variables emitted for the file-list cursor and multi-selection.
+# Values may reference Textual palette variables with `$name` (e.g. `$primary`).
+# References are resolved against this theme's own fields when the CSS is generated.
+cursor_row_background: $primary
+cursor_row_foreground: $foreground
+selected_file_background: $warning 30%
+selected_file_foreground: $success
+selected_cursor_row_background: $primary
+selected_cursor_row_foreground: $success

gitnc/themes/atom-one-light.yaml

@@ -0,0 +1,100 @@
+# Textual theme palette. These fields are forwarded to textual.theme.Theme,
+# which colors the application chrome (borders, buttons, headers, scrollbars).
+# `name` is the identifier shown in the Theme menu and persisted in settings.json.
+# Color values accept any CSS-style color (hex, ansi_*, rgb()).
+name: atom-one-light
+primary: '#4078F2'
+secondary: '#A626A4'
+warning: '#D8D938'
+error: '#F23F3F'
+success: '#6CF23F'
+accent: '#bf9232'
+foreground: '#383A42'
+background: '#FAFAFA'
+surface: '#E0E0E0'
+panel: '#CCCCCC'
+boost: null
+
+# Theme behavior flags.
+# `dark` selects dark-mode contrast defaults inside Textual.
+# `luminosity_spread` / `text_alpha` tune Textual's automatic shade derivation.
+# `variables` are passed through to Textual's CSS variable table
+# (use kebab-case keys, e.g. `block-cursor-foreground`).
+# `ansi: true` opts the theme into the terminal's own ANSI palette
+# instead of fixed hex colors.
+dark: false
+luminosity_spread: 0.15
+text_alpha: 0.95
+variables: {}
+ansi: false
+
+# Status-code colors painted in the Status column of the file list.
+# Values are Rich style strings (e.g. "bold yellow", "#ff8800").
+status_modified: bold yellow
+status_type_changed: 'bold #ff8800'
+status_added: bold green
+status_deleted: bold red
+status_renamed: bold cyan
+status_copied: bold blue
+status_unmerged: 'bold #ff5555'
+status_untracked: bold white
+status_ignored: '#888888'
+status_submodule: bold magenta
+
+# Diff line rendering inside FileDiff.
+# Added/removed lines get a foreground color and a dimmer matching line-number gutter.
+diff_added_line: green
+diff_added_line_number: green dim
+diff_removed_line: red
+diff_removed_line_number: red dim
+diff_context_line_number: dim
+
+# Commit detail rendering inside CommitDetail (git show output).
+# The commit/Author/Date header block, and the @@ hunk markers of a patch.
+commit_header_line: bold
+diff_hunk_header: cyan
+
+# Y/N hint shown at the bottom of the confirm dialog.
+confirm_yes_key: b green
+confirm_no_key: b red
+
+# Warning text shown above the file list (e.g. submodule branch mismatches).
+warning_text: bold red
+
+# Faint hint text at the bottom of dialogs (e.g. "(Esc cancels)").
+dialog_hint: dim
+
+# Accelerator letter highlighted in the menu bar and in dropdown entries.
+# Must stay readable on the menu bar ($menu-bar-background) and dropdown ($panel)
+# backgrounds.
+menu_mnemonic: bold underline
+
+# Settings dialog checkbox mark color.
+checkbox_mark: green
+
+# Settings dialog text caret. It is drawn on the cell it sits on, so it
+# swaps that cell's colors instead of painting one of its own.
+text_caret: reverse
+
+# Selected text in the commit message box (Shift+arrows). Empty keeps
+# Textual's default: $primary lightened at 40% opacity over the background.
+text_selection_background: ''
+text_selection_foreground: ''
+
+# Chrome colors for the menu bar and the footer. The defaults are Textual's
+# own Header/Footer palette, so the bars match every other Textual app.
+# Values may reference this theme's palette fields with `$name`.
+menu_bar_background: $panel
+menu_bar_foreground: $foreground
+footer_background: $panel
+footer_foreground: $foreground
+
+# CSS variables emitted for the file-list cursor and multi-selection.
+# Values may reference Textual palette variables with `$name` (e.g. `$primary`).
+# References are resolved against this theme's own fields when the CSS is generated.
+cursor_row_background: $primary
+cursor_row_foreground: $foreground
+selected_file_background: $warning 30%
+selected_file_foreground: $success
+selected_cursor_row_background: $primary
+selected_cursor_row_foreground: $success

gitnc/themes/catppuccin-frappe.yaml

@@ -0,0 +1,108 @@
+# Textual theme palette. These fields are forwarded to textual.theme.Theme,
+# which colors the application chrome (borders, buttons, headers, scrollbars).
+# `name` is the identifier shown in the Theme menu and persisted in settings.json.
+# Color values accept any CSS-style color (hex, ansi_*, rgb()).
+name: catppuccin-frappe
+primary: '#CA9EE6'
+secondary: '#EF9F76'
+warning: '#E5C890'
+error: '#E78284'
+success: '#A6D189'
+accent: '#F4B8E4'
+foreground: '#C6D0F5'
+background: '#303446'
+surface: '#414559'
+panel: '#51576D'
+boost: null
+
+# Theme behavior flags.
+# `dark` selects dark-mode contrast defaults inside Textual.
+# `luminosity_spread` / `text_alpha` tune Textual's automatic shade derivation.
+# `variables` are passed through to Textual's CSS variable table
+# (use kebab-case keys, e.g. `block-cursor-foreground`).
+# `ansi: true` opts the theme into the terminal's own ANSI palette
+# instead of fixed hex colors.
+dark: true
+luminosity_spread: 0.15
+text_alpha: 0.95
+variables:
+  input-cursor-foreground: '#232634'
+  input-cursor-background: '#F2D5CF'
+  border: '#BABBF1'
+  border-blurred: '#838BA7'
+  footer-background: '#51576D'
+  block-cursor-foreground: '#292C3C'
+  block-cursor-text-style: none
+  button-color-foreground: '#303446'
+ansi: false
+
+# Status-code colors painted in the Status column of the file list.
+# Values are Rich style strings (e.g. "bold yellow", "#ff8800").
+status_modified: bold yellow
+status_type_changed: 'bold #ff8800'
+status_added: bold green
+status_deleted: bold red
+status_renamed: bold cyan
+status_copied: bold blue
+status_unmerged: 'bold #ff5555'
+status_untracked: bold white
+status_ignored: '#888888'
+status_submodule: bold magenta
+
+# Diff line rendering inside FileDiff.
+# Added/removed lines get a foreground color and a dimmer matching line-number gutter.
+diff_added_line: green
+diff_added_line_number: green dim
+diff_removed_line: red
+diff_removed_line_number: red dim
+diff_context_line_number: dim
+
+# Commit detail rendering inside CommitDetail (git show output).
+# The commit/Author/Date header block, and the @@ hunk markers of a patch.
+commit_header_line: bold
+diff_hunk_header: cyan
+
+# Y/N hint shown at the bottom of the confirm dialog.
+confirm_yes_key: b green
+confirm_no_key: b red
+
+# Warning text shown above the file list (e.g. submodule branch mismatches).
+warning_text: bold red
+
+# Faint hint text at the bottom of dialogs (e.g. "(Esc cancels)").
+dialog_hint: dim
+
+# Accelerator letter highlighted in the menu bar and in dropdown entries.
+# Must stay readable on the menu bar ($menu-bar-background) and dropdown ($panel)
+# backgrounds.
+menu_mnemonic: bold underline
+
+# Settings dialog checkbox mark color.
+checkbox_mark: green
+
+# Settings dialog text caret. It is drawn on the cell it sits on, so it
+# swaps that cell's colors instead of painting one of its own.
+text_caret: reverse
+
+# Selected text in the commit message box (Shift+arrows). Empty keeps
+# Textual's default: $primary lightened at 40% opacity over the background.
+text_selection_background: '#949CBB 30%'
+text_selection_foreground: ''
+
+# Chrome colors for the menu bar and the footer. The defaults are Textual's
+# own Header/Footer palette, so the bars match every other Textual app.
+# Values may reference this theme's palette fields with `$name`.
+menu_bar_background: $panel
+menu_bar_foreground: $foreground
+footer_background: $panel
+footer_foreground: $foreground
+
+# CSS variables emitted for the file-list cursor and multi-selection.
+# Values may reference Textual palette variables with `$name` (e.g. `$primary`).
+# References are resolved against this theme's own fields when the CSS is generated.
+cursor_row_background: $primary
+cursor_row_foreground: $foreground
+selected_file_background: $warning 30%
+selected_file_foreground: $success
+selected_cursor_row_background: $primary
+selected_cursor_row_foreground: $success

gitnc/themes/catppuccin-latte.yaml

@@ -0,0 +1,101 @@
+# Textual theme palette. These fields are forwarded to textual.theme.Theme,
+# which colors the application chrome (borders, buttons, headers, scrollbars).
+# `name` is the identifier shown in the Theme menu and persisted in settings.json.
+# Color values accept any CSS-style color (hex, ansi_*, rgb()).
+name: catppuccin-latte
+primary: '#8839EF'
+secondary: '#DC8A78'
+warning: '#DF8E1D'
+error: '#D20F39'
+success: '#40A02B'
+accent: '#FE640B'
+foreground: '#4C4F69'
+background: '#EFF1F5'
+surface: '#E6E9EF'
+panel: '#CCD0DA'
+boost: null
+
+# Theme behavior flags.
+# `dark` selects dark-mode contrast defaults inside Textual.
+# `luminosity_spread` / `text_alpha` tune Textual's automatic shade derivation.
+# `variables` are passed through to Textual's CSS variable table
+# (use kebab-case keys, e.g. `block-cursor-foreground`).
+# `ansi: true` opts the theme into the terminal's own ANSI palette
+# instead of fixed hex colors.
+dark: false
+luminosity_spread: 0.15
+text_alpha: 0.95
+variables:
+  button-color-foreground: '#EFF1F5'
+ansi: false
+
+# Status-code colors painted in the Status column of the file list.
+# Values are Rich style strings (e.g. "bold yellow", "#ff8800").
+status_modified: bold yellow
+status_type_changed: 'bold #ff8800'
+status_added: bold green
+status_deleted: bold red
+status_renamed: bold cyan
+status_copied: bold blue
+status_unmerged: 'bold #ff5555'
+status_untracked: bold white
+status_ignored: '#888888'
+status_submodule: bold magenta
+
+# Diff line rendering inside FileDiff.
+# Added/removed lines get a foreground color and a dimmer matching line-number gutter.
+diff_added_line: green
+diff_added_line_number: green dim
+diff_removed_line: red
+diff_removed_line_number: red dim
+diff_context_line_number: dim
+
+# Commit detail rendering inside CommitDetail (git show output).
+# The commit/Author/Date header block, and the @@ hunk markers of a patch.
+commit_header_line: bold
+diff_hunk_header: cyan
+
+# Y/N hint shown at the bottom of the confirm dialog.
+confirm_yes_key: b green
+confirm_no_key: b red
+
+# Warning text shown above the file list (e.g. submodule branch mismatches).
+warning_text: bold red
+
+# Faint hint text at the bottom of dialogs (e.g. "(Esc cancels)").
+dialog_hint: dim
+
+# Accelerator letter highlighted in the menu bar and in dropdown entries.
+# Must stay readable on the menu bar ($menu-bar-background) and dropdown ($panel)
+# backgrounds.
+menu_mnemonic: bold underline
+
+# Settings dialog checkbox mark color.
+checkbox_mark: green
+
+# Settings dialog text caret. It is drawn on the cell it sits on, so it
+# swaps that cell's colors instead of painting one of its own.
+text_caret: reverse
+
+# Selected text in the commit message box (Shift+arrows). Empty keeps
+# Textual's default: $primary lightened at 40% opacity over the background.
+text_selection_background: ''
+text_selection_foreground: ''
+
+# Chrome colors for the menu bar and the footer. The defaults are Textual's
+# own Header/Footer palette, so the bars match every other Textual app.
+# Values may reference this theme's palette fields with `$name`.
+menu_bar_background: $panel
+menu_bar_foreground: $foreground
+footer_background: $panel
+footer_foreground: $foreground
+
+# CSS variables emitted for the file-list cursor and multi-selection.
+# Values may reference Textual palette variables with `$name` (e.g. `$primary`).
+# References are resolved against this theme's own fields when the CSS is generated.
+cursor_row_background: $primary
+cursor_row_foreground: $foreground
+selected_file_background: $warning 30%
+selected_file_foreground: $success
+selected_cursor_row_background: $primary
+selected_cursor_row_foreground: $success