vantage-cli 0.1.1__tar.gz

vantage_cli-0.1.1/.commitlintrc.yml

@@ -0,0 +1,2 @@
+extends:
+  - '@commitlint/config-conventional'

vantage_cli-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: Vantage CLI Code Quality Checks
+on:
+  workflow_call:
+  pull_request:
+    branches:
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  commitlint:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    if: github.event_name == 'pull_request'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Setup node
+        uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+      - name: Install commitlint
+        run: npm install -D @commitlint/cli @commitlint/config-conventional
+      - name: Validate PR commits with commitlint
+        run: npx commitlint --from ${{ github.event.pull_request.base.sha }} --to ${{ github.event.pull_request.head.sha }} --verbose
+
+  ci-tests:
+    name: CI-Tests
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Install `just`
+        run: sudo snap install just --classic
+      - name: Install `uv`
+        run: sudo snap install astral-uv --classic
+      - name: Run lint checks
+        run: just lint
+      - name: Run type checks
+        run: just typecheck
+      - name: Run unit tests
+        run: just unit
+      - name: Run integration tests
+        run: just integration

vantage_cli-0.1.1/.github/workflows/pages.yml

@@ -0,0 +1,51 @@
+# Sample workflow for building and deploying a Jekyll site to GitHub Pages
+name: Deploy Jekyll with GitHub Pages dependencies preinstalled
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./docs
+          destination: ./_site
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

vantage_cli-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,205 @@
+# Copyright (c) 2025 Vantage Compute Corporation.
+name: Build and Release
+
+on:
+  push:
+    tags:
+      - "[0-9]+.[0-9]+.[0-9]+"
+      - "[0-9]+.[0-9]+.[0-9]+-alpha.[0-9]+"
+      - "[0-9]+.[0-9]+.[0-9]+-beta.[0-9]+"
+      - "[0-9]+.[0-9]+.[0-9]+a[0-9]+"
+      - "[0-9]+.[0-9]+.[0-9]+b[0-9]+"
+      - "[0-9]+.[0-9]+.[0-9]+rc[0-9]+"
+  workflow_dispatch:  # Allow manual triggering
+
+permissions:
+  contents: write  # Required for creating releases
+  id-token: write  # Required for PyPI trusted publishing
+
+jobs:
+  build:
+    name: Build Distribution
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0  # Fetch full history for proper version detection
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+    
+    - name: Install system dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y build-essential
+        sudo snap install astral-uv --classic
+
+    
+    - name: Install git-cliff
+      run: |
+        curl -L https://github.com/orhun/git-cliff/releases/download/v2.10.0/git-cliff-2.10.0-x86_64-unknown-linux-gnu.tar.gz | tar xz
+        sudo mv git-cliff-*/git-cliff /usr/local/bin/
+        git-cliff --version
+    
+    - name: Build Python package
+      run: |
+        uv build
+    
+    - name: Check build artifacts
+      run: |
+        ls -la dist/
+        # Basic validation - ensure files exist
+        test -n "$(find dist -name '*.whl')" || (echo "No wheel files found" && exit 1)
+        test -n "$(find dist -name '*.tar.gz')" || (echo "No source distribution found" && exit 1)
+
+    - name: Upload build artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: distribution-files
+        path: dist/
+        retention-days: 7
+
+  test-install:
+    name: Test Installation
+    needs: build
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.12', '3.13']
+    
+    steps:
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Download build artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: distribution-files
+        path: dist/
+    
+    - name: Test wheel installation
+      run: |
+        sudo snap install astral-uv --classic
+        uv venv
+        uv pip install dist/*.whl
+        uv run python3 -c "import vantage_cli; print('Package imported successfully')"
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: [build, test-install]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/vantage-cli
+
+    steps:
+    - name: Download build artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: distribution-files
+        path: dist/
+    
+    - name: Publish to PyPI
+      run: |
+        sudo snap install astral-uv --classic
+        uv publish
+
+  create-release:
+    name: Create GitHub Release
+    needs: [build, test-install]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+    
+    - name: Download build artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: distribution-files
+        path: dist/
+
+    - name: Extract version from tag
+      id: get_version
+      run: |
+        VERSION=${GITHUB_REF#refs/tags/}
+        echo "version=$VERSION" >> $GITHUB_OUTPUT
+        echo "tag=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
+    
+    - name: Generate release notes
+      id: release_notes
+      run: |
+        # Extract release notes from CHANGELOG.md if it exists
+        if [ -f "CHANGELOG.md" ]; then
+          # Try to extract notes for this version using git-cliff for consistency
+          VERSION="${{ steps.get_version.outputs.version }}"
+          
+          # Use git-cliff to generate notes for this specific version
+          git-cliff --latest --strip header --strip footer > release_notes.txt || true
+          
+          # If that fails, fall back to grep method
+          if [ ! -s release_notes.txt ]; then
+            grep -A 1000 "^## .*${VERSION}" CHANGELOG.md | grep -B 1000 -m 2 "^## " | head -n -1 | tail -n +2 > release_notes.txt || true
+          fi
+          
+          # If no specific version notes found, create generic notes
+          if [ ! -s release_notes.txt ]; then
+            echo "Release ${{ steps.get_version.outputs.tag }}" > release_notes.txt
+            echo "" >> release_notes.txt
+            echo "### Changes" >> release_notes.txt
+            echo "- See CHANGELOG.md for detailed changes" >> release_notes.txt
+          fi
+        else
+          echo "Release ${{ steps.get_version.outputs.tag }}" > release_notes.txt
+          echo "" >> release_notes.txt
+          echo "### Files" >> release_notes.txt
+          echo "- Source distribution (tar.gz)" >> release_notes.txt
+          echo "- Wheel distribution (.whl)" >> release_notes.txt
+        fi
+        
+        echo "Release notes:"
+        cat release_notes.txt
+    
+    - name: Create Release
+      uses: softprops/action-gh-release@v1
+      with:
+        name: Release ${{ steps.get_version.outputs.tag }}
+        body_path: release_notes.txt
+        files: |
+          dist/*.tar.gz
+          dist/*.whl
+        draft: false
+        prerelease: ${{ contains(steps.get_version.outputs.version, 'rc') || contains(steps.get_version.outputs.version, 'beta') || contains(steps.get_version.outputs.version, 'alpha') }}
+        generate_release_notes: true
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  notify-success:
+    name: Notify Success
+    needs: [publish-pypi, create-release]
+    runs-on: ubuntu-latest
+    if: success() && startsWith(github.ref, 'refs/tags/')
+    
+    steps:
+    - name: Extract version from tag
+      id: get_version
+      run: |
+        VERSION=${GITHUB_REF#refs/tags/}
+        echo "version=$VERSION" >> $GITHUB_OUTPUT
+        echo "tag=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
+    
+    - name: Success notification
+      run: |
+        echo "🎉 Successfully released vantage-cli ${{ steps.get_version.outputs.tag }}"
+        echo "📦 Published to PyPI: https://pypi.org/project/vantage-cli/${{ steps.get_version.outputs.version }}/"
+        echo "🚀 GitHub Release: ${{ github.server_url }}/${{ github.repository }}/releases/tag/${{ steps.get_version.outputs.tag }}"

vantage_cli-0.1.1/.gitignore

@@ -0,0 +1,30 @@
+__pycache__/
+**/__pycache__/
+**/**/__pycache__/
+.venv
+venv/
+env/
+.env
+**/.env
+.coverage
+cover_unit
+cover_integration
+cover_combined
+.coverage.*
+coverage
+cover/
+htmlcov/
+.tox/
+.nox/
+.pytest_cache/
+.pytest_cache/**
+.pytest_cache/**/*
+.pytest_cache/**/*
+.ruff_cache/
+.mypy_cache/
+.dmypy.json
+.dmypy.json/**
+.pyre/
+.pyre/**
+.pyre/**/*
+.ipynb_checkpoints

vantage_cli-0.1.1/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: vantage-cli
+Version: 0.1.1
+Summary: The Vantage Compute CLI.
+Author-email: jamesbeedy <james@vantagecompute.ai>
+License: MIT
+Requires-Python: >=3.12
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: anyio>=3.6.0
+Requires-Dist: gql>=4.0.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: juju~=3.6
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pendulum>=3.1.0
+Requires-Dist: py-buzz>=7.3
+Requires-Dist: pydantic>=2.11
+Requires-Dist: python-jose[cryptography]>=3.5.0
+Requires-Dist: requests-toolbelt>=0.10.0
+Requires-Dist: rich>=14.1.0
+Requires-Dist: ruamel-yaml
+Requires-Dist: snick>=2.1
+Requires-Dist: typer>=0.17.4
+Provides-Extra: dev
+Requires-Dist: black; extra == 'dev'
+Requires-Dist: codespell; extra == 'dev'
+Requires-Dist: coverage[toml]~=7.8; extra == 'dev'
+Requires-Dist: pyright; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'

vantage_cli-0.1.1/README.md

@@ -0,0 +1,86 @@
+<div align="center">
+<a href="https://www.vantagecompute.ai/">
+  <img src="https://vantage-compute-public-assets.s3.us-east-1.amazonaws.com/branding/vantage-logo-text-black-horz.png" alt="Vantage Compute Logo" width="100" style="margin-bottom: 0.5em;"/>
+</a>
+</div>
+<div align="center">
+
+# Vantage CLI
+
+[![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://python.org)
+[![PyPI](https://img.shields.io/pypi/v/vantage-cli.svg)](https://pypi.org/project/vantage-cli/)
+
+![Build Status](https://img.shields.io/github/actions/workflow/status/vantagecompute/vantage-cli/ci.yaml?branch=main&label=build&logo=github&style=plastic)
+![GitHub Issues](https://img.shields.io/github/issues/vantagecompute/vantage-cli?label=issues&logo=github&style=plastic)
+![Pull Requests](https://img.shields.io/github/issues-pr/vantagecompute/vantage-cli?label=pull-requests&logo=github&style=plastic)
+![GitHub Contributors](https://img.shields.io/github/contributors/vantagecompute/vantage-cli?logo=github&style=plastic)
+
+</div>
+
+A modern Python CLI tool to interface to Vantage Compute.
+
+## 🚀 Quick Start
+
+### Option 1: Install from PyPI (Recommended)
+
+```bash
+# Install LXD
+pip install vantage-cli
+
+# Login to Vantage
+vantage login
+
+# Check your logged in user
+vantage whoami
+```
+
+### Option 2: Install from Source
+
+```bash
+# Clone and setup
+git clone https://github.com/vantagecompute/vantage-cli.git
+cd vantage-cli && uv sync
+
+# Login to Vantage
+uv run vantage login
+```
+
+## 📚 Documentation
+
+Visit our comprehensive documentation site:
+**[vantagecompute.github.io/vantage-cli](https://vantagecompute.github.io/vantage-cli)**
+
+- **[Installation Guide](https://vantagecompute.github.io/vantage-cli/installation/)**: Detailed setup instructions
+- **[Architecture Overview](https://vantagecompute.github.io/vantage-cli/architecture/)**: How vantage-cli works
+- **[Command Reference](https://vantagecompute.github.io/vantage-cli/commands/)**: Complete command documentation
+- **[Troubleshooting](https://vantagecompute.github.io/vantage-cli/troubleshooting/)**: Common issues and solutions
+
+
+## 📄 License
+
+This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
+
+Copyright 2025 Vantage Compute Corporation
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+## 🆘 Support
+
+- **Issues**: [GitHub Issues](https://github.com/vantagecompute/vantage-cli/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/vantagecompute/vantage-cli/discussions)
+- **Email**: [james@vantagecompute.ai](mailto:james@vantagecompute.ai)
+
+---
+
+**Made with ❤️ by [Vantage Compute](https://vantagecompute.ai)**

vantage_cli-0.1.1/docs/Gemfile

@@ -0,0 +1,24 @@
+source "https://rubygems.org"
+
+gem "github-pages", group: :jekyll_plugins
+gem "webrick", "~> 1.7"
+
+group :jekyll_plugins do
+  gem "jekyll-feed", "~> 0.12"
+  gem "jekyll-sitemap"
+  gem "jekyll-seo-tag"
+end
+
+# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
+# and associated library.
+platforms :mingw, :x64_mingw, :mswin, :jruby do
+  gem "tzinfo", ">= 1", "< 3"
+  gem "tzinfo-data"
+end
+
+# Performance-booster for watching directories on Windows
+gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
+
+# Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem
+# do not have a Java counterpart.
+gem "http_parser.rb", "~> 0.6.0", :platforms => [:jruby]

vantage_cli-0.1.1/docs/_config.yml

@@ -0,0 +1,68 @@
+# Copyright (c) 2025 James Beedy.
+# GitHub Pages configuration for Vantage CLI
+title: Vantage CLI
+description: A powerful Python CLI for interacting with the Vantage platform.
+
+# Site settings
+url: "https://vantagecompute.github.io"
+baseurl: "/vantage-cli"
+repository: "vantagecompute/vantage-cli"
+
+# Logo and branding
+show_downloads: true
+
+# Author information
+author:
+  name: "James Beedy"
+  email: "james@vantagecompute.ai"
+
+# Social links
+github_username: vantagecompute
+
+# Build settings
+markdown: kramdown
+highlighter: rouge
+kramdown:
+  syntax_highlighter: rouge
+  syntax_highlighter_opts:
+    line_numbers: false
+    block:
+      line_numbers: false
+    span:
+      line_numbers: false
+  input: GFM
+
+plugins:
+  - jekyll-feed
+  - jekyll-sitemap
+  - jekyll-seo-tag
+
+# Exclude files from processing
+exclude:
+  - Gemfile
+  - Gemfile.lock
+  - node_modules
+  - vendor/bundle/
+  - vendor/cache/
+  - vendor/gems/
+  - vendor/ruby/
+  - README.md
+
+# Collections
+collections:
+  docs:
+    output: true
+    permalink: /:collection/:name/
+
+# Defaults
+defaults:
+  - scope:
+      path: ""
+      type: "pages"
+    values:
+      layout: "page"
+  - scope:
+      path: ""
+      type: "docs"
+    values:
+      layout: "page"

vantage_cli-0.1.1/docs/_data/project.yml

@@ -0,0 +1,38 @@
+# Project metadata for Vantage CLI
+name: "vantage-cli"
+version: "0.1.0"
+description: "CLI for authentication, profiles, clusters, apps & GraphQL against the Vantage Compute platform"
+repository: "https://github.com/vantagecompute/vantage-cli"
+documentation: "https://vantagecompute.github.io/vantage-cli"
+license: "Apache 2.0"
+python_version: ">=3.12"
+updated: "2025-09-09"
+
+
+
+# Key technologies
+technologies:
+  - "Python 3.12+"
+  - "Typer CLI Framework"
+  - "Rich Terminal UI"
+  - "HTTPX Async Client"
+  - "GraphQL"
+  - "OIDC / OAuth2"
+  - "Pytest"
+  - "uv Package Manager"
+  - "Pydantic-style Schemas"
+  - "GitHub Actions CI"
+  - "MicroK8s (app helper)"
+  - "Multipass (app helper)"
+  - "Juju (app helper)"
+
+# Package features
+features:
+  - "Profile & token management"
+  - "Cluster create/list/get/delete"
+  - "Client secret retrieval"
+  - "App deployment helpers"
+  - "GraphQL query execution"
+  - "Retry & metrics logging"
+  - "JSON or Rich output"
+  - "High test coverage"