action.yml

name: "template-python-rust-cmd"
description: >-
  Composite action that installs the `template-cli` binary shipped with
  the template-python-rust-cmd Python package, then exposes it on PATH
  for downstream steps. Pair with `./cleanup` for a clean
  post-job state.

branding:
  icon: "package"
  color: "purple"

inputs:
  version:
    description: >-
      Version of the template-python-rust-cmd Python package to install.
      Defaults to the version declared in pyproject.toml of the consuming
      repo (resolved by uv).
    required: false
    default: ""
  python-version:
    description: >-
      Python version uv should provision the install venv with.
      Defaults to a recent CPython compatible with the package's
      requires-python lower bound.
    required: false
    default: "3.11"

outputs:
  binary-path:
    description: >-
      Absolute path to the installed `template-cli` binary.
    value: ${{ steps.expose.outputs.binary-path }}

runs:
  using: "composite"
  steps:
    - name: Install uv
      uses: astral-sh/setup-uv@v5
      with:
        enable-cache: true

    - name: Provision Python
      shell: bash
      run: |
        uv python install ${{ inputs.python-version }}

    - name: Install template-python-rust-cmd via uv tool
      shell: bash
      run: |
        if [ -n "${{ inputs.version }}" ]; then
          uv tool install "template-python-rust-cmd==${{ inputs.version }}"
        else
          uv tool install template-python-rust-cmd
        fi

    - name: Expose binary path
      id: expose
      shell: bash
      run: |
        bin_path="$(command -v template-cli)"
        echo "binary-path=$bin_path" >> "$GITHUB_OUTPUT"
        echo "$(dirname "$bin_path")" >> "$GITHUB_PATH"

    - name: Smoke-test the surface
      shell: bash
      run: |
        template-cli --version
        template-cli --help