Update README with 1st and 3rd party sections

Author: chingc

.github/workflows/basic.yml

@@ -20,9 +20,7 @@ jobs:
           cache: pip
 
       - name: Show python version
-        run: |
-          python --version
-          pip --version
+        run: python --version && pip --version
 
       - name: Install python dependencies
         run: |

.github/workflows/parallel_dir.yml

@@ -16,26 +16,29 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - uses: astral-sh/setup-uv@v6
+      - uses: actions/setup-python@v5
         with:
-          enable-cache: true
+          python-version-file: .python-version
+          cache: pip
+
+      - name: Show python version
+        run: python --version && pip --version
 
       - name: Install python dependencies
         run: |
-          uv python install; echo
-          uv sync --locked; echo
-          uv tree
+          pip install --upgrade pip setuptools wheel
+          pip install --requirement requirements.txt
 
       - name: Collect tests
         run: |
-          uv run -- pytest --collect-only --quiet | tee collected.tmp
+          pytest --collect-only --quiet | tee collected.tmp
           echo '::group::Delete the last two lines'
           sed -e '$d' collected.tmp | sed -e '$d' | tee collected.txt
           echo '::endgroup::'
 
       - name: Build test matrix
         id: build
-        shell: uv run -- python {0}
+        shell: python
         run: |
           from os import environ
           from pathlib import Path
@@ -60,15 +63,18 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - uses: astral-sh/setup-uv@v6
+      - uses: actions/setup-python@v5
         with:
-          enable-cache: true
+          python-version-file: .python-version
+          cache: pip
+
+      - name: Show python version
+        run: python --version && pip --version
 
       - name: Install python dependencies
         run: |
-          uv python install; echo
-          uv sync --locked; echo
-          uv tree
+          pip install --upgrade pip setuptools wheel
+          pip install --requirement requirements.txt
 
       - name: Set pytest norecursedirs
         # Prevent the test runner from recursing into subdirectories. This
@@ -79,4 +85,4 @@ jobs:
 
       - name: Run test
         # Quote the matrix argument because the path may contain spaces.
-        run: uv run -- pytest '${{ matrix.directory }}'
+        run: pytest '${{ matrix.directory }}'

.github/workflows/parallel_file.yml

@@ -16,26 +16,29 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - uses: astral-sh/setup-uv@v6
+      - uses: actions/setup-python@v5
         with:
-          enable-cache: true
+          python-version-file: .python-version
+          cache: pip
+
+      - name: Show python version
+        run: python --version && pip --version
 
       - name: Install python dependencies
         run: |
-          uv python install; echo
-          uv sync --locked; echo
-          uv tree
+          pip install --upgrade pip setuptools wheel
+          pip install --requirement requirements.txt
 
       - name: Collect tests
         run: |
-          uv run -- pytest --collect-only --quiet | tee collected.tmp
+          pytest --collect-only --quiet | tee collected.tmp
           echo '::group::Delete the last two lines'
           sed -e '$d' collected.tmp | sed -e '$d' | tee collected.txt
           echo '::endgroup::'
 
       - name: Build test matrix
         id: build
-        shell: uv run -- python {0}
+        shell: python
         run: |
           from os import environ
 
@@ -70,17 +73,20 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - uses: astral-sh/setup-uv@v6
+      - uses: actions/setup-python@v5
         with:
-          enable-cache: true
+          python-version-file: .python-version
+          cache: pip
+
+      - name: Show python version
+        run: python --version && pip --version
 
       - name: Install python dependencies
         run: |
-          uv python install; echo
-          uv sync --locked; echo
-          uv tree
+          pip install --upgrade pip setuptools wheel
+          pip install --requirement requirements.txt
 
       - name: Run test
         # Don't quote the matrix argument because it causes the shell
         # to treat the entire list of paths as a single argument.
-        run: uv run -- pytest ${{ matrix.paths }}
+        run: pytest ${{ matrix.paths }}

.github/workflows/uv.yml

@@ -24,5 +24,12 @@ jobs:
           uv sync --locked; echo
           uv tree
 
+      - name: Python shell with uv
+        shell: uv run -- python {0}
+        run: |
+          import sys
+          print(f"Running: {sys.version}")
+          print("Hello, World!")
+
       - name: Run test
         run: uv run -- pytest tests/test_basic.py

README.md

@@ -2,7 +2,11 @@
 
 A collection of small GitHub Actions workflows demonstrating various capabilities and features to get you started.
 
-## basic.yml
+## 1st Party
+
+These examples use only tools and actions from GitHub.
+
+### basic.yml
 
 <details>
 
@@ -22,7 +26,7 @@ See the [workflow](.github/workflows/basic.yml) and [dependabot](.github/dependa
 
 </details>
 
-## branch_name.yml
+### branch_name.yml
 
 <details>
 
@@ -45,7 +49,7 @@ See the [workflow](.github/workflows/branch_name.yml).
 
 </details>
 
-## cache.yml
+### cache.yml
 
 <details>
 
@@ -59,7 +63,7 @@ See the [workflow](.github/workflows/cache.yml).
 
 </details>
 
-## context.yml
+### context.yml
 
 <details>
 
@@ -71,7 +75,7 @@ See the [workflow](.github/workflows/context.yml).
 
 </details>
 
-## env_var_*.yml
+### env_var_*.yml
 
 <details>
 
@@ -91,7 +95,7 @@ See the workflows:
 
 </details>
 
-## github_script.yml
+### github_script.yml
 
 <details>
 
@@ -105,21 +109,7 @@ See the [workflow](.github/workflows/github_script.yml).
 
 </details>
 
-## homebrew.yml
-
-<details>
-
-<summary>Using homebrew in your workflow.</summary>
-
-<br/>Leverage the convenience of homebrew to install applications on GitHub Actions runners.
-
-- Uses `Homebrew/actions/setup-homebrew`
-
-See the [workflow](.github/workflows/homebrew.yml).
-
-</details>
-
-## job_summary.yml
+### job_summary.yml
 
 <details>
 
@@ -135,7 +125,7 @@ See the [workflow](.github/workflows/job_summary.yml).
 
 </details>
 
-## log_annotation.yml
+### log_annotation.yml
 
 <details>
 
@@ -147,7 +137,7 @@ See the [workflow](.github/workflows/log_annotation.yml).
 
 </details>
 
-## matrix.yml
+### matrix.yml
 
 <details>
 
@@ -161,63 +151,81 @@ See the [workflow](.github/workflows/matrix.yml).
 
 </details>
 
-## mise.yml
+### parallel_*.yml
 
 <details>
 
-<summary>Using mise in your workflow.</summary>
+<summary>Parallel testing without any code changes or extra dependencies.</summary>
 
-<br/>The polyglot tool version manager.
+<br/>The matrix strategy can be used in a particular way to enable parallel testing for free. "Free" meaning no code changes and no extra dependencies. This example uses Python, but can be adapted to any language. The idea is to identify where your tests are and distrubute them across multiple GitHub Actions runners. If your testing framework supports parallel testing, you can use it together with this strategy to really go fast!
 
-- Uses `jdx/mise-action`
+Note: This will increase the number of runners used, so keep an eye on your usage to avoid billing surprises.
 
-See the [workflow](.github/workflows/mise.yml).
+See the workflows:
+- [Directory-level parallel testing](.github/workflows/parallel_dir.yml)
+- [File-level parallel testing](.github/workflows/parallel_file.yml)
 
 </details>
 
-## parallel_*.yml
+### workflow_input.yml
 
 <details>
 
-<summary>Parallel testing without any code changes or extra dependencies.</summary>
+<summary>Adjust how a workflow will run with custom input.</summary>
 
-<br/>The matrix strategy can be used in a particular way to enable parallel testing for free. "Free" meaning no code changes and no extra dependencies. This example uses Python, but can be adapted to any language. The idea is to identify where your tests are and distrubute them across multiple GitHub Actions runners. If your testing framework supports parallel testing, you can use it together with this strategy to really go fast!
+<br/>When using the `workflow_dispatch` event, you can optionally specify inputs that are passed to the workflow.
 
-Note: This will increase the number of runners used, so keep an eye on your usage to avoid billing surprises.
+This trigger only receives events when the workflow file is on the default branch. This means you have to merge your changes to `main` or `master` before you can test your inputs. It would be wise to try input changes in a totally separate workflow before merging them into critical workflows.
 
-See the workflows:
-- [Directory-level parallel testing](.github/workflows/parallel_dir.yml)
-- [File-level parallel testing](.github/workflows/parallel_file.yml)
+Also, if the event that triggers the workflow isn't `workflow_dispatch` the input values are empty/null. This is true even if you have default values defined.
+
+See the [workflow](.github/workflows/workflow_input.yml).
 
 </details>
 
-## uv.yml
+## 3rd Party
+
+These examples include tools and actions from 3rd parties.
+
+### homebrew.yml
 
 <details>
 
-<summary>Using uv in your workflow.</summary>
+<summary>Using homebrew in your workflow.</summary>
 
-<br/>Same as basic.yml but uses the uv project manager.
+<br/>Leverage the convenience of homebrew to install applications on GitHub Actions runners.
 
-- Uses `astral-sh/setup-uv`
+- Uses `Homebrew/actions/setup-homebrew`
 
-See the [workflow](.github/workflows/uv.yml).
+See the [workflow](.github/workflows/homebrew.yml).
 
 </details>
 
-## workflow_input.yml
+### mise.yml
 
 <details>
 
-<summary>Adjust how a workflow will run with custom input.</summary>
+<summary>Using mise in your workflow.</summary>
 
-<br/>When using the `workflow_dispatch` event, you can optionally specify inputs that are passed to the workflow.
+<br/>The polyglot tool and project manager.
 
-This trigger only receives events when the workflow file is on the default branch. This means you have to merge your changes to `main` or `master` before you can test your inputs. It would be wise to try input changes in a totally separate workflow before merging them into critical workflows.
+- Uses `jdx/mise-action`
 
-Also, if the event that triggers the workflow isn't `workflow_dispatch` the input values are empty/null. This is true even if you have default values defined.
+See the [workflow](.github/workflows/mise.yml).
 
-See the [workflow](.github/workflows/workflow_input.yml).
+</details>
+
+### uv.yml
+
+<details>
+
+<summary>Using uv in your workflow.</summary>
+
+<br/>Same as basic.yml but uses the uv Python project manager.
+
+- Uses `astral-sh/setup-uv`
+
+See the [workflow](.github/workflows/uv.yml).
 
 </details>