-
Notifications
You must be signed in to change notification settings - Fork 182
/
readme.py
73 lines (57 loc) · 2.94 KB
/
readme.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
import os
import re
def readme(self):
"""Repository ``README.md`` tests
The ``README.md`` files for a project are very important and must meet some requirements:
* Nextflow badge
* If no Nextflow badge is found, a warning is given
* If a badge is found but the version doesn't match the minimum version in the config file, the test fails
* Example badge code:
.. code-block:: md
[![Nextflow](https://img.shields.io/badge/nextflow-%E2%89%A50.27.6-brightgreen.svg)](https://www.nextflow.io/)
.. note:: This badge are a markdown image ``![alt-text](<image URL>)`` *inside* a markdown link ``[markdown image](<link URL>)``, so a bit fiddly to write.
* Zenodo release
* If pipeline is released but still contains a 'zenodo.XXXXXXX' tag, the test fails
"""
passed = []
warned = []
failed = []
# Remove field that should be ignored according to the linting config
ignore_configs = self.lint_config.get("readme", [])
with open(os.path.join(self.wf_path, "README.md"), "r") as fh:
content = fh.read()
if "nextflow_badge" not in ignore_configs:
# Check that there is a readme badge showing the minimum required version of Nextflow
# [![Nextflow](https://img.shields.io/badge/nextflow%20DSL2-%E2%89%A523.04.0-23aa62.svg)](https://www.nextflow.io/)
# and that it has the correct version
nf_badge_re = r"\[!\[Nextflow\]\(https://img\.shields\.io/badge/nextflow%20DSL2-!?(?:%E2%89%A5|%3E%3D)([\d\.]+)-23aa62\.svg\)\]\(https://www\.nextflow\.io/\)"
match = re.search(nf_badge_re, content)
if match:
nf_badge_version = match.group(1).strip("'\"")
try:
if nf_badge_version != self.minNextflowVersion:
raise AssertionError()
except (AssertionError, KeyError):
failed.append(
f"README Nextflow minimum version badge does not match config. Badge: `{nf_badge_version}`, "
f"Config: `{self.minNextflowVersion}`"
)
else:
passed.append(
f"README Nextflow minimum version badge matched config. Badge: `{nf_badge_version}`, "
f"Config: `{self.minNextflowVersion}`"
)
else:
warned.append("README did not have a Nextflow minimum version badge.")
if "zenodo_doi" not in ignore_configs:
# Check that zenodo.XXXXXXX has been replaced with the zendo.DOI
zenodo_re = r"/zenodo\.X+"
match = re.search(zenodo_re, content)
if match:
warned.append(
"README contains the placeholder `zenodo.XXXXXXX`. "
"This should be replaced with the zenodo doi (after the first release)."
)
else:
passed.append("README Zenodo placeholder was replaced with DOI.")
return {"passed": passed, "warned": warned, "failed": failed}