GitHub Action and GitLab CI/CD Component

.github/actions/zpretty/action.yml

@@ -0,0 +1,33 @@
+name: Set up zpretty
+description: >
+  Install zpretty so a workflow can run it (for example `zpretty --check`).
+
+inputs:
+  spec:
+    description: >
+      pip requirement specifier for zpretty: a release such as
+      "zpretty==4.0.2", a VCS URL, or "." to install the checked-out source.
+    required: false
+    default: zpretty
+  python-version:
+    description: Python version to set up.
+    required: false
+    default: "3.x"
+
+runs:
+  using: composite
+  steps:
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: Install zpretty
+      shell: bash
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install "${{ inputs.spec }}"
+
+    - name: Report zpretty version
+      shell: bash
+      run: zpretty --version

.github/workflows/zpretty-action.yml

@@ -0,0 +1,22 @@
+name: zpretty action
+
+on: [push, pull_request]
+
+permissions:
+  contents: read
+
+jobs:
+  self-test:
+    name: Set up zpretty from source and run it
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up zpretty from this checkout
+        uses: ./.github/actions/zpretty
+        with:
+          spec: .
+
+      - name: Smoke-test the installed zpretty
+        shell: bash
+        run: zpretty --check zpretty/tests/original/sample_xml.xml

HISTORY.md

@@ -7,6 +7,10 @@
   @ale-rt
 - Fix possible issue with whitespaces lost around comments in XML documents.
   @ale-rt
+- Add a reusable GitHub Action and GitLab CI/CD component to set up
+  `zpretty` in CI pipelines.
+  (#232)
+  @gronke
 
 
 ## 4.0.2 (2026-06-09)

MANIFEST.in

@@ -1,4 +1,5 @@
 global-exclude *.pyc __pycache__ pyvenv.cfg
 graft zpretty
 graft zpretty/tests/include-excludes/.git
+recursive-include gitlab *.yml
 include *.cfg *.txt *.md *.in LICENSE Makefile .pre-commit-config.yaml .pre-commit-hooks.yaml tox.ini pyproject.toml

README.md

@@ -136,6 +136,43 @@ To do so, add the following to your `.pre-commit-config.yaml`:
     - id: zpretty
 ```
 
+# Continuous integration
+
+## GitHub Actions
+
+This repository ships a composite action that installs `zpretty` so a
+workflow can run it:
+
+```yaml
+- uses: actions/checkout@v6
+- uses: collective/zpretty/.github/actions/zpretty@master
+- run: zpretty --check path/to/file.xml
+```
+
+The action takes two optional inputs: `spec`, a pip requirement specifier
+(a release such as `zpretty==4.0.2`, a VCS URL, or `.` to install the
+checked-out source; defaults to `zpretty`), and `python-version`
+(defaults to `3.x`).
+
+## GitLab CI/CD
+
+For GitLab there is a reusable CI/CD configuration. Include it and extend
+the `.zpretty` job it defines:
+
+```yaml
+include:
+  - remote: "https://raw.githubusercontent.com/collective/zpretty/master/gitlab/zpretty.gitlab-ci.yml"
+
+zpretty:
+  extends: .zpretty
+  script:
+    - zpretty --check path/to/file.xml
+```
+
+Set the `ZPRETTY_SPEC` variable (default `zpretty`) to change the pip
+specifier and `ZPRETTY_PYTHON_VERSION` (default `3`) to pick the Python
+image tag.
+
 # VSCode extension
 
 There is a VSCode extension that uses `zpretty`:

gitlab/zpretty.gitlab-ci.yml

@@ -0,0 +1,15 @@
+# Reusable zpretty setup for GitLab CI. Usage:
+#   include:
+#     - remote: "https://raw.githubusercontent.com/collective/zpretty/<ref>/gitlab/zpretty.gitlab-ci.yml"
+#   zpretty:
+#     extends: .zpretty
+#     variables: { ZPRETTY_SPEC: "zpretty==4.0.2" }   # optional
+#     script: [zpretty --check path/to/file.xml]
+.zpretty:
+  image: "python:$ZPRETTY_PYTHON_VERSION"
+  variables:
+    ZPRETTY_PYTHON_VERSION: "3"
+    ZPRETTY_SPEC: zpretty
+  before_script:
+    - pip install "$ZPRETTY_SPEC"
+    - zpretty --version