add github actions for release

Author: sophec

.github/workflows/pypi-publish.yml

@@ -0,0 +1,61 @@
+# This workflow will upload a Python Package using Twine when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Upload Python Package
+
+on:
+  workflow_run:
+    workflows: [Create Release]
+    types:
+      - completed
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: build release distribution
+        run: |
+          python -m pip install build
+          python -m build
+
+      - name: upload dists
+        uses: actions/upload-artifact@v7
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    environment:
+      name: pypi
+      url: https://pypi.org/p/bs120xenet
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v8
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+

.github/workflows/release-docs.yml

@@ -0,0 +1,51 @@
+name: Publish Docs
+
+on:
+  push:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-24.04
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup venv
+        run: |
+          python -m venv .venv
+          . .venv/bin/activate
+          python -m pip install -r docs/doc-requirements.txt
+
+      - name: Run Sphinx
+        run: |
+          . .venv/bin/activate
+          python -m sphinx -an docs docs/_build
+
+      - name: Setup pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: 'docs/_build'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/release.yml

@@ -0,0 +1,53 @@
+name: Create Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      tag_name:
+        required: true
+        type: string
+      release:
+        description: "Whether to create a GitHub Release"
+        type: boolean
+        default: true
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Setup venv
+      run: |
+        python -m venv .venv
+        . .venv/bin/activate
+        python -m pip install build
+
+    - name: Build
+      run: |
+        . .venv/bin/activate
+        python -m build
+
+    - name: Create Release
+      shell: bash
+      env:
+        TAG_NAME: ${{ inputs.tag_name }}
+        GH_TOKEN: ${{ github.token }}
+      run: |
+        release_args=(
+          "$TAG_NAME"
+          --title "${TAG_NAME}"
+          --target "$GITHUB_SHA"
+          --generate-notes
+        )
+
+        # check for e.g., v1.1.0-rc0
+        if [[ $TAG_NAME == *-* ]]; then
+          release_args+=( --prerelease )
+        fi
+
+        gh release create "${release_args[@]}" dist/*.whl