.gitlab-ci.yml

variables:
  GITLAB_REMOTE:
    description: "The remote gitlab URL used."
    value: "https://gitlab-ci-token:${CI_JOB_TOKEN}@${CI_SERVER_HOST}:${CI_SERVER_PORT}/"
  LATEST_PYTHON:
    description: "The latest python version used to test this project."
    options:
      - "3.9"
      - "3.10"
      - "3.11"
      - "3.12"
      - "3.13"
    value: "3.13"
  LINUX_CI_TOX_ENV:
    # Run coverage only with one Python version as this is costly.
    description: "Tox environments to run on Linux."
    value: "py39-cov-xdist,py310-xdist,py311-xdist,py312-xdist,py313-xdist"
  WINDOWS_CI_TOX_ENV:
    description: "Tox environments to run on Windows."
    value: "py312-xdist"

stages:
  - checks
  - tests linux
  - tests windows
  - upload

default:
  services:
    - run_as_root:false
  interruptible: true

# Common

.tox-common:
  before_script:
    - python -m pip install --force tox
  script:
    # Should be quoted using \' to deal with ':' in the command
    - 'echo "Tox run environment: ${CI_TOX_ENV}"'
    - python -m tox --colored yes -e ${CI_TOX_ENV}

### Linux jobs ###

.linux-image:
  services:
    - image:all-pythons
  before_script:
    - |
      if [ -z "$PYTHON_VERSION" ]; then
        versions=$(echo "$LINUX_CI_TOX_ENV" | sed -E 's/py([0-9]+)-[^,]+/\1/g' | tr ',' ' ')
        for pyversion in $versions; do
          source /it/activate-py$pyversion
        done
      else
        source /it/activate-py${PYTHON_VERSION:0:1}${PYTHON_VERSION:2}
      fi

.linux-common:
  extends:
    - .linux-image
    - .tox-common
  before_script:
    - !reference [.linux-image, before_script]
    - !reference [.tox-common, before_script]

# Stage: Checks

check:
  stage: checks
  extends: .linux-common
  needs: []
  before_script:
    - !reference [.linux-common, before_script]
    - git config --global --add
      url."${GITLAB_REMOTE}/it/black.git".insteadOf
      https://github.com/ambv/black
    - git config --global --add
      url."${GITLAB_REMOTE}/it/flake8.git".insteadOf
      https://github.com/pycqa/flake8
    - python -m pip install pre-commit
    - pre-commit install
  script:
    - pre-commit run -a --show-diff-on-failure
    - !reference [.linux-common, script]
  variables:
    PYTHON_VERSION: ${LATEST_PYTHON}
    CI_TOX_ENV: check
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"

.test-linux:
  stage: tests linux
  extends: .linux-common
  services:
    - !reference [.linux-common, services]
    - cpu:4
  coverage: '/(?i)total.*? (100(?:\.0+)?\%|[1-9]?\d(?:\.\d+)?\%)$/'
  variables:
    CI_TOX_ENV: $LINUX_CI_TOX_ENV
  artifacts:
    when: always
    paths:
      - pytest-report.xml
    reports:
      coverage_report:
        coverage_format: cobertura
        path: coverage.xml
      junit: pytest-report.xml

linux python:
  extends: .test-linux
  needs: ["check"]
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"

# A job triggered by 'run linux tests'. This jobs will run without waiting any others
# jobs.
linux python (always):
  extends: .test-linux
  needs: []
  rules:
    - if: $CI_PIPELINE_SOURCE == "parent_pipeline" && $CI_MERGE_REQUEST_ID && $CI_PROJECT_NAME == "e3-core" && $ALWAYS_LINUX_TESTS == "y"

# A manual job to run Linux tests even if "check" job has failed
run linux tests:
  stage: tests linux
  needs: []
  trigger:
    include: .gitlab-ci.yml
    strategy: depend
  variables:
    ALWAYS_LINUX_TESTS: "y"
    ALWAYS_WINDOWS_TESTS: "n"
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
      when: manual
      allow_failure: true
  # Contrary to what the documentation might suggest, manual_confirmation
  # is not currently usable with our gitlab.
  # However, when it is, adding a manual confirmation to warn the user that
  # this job should only be used when previous steps have failed seems
  # useful. Something like:
  #
  # manual_confirmation: |-
  #     Are you sure you want to run Linux tests?
  #
  #     This is only useful if the previous stages have failed and you still want to run the tests.

### Windows jobs ###

.windows-image:
  services:
    - image:e3-windows-2022
    - platform:x86_64-windows-2022
    - cpu:2
    - mem:4
  before_script:
    - |
      if [ -z "$PYTHON_VERSION" ]; then
        versions=$(echo "$WINDOWS_CI_TOX_ENV" | sed -E 's/py([0-9])([0-9]+)-[^,]+/\1.\2/g' | tr ',' ' ')
        for pyversion in $versions; do
          if [ -d /it/python/$pyversion ]; then
            source /it/activate-python $pyversion
          fi
        done
      else
        source /it/activate-python $PYTHON_VERSION
      fi
    - mkdir -p "C:/tmp/Trash"

.windows-common:
  extends:
    - .windows-image
    - .tox-common
  before_script:
    - !reference [.windows-image, before_script]
    - !reference [.tox-common, before_script]

.test-windows:
  stage: tests windows
  extends: .windows-common
  variables:
    CI_TOX_ENV: $WINDOWS_CI_TOX_ENV

# A job tiggered by 'Run Windows tests'. This jobs will run without waiting any others
# jobs.
windows python (always):
  extends: .test-windows
  needs: []
  rules:
    - if: $CI_PIPELINE_SOURCE == "parent_pipeline" && $CI_MERGE_REQUEST_ID && $CI_PROJECT_NAME == "e3-aws" && $ALWAYS_WINDOWS_TESTS == "y"

# A manual job to run Windows tests even if previous jobs have failed
run windows tests:
  stage: tests windows
  needs: []
  trigger:
    include: .gitlab-ci.yml
    strategy: depend
  variables:
    ALWAYS_LINUX_TESTS: "n"
    ALWAYS_WINDOWS_TESTS: "y"
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
      when: manual
      allow_failure: true
  # Contrary to what the documentation might suggest, manual_confirmation
  # is not currently usable with our gitlab.
  # However, when it is, adding a manual confirmation to warn the user that
  # this job should only be used when previous steps have failed seems
  # useful. Something like:
  #
  # manual_confirmation: |-
  #     Are you sure you want to run Windows tests?
  #
  #     This is only useful if the previous stages have failed and you still want to run the tests.

upload-python-registry:
  stage: upload
  services:
    - image:e3
  before_script:
    - python -m pip install twine
  script:
    - python build_wheel.py
    - python -m twine upload --skip-existing
      --repository-url https://${CI_SERVER_HOST}:${CI_SERVER_PORT}/api/v4/projects/202/packages/pypi
      build/*.whl
  rules:
    - if: $CI_PIPELINE_SOURCE == "push" && $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
  variables:
    TWINE_PASSWORD: $CI_JOB_TOKEN
    TWINE_USERNAME: gitlab-ci-token