Allow to append something to conf.py. (#73)

Author: felixfontein

.github/workflows/_shared-docs-build-pr.yml

@@ -99,6 +99,11 @@ on:
           `conf.py` in `html_theme_options`
         required: false
         type: string
+      init-append-conf-py:
+        description: |
+          If provided, this text will be appended to the generated `conf.py` as-is.
+        required: false
+        type: string
       artifact-name:
         description: The name of the artifact to upload.
         required: false
@@ -312,6 +317,7 @@ jobs:
           extra-conf: ${{ inputs.init-extra-conf }}
           extra-html-context: ${{ inputs.init-extra-html-context }}
           extra-html-theme-options: ${{ inputs.init-extra-html-theme-options }}
+          append-conf-py: ${{ inputs.init-append-conf-py }}
 
       - name: Build BASE
         id: build-base
@@ -356,6 +362,7 @@ jobs:
           extra-conf: ${{ inputs.init-extra-conf }}
           extra-html-context: ${{ inputs.init-extra-html-context }}
           extra-html-theme-options: ${{ inputs.init-extra-html-theme-options }}
+          append-conf-py: ${{ inputs.init-append-conf-py }}
 
       - name: Build HEAD
         id: build-head

.github/workflows/_shared-docs-build-push.yml

@@ -101,6 +101,11 @@ on:
           `conf.py` in `html_theme_options`
         required: false
         type: string
+      init-append-conf-py:
+        description: |
+          If provided, this text will be appended to the generated `conf.py` as-is.
+        required: false
+        type: string
       artifact-upload:
         description: Whether or not to upload the build as an artifact.
         type: boolean
@@ -230,6 +235,7 @@ jobs:
           extra-conf: ${{ inputs.init-extra-conf }}
           extra-html-context: ${{ inputs.init-extra-html-context }}
           extra-html-theme-options: ${{ inputs.init-extra-html-theme-options }}
+          append-conf-py: ${{ inputs.init-append-conf-py }}
 
       - name: Build
         id: build

.github/workflows/test-action-build-init.yml

@@ -59,6 +59,8 @@ jobs:
           - ''
         extra-html-theme-options:
           - ''
+        append-conf-py:
+          - ''
         intersphinx-links: ['']
         squash-hierarchy:
           - false
@@ -100,6 +102,9 @@ jobs:
             extra-html-theme-options: |
               foo=baz
               long=Yet "another" long 'quotes' text
+            append-conf-py: |
+              # This is a special comment.
+              # FOO BAR 1234
 
     steps:
       - name: Checkout
@@ -137,6 +142,7 @@ jobs:
           extra-conf: ${{ matrix.extra-conf }}
           extra-html-context: ${{ matrix.extra-html-context }}
           extra-html-theme-options: ${{ matrix.extra-html-theme-options }}
+          append-conf-py: ${{ matrix.append-conf-py }}
 
       - name: assert
         env:
@@ -233,5 +239,8 @@ jobs:
           # TODO Check extra-html-context
           # TODO Check extra-html-theme-options
 
+          ${{ matrix.append-conf-py && 'true' || 'false' }} && (grep -E '^# This is a special comment\.$' conf.py || exit 1)
+          ${{ matrix.append-conf-py && 'true' || 'false' }} && (grep -E '^# FOO BAR 1234$' conf.py || exit 1)
+
           # This must be the last line
           exit 0

actions/ansible-docs-build-init/action.yml

@@ -97,6 +97,10 @@ inputs:
       A newline separated list of `key=value` entries that will be added to the generated
       `conf.py` in `html_theme_options`
     required: false
+  append-conf-py:
+    description: |
+      If provided, this text will be appended to the generated `conf.py` as-is.
+    required: false
 outputs:
   build-script:
     description: The path of the build script to execute.
@@ -121,6 +125,7 @@ runs:
         _INPUT_EXTRA_CONF: ${{ inputs.extra-conf }}
         _INPUT_EXTRA_HTML_CONTEXT: ${{ inputs.extra-html-context }}
         _INPUT_EXTRA_HTML_THEME_OPTIONS: ${{ inputs.extra-html-theme-options }}
+        _INPUT_APPEND_CONF_PY: ${{ inputs.append-conf-py }}
       shell: bash
       run: |
         echo "::group::Installing antsibull-docs"
@@ -229,6 +234,15 @@ runs:
             echo "::endgroup::"
         fi
 
+        if [[ "${_INPUT_APPEND_CONF_PY}" != "" ]]; then
+            echo "::group::Appending to conf.py"
+            echo "${_INPUT_APPEND_CONF_PY}" >> "${{ inputs.dest-dir }}/conf.py"
+            echo "Content of ${{ inputs.dest-dir }}/conf.py:"
+            echo ""
+            cat "${{ inputs.dest-dir }}/conf.py"
+            echo "::endgroup::"
+        fi
+
         echo "::group::Install additional requirements"
         pip install -r "${{ inputs.dest-dir }}/requirements.txt"
         echo "::endgroup::"