action.yml

name: CalVer Creation
author: MicahWW
description: Automatically create a new CalVer following YYYY.MM.DD
branding:
  icon: 'calendar'
  color: 'blue'

inputs:
  prefix:
    description: 'The prefix that will be found in front of each version tag, and should be reused on the new one.'
    required: false
    default: ''
  timezone:
    description: 'The time zone to base the date on, e.g. UTC, America/Chicago, etc. (default: UTC)'
    required: false
    default: 'UTC'
  push_tag:
    description: 'If the newly created version tag should be pushed, requires github_token. (default: false)'
    required: false
    default: 'false'
  publish_release:
    description: 'If the newly created & pushed tag should have a GitHub Release created, required push_tag=true & github_token. (default: false)'
    required: false
    default: 'false'
  github_token:
    description: 'GitHub token for pushing tags'
    required: false
  set_build_metadata:
    description: 'If the build metadata should be set and incremented at the end of the version tag. (default: true)'
    required: false
    default: 'true'
outputs:
  new_version:
    description: 'The newly generated version tag'
    value: ${{ steps.new_tag.outputs.new_version }}

runs:
  using: composite
  steps:
    - name: Checkout calling repo
      uses: actions/checkout@v6.0.2
      with:
        fetch-depth: 0
    
    - name: Setup Python
      uses: actions/setup-python@v6.2.0
      with:
        # TODO: Use the .python-version file contents
        python-version: '3.13'
    
    - name: Install Python dependencies
      shell: bash
      run: |
        echo "::group::Installing requirements"
        pip install -r ${{ github.action_path }}/requirements.txt
        echo "::endgroup::"

    - name: Pre Check
      env:
        INPUT_TIMEZONE: ${{ inputs.timezone }}
        INPUT_PUSH_TAG: ${{ inputs.push_tag }}
        INPUT_GITHUB_TOKEN: ${{ inputs.github_token }}
        INPUT_PUBLISH_RELEASE: ${{ inputs.publish_release }}
        INPUT_SET_BUILD_METADATA: ${{ inputs.set_build_metadata }}
      shell: bash
      run: python ${{ github.action_path }}/pre_check.py

    - name: Generate new tag
      id: new_tag
      env:
        INPUT_TIMEZONE: ${{ inputs.timezone }}
        INPUT_PREFIX: ${{ inputs.prefix }}
        INPUT_SET_BUILD_METADATA: ${{ inputs.set_build_metadata }}
      shell: bash
      run: python ${{ github.action_path }}/generate_new_tag.py

    - name: Push tag
      if: ${{ inputs.push_tag == 'true' }}
      env:
        GITHUB_TOKEN: ${{ inputs.github_token }}
      shell: bash
      run: |
        echo "::group::Pushing tag"
        git config user.name "github-actions"
        git config user.email "github-actions@github.com"
        git tag ${{ steps.new_tag.outputs.new_version }}
        git push origin ${{ steps.new_tag.outputs.new_version }}
        echo "::endgroup::"

    - name: Publish Release
      if: ${{ inputs.publish_release == 'true' }}
      env:
        GITHUB_TOKEN: ${{ inputs.github_token }}
      shell: bash
      run: |
        echo "::group::Publishing release"
        gh release create ${{ steps.new_tag.outputs.new_version }} --generate-notes --verify-tag
        echo "::endgroup::"