avr-cli 0.7.0__py3-none-win_amd64.whl

avr_cli-0.7.0.data/data/share/avr/completions/_avr

@@ -0,0 +1,25 @@
+#compdef avr
+_avr_go_complete() {
+    local kind value description
+    local -a described plain
+    while IFS= read -r kind && IFS= read -r value && IFS= read -r description; do
+        case "$kind" in
+            plain)
+                if [[ "$description" == _ ]]; then
+                    plain+=("$value")
+                else
+                    described+=("$value:$description")
+                fi
+                ;;
+            file) _files ;;
+            dir) _files -/ ;;
+        esac
+    done < <(COMP_WORDS="${(j: :)${(@q)words}}" COMP_CWORD="$((CURRENT-1))" _AVR_COMPLETE=zsh_complete "$words[1]")
+    (( ${#plain} )) && compadd -- "${plain[@]}"
+    (( ${#described} )) && _describe 'avr' described
+    return 0
+}
+compdef _avr_go_complete avr
+case "${zsh_eval_context[-1]}" in
+    loadautofunc) _avr_go_complete "$@" ;;
+esac

avr_cli-0.7.0.data/data/share/avr/completions/avr.bash

@@ -0,0 +1,38 @@
+_avr_go_complete() {
+    local word quoted words="" record kind value candidate
+    COMPREPLY=()
+    if type compopt >/dev/null 2>&1; then compopt +o filenames 2>/dev/null; fi
+    for word in "${COMP_WORDS[@]}"; do
+        printf -v quoted '%q' "$word"
+        words="$words$quoted "
+    done
+    while IFS= read -r record; do
+        kind="${record%%,*}"
+        value="${record#*,}"
+        case "$kind" in
+            plain)
+                if ! type compopt >/dev/null 2>&1; then value="$value "; fi
+                COMPREPLY+=("$value") ;;
+            file|dir)
+                if type compopt >/dev/null 2>&1; then compopt -o filenames 2>/dev/null; fi
+                while IFS= read -r candidate; do
+                    if [[ -d "$candidate" ]]; then candidate="$candidate/"; fi
+                    # Bash 3.2 has no compopt; quote paths ourselves without
+                    # classifying command suggestions as filenames.
+                    if ! type compopt >/dev/null 2>&1; then
+                        printf -v candidate '%q' "$candidate"
+                        if [[ "$candidate" != */ ]]; then candidate="$candidate "; fi
+                    fi
+                    COMPREPLY+=("$candidate")
+                done < <(if [[ "$kind" == dir ]]; then compgen -d -- "$value"; else compgen -f -- "$value"; fi)
+                ;;
+        esac
+    done < <(COMP_WORDS="$words" COMP_CWORD="$COMP_CWORD" _AVR_COMPLETE=bash_complete "${COMP_WORDS[0]}")
+}
+if type compopt >/dev/null 2>&1; then
+    complete -F _avr_go_complete avr
+else
+    # Bash 3.2 cannot select filename handling per invocation. Add spaces
+    # explicitly for complete words, leaving directories open for more typing.
+    complete -o nospace -F _avr_go_complete avr
+fi

avr_cli-0.7.0.data/data/share/avr/completions/avr.fish

@@ -0,0 +1,17 @@
+function _avr_go_complete
+    set -l tokens (commandline -opc)
+    set -l full (commandline -cp)
+    set -l partial (commandline -ct)
+    for record in (env COMP_WORDS="$full" COMP_CWORD="$partial" _AVR_COMPLETE=fish_complete $tokens[1])
+        set -l parts (string split -m 1 , -- $record)
+        switch $parts[1]
+            case plain
+                printf '%s\n' "$parts[2]"
+            case file
+                __fish_complete_path "$parts[2]"
+            case dir
+                __fish_complete_directories "$parts[2]"
+        end
+    end
+end
+complete -c avr -f -a '(_avr_go_complete)'

avr_cli-0.7.0.data/data/share/avr/docs/INSTALL.md

@@ -0,0 +1,115 @@
+# Install and update AVR
+
+The native Go transition targets **0.7.0**, validated through CI artifacts before release.
+These instructions describe the prepared release paths. Until that release
+is published, normal package-manager installs still obtain Python 0.6.0.
+PR artifacts can be downloaded and tested without changing your current `avr`.
+
+Supported native targets: macOS 13+ on Apple Silicon, Linux AMD64/ARM64, and
+Windows AMD64. Intel macOS builds are not included. PyPI
+wheels support macOS 13+, glibc Linux AMD64/ARM64 and Windows AMD64. Alpine uses the standalone Linux binary and shell installer; install `curl` and
+`ca-certificates` first. Alpine PyPI wheels and Intel macOS builds are not shipped.
+On platforms without a compatible wheel, an unpinned PyPI upgrade may retain
+Python 0.6.0. An exact request such as `uv tool install 'avr-cli==0.7.0'`
+fails clearly if no compatible wheel exists. There is no fallback source distribution.
+
+## Keep your existing installation method
+
+| Installed with | Install | Update |
+| --- | --- | --- |
+| Homebrew | `brew install avrea-com/tap/avr` | `brew upgrade avr` |
+| uv | `uv tool install avr-cli` | `uv tool upgrade avr-cli` |
+| pipx | `pipx install avr-cli` | `pipx upgrade avr-cli` |
+| pip, in an environment | `python -m pip install avr-cli` | `python -m pip install --upgrade avr-cli` |
+| mise | `mise use -g github:avrea-com/cli@0.7.0` | Update your exact pin, or use `mise upgrade github:avrea-com/cli` with a floating version |
+
+The PyPI package contains native executables named `avr` and `avr-cli`.
+Python is needed by the package manager, but is not launched when running
+AVR. The wheels have no Python runtime dependencies and require Python 3.9+
+for installation. `uvx avr-cli` remains available.
+
+For mise, the release includes `mise.toml` with an exact version, platform
+asset names and checksums. Its built-in GitHub backend is sufficient; no AVR
+plugin is required. Merge the `[tools]` entry into your existing configuration.
+The GitHub-backed install can be tested end to end only after release assets
+exist. [mise backend documentation](https://mise.jdx.dev/dev-tools/backends/github.html).
+
+## Native installation without Python
+
+Download `install.sh` or `install.ps1` from the desired GitHub release,
+inspect it, then run it. Installers fetch versioned archives and verify their
+SHA-256 sidecars before changing the destination. They do not request root,
+modify shell profiles, or overwrite an installation belonging to a package
+manager. Check `command -v avr` (PowerShell: `Get-Command avr`) if an older
+installation is earlier on PATH.
+
+Linux or macOS:
+
+```sh
+sh install.sh --version 0.7.0 --bin-dir "$HOME/.local/bin"
+```
+
+Windows PowerShell:
+
+```powershell
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -Version 0.7.0 -BinDir "$env:LOCALAPPDATA\Avrea\bin"
+```
+
+The execution-policy override applies only to this process; organization policy still takes precedence. Inspect the downloaded script before running it. Both Windows PowerShell 5.1 and PowerShell 7 are tested.
+
+Omitting the version selects the latest stable release, once a native stable
+release exists. Re-running the installer upgrades its own installation;
+passing an older version rolls it back. Add the printed directory to PATH.
+An executable currently running on Windows may need to be closed first.
+
+For manual installation, extract `avr_VERSION_TARGET.tar.gz` or `.zip`,
+verify the checksum, and add its directory to PATH. Full archives also contain
+completions, man pages, reference documentation and license notices. Installers
+install only the executable. Generate completion source with
+`_AVR_COMPLETE=bash_source avr`, `zsh_source`, or `fish_source`, and install it
+using your shell's completion-directory conventions.
+
+`avr vm bootstrap VM --install-avr` uses the same native shell installer to
+install the release matching the local CLI's source version into the VM's
+`~/.local/bin`. It needs curl, tar and SHA-256 tooling, but no Python. That
+version must already have published release assets. The installer prints PATH
+instructions and refuses to overwrite a package-managed installation; move or
+remove that installation using its original package manager first.
+
+## Credentials, rollback and admin
+
+The command stays `avr`, using the existing configuration and credentials.
+Installation does not log in, log out, or rewrite `hosts.json`.
+
+Use your original package manager for rollback, for example
+`uv tool install --force 'avr-cli==0.6.0'` or
+`python -m pip install 'avr-cli==0.6.0'`. Python 0.6.0 requires Python 3.14+.
+A native installer cannot install Python 0.6.0; use its former package manager.
+
+`avr-admin` still imports Python `avrea_cli`. Its dependency must be pinned to
+`avr-cli==0.6.0` in avrea-core before the native PyPI release. Install admin and
+public AVR in separate environments. Existing admin installations need to
+consume the updated dependency metadata; an older unbounded requirement is
+not changed retroactively. Native wheels intentionally omit `avrea_cli`.
+
+## JSON and jq
+
+AVR uses embedded gojq, like GitHub CLI. Object keys are sorted,
+`keys_unsorted` is unavailable, and there is no system-jq fallback. When column
+order matters, name fields explicitly: `.[] | [.status,.conclusion,.run_id] | @tsv`.
+
+## Update notices
+
+Successful interactive commands may print an update notice on stderr. Checks
+use the public GitHub stable-release feed and a local 24-hour cache. They are
+best effort, have a two-second network deadline, and never delay command
+completion. No Avrea credentials are sent and no update is installed.
+The attempt timestamp is saved before the request. Short commands may exit
+before it finishes; that attempt still suppresses another check for 24 hours.
+
+Notices and checks are disabled for help, version, completion, hidden commands,
+structured output, redirected stdout/stderr, CI and automation. Set
+`AVR_NO_UPDATE_NOTIFIER=1` to disable them explicitly. Notices suggest Homebrew,
+uv, pipx or mise commands when their installation path is recognizable;
+otherwise they link to these instructions. Custom installation directories may
+require choosing the appropriate package manager yourself.