Merge branch 'main2' of https://github.com/epics-containers/python3-pip-skeleton

Author: gilesknap

.github/workflows/code.yml

@@ -10,7 +10,7 @@ on:
 jobs:
   lint:
     # pull requests are a duplicate of a branch push if within the same repo.
-    if: github.event_name != 'pull_request' || github.event.pull_request.repository == github.repository
+    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository
     runs-on: ubuntu-latest
 
     steps:
@@ -29,7 +29,7 @@ jobs:
           tox -e pre-commit,mypy
 
   test:
-    if: github.event_name != 'pull_request' || github.event.pull_request.repository == github.repository
+    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository
     strategy:
       fail-fast: false
       matrix:
@@ -70,7 +70,7 @@ jobs:
           files: cov.xml
 
   container:
-    if: github.event_name != 'pull_request' || github.event.pull_request.repository == github.repository
+    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository
     runs-on: ubuntu-latest
     permissions:
       contents: read

.github/workflows/docs.yml

@@ -6,6 +6,7 @@ on:
 
 jobs:
   docs:
+    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository
     strategy:
       fail-fast: false
       matrix:
@@ -14,6 +15,12 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
+      - name: Dump github context
+        run: echo "$GITHUB_CONTEXT"
+        shell: bash
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+
       - name: Avoid git conflicts when tag and branch pushed at same time
         if: startsWith(github.ref, 'refs/tags')
         run: sleep 60

.github/workflows/docs_clean.yml

@@ -0,0 +1,41 @@
+name: Docs Cleanup CI
+
+# delete branch documentation when a branch is deleted
+# also allow manually deleting a documentation version
+on:
+  delete:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "documentation version to DELETE"
+        required: true
+        type: string
+
+jobs:
+  remove:
+    if: github.event.ref_type == 'branch' || github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: checkout
+        uses: actions/checkout@v2
+        with:
+          ref: gh-pages
+
+      - name: removing documentation for branch ${{ github.event.ref }}
+        if: ${{ github.event_name != 'workflow_dispatch' }}
+        run: echo "remove_me=${{ github.event.ref }}" >> $GITHUB_ENV
+
+      - name: manually removing documentation version ${{ github.event.inputs.version }}
+        if: ${{ github.event_name == 'workflow_dispatch' }}
+        run: echo "remove_me=${{ github.event.inputs.version }}" >> $GITHUB_ENV
+
+      - name: update index and push changes
+        run: |
+          echo removing redundant documentation version ${{ env.remove_me }}
+          rm -r ${{ env.remove_me }}
+          sed -i /${{ env.remove_me }}/d versions.txt
+          git config --global user.name 'GitHub Actions Docs Cleanup CI'
+          git config --global user.email '[email protected]'
+          git commit -am"removing redundant docs version ${{ env.remove_me }}" 
+          git push

docs/explanations.rst

@@ -12,4 +12,4 @@ Explanation of how the library works and why it works that way.
     explanations/why-src
     explanations/why-pre-commit
     explanations/features
-    explanations/decisions
+    explanations/decisions