Refactor common setup into new action

Author: object-Object

.github/workflows/hexdoc.yml

@@ -55,15 +55,19 @@ jobs:
       pages-url: ${{ steps.build.outputs.pages-url }}
     steps:
       - uses: actions/checkout@v4
+
+      - uses: hexdoc-dev/actions/setup@v0
+        with:
+          python-version: ${{ inputs.python-version }}
+          pip-extras: ${{ inputs.pip-extras }}
+
       - id: build
         uses: hexdoc-dev/actions/build@v0
         env:
           GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
         with:
-          python-version: ${{ inputs.python-version }}
           release: ${{ inputs.release }}
           props: ${{ inputs.props }}
-          pip-extras: ${{ inputs.pip-extras }}
           subdirectory: ${{ inputs.subdirectory }}
           site-url: ${{ inputs.site-url }}
 
@@ -78,13 +82,17 @@ jobs:
       contents: write
     steps:
       - uses: actions/checkout@v4
+
+      - uses: hexdoc-dev/actions/setup@v0
+        with:
+          python-version: ${{ inputs.python-version }}
+          pip-extras: ${{ inputs.pip-extras }}
+
       - uses: hexdoc-dev/actions/deploy-pages@v0
         env:
           GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
         with:
-          python-version: ${{ inputs.python-version }}
           release: ${{ inputs.release }}
           props: ${{ inputs.props }}
-          pip-extras: ${{ inputs.pip-extras }}
           subdirectory: ${{ inputs.subdirectory }}
           site-url: ${{ needs.build.outputs.pages-url }}

build/action.yml

@@ -6,16 +6,9 @@ inputs:
   release:
     description: "Boolean: if the book should be written to the release path (true) or the latest path (false)"
     required: true
-  python-version:
-    description: Python version to install
-    required: false
-    default: "3.11"
   props:
     description: Path to your props file (hexdoc.toml or properties.toml)
     required: false
-  pip-extras:
-    description: Pip extras for your package (eg. "[dev]")
-    required: false
   subdirectory:
     description: Subdirectory to deploy the book to
     required: false
@@ -42,21 +35,11 @@ outputs:
 runs:
   using: composite
   steps:
-    - uses: actions/setup-python@v4
-      with:
-        python-version: ${{ inputs.python-version }}
-        cache: pip
-    - uses: yezz123/setup-uv@v4
-
     - name: Install display server
       uses: awalsh128/cache-apt-pkgs-action@v1
       with:
         packages: xvfb
 
-    - name: Install Python packages
-      shell: bash
-      run: uv pip install --system -e .${{ inputs.pip-extras }} hatch
-
     - name: Build web book
       id: export
       env:

deploy-pages/action.yml

@@ -6,16 +6,9 @@ inputs:
   release:
     description: "Boolean: if the book should be written to the release path (true) or the latest path (false)"
     required: true
-  python-version:
-    description: Python version to install
-    required: false
-    default: "3.11"
   props:
     description: Path to your props file (hexdoc.toml or properties.toml)
     required: false
-  pip-extras:
-    description: Pip extras for your package (eg. "[dev]")
-    required: false
   subdirectory:
     description: Subdirectory to deploy the book to
     required: false
@@ -34,16 +27,6 @@ inputs:
 runs:
   using: composite
   steps:
-    - uses: actions/setup-python@v4
-      with:
-        python-version: ${{ inputs.python-version }}
-        cache: pip
-    - uses: yezz123/setup-uv@v4
-
-    - name: Install Python packages
-      shell: bash
-      run: uv pip install --system -e .${{ inputs.pip-extras }}
-
     - name: Download Pages artifact
       uses: actions/download-artifact@v4
       with:

setup/action.yml

@@ -0,0 +1,31 @@
+name: Set up hexdoc actions
+description: Runs helpful setup for other hexdoc actions.
+author: hexdoc-dev
+
+inputs:
+  python-version:
+    description: Python version to install
+    required: false
+    default: "3.11"
+  uv-version:
+    description: UV version to install
+    required: false
+  pip-extras:
+    description: Pip extras for your package (eg. "[dev]")
+    required: false
+
+runs:
+  using: composite
+  steps:
+    - uses: actions/setup-python@v4
+      with:
+        python-version: ${{ inputs.python-version }}
+        cache: pip
+
+    - uses: yezz123/setup-uv@v4
+      with:
+        uv-version: ${{ inputs.uv-version }}
+
+    - name: Install Python packages
+      shell: bash
+      run: uv pip install --system -e .${{ inputs.pip-extras }}