# -- GWpy CI/CD pipeline

#

# The configuration below is designed (badly, probably) to

# maximise the test coverage (minimise risk of breakages)

# whilst also minimising duplicate use of CI/CD credits for

# the GWpy project or individual contributors.

#

stages:

- check

- build

- test

- conda

- docs

- deploy

default:

# all jobs are, by default, interruptible

interruptible: true

# retry all jobs at most twice when gitlab-ci fails to start the job properly

# see https://docs.gitlab.com/ee/ci/yaml/#retry

retry:

max: 2

when:

- job_execution_timeout

- runner_system_failure

- stuck_or_timeout_failure

# no job should take more than an hour

timeout: 1h

workflow:

rules:

# run for merge requests

- if: $CI_PIPELINE_SOURCE == "merge_request_event"

# don't run on branches if there's an open merge request

- if: $CI_COMMIT_BRANCH && $CI_OPEN_MERGE_REQUESTS

when: never

# run on branches and tags

- if: $CI_COMMIT_BRANCH || $CI_COMMIT_TAG

# Define reusable variables

.minimum_python_version: &minimum_python_version "3.11"

.experimental_python_version: &experimental_python_version "3.14"

include:

# -- Quality assurance checks

- local: .gitlab/ci/qa.yml

inputs:

stage: check

minimum_python_version: *minimum_python_version

# -- Build

- local: .gitlab/ci/python-dist.yml

inputs:

job_name: &python_dist_job build

stage: build

# -- Test

- local: .gitlab/ci/test.yml

inputs:

minimum_python_version: *minimum_python_version

experimental_python_version: *experimental_python_version

# -- Documentation

#- local: .gitlab/ci/sphinx.yml

# inputs:

# stage: docs

# -- Deploy release

- local: .gitlab/ci/publish.yml

inputs:

stage: deploy

dependencies:

- *python_dist_job

rules:

- if: '$CI_COMMIT_MESSAGE =~ /\[skip deploy\]/'

when: never

- when: always