Next: Package, Tests, New layout and more.

.github/workflows/on-release.yml

@@ -0,0 +1,79 @@
+name: On Release
+
+on:
+  workflow_dispatch:   # allows manual trigger
+  release:
+    types:
+      - released
+      - prereleased
+
+jobs:
+  build-and-deploy:
+    if: github.event.release.target_commitish == 'main'
+    runs-on: ubuntu-latest
+    environment: release
+    env:
+      VERSION: ${{ github.event.release.tag_name }}
+      PACKAGE_NAME: 'nasal_api_docs'
+      PACKAGE_COMMAND: 'nasal-api-docs -h'
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v6
+
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: '3.13'
+
+    - name: Package wheel
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install --upgrade wheel build twine
+        python -m build .
+
+        FILE_WHL="dist/${PACKAGE_NAME}-${VERSION}-py3-none-any.whl"
+        FILE_TARGZ="dist/${PACKAGE_NAME}-${VERSION}.tar.gz"
+
+        # check files exists (quoted to be safe)
+        [ -f "$FILE_WHL" ] || { echo "Wheel not found: $FILE_WHL"; exit 1; }
+        [ -f "$FILE_TARGZ" ] || { echo "Tarball not found: $FILE_TARGZ"; exit 1; }
+
+        echo "FILE_WHL=$FILE_WHL" >> "$GITHUB_ENV"
+        echo "FILE_TARGZ=$FILE_TARGZ" >> "$GITHUB_ENV"
+        echo "Packaged app version: $VERSION at $FILE_WHL"
+
+    - name: Test local installation
+      run: |
+        python -m pip install --upgrade --force-reinstall "$FILE_WHL"
+        $PACKAGE_COMMAND
+
+    - name: Publish to TestPyPI
+      if: github.event.release.prerelease == true
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }}
+      run: python -m twine upload --verbose --repository-url https://test.pypi.org/legacy/ dist/*
+
+    - name: Test install from TestPyPI
+      if: github.event.release.prerelease == true
+      run: |
+        python -m pip uninstall -y ${PACKAGE_NAME} || true
+
+        for i in {1..5}; do
+          python -m pip install \
+            --index-url https://test.pypi.org/simple/ \
+            --extra-index-url https://pypi.org/simple/ \
+            "${PACKAGE_NAME}==${VERSION}" && break
+
+          echo "Waiting for package to appear on TestPyPI..."
+          sleep 5
+        done
+
+        $PACKAGE_COMMAND
+
+    - name: Publish to real PyPI
+      if: github.event.release.prerelease == false
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: python -m twine upload --verbose dist/*

.github/workflows/tests.yml

@@ -0,0 +1,29 @@
+name: Lint and Test
+
+on:
+  pull_request:
+  push:
+    branches: [dev]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install .
+          pip install flake8 pylint pytest
+
+      - run: flake8 nasal_api_docs --config setup.cfg
+      - run: pylint --rcfile setup.cfg nasal_api_docs
+      - run: pytest