GitLab

Add autopep8 CI template

See merge request omegacen/ci-templates!44

Update documentation on conda an the monthly merge

See merge request omegacen/ci-templates!43

After running conda jobs on tags, the following failed:
https://gitlab.astro-wise.org/omegacen/common/-/pipelines/10844
This was due to the tags created by the MM job not being protected,
but the CONDA_UPLOAD_KEY (set globally by an admin) was.

This has been fixed for the common project: the tags `20*` are now
protected.

This MR adds a bit of documentation to other confused project owners
can understand what's going on.

Expand the black doc a bit more

See merge request omegacen/ci-templates!42

Update black documentation

See merge request omegacen/ci-templates!41

Add Black CI template

See merge request omegacen/ci-templates!40

Run conda and latex jobs on release branches

See merge request omegacen/ci-templates!38

Run conda and latex jobs on tags

See merge request omegacen/ci-templates!39

The tag information is needed in some jobs to get a proper version
string. This is only available pipelines triggered from tags, which
have $CI_COMMIT_TAG set.

This will lead to duplicate near-identical CI jobs for branches and
tags (which only differ in the $CI_COMMIT_TAG environment variable).
But there is no way to disable the branch CI jobs when there's also
a tag, because the branch CI job doesn't know anything about the tag
via the GitLab CI variables.

This is needed for the DPS, and it doesn't hurt other projects (I think).
Ideally, we'd use a regex in variable on the RHS of `=~` to give
project maintainers more control over the branch names and / or patterns.
But since this doesn't work (yet) in GitLab (13.4 at the time of writing)
we have to resort to spelling all the branches and patterns out
(so 'master', 'develop', 'release\/.*').

See the following issue on GitLab for progress on variables inside
regexes:

* https://gitlab.com/gitlab-org/gitlab/-/issues/25138
* https://gitlab.com/gitlab-org/gitlab-runner/-/issues/1809

Fix report extraction in case of test failure

See merge request omegacen/ci-templates!37

Report extraction has to be done in the `after_script` section because
GitLab CI terminates the execution of the `script` section after the
first error. This would mean that the reports wouldn't get extract if
the tests fail and the extraction would happen in the `script` section.
In contrast, `after_script` always gets executed.

Add unit test result reports to GitLab MRs and SonarQube

See merge request omegacen/ci-templates!36

Add inline coverage displayed in GitLab MRs

See merge request omegacen/ci-templates!35

See https://docs.gitlab.com/ee/user/project/merge_requests/test_coverage_visualization.html

Add env var to trigger conda jobs in scheduled pipelines

See merge request omegacen/ci-templates!34

As requested by Ewout, this environment variable can be set to
trigger the conda build and test jobs in scheduled pipelines.

Use biber in latex_pdf

See merge request omegacen/ci-templates!33

Remove conda package cache mechanism

See merge request omegacen/ci-templates!32

Since the pacakge cache keeps clogging up with new packages, it is
better to remove it altogether.

I have tried to create a mechanism that creates a new package cache
only when the conda recipe changes via rules:changes, cache:key:files,
and cache:policy, but this proved to be too cumbersome. It would only
with dynamic child pipelines, and that was a bridge too far for me.

Use project slug instead of project path for sonarqube key

See merge request omegacen/ci-templates!31

Slashes are no longer allowed in the project keys since SonarQube 8.2.

Remove variable from documentation that are now globally defined.

See merge request omegacen/ci-templates!30

Since GitLab 13.1 has introduced
[Global CI variables](https://docs.gitlab.com/ee/api/instance_level_ci_variables.html),
there is no need to add them to each project separately anymore.

Add CONDA_PACKAGE_VERSION variable

See merge request omegacen/ci-templates!29

This variable can be used for setting the conda package name to the
git branch. If it is left unset, it will default to CI_COMMIT_REF_NAME
with bad characters replace with dots ('.'). The bad characters are
conda-build specific, and are '=@#$%^&*:;"\'\\|<>?/ -'
(see https://github.com/conda/conda-build/blob/ef6e0b5aaa7652d37e8cdf3f461bf987610b89b0/conda_build/metadata.py#L529).

CI_COMMIT_REF_NAME is equal to the name of the branch when no tag is
set, and equal to the name of the tag otherwise.

This is documented in https://pkg.go.dev/mod/github.com/bmatcuk/doublestar@v1.2.2