kx-cli 0.0.4__tar.gz → 0.0.6__tar.gz

kx_cli-0.0.6/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: kx-cli
+Version: 0.0.6
+Summary: kubectl wrapper with index-based resource selection
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer==0.26.8
+Requires-Dist: kubernetes
+Requires-Dist: rich
+Provides-Extra: dev
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/jzills/kx/main/assets/banner.svg" alt="kx — kubectl, indexed." width="800"/>
+</div>
+
+<br>
+
+<div align="center">
+
+# kubectl, indexed
+
+</div>
+
+<div align="center">
+
+[![PyPI version](https://img.shields.io/pypi/v/kx-cli?style=flat-square&color=3fb950&labelColor=21262d)](https://pypi.org/project/kx-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/kx-cli?style=flat-square&color=3fb950&labelColor=21262d)](https://pypi.org/project/kx-cli/)
+[![License](https://img.shields.io/github/license/jzills/kx?style=flat-square&color=3fb950&labelColor=21262d)](LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/jzills/kx/pr.yml?style=flat-square&color=3fb950&labelColor=21262d&label=CI)](https://github.com/jzills/kx/actions/workflows/pr.yml)
+
+</div>
+
+`kx` is a kubectl wrapper that adds index-based resource selection. Run `kx get <resource>` once, then reference any result by number instead of typing full resource names.
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/jzills/kx/main/demo/demo.gif" alt="kx demo" width="800"/>
+</div>
+
+## Install
+
+```bash
+pip install kx-cli
+```
+
+## Usage
+
+### List resources
+
+```
+kx get <resource> [--match|-m <substring>] [kubectl flags...]
+```
+
+Fetches resources and assigns index numbers. Any extra flags (e.g. `-n <namespace>`, `-A`) are passed through to kubectl. Use `--match`/`-m` to filter results by name (substring, case-insensitive).
+
+```
+$ kx get pods
+Pods · default · 3 items
+  X    NAME                      READY    STATUS     RESTARTS    AGE
+  1    api-7d9f4b8c6-xkp2q       1/1      Running    0            2d
+  2    worker-6c8b5f7d9-mnt4r    1/1      Running    3            5h
+  3    postgres-0                1/1      Running    0           12d
+```
+
+All subsequent commands reference resources by their `X` index from the last `kx get`.
+
+Global flags: `--no-color` disables styled output, `--version` prints the installed version, and `--help` on any command shows usage, examples, and aliases.
+
+### Commands
+
+<!-- commands-table-start -->
+| Command | Description |
+|---|---|
+| `kx get <resource> [--match/-m text] [kubectl flags...]` | List resources and assign index numbers for use with other commands. |
+| `kx describe <indexes>... [kubectl flags...]` | Show full kubectl describe output for one or more indexed resources. |
+| `kx events <indexes>...` | Show Kubernetes events for one or more indexed resources. |
+| `kx logs <index> [kubectl flags...]` | Stream logs for an indexed resource; aggregates across pods for Deployments, StatefulSets, DaemonSets, and Services. |
+| `kx labels <indexes>... [--selector/-s]` | Show labels for one or more indexed resources; --selector formats output as a label selector. |
+| `kx yaml <indexes>... [--show text]` | Print the raw YAML manifest for one or more indexed resources; --show filters to specific top-level fields. |
+| `kx delete <indexes>... [--yes/-y]` | Delete one or more indexed resources (prompts for confirmation unless --yes). |
+| `kx edit <index> [kubectl flags...]` | Open an indexed resource in your editor via kubectl edit. |
+| `kx exec <index> [<cmd>...] [kubectl flags...]` | Open an interactive shell in an indexed pod (bash, falling back to sh). |
+| `kx tree <index> [--index/-i]` | Show the ownership graph for an indexed resource; --index assigns indexes to tree nodes. |
+| `kx rollout <action> <index>` | Run a rollout action (status, restart, pause, resume, history, undo) on a Deployment, StatefulSet, or DaemonSet. |
+| `kx scale <index> <replicas>` | Scale an indexed Deployment, StatefulSet, or ReplicaSet to a given replica count. |
+| `kx port-forward <index> <port> [kubectl flags...]` | Forward a local port to an indexed resource (Pod, Deployment, ReplicaSet, StatefulSet, DaemonSet, Service). |
+| `kx diagnostic <index>` | Run read-only health diagnostics on an indexed Deployment, StatefulSet, DaemonSet, or Pod; alias: kx diag. |
+| `kx namespace <index>` | Switch to an indexed namespace; alias: kx ns (run kx get namespaces first). |
+| `kx theme [<name>]` | List available color themes or persist a choice by name or index. |
+| `kx state [<position>] [--all/-a]` | Show current state, jump to a history position, or list all entries with --all. |
+| `kx drop <position>` | Remove a history entry by position (shown in kx state --all). |
+| `kx back` | Navigate to the previous kx get result. |
+| `kx forward` | Navigate to the next kx get result. |
+<!-- commands-table-end -->
+
+### Example workflow
+
+```bash
+# list deployments, pick index 2
+kx get deployments
+kx describe 2
+
+# check events on that deployment
+kx events 2
+
+# drill into a pod
+kx get pods
+kx logs 1
+kx exec 1            # opens bash/sh
+kx exec 1 -- env     # run a specific command
+
+# forward local port 8080 to port 80 on a service
+kx get services
+kx port-forward 2 8080:80
+
+# navigate history after multiple gets
+kx get pods
+kx get deployments
+kx logs 1            # logs from pod index 1
+kx state --all       # review full history
+
+# clean up
+kx delete 3
+```
+
+## State
+
+`kx` maintains a history of up to 10 `kx get` results in `~/.kx/state.json`. A cursor tracks your current position; index-based commands always resolve against the entry at the cursor.
+
+```
+$ kx get pods          # saves a new entry, cursor advances
+$ kx get deployments   # saves another entry, cursor advances
+$ kx logs 1            # resolves index 1 from the pods result
+$ kx state --all       # lists all history entries and the current position
+```
+
+Use `kx state <position>` to jump directly to any history entry, and `kx drop <position>` to remove one.
+
+## Configuration
+
+`kx` reads `~/.kx/config.toml`; environment variables override file settings.
+
+| Key | Env var | Default | Description |
+| --- | --- | --- | --- |
+| `max_history` | `KX_MAX_HISTORY` | `10` | Number of `kx get` results kept in history. |
+| `shells` | `KX_SHELLS` (comma-separated) | `["bash", "sh"]` | Shell candidates for `kx exec`. |
+| `no_color` | `KX_NO_COLOR` | `false` | Disable styled output (same as `--no-color`). |
+| `theme` | `KX_THEME` | `"github-dark"` | Color theme for all output. |
+
+Styled output is emitted only when stdout is a terminal — piped or redirected output is plain text, so `kx get pods | grep worker` stays clean. The [`NO_COLOR`](https://no-color.org/) convention is honored as well.
+
+### Themes
+
+```bash
+kx theme        # list available themes (indexed) with a preview of each
+kx theme nord   # persist a theme to ~/.kx/config.toml
+kx theme 3      # same, selecting by index from the kx theme listing
+```
+
+Prefab themes: `github-dark` (default), `dracula`, `nord`, `gruvbox`, `solarized-dark`, `catppuccin-mocha`, `tokyo-night`, `rose-pine`, `mono`, `light` (for light terminal backgrounds), and `plain` (no styling at all).
+
+## Development
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+```
+
+Run the CLI directly:
+
+```bash
+python -m kx.main --help
+```

kx_cli-0.0.6/README.md

@@ -0,0 +1,162 @@
+<div align="center">
+  <img src="https://raw.githubusercontent.com/jzills/kx/main/assets/banner.svg" alt="kx — kubectl, indexed." width="800"/>
+</div>
+
+<br>
+
+<div align="center">
+
+# kubectl, indexed
+
+</div>
+
+<div align="center">
+
+[![PyPI version](https://img.shields.io/pypi/v/kx-cli?style=flat-square&color=3fb950&labelColor=21262d)](https://pypi.org/project/kx-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/kx-cli?style=flat-square&color=3fb950&labelColor=21262d)](https://pypi.org/project/kx-cli/)
+[![License](https://img.shields.io/github/license/jzills/kx?style=flat-square&color=3fb950&labelColor=21262d)](LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/jzills/kx/pr.yml?style=flat-square&color=3fb950&labelColor=21262d&label=CI)](https://github.com/jzills/kx/actions/workflows/pr.yml)
+
+</div>
+
+`kx` is a kubectl wrapper that adds index-based resource selection. Run `kx get <resource>` once, then reference any result by number instead of typing full resource names.
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/jzills/kx/main/demo/demo.gif" alt="kx demo" width="800"/>
+</div>
+
+## Install
+
+```bash
+pip install kx-cli
+```
+
+## Usage
+
+### List resources
+
+```
+kx get <resource> [--match|-m <substring>] [kubectl flags...]
+```
+
+Fetches resources and assigns index numbers. Any extra flags (e.g. `-n <namespace>`, `-A`) are passed through to kubectl. Use `--match`/`-m` to filter results by name (substring, case-insensitive).
+
+```
+$ kx get pods
+Pods · default · 3 items
+  X    NAME                      READY    STATUS     RESTARTS    AGE
+  1    api-7d9f4b8c6-xkp2q       1/1      Running    0            2d
+  2    worker-6c8b5f7d9-mnt4r    1/1      Running    3            5h
+  3    postgres-0                1/1      Running    0           12d
+```
+
+All subsequent commands reference resources by their `X` index from the last `kx get`.
+
+Global flags: `--no-color` disables styled output, `--version` prints the installed version, and `--help` on any command shows usage, examples, and aliases.
+
+### Commands
+
+<!-- commands-table-start -->
+| Command | Description |
+|---|---|
+| `kx get <resource> [--match/-m text] [kubectl flags...]` | List resources and assign index numbers for use with other commands. |
+| `kx describe <indexes>... [kubectl flags...]` | Show full kubectl describe output for one or more indexed resources. |
+| `kx events <indexes>...` | Show Kubernetes events for one or more indexed resources. |
+| `kx logs <index> [kubectl flags...]` | Stream logs for an indexed resource; aggregates across pods for Deployments, StatefulSets, DaemonSets, and Services. |
+| `kx labels <indexes>... [--selector/-s]` | Show labels for one or more indexed resources; --selector formats output as a label selector. |
+| `kx yaml <indexes>... [--show text]` | Print the raw YAML manifest for one or more indexed resources; --show filters to specific top-level fields. |
+| `kx delete <indexes>... [--yes/-y]` | Delete one or more indexed resources (prompts for confirmation unless --yes). |
+| `kx edit <index> [kubectl flags...]` | Open an indexed resource in your editor via kubectl edit. |
+| `kx exec <index> [<cmd>...] [kubectl flags...]` | Open an interactive shell in an indexed pod (bash, falling back to sh). |
+| `kx tree <index> [--index/-i]` | Show the ownership graph for an indexed resource; --index assigns indexes to tree nodes. |
+| `kx rollout <action> <index>` | Run a rollout action (status, restart, pause, resume, history, undo) on a Deployment, StatefulSet, or DaemonSet. |
+| `kx scale <index> <replicas>` | Scale an indexed Deployment, StatefulSet, or ReplicaSet to a given replica count. |
+| `kx port-forward <index> <port> [kubectl flags...]` | Forward a local port to an indexed resource (Pod, Deployment, ReplicaSet, StatefulSet, DaemonSet, Service). |
+| `kx diagnostic <index>` | Run read-only health diagnostics on an indexed Deployment, StatefulSet, DaemonSet, or Pod; alias: kx diag. |
+| `kx namespace <index>` | Switch to an indexed namespace; alias: kx ns (run kx get namespaces first). |
+| `kx theme [<name>]` | List available color themes or persist a choice by name or index. |
+| `kx state [<position>] [--all/-a]` | Show current state, jump to a history position, or list all entries with --all. |
+| `kx drop <position>` | Remove a history entry by position (shown in kx state --all). |
+| `kx back` | Navigate to the previous kx get result. |
+| `kx forward` | Navigate to the next kx get result. |
+<!-- commands-table-end -->
+
+### Example workflow
+
+```bash
+# list deployments, pick index 2
+kx get deployments
+kx describe 2
+
+# check events on that deployment
+kx events 2
+
+# drill into a pod
+kx get pods
+kx logs 1
+kx exec 1            # opens bash/sh
+kx exec 1 -- env     # run a specific command
+
+# forward local port 8080 to port 80 on a service
+kx get services
+kx port-forward 2 8080:80
+
+# navigate history after multiple gets
+kx get pods
+kx get deployments
+kx logs 1            # logs from pod index 1
+kx state --all       # review full history
+
+# clean up
+kx delete 3
+```
+
+## State
+
+`kx` maintains a history of up to 10 `kx get` results in `~/.kx/state.json`. A cursor tracks your current position; index-based commands always resolve against the entry at the cursor.
+
+```
+$ kx get pods          # saves a new entry, cursor advances
+$ kx get deployments   # saves another entry, cursor advances
+$ kx logs 1            # resolves index 1 from the pods result
+$ kx state --all       # lists all history entries and the current position
+```
+
+Use `kx state <position>` to jump directly to any history entry, and `kx drop <position>` to remove one.
+
+## Configuration
+
+`kx` reads `~/.kx/config.toml`; environment variables override file settings.
+
+| Key | Env var | Default | Description |
+| --- | --- | --- | --- |
+| `max_history` | `KX_MAX_HISTORY` | `10` | Number of `kx get` results kept in history. |
+| `shells` | `KX_SHELLS` (comma-separated) | `["bash", "sh"]` | Shell candidates for `kx exec`. |
+| `no_color` | `KX_NO_COLOR` | `false` | Disable styled output (same as `--no-color`). |
+| `theme` | `KX_THEME` | `"github-dark"` | Color theme for all output. |
+
+Styled output is emitted only when stdout is a terminal — piped or redirected output is plain text, so `kx get pods | grep worker` stays clean. The [`NO_COLOR`](https://no-color.org/) convention is honored as well.
+
+### Themes
+
+```bash
+kx theme        # list available themes (indexed) with a preview of each
+kx theme nord   # persist a theme to ~/.kx/config.toml
+kx theme 3      # same, selecting by index from the kx theme listing
+```
+
+Prefab themes: `github-dark` (default), `dracula`, `nord`, `gruvbox`, `solarized-dark`, `catppuccin-mocha`, `tokyo-night`, `rose-pine`, `mono`, `light` (for light terminal backgrounds), and `plain` (no styling at all).
+
+## Development
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+```
+
+Run the CLI directly:
+
+```bash
+python -m kx.main --help
+```

{kx_cli-0.0.4 → kx_cli-0.0.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kx-cli"
-version = "0.0.4"
+version = "0.0.6"
 description = "kubectl wrapper with index-based resource selection"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -11,7 +11,7 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "typer==0.26.7",
+    "typer==0.26.8",
     "kubernetes",
     "rich",
 ]
@@ -21,6 +21,7 @@ dev = [
     "ruff",
     "pre-commit",
     "pytest",
+    "pytest-cov",
 ]
 
 [project.scripts]

kx_cli-0.0.6/src/kx/commands/back.py

@@ -0,0 +1,13 @@
+from dataclasses import asdict
+import json
+
+from kx.state import StateServiceProtocol
+
+
+class BackCommand:
+    def __init__(self, state: StateServiceProtocol):
+        self.state = state
+
+    def execute(self) -> str:
+        state = self.state.navigate(-1)
+        return json.dumps(asdict(state), indent=2)

{kx_cli-0.0.4 → kx_cli-0.0.6}/src/kx/commands/describe.py

@@ -11,7 +11,8 @@ class DescribeCommand:
         self.state = state
         self.kubectl = kubectl
 
-    def execute(self, index: int, extra_args: list[str] = []) -> None:
+    def execute(self, index: int, extra_args: list[str] | None = None) -> None:
+        extra_args = extra_args or []
         name, namespace, kind = self.state.fields(index)
         self.kubectl.run_interactive(
             ["describe", kind, name, "-n", namespace, *extra_args]

kx_cli-0.0.6/src/kx/commands/diagnostic.py

@@ -0,0 +1,195 @@
+from kx.diagnostics import (
+    ContainerDiagnostic,
+    DiagnosticData,
+    DiagnosticReport,
+    DiagnosticsServiceProtocol,
+    Finding,
+    PodDiagnostic,
+    ReplicaHealth,
+    Severity,
+)
+from kx.kinds import Kind
+from kx.state import StateServiceProtocol
+
+_SUPPORTED_KINDS = {Kind.Deployment, Kind.StatefulSet, Kind.DaemonSet, Kind.Pod}
+_RESTART_WARN_THRESHOLD = 5
+
+_IMAGE_PULL_REASONS = {"ImagePullBackOff", "ErrImagePull", "InvalidImageName"}
+_CONFIG_ERROR_REASONS = {"CreateContainerConfigError", "CreateContainerError"}
+
+
+class DiagnosticCommand:
+    def __init__(
+        self,
+        state: StateServiceProtocol,
+        diagnostics: DiagnosticsServiceProtocol,
+    ):
+        self.state = state
+        self.diagnostics = diagnostics
+
+    def execute(self, index: int) -> DiagnosticReport:
+        name, namespace, kind = self.state.fields(index)
+        if kind not in _SUPPORTED_KINDS:
+            raise ValueError(f"diagnostic is not supported for '{kind}'.")
+        return build_report(self.diagnostics.gather(kind, name, namespace))
+
+
+def build_report(data: DiagnosticData) -> DiagnosticReport:
+    findings: list[Finding] = []
+
+    if data.replicas is not None:
+        findings.extend(_replica_findings(data.replicas))
+    for pod in data.pods:
+        findings.extend(_pod_findings(pod))
+    findings.extend(_event_findings(data.warning_events))
+
+    # Prioritize: highest severity first, stable within a severity.
+    findings.sort(key=lambda f: f.severity, reverse=True)
+    verdict = max((f.severity for f in findings), default=Severity.OK)
+
+    return DiagnosticReport(
+        kind=data.kind,
+        name=data.name,
+        namespace=data.namespace,
+        verdict=verdict,
+        findings=findings,
+        pods=data.pods,
+        warning_events=data.warning_events,
+    )
+
+
+def _replica_findings(replicas: ReplicaHealth) -> list[Finding]:
+    findings: list[Finding] = []
+    gen = replicas.generation
+    observed = replicas.observed_generation
+    if gen is not None and observed is not None and observed < gen:
+        findings.append(
+            Finding(
+                Severity.CRITICAL,
+                f"Rollout stalled: observed generation {observed} behind spec generation {gen}",
+            )
+        )
+    if replicas.ready < replicas.desired:
+        severity = (
+            Severity.CRITICAL
+            if replicas.ready == 0 and replicas.desired > 0
+            else Severity.WARNING
+        )
+        findings.append(
+            Finding(
+                severity,
+                f"Only {replicas.ready}/{replicas.desired} replicas ready",
+            )
+        )
+    if replicas.available < replicas.desired:
+        findings.append(
+            Finding(
+                Severity.WARNING,
+                f"{replicas.available}/{replicas.desired} replicas available",
+            )
+        )
+    if replicas.updated < replicas.desired:
+        findings.append(
+            Finding(
+                Severity.WARNING,
+                f"Rollout in progress: {replicas.updated}/{replicas.desired} replicas updated",
+            )
+        )
+    return findings
+
+
+def _pod_findings(pod: PodDiagnostic) -> list[Finding]:
+    findings: list[Finding] = []
+
+    for container in pod.containers:
+        findings.extend(_container_findings(pod.name, container))
+
+    if pod.phase == "Pending" and not pod.scheduling.schedulable:
+        detail = pod.scheduling.message or pod.scheduling.reason or "unschedulable"
+        findings.append(
+            Finding(Severity.CRITICAL, f"Pod {pod.name} unschedulable: {detail}")
+        )
+    elif pod.phase == "Pending":
+        findings.append(Finding(Severity.WARNING, f"Pod {pod.name} pending"))
+    elif pod.phase == "Failed":
+        findings.append(Finding(Severity.CRITICAL, f"Pod {pod.name} failed"))
+    elif (
+        pod.phase == "Running"
+        and pod.ready_containers < pod.total_containers
+        and not any(c.waiting_reason for c in pod.containers)
+    ):
+        findings.append(
+            Finding(
+                Severity.WARNING,
+                f"Pod {pod.name}: {pod.ready_containers}/{pod.total_containers} containers ready",
+            )
+        )
+    return findings
+
+
+def _container_findings(pod_name: str, container: ContainerDiagnostic) -> list[Finding]:
+    findings: list[Finding] = []
+    reason = container.waiting_reason
+
+    if reason == "CrashLoopBackOff":
+        findings.append(
+            Finding(
+                Severity.CRITICAL,
+                f"CrashLoopBackOff in pod {pod_name} ({container.restart_count} restarts)",
+            )
+        )
+    elif reason in _IMAGE_PULL_REASONS:
+        findings.append(
+            Finding(
+                Severity.CRITICAL,
+                f"Image pull failure ({reason}) in pod {pod_name}",
+            )
+        )
+    elif reason in _CONFIG_ERROR_REASONS:
+        detail = container.waiting_message or reason
+        findings.append(
+            Finding(
+                Severity.CRITICAL,
+                f"Container config error in pod {pod_name}: {detail}",
+            )
+        )
+    elif reason is not None:
+        findings.append(
+            Finding(
+                Severity.WARNING,
+                f"Container {container.name} in pod {pod_name} waiting: {reason}",
+            )
+        )
+
+    if "OOMKilled" in (container.terminated_reason, container.last_terminated_reason):
+        findings.append(Finding(Severity.CRITICAL, f"OOMKilled in pod {pod_name}"))
+    elif container.terminated_reason not in (None, "Completed") and container.exit_code:
+        findings.append(
+            Finding(
+                Severity.CRITICAL,
+                f"Container {container.name} in pod {pod_name} terminated: "
+                f"{container.terminated_reason} (exit {container.exit_code})",
+            )
+        )
+
+    if reason is None and container.restart_count >= _RESTART_WARN_THRESHOLD:
+        findings.append(
+            Finding(
+                Severity.WARNING,
+                f"Container {container.name} in pod {pod_name} "
+                f"restarted {container.restart_count} times",
+            )
+        )
+    return findings
+
+
+def _event_findings(events) -> list[Finding]:
+    # The message is deliberately omitted: the WARNING EVENTS section renders it
+    # in full, so repeating it here only bloats the summary.
+    return [
+        Finding(
+            Severity.WARNING,
+            f"{event.reason} ×{event.count} on {event.kind}/{event.name}",
+        )
+        for event in events
+    ]

kx_cli-0.0.6/src/kx/commands/drop.py

@@ -0,0 +1,9 @@
+from kx.state import StateHistory, StateServiceProtocol
+
+
+class DropCommand:
+    def __init__(self, state: StateServiceProtocol):
+        self.state = state
+
+    def execute(self, position: int) -> StateHistory:
+        return self.state.drop(position)

{kx_cli-0.0.4 → kx_cli-0.0.6}/src/kx/commands/edit.py

@@ -7,6 +7,7 @@ class EditCommand:
         self.state = state
         self.kubectl = kubectl
 
-    def execute(self, index: int, extra_args: list[str] = []) -> None:
+    def execute(self, index: int, extra_args: list[str] | None = None) -> None:
+        extra_args = extra_args or []
         name, namespace, kind = self.state.fields(index)
         self.kubectl.run_interactive(["edit", kind, name, "-n", namespace, *extra_args])

{kx_cli-0.0.4 → kx_cli-0.0.6}/src/kx/commands/exec.py

@@ -4,17 +4,22 @@ from kx.kinds import Kind
 from kx.kubectl import KubectlServiceProtocol
 from kx.state import StateServiceProtocol
 
-_SHELLS = ["bash", "sh"]
-
 
 class ExecCommand:
-    def __init__(self, state: StateServiceProtocol, kubectl: KubectlServiceProtocol):
+    def __init__(
+        self,
+        state: StateServiceProtocol,
+        kubectl: KubectlServiceProtocol,
+        shells: tuple[str, ...] = ("bash", "sh"),
+    ):
         self.state = state
         self.kubectl = kubectl
+        self.shells = shells
 
     def execute(
-        self, index: int, cmd: list[str] | None, extra_args: list[str] = []
+        self, index: int, cmd: list[str] | None, extra_args: list[str] | None = None
     ) -> None:
+        extra_args = extra_args or []
         name, namespace, kind = self.state.fields(index)
         if kind != Kind.Pod:
             raise ValueError("exec is only supported for pods.")
@@ -26,7 +31,7 @@ class ExecCommand:
             if rc != 0:
                 raise ValueError(f"Command failed in container (exit {rc}).")
         else:
-            for shell in _SHELLS:
+            for shell in self.shells:
                 probe_rc = self.kubectl.probe(
                     [
                         "exec",

kx_cli-0.0.6/src/kx/commands/forward.py

@@ -0,0 +1,13 @@
+from dataclasses import asdict
+import json
+
+from kx.state import StateServiceProtocol
+
+
+class ForwardCommand:
+    def __init__(self, state: StateServiceProtocol):
+        self.state = state
+
+    def execute(self) -> str:
+        state = self.state.navigate(+1)
+        return json.dumps(asdict(state), indent=2)

{kx_cli-0.0.4 → kx_cli-0.0.6}/src/kx/commands/get.py

@@ -28,8 +28,9 @@ class GetCommand:
         self,
         resource: str,
         filter_term: str | None = None,
-        extra_args: list[str] = [],
+        extra_args: list[str] | None = None,
     ) -> str:
+        extra_args = extra_args or []
         output = self.kubectl.run(["get", resource, *extra_args])
         if filter_term:
             output = self.index.filter(output, filter_term)

{kx_cli-0.0.4 → kx_cli-0.0.6}/src/kx/commands/logs.py

@@ -12,7 +12,8 @@ class LogsCommand:
         self.state = state
         self.kubectl = kubectl
 
-    def execute(self, index: int, extra_args: list[str] = []) -> None:
+    def execute(self, index: int, extra_args: list[str] | None = None) -> None:
+        extra_args = extra_args or []
         name, namespace, kind = self.state.fields(index)
         if kind == Kind.Pod:
             self.kubectl.run_interactive(["logs", name, "-n", namespace, *extra_args])