base-cli 0.4.2__tar.gz → 0.5.0__tar.gz

base_cli-0.5.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,50 @@
+name: Bug report
+description: Report a reproducible base-cli defect
+title: "bug: "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Do not include secrets, personal data, or vulnerability details. Use SECURITY.md for private reports.
+  - type: input
+    id: version
+    attributes:
+      label: Version or commit
+      description: Include the installed release, package revision, or commit.
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: Include Python, Click/Typer, OS, architecture, and relevant extras.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction
+      description: Give the smallest command, fixture, or test that reproduces the problem.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+      render: text
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant logs
+      description: Redact credentials, tokens, personal data, and private paths.
+      render: text

base_cli-0.5.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Support and adoption questions
+    url: https://github.com/orgs/basefoundry/discussions
+    about: Ask ecosystem-wide usage and onboarding questions in the canonical public forum.
+  - name: Private security report
+    url: https://github.com/basefoundry/base-cli/security/advisories/new
+    about: Never disclose vulnerabilities or sensitive data in a public issue.

base_cli-0.5.0/.github/ISSUE_TEMPLATE/documentation.yml

@@ -0,0 +1,25 @@
+name: Documentation improvement
+description: Report missing, incorrect, or confusing base-cli documentation
+title: "docs: "
+labels:
+  - documentation
+body:
+  - type: input
+    id: location
+    attributes:
+      label: Documentation location
+      description: Give the URL or repository path.
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: Explain what a reader cannot understand or do.
+    validations:
+      required: true
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: Suggested improvement
+      description: Describe the corrected or clearer outcome.

base_cli-0.5.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,25 @@
+name: Feature proposal
+description: Propose a user-facing base-cli capability or improvement
+title: "feature: "
+labels:
+  - enhancement
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: User problem
+      description: Who is affected, and what are they unable to do today?
+    validations:
+      required: true
+  - type: textarea
+    id: outcome
+    attributes:
+      label: Desired outcome
+      description: Describe what success looks like without requiring a particular implementation.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives and context
+      description: Include workarounds, constraints, or compatibility concerns.

base_cli-0.5.0/.github/ISSUE_TEMPLATE/support.md

@@ -0,0 +1,12 @@
+---
+name: Adoption support
+about: Request migration or downstream compatibility help
+title: "[Support] "
+labels: ""
+assignees: ""
+---
+
+Use the Support and adoption question form when it is available. Include the
+base-cli version, Python and operating-system versions, a minimal
+reproduction, and redacted evidence. Never include secrets; use SECURITY.md
+for private vulnerability reports.

base_cli-0.5.0/.github/ISSUE_TEMPLATE/support.yml

@@ -0,0 +1,30 @@
+name: Support and adoption question
+description: Ask for help using or evaluating base-cli
+title: "support: "
+labels:
+  - adoption support
+body:
+  - type: markdown
+    attributes:
+      value: |
+        For general ecosystem questions, prefer Base Discussions. Do not include secrets or security-sensitive details here.
+  - type: input
+    id: version
+    attributes:
+      label: Version or commit
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Include Python, Click/Typer, OS, architecture, and relevant extras.
+    validations:
+      required: true
+  - type: textarea
+    id: goal
+    attributes:
+      label: Goal and evidence
+      description: What are you trying to do, what did you try, and what happened?
+    validations:
+      required: true

base_cli-0.5.0/.github/workflows/compatibility.yml

@@ -0,0 +1,110 @@
+name: Reference consumers
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  typer-matrix:
+    name: Typer ${{ matrix.typer-version }} / Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        typer-version: ["0.25.1", "0.26.0", "0.27.1", "0.27.2"]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install framework and exact Typer line
+        run: |
+          python -m pip install "setuptools<77" "wheel"
+          python -m pip install ".[dev]"
+          python -m pip install --upgrade "typer==${{ matrix.typer-version }}"
+      - name: Install Beacon fixture without dependency resolution
+        run: python -m pip install --no-deps compatibility/consumers/beacon_typer
+      - name: Run adapter and Beacon compatibility tests
+        run: python -m pytest tests/test_typer_adapter.py compatibility/consumers/beacon_typer/tests
+
+  typer-click-boundaries:
+    name: Typer ${{ matrix.typer-version }} / Click ${{ matrix.click-version }} / Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.14"]
+        typer-version: ["0.25.1", "0.27.2"]
+        click-version: ["8.2.1", "8.5.0"]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install framework and supported Typer adapter
+        run: |
+          python -m pip install "setuptools<77" "wheel"
+          python -m pip install ".[dev,typer]"
+      - name: Pin the tested Click/Typer boundary pair
+        run: python -m pip install --upgrade "click==${{ matrix.click-version }}" "typer==${{ matrix.typer-version }}"
+      - name: Install Beacon fixture without dependency resolution
+        run: python -m pip install --no-deps compatibility/consumers/beacon_typer
+      - name: Run adapter and Beacon compatibility tests
+        run: python -m pytest tests/test_typer_adapter.py compatibility/consumers/beacon_typer/tests
+
+  downstream:
+    name: Install and test independent consumers
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.13"
+      - name: Install framework build and test dependencies
+        run: python -m pip install ".[dev,typer,rich,telemetry]"
+      - name: Build and install the framework wheel
+        run: |
+          python -m build --wheel
+          python -m pip uninstall --yes base-cli
+          python -m pip install dist/*.whl
+      - name: Validate consumer manifest
+        run: python scripts/validate_consumers.py
+      - name: Install consumers without dependency resolution
+        run: |
+          python -m pip install --no-deps compatibility/consumers/atlas_click
+          python -m pip install --no-deps compatibility/consumers/beacon_typer
+          python -m pip install --no-deps "compatibility/consumers/cinder_automation[observability]"
+      - name: Verify the installed framework matches the source release
+        run: |
+          expected="$(tr -d '\r\n' < VERSION)"
+          actual="$(python -c 'from importlib.metadata import version; print(version("base-cli"))')"
+          test "$actual" = "$expected"
+          python -m pip check
+      - name: Run downstream compatibility suites
+        run: |
+          for tests in compatibility/consumers/*/tests; do
+            python -m pytest "$tests"
+          done
+      - name: Record dated compatibility evidence
+        run: python scripts/record_compatibility_evidence.py > compatibility-evidence.json
+      - name: Upload compatibility evidence
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: base-cli-compatibility-evidence-${{ github.run_id }}
+          path: compatibility-evidence.json
+          if-no-files-found: error
+          retention-days: 90

base_cli-0.5.0/.github/workflows/dependency-matrix.yml

@@ -0,0 +1,48 @@
+name: Dependency compatibility
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  core:
+    name: Click ${{ matrix.click-version }} / PyYAML ${{ matrix.pyyaml-version }} / Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.14"]
+        click-version: ["8.1.*", "8.2.*", "8.3.*", "8.4.*", "8.5.*"]
+        pyyaml-version: ["6.0.*"]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install framework and test dependencies
+        run: python -m pip install "setuptools<77" "wheel" ".[dev]"
+      - name: Select tested core dependency lines
+        run: |
+          python -m pip install --upgrade --force-reinstall \
+            "click==${{ matrix.click-version }}" \
+            "PyYAML==${{ matrix.pyyaml-version }}"
+      - name: Verify resolved dependency contract
+        run: |
+          python - <<'PY'
+          from importlib.metadata import version
+
+          click_version = version("click")
+          yaml_version = version("PyYAML")
+          print(f"Click {click_version}; PyYAML {yaml_version}")
+          PY
+      - name: Run core suite
+        run: python -m pytest

{base_cli-0.4.2 → base_cli-0.5.0}/.github/workflows/docs.yml

@@ -11,7 +11,19 @@ on:
       - "mkdocs.yml"
       - "pyproject.toml"
       - "scripts/validate_docs.py"
+      - "scripts/validate_changelog.py"
+      - "scripts/generate_compatibility_dashboard.py"
+      - ".github/workflows/tests.yml"
+      - ".github/workflows/dependency-matrix.yml"
+      - ".github/workflows/compatibility.yml"
+      - "scripts/generate_api_reference.py"
+      - "scripts/generate_compatibility_dashboard.py"
+      - ".github/workflows/tests.yml"
+      - ".github/workflows/dependency-matrix.yml"
+      - ".github/workflows/compatibility.yml"
       - "tests/validate.sh"
+      - "tests/full_validate.sh"
+      - "docs/testing.md"
       - ".github/workflows/docs.yml"
   pull_request:
     paths:
@@ -21,7 +33,10 @@ on:
       - "mkdocs.yml"
       - "pyproject.toml"
       - "scripts/validate_docs.py"
+      - "scripts/generate_api_reference.py"
       - "tests/validate.sh"
+      - "tests/full_validate.sh"
+      - "docs/testing.md"
       - ".github/workflows/docs.yml"
   workflow_dispatch:
 
@@ -40,6 +55,8 @@ jobs:
     steps:
       - name: Check out source
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
 
       - name: Set up Python
         uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
@@ -50,7 +67,13 @@ jobs:
         run: python -m pip install ".[docs]"
 
       - name: Validate repository links and examples
-        run: python scripts/validate_docs.py
+        run: |
+          python scripts/validate_docs.py
+          python scripts/validate_changelog.py
+          python scripts/generate_compatibility_dashboard.py --check
+
+      - name: Validate generated public API reference
+        run: python scripts/generate_api_reference.py --check
 
       - name: Build documentation with strict warnings
         run: python -m mkdocs build --strict --site-dir site