chore: python-client autorelease flow

Author: daquinteroflex

.github/workflows/tidy3d-docs-sync-readthedocs-repo.yml

@@ -3,10 +3,36 @@ name: "docs/tidy3d/sync-to-readthedocs-repo"
 on:
   workflow_dispatch:
     inputs:
-      target_branch:
-        description: 'Target mirror repo branch. Defaults to source branch/tag.'
+      source_ref:
+        description: 'Source ref (branch/tag) to sync. Defaults to current ref.'
         required: false
         type: string
+        default: ''
+      target_ref:
+        description: 'Target mirror repo ref. Defaults to source ref.'
+        required: false
+        type: string
+        default: ''
+  
+  workflow_call:
+    inputs:
+      source_ref:
+        description: 'Source ref (branch/tag) to sync. Required for workflow_call.'
+        required: true
+        type: string
+      target_ref:
+        description: 'Target mirror repo ref. Defaults to source ref.'
+        required: false
+        type: string
+        default: ''
+    outputs:
+      workflow_success:
+        description: 'Sync workflow success status'
+        value: ${{ jobs.build-and-deploy.result == 'success' }}
+      synced_ref:
+        description: 'The ref that was synced to the mirror'
+        value: ${{ jobs.build-and-deploy.outputs.synced_ref }}
+  
   push:
     branches:
       - main
@@ -30,16 +56,26 @@ jobs:
       - id: extract
         name: Extract branch or tag name
         shell: bash
+        env:
+          INPUT_SOURCE_REF: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.source_ref || inputs.source_ref }}
         run: |
-          REF_NAME="${GITHUB_REF#refs/*/}"
+          if [[ -n "$INPUT_SOURCE_REF" ]]; then
+            REF_NAME="$INPUT_SOURCE_REF"
+            echo "Using provided source_ref: $REF_NAME"
+          else
+            REF_NAME="${GITHUB_REF#refs/*/}"
+            echo "Extracted ref from GITHUB_REF: $REF_NAME"
+          fi
           echo "ref_name=$REF_NAME" >> $GITHUB_OUTPUT
-          echo "Extracted ref: $REF_NAME"
+          echo "Final ref: $REF_NAME"
 
   build-and-deploy:
     permissions:
       contents: write
     needs: extract_branch_or_tag
     runs-on: ubuntu-latest
+    outputs:
+      synced_ref: ${{ steps.sync-result.outputs.synced_ref }}
     steps:
       - name: full-checkout
         uses: actions/checkout@v4
@@ -52,20 +88,25 @@ jobs:
           persist-credentials: true
 
       - name: push-mirror-repo
+        id: sync-result
         env:
           GITHUB_TOKEN: ${{ secrets.GH_PAT }}
           SOURCE_REF: ${{ needs.extract_branch_or_tag.outputs.ref_name }}
-          TARGET_BRANCH_INPUT: ${{ github.event.inputs.target_branch }}
+          TARGET_REF: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.target_ref || inputs.target_ref }}
         run: |
           echo "Source reference: $SOURCE_REF"
           git pull origin "$SOURCE_REF"
           git remote add mirror https://github.com/flexcompute-readthedocs/tidy3d-docs.git
          
-          if [[ -n "$TARGET_BRANCH_INPUT" && "${{ github.event_name }}" == "workflow_dispatch" ]]; then
-            echo "Manual trigger detected. Pushing contents of '$SOURCE_REF' to remote branch '$TARGET_BRANCH_INPUT'."
-            git push mirror "$SOURCE_REF:refs/heads/$TARGET_BRANCH_INPUT" --force
+          if [[ -n "$TARGET_REF" ]]; then
+            echo "Pushing contents of '$SOURCE_REF' to remote ref '$TARGET_REF'."
+            git push mirror "$SOURCE_REF:refs/heads/$TARGET_REF" --force
+            SYNCED_REF="$TARGET_REF"
           else
-            echo "Automatic trigger or manual run without target. Pushing '$SOURCE_REF' to the same ref on the mirror."
-            # This preserves the original behavior: pushes a branch to a branch, or a tag to a tag.
+            echo "Pushing '$SOURCE_REF' to the same ref on the mirror."
             git push mirror "$SOURCE_REF" --force
+            SYNCED_REF="$SOURCE_REF"
           fi
+          
+          echo "synced_ref=$SYNCED_REF" >> $GITHUB_OUTPUT
+          echo "? Successfully synced to: $SYNCED_REF"

.github/workflows/tidy3d-python-client-create-tag.yml

@@ -0,0 +1,116 @@
+name: "public/tidy3d/python-client-create-tag"
+
+on:
+  workflow_dispatch:
+    inputs:
+      release_tag:
+        description: 'Release Tag (e.g., v2.10.0, v2.10.0rc1)'
+        required: true
+        type: string
+      
+      release_type:
+        description: 'Release Type (draft=test, final=PyPI)'
+        type: choice
+        default: 'draft'
+        required: false
+        options:
+          - draft
+          - final
+  
+  workflow_call:
+    inputs:
+      release_tag:
+        description: 'Release Tag (e.g., v2.10.0, v2.10.0rc1)'
+        required: true
+        type: string
+      
+      release_type:
+        description: 'Release Type (draft=test, final=PyPI)'
+        type: string
+        default: 'draft'
+        required: false
+    
+    outputs:
+      tag_created:
+        description: 'Whether tag was successfully created'
+        value: ${{ jobs.create-and-push-tag.result == 'success' }}
+
+permissions:
+  contents: write
+
+jobs:
+  create-and-push-tag:
+    runs-on: ubuntu-latest
+    env:
+      RELEASE_TAG: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.release_tag || inputs.release_tag }}
+      RELEASE_TYPE: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.release_type || inputs.release_type }}
+    steps:
+      - name: checkout-code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+          persist-credentials: true
+          token: ${{ secrets.GH_PAT }}
+      
+      - name: validate-version-match
+        if: env.RELEASE_TYPE == 'final'
+        run: |
+          set -e
+          echo "Validating version match with pyproject.toml..."
+          
+          # Extract version from pyproject.toml
+          PYPROJECT_VERSION=$(grep '^version = ' pyproject.toml | sed 's/version = "\(.*\)"/\1/')
+          echo "pyproject.toml version: $PYPROJECT_VERSION"
+          
+          # Strip 'v' prefix from release tag
+          TAG_VERSION="${RELEASE_TAG#v}"
+          echo "Release tag version: $TAG_VERSION"
+          
+          if [[ "$TAG_VERSION" != "$PYPROJECT_VERSION" ]]; then
+            echo "Version mismatch!"
+            echo " pyproject.toml: $PYPROJECT_VERSION"
+            echo " Release tag:    $TAG_VERSION"
+            echo ""
+            echo "Please update pyproject.toml version to match the release tag."
+            exit 1
+          fi
+          
+          echo "Version matches: $PYPROJECT_VERSION"
+      
+      - name: retag
+        run: |
+          set -e
+          echo "Creating and pushing tag: $RELEASE_TAG"
+          
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          
+          # Fetch existing tags
+          git fetch --tags origin || true
+          
+          # Check if tag exists
+          if git rev-parse "$RELEASE_TAG" >/dev/null 2>&1; then
+            echo "Tag $RELEASE_TAG already exists"
+            echo "Deleting existing tag locally and remotely..."
+            git tag -d "$RELEASE_TAG" || true
+            git push --delete origin "$RELEASE_TAG" || true
+          else
+            echo "Tag $RELEASE_TAG does not exist yet"
+          fi
+          
+          # Create new tag
+          echo "Creating tag $RELEASE_TAG at commit $(git rev-parse HEAD)"
+          git tag "$RELEASE_TAG"
+          
+          # Push tag
+          echo "Pushing tag to origin..."
+          git push origin "$RELEASE_TAG"
+          
+          echo "Successfully created and pushed tag $RELEASE_TAG"
+      
+      - name: confirm-push
+        run: |
+          echo "Tag creation complete"
+          echo "Tag: $RELEASE_TAG"
+          echo "Commit: $(git rev-parse HEAD)"
+          echo "Pushed to: origin"

.github/workflows/tidy3d-python-client-develop-cli.yml

@@ -2,8 +2,28 @@ name: "public/tidy3d/python-client-develop-cli"
 
 on:
   workflow_dispatch:
+    inputs:
+      release_tag:
+        description: 'Release Tag (v2.10.0, v2.10.0rc1)'
+        required: false
+        type: string
+        default: ''
+  
+  workflow_call:
+    inputs:
+      release_tag:
+        description: 'Release Tag (v2.10.0, v2.10.0rc1)'
+        required: false
+        type: string
+        default: ''
+    outputs:
+      workflow_success:
+        description: 'CLI tests workflow success status'
+        value: ${{ jobs.test-dev-commands.result == 'success' }}
+  
   schedule:
     - cron: '0 2 * * *'  # Runs every day at 2:00 AM UTC
+  
   push:
     branches:
       - develop
@@ -14,16 +34,27 @@ permissions:
 
 jobs:
   test-dev-commands:
+    env:
+      RELEASE_TAG: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.release_tag || inputs.release_tag }}
     strategy:
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
     runs-on: ${{ matrix.os }}
 
     steps:
-    - name: Checkout code
+    - name: Checkout code (HEAD)
+      if: ${{ !env.RELEASE_TAG }}
       uses: actions/checkout@v4
       with:
-        ref: develop
+        fetch-depth: 1
+        submodules: false
+        persist-credentials: false
+
+    - name: Checkout code (TAG)
+      if: ${{ env.RELEASE_TAG }}
+      uses: actions/checkout@v4
+      with:
+        ref: refs/tags/${{ env.RELEASE_TAG }}
         fetch-depth: 1
         submodules: false
         persist-credentials: false