ktui 0.1.0__tar.gz

ktui-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run interaction tests
+        run: python test_interaction.py
+
+      - name: Run full suite
+        run: python test_full_suite.py

ktui-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,205 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+permissions:
+  contents: write   # to create GitHub Release + upload assets
+
+jobs:
+  # ─────────────────────────────────────────────────────────────────────────────
+  # 1. Run tests before doing anything
+  # ─────────────────────────────────────────────────────────────────────────────
+  test:
+    name: Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - run: pip install -e ".[dev]"
+      - run: python test_interaction.py
+      - run: python test_full_suite.py
+
+  # ─────────────────────────────────────────────────────────────────────────────
+  # 2. Build a self-contained binary on each platform
+  # ─────────────────────────────────────────────────────────────────────────────
+  build:
+    name: Build — ${{ matrix.target }}
+    needs: test
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: linux-x64
+            bin: ktui
+
+
+          - os: macos-latest      # Apple Silicon (M1)
+            target: darwin-arm64
+            bin: ktui
+
+          - os: windows-latest
+            target: win32-x64
+            bin: ktui.exe
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install dependencies + PyInstaller
+        run: |
+          pip install -e .
+          pip install pyinstaller
+
+      - name: Build binary
+        run: |
+          pyinstaller ktui.spec --distpath dist --workpath build/pyinstaller --clean -y
+
+      - name: Upload binary artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ktui-${{ matrix.target }}
+          path: dist/${{ matrix.bin }}
+          if-no-files-found: error
+          retention-days: 1
+
+  # ─────────────────────────────────────────────────────────────────────────────
+  # 3. Create GitHub Release and attach all binaries
+  # ─────────────────────────────────────────────────────────────────────────────
+  github-release:
+    name: GitHub Release
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download all binaries
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts/
+
+      - name: Rename binaries for release assets
+        run: |
+          mkdir -p release
+          cp artifacts/ktui-linux-x64/ktui      release/ktui-linux-x64
+          cp artifacts/ktui-darwin-arm64/ktui    release/ktui-darwin-arm64
+          cp artifacts/ktui-win32-x64/ktui.exe   release/ktui-win32-x64.exe
+          chmod +x release/ktui-linux-x64 release/ktui-darwin-arm64
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: release/*
+
+  # ─────────────────────────────────────────────────────────────────────────────
+  # 4. Publish to npm
+  # ─────────────────────────────────────────────────────────────────────────────
+  npm-publish:
+    name: Publish to npm
+    needs: build
+    runs-on: ubuntu-latest
+    env:
+      NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Download all binaries
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts/
+
+      - name: Stage binaries into npm platform packages
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"   # strip leading "v" from tag
+
+          stage() {
+            local target="$1" bin="$2"
+            local pkg_dir="npm-package/npm/ktui-${target}"
+            mkdir -p "${pkg_dir}/bin"
+            cp "artifacts/ktui-${target}/${bin}" "${pkg_dir}/bin/${bin}"
+            chmod +x "${pkg_dir}/bin/${bin}" 2>/dev/null || true
+            # Stamp version into the sub-package
+            node -e "
+              const fs = require('fs');
+              const p = '${pkg_dir}/package.json';
+              const j = JSON.parse(fs.readFileSync(p));
+              j.version = '${VERSION}';
+              fs.writeFileSync(p, JSON.stringify(j, null, 2) + '\n');
+            "
+          }
+
+          stage linux-x64   ktui
+          stage darwin-arm64 ktui
+          stage win32-x64   ktui.exe
+
+          # Stamp version into main package and optionalDependencies
+          node -e "
+            const fs = require('fs');
+            const p = 'npm-package/package.json';
+            const j = JSON.parse(fs.readFileSync(p));
+            j.version = '${VERSION}';
+            for (const k of Object.keys(j.optionalDependencies)) {
+              j.optionalDependencies[k] = '${VERSION}';
+            }
+            fs.writeFileSync(p, JSON.stringify(j, null, 2) + '\n');
+          "
+
+      - name: Publish platform packages
+        run: |
+          for pkg in npm-package/npm/ktui-*/; do
+            echo "Publishing $pkg …"
+            cd "$pkg"
+            npm publish --access public
+            cd "$GITHUB_WORKSPACE"
+          done
+
+      - name: Publish main package
+        run: |
+          cd npm-package
+          npm publish --access public
+
+  # ─────────────────────────────────────────────────────────────────────────────
+  # 5. Publish to PyPI
+  # ─────────────────────────────────────────────────────────────────────────────
+  pypi-publish:
+    name: Publish to PyPI
+    needs: test
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # required for OIDC PyPI publishing
+    
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install build tool
+        run: pip install build
+
+      - name: Build sdist and wheel
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

ktui-0.1.0/.gitignore

@@ -0,0 +1,40 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+*.egg
+
+# PyInstaller build artifacts
+build/pyinstaller/
+
+# npm binary artifacts (built by CI, not committed)
+npm-package/npm/*/bin/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test scratch files
+test_debug*.py
+test_add_field*.py
+test_merge*.py
+test_tree.py
+test_quit.py
+dom.txt
+output.yaml

ktui-0.1.0/LICENSE

@@ -0,0 +1,131 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.

ktui-0.1.0/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.5
+Name: ktui
+Version: 0.1.0
+Summary: ktui — an interactive Kubernetes TUI manifest builder
+License: # PolyForm Noncommercial License 1.0.0
+        
+        <https://polyformproject.org/licenses/noncommercial/1.0.0>
+        
+        ## Acceptance
+        
+        In order to get any license under these terms, you must agree
+        to them as both strict obligations and conditions to all
+        your licenses.
+        
+        ## Copyright License
+        
+        The licensor grants you a copyright license for the
+        software to do everything you might do with the software
+        that would otherwise infringe the licensor's copyright
+        in it for any permitted purpose.  However, you may
+        only distribute the software according to [Distribution
+        License](#distribution-license) and make changes or new works
+        based on the software according to [Changes and New Works
+        License](#changes-and-new-works-license).
+        
+        ## Distribution License
+        
+        The licensor grants you an additional copyright license
+        to distribute copies of the software.  Your license
+        to distribute covers distributing the software with
+        changes and new works permitted by [Changes and New Works
+        License](#changes-and-new-works-license).
+        
+        ## Notices
+        
+        You must ensure that anyone who gets a copy of any part of
+        the software from you also gets a copy of these terms or the
+        URL for them above, as well as copies of any plain-text lines
+        beginning with `Required Notice:` that the licensor provided
+        with the software.  For example:
+        
+        > Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+        
+        ## Changes and New Works License
+        
+        The licensor grants you an additional copyright license to
+        make changes and new works based on the software for any
+        permitted purpose.
+        
+        ## Patent License
+        
+        The licensor grants you a patent license for the software that
+        covers patent claims the licensor can license, or becomes able
+        to license, that you would infringe by using the software.
+        
+        ## Noncommercial Purposes
+        
+        Any noncommercial purpose is a permitted purpose.
+        
+        ## Personal Uses
+        
+        Personal use for research, experiment, and testing for
+        the benefit of public knowledge, personal study, private
+        entertainment, hobby projects, amateur pursuits, or religious
+        observance, without any anticipated commercial application,
+        is use for a permitted purpose.
+        
+        ## Noncommercial Organizations
+        
+        Use by any charitable organization, educational institution,
+        public research organization, public safety or health
+        organization, environmental protection organization,
+        or government institution is use for a permitted purpose
+        regardless of the source of funding or obligations resulting
+        from the funding.
+        
+        ## Fair Use
+        
+        You may have "fair use" rights for the software under the
+        law. These terms do not limit them.
+        
+        ## No Other Rights
+        
+        These terms do not allow you to sublicense or transfer any of
+        your licenses to anyone else, or prevent the licensor from
+        granting licenses to anyone else.  These terms do not imply
+        any other licenses.
+        
+        ## Patent Defense
+        
+        If you make any written claim that the software infringes or
+        contributes to infringement of any patent, your patent license
+        for the software granted under these terms ends immediately. If
+        your company makes such a claim, your patent license ends
+        immediately for work on behalf of your company.
+        
+        ## Violations
+        
+        The first time you are notified in writing that you have
+        violated any of these terms, or done anything with the software
+        not covered by your licenses, your licenses can nonetheless
+        continue if you come into full compliance with these terms,
+        and take practical steps to correct past violations, within
+        32 days of receiving notice.  Otherwise, all your licenses
+        end immediately.
+        
+        ## No Liability
+        
+        ***As far as the law allows, the software comes as is, without
+        any warranty or condition, and the licensor will not be liable
+        to you for any damages arising out of these terms or the use
+        or nature of the software, under any kind of legal claim.***
+        
+        ## Definitions
+        
+        The **licensor** is the individual or entity offering these
+        terms, and the **software** is the software the licensor makes
+        available under these terms.
+        
+        **You** refers to the individual or entity agreeing to these
+        terms.
+        
+        **Your company** is any legal entity, sole proprietorship,
+        or other kind of organization that you work for, plus all
+        organizations that have control over, are under the control of,
+        or are under common control with that organization.  **Control**
+        means ownership of substantially all the assets of an entity,
+        or the power to direct its management and policies by vote,
+        contract, or otherwise.  Control can be direct or indirect.
+        
+        **Your licenses** are all the licenses granted to you for the
+        software under these terms.
+        
+        **Use** means anything you do with the software requiring one
+        of your licenses.
+License-File: LICENSE
+Keywords: cli,k8s,kubernetes,terminal,tui,yaml
+Requires-Python: >=3.12
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: ruamel-yaml>=0.18.0
+Requires-Dist: textual>=0.80.0
+Provides-Extra: dev
+Requires-Dist: pyinstaller>=6.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# ktui
+
+> An interactive terminal UI for building Kubernetes YAML manifests — schema-driven forms, field picker, and live preview.
+
+---
+
+## What it does
+
+`ktui` is a terminal application that lets you interactively build Kubernetes resource manifests without memorising YAML structure. Pick a resource type, fill in only the fields you need, add optional fields through a searchable picker, and preview or save the generated YAML — all from your terminal.
+
+**Key features:**
+- Schema-driven forms for common Kubernetes resources (Deployment, Service, ConfigMap, RBAC, …)
+- Searchable field picker with grouped categories — select individual fields or entire groups at once
+- Added fields are intelligently merged into the correct section (no duplicate categories)
+- Live YAML preview
+- Theme switching (`t` to cycle)
+- Clean keyboard-first navigation
+
+---
+
+## Requirements
+
+- Python ≥ 3.12
+- A terminal with UTF-8 support (minimum 80×24)
+- Truecolor recommended but not required
+
+---
+
+## Installation
+
+```bash
+# From source (development)
+git clone <repo-url>
+cd ktui
+python -m venv .venv && source .venv/bin/activate
+pip install -e .
+
+# Run
+ktui
+```
+
+---
+
+## Keybindings
+
+| Key | Action |
+|-----|--------|
+| `↑ / ↓` | Navigate list |
+| `Enter` | Select resource / confirm |
+| `p` | Preview YAML |
+| `Ctrl+S` | Save YAML |
+| `t` | Cycle theme |
+| `Esc` | Close modal / go back |
+| `q` | Quit |
+
+**Inside Field Picker:**
+
+| Key | Action |
+|-----|--------|
+| `↑ / ↓` | Navigate fields |
+| `Enter` on leaf | Toggle field selection |
+| `Enter` on 📁 group | Select / deselect all fields in group |
+| `Esc` | Cancel without adding |
+
+---
+
+## Status
+
+Early development — schemas and features are actively expanding.
+
+---
+
+## License
+
+[PolyForm Noncommercial License 1.0.0](LICENSE)

ktui-0.1.0/README.md

@@ -0,0 +1,75 @@
+# ktui
+
+> An interactive terminal UI for building Kubernetes YAML manifests — schema-driven forms, field picker, and live preview.
+
+---
+
+## What it does
+
+`ktui` is a terminal application that lets you interactively build Kubernetes resource manifests without memorising YAML structure. Pick a resource type, fill in only the fields you need, add optional fields through a searchable picker, and preview or save the generated YAML — all from your terminal.
+
+**Key features:**
+- Schema-driven forms for common Kubernetes resources (Deployment, Service, ConfigMap, RBAC, …)
+- Searchable field picker with grouped categories — select individual fields or entire groups at once
+- Added fields are intelligently merged into the correct section (no duplicate categories)
+- Live YAML preview
+- Theme switching (`t` to cycle)
+- Clean keyboard-first navigation
+
+---
+
+## Requirements
+
+- Python ≥ 3.12
+- A terminal with UTF-8 support (minimum 80×24)
+- Truecolor recommended but not required
+
+---
+
+## Installation
+
+```bash
+# From source (development)
+git clone <repo-url>
+cd ktui
+python -m venv .venv && source .venv/bin/activate
+pip install -e .
+
+# Run
+ktui
+```
+
+---
+
+## Keybindings
+
+| Key | Action |
+|-----|--------|
+| `↑ / ↓` | Navigate list |
+| `Enter` | Select resource / confirm |
+| `p` | Preview YAML |
+| `Ctrl+S` | Save YAML |
+| `t` | Cycle theme |
+| `Esc` | Close modal / go back |
+| `q` | Quit |
+
+**Inside Field Picker:**
+
+| Key | Action |
+|-----|--------|
+| `↑ / ↓` | Navigate fields |
+| `Enter` on leaf | Toggle field selection |
+| `Enter` on 📁 group | Select / deselect all fields in group |
+| `Esc` | Cancel without adding |
+
+---
+
+## Status
+
+Early development — schemas and features are actively expanding.
+
+---
+
+## License
+
+[PolyForm Noncommercial License 1.0.0](LICENSE)