Public Access
DEVX-118: feat: enhance documentation-as-code with badges, version refs, Vale
Post-merge / detect-type (push) Successful in 11s
Post-merge / validate-commit-msg (push) Successful in 13s
Post-merge / vikunja (push) Successful in 19s
Post-merge / configure-repo (push) Successful in 15s
Post-merge / release (push) Successful in 45s
Post-merge / sync-wiki (push) Successful in 50s
Post-merge / publish (push) Successful in 32s
Post-merge / badges (push) Failing after 36s
Post-merge / detect-type (push) Successful in 11s
Post-merge / validate-commit-msg (push) Successful in 13s
Post-merge / vikunja (push) Successful in 19s
Post-merge / configure-repo (push) Successful in 15s
Post-merge / release (push) Successful in 45s
Post-merge / sync-wiki (push) Successful in 50s
Post-merge / publish (push) Successful in 32s
Post-merge / badges (push) Failing after 36s
- Fix badge system: clean .badges dir from orphan branch, add version verification, make badges job depend on release (avoids stale version badge race condition) - Add check_doc_versions.py: lint tool that verifies docs version references match current __version__, with --fix for auto-update - Integrate check_doc_versions into release process (auto-updates docs on every release commit) - Add Vale prose linter integration: .vale.ini, custom styles for terminology and code block language, CI step, make target - Fix stale version references in docs (0.27.0 → 0.33.4) - Fix e.g. → for example in docs (Google.Latin Vale rule) - Add CI steps for check_doc_versions and Vale to quality workflow - Add make targets: devx-check-doc-versions, devx-vale Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
This commit is contained in:
emil
co-authored by
Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
parent
3e12cf222f
commit
bbf0c81c32
@@ -44,6 +44,19 @@ jobs:
|
|||||||
run: |
|
run: |
|
||||||
. .venv/bin/activate 2>/dev/null || true
|
. .venv/bin/activate 2>/dev/null || true
|
||||||
python3 -m devx.ci.lint_docs --root .
|
python3 -m devx.ci.lint_docs --root .
|
||||||
|
- name: Documentation version reference check
|
||||||
|
env:
|
||||||
|
PYTHONPATH: src
|
||||||
|
run: |
|
||||||
|
. .venv/bin/activate 2>/dev/null || true
|
||||||
|
python3 -m devx.tools.check_doc_versions --root .
|
||||||
|
- name: Vale prose lint check
|
||||||
|
env:
|
||||||
|
PYTHONPATH: src
|
||||||
|
run: |
|
||||||
|
. .venv/bin/activate 2>/dev/null || true
|
||||||
|
export PATH="$HOME/.local/bin:$PATH"
|
||||||
|
vale --minAlertLevel=error docs/ AGENTS.md README.md
|
||||||
- name: Translation completeness check
|
- name: Translation completeness check
|
||||||
env:
|
env:
|
||||||
PYTHONPATH: src
|
PYTHONPATH: src
|
||||||
|
|||||||
@@ -8,7 +8,8 @@ name: Post-merge
|
|||||||
# detect-type ──┬── validate-commit-msg (skip if release commit)
|
# detect-type ──┬── validate-commit-msg (skip if release commit)
|
||||||
# ├── release (skip if release commit)
|
# ├── release (skip if release commit)
|
||||||
# │ └── publish (needs release — builds & publishes to PyPI)
|
# │ └── publish (needs release — builds & publishes to PyPI)
|
||||||
# ├── badges (ALWAYS runs — even on release commits)
|
# ├── badges (needs release — ALWAYS runs, waits for release
|
||||||
|
# │ so version badge picks up new __version__)
|
||||||
# ├── configure-repo (independent — skip if release commit)
|
# ├── configure-repo (independent — skip if release commit)
|
||||||
# ├── sync-wiki (skip if release commit — runs for ALL merges)
|
# ├── sync-wiki (skip if release commit — runs for ALL merges)
|
||||||
# └── vikunja (skip if release commit — runs for ALL merges)
|
# └── vikunja (skip if release commit — runs for ALL merges)
|
||||||
@@ -17,9 +18,10 @@ name: Post-merge
|
|||||||
# release succeeds. This ensures the wiki and task tracker are updated
|
# release succeeds. This ensures the wiki and task tracker are updated
|
||||||
# even for infrastructure-only changes (docs, CI config, etc.).
|
# even for infrastructure-only changes (docs, CI config, etc.).
|
||||||
#
|
#
|
||||||
# The badges job uses `if: always()` with no is-release condition so it
|
# The badges job uses `if: always()` and needs `release` so it waits for
|
||||||
# runs on every push to master, including release commits. This ensures
|
# the release job to complete (whether it ran or was skipped). This ensures
|
||||||
# badges (tests, coverage, version, etc.) are always current.
|
# the version badge always reflects the latest __version__ on master.
|
||||||
|
# Badges run on every push to master, including release commits.
|
||||||
#
|
#
|
||||||
# When release creates a "release: vX.Y.Z" commit and tag, the publish
|
# When release creates a "release: vX.Y.Z" commit and tag, the publish
|
||||||
# job (which depends on release) builds and publishes the package to the
|
# job (which depends on release) builds and publishes the package to the
|
||||||
@@ -204,7 +206,7 @@ jobs:
|
|||||||
--auto-login
|
--auto-login
|
||||||
|
|
||||||
badges:
|
badges:
|
||||||
needs: [detect-type]
|
needs: [detect-type, release]
|
||||||
if: always()
|
if: always()
|
||||||
runs-on: docker
|
runs-on: docker
|
||||||
container: git.oblachno.oblachno.fyi/oblachno-oss/runner-images/ci-quality:latest
|
container: git.oblachno.oblachno.fyi/oblachno-oss/runner-images/ci-quality:latest
|
||||||
|
|||||||
@@ -0,0 +1,46 @@
|
|||||||
|
# Vale configuration for devx documentation
|
||||||
|
# https://vale.sh/docs/
|
||||||
|
|
||||||
|
StylesPath = .vale/styles
|
||||||
|
|
||||||
|
# Packages are downloaded via `vale sync`
|
||||||
|
Packages = write-good, Google, Readability
|
||||||
|
|
||||||
|
# Minimum alert level to display (suggestion, warning, error)
|
||||||
|
MinAlertLevel = warning
|
||||||
|
|
||||||
|
# Project vocabulary — terms not flagged as spelling errors
|
||||||
|
Vocab = devx
|
||||||
|
|
||||||
|
[*.{md}]
|
||||||
|
# Enable style guides
|
||||||
|
BasedOnStyles = Vale, write-good, Google, Readability, devx
|
||||||
|
|
||||||
|
# Google style — relax rules too strict for technical docs
|
||||||
|
Google.Contractions = NO
|
||||||
|
Google.WordList = NO
|
||||||
|
Google.Acronyms = NO
|
||||||
|
Google.We = NO
|
||||||
|
Google.Will = NO
|
||||||
|
Google.Colons = NO
|
||||||
|
Google.Headings = NO
|
||||||
|
Google.EmDash = NO
|
||||||
|
Google.Units = NO
|
||||||
|
|
||||||
|
# write-good — relax rules too strict for technical writing
|
||||||
|
write-good.E-Prime = NO
|
||||||
|
write-good.So = NO
|
||||||
|
write-good.ThereIs = NO
|
||||||
|
write-good.TooWordy = NO
|
||||||
|
|
||||||
|
# Vale defaults — spelling catches too many technical terms
|
||||||
|
Vale.Terms = NO
|
||||||
|
Vale.Repetition = NO
|
||||||
|
Vale.Spelling = NO
|
||||||
|
|
||||||
|
# Readability — warnings only, technical docs are naturally complex
|
||||||
|
Readability.FleschReadingEase = suggestion
|
||||||
|
Readability.ColemanLiau = suggestion
|
||||||
|
Readability.LIX = suggestion
|
||||||
|
Readability.GunningFog = suggestion
|
||||||
|
Readability.SMOG = suggestion
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Use 'AM' or 'PM' (preceded by a space)."
|
||||||
|
link: "https://developers.google.com/style/word-list"
|
||||||
|
level: error
|
||||||
|
nonword: true
|
||||||
|
tokens:
|
||||||
|
- '\d{1,2}[AP]M\b'
|
||||||
|
- '\d{1,2} ?[ap]m\b'
|
||||||
|
- '\d{1,2} ?[aApP]\.[mM]\.'
|
||||||
@@ -0,0 +1,64 @@
|
|||||||
|
extends: conditional
|
||||||
|
message: "Spell out '%s', if it's unfamiliar to the audience."
|
||||||
|
link: 'https://developers.google.com/style/abbreviations'
|
||||||
|
level: suggestion
|
||||||
|
ignorecase: false
|
||||||
|
# Ensures that the existence of 'first' implies the existence of 'second'.
|
||||||
|
first: '\b([A-Z]{3,5})\b'
|
||||||
|
second: '(?:\b[A-Z][a-z]+ )+\(([A-Z]{3,5})\)'
|
||||||
|
# ... with the exception of these:
|
||||||
|
exceptions:
|
||||||
|
- API
|
||||||
|
- ASP
|
||||||
|
- CLI
|
||||||
|
- CPU
|
||||||
|
- CSS
|
||||||
|
- CSV
|
||||||
|
- DEBUG
|
||||||
|
- DOM
|
||||||
|
- DPI
|
||||||
|
- FAQ
|
||||||
|
- GCC
|
||||||
|
- GDB
|
||||||
|
- GET
|
||||||
|
- GPU
|
||||||
|
- GTK
|
||||||
|
- GUI
|
||||||
|
- HTML
|
||||||
|
- HTTP
|
||||||
|
- HTTPS
|
||||||
|
- IDE
|
||||||
|
- JAR
|
||||||
|
- JSON
|
||||||
|
- JSX
|
||||||
|
- LESS
|
||||||
|
- LLDB
|
||||||
|
- NET
|
||||||
|
- NOTE
|
||||||
|
- NVDA
|
||||||
|
- OSS
|
||||||
|
- PATH
|
||||||
|
- PDF
|
||||||
|
- PHP
|
||||||
|
- POST
|
||||||
|
- RAM
|
||||||
|
- REPL
|
||||||
|
- RSA
|
||||||
|
- SCM
|
||||||
|
- SCSS
|
||||||
|
- SDK
|
||||||
|
- SQL
|
||||||
|
- SSH
|
||||||
|
- SSL
|
||||||
|
- SVG
|
||||||
|
- TBD
|
||||||
|
- TCP
|
||||||
|
- TODO
|
||||||
|
- URI
|
||||||
|
- URL
|
||||||
|
- USB
|
||||||
|
- UTF
|
||||||
|
- XML
|
||||||
|
- XSS
|
||||||
|
- YAML
|
||||||
|
- ZIP
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "'%s' should be in lowercase."
|
||||||
|
link: 'https://developers.google.com/style/colons'
|
||||||
|
nonword: true
|
||||||
|
level: warning
|
||||||
|
scope: sentence
|
||||||
|
tokens:
|
||||||
|
- '(?<!:[^ ]+?):\s[A-Z]'
|
||||||
@@ -0,0 +1,30 @@
|
|||||||
|
extends: substitution
|
||||||
|
message: "Use '%s' instead of '%s'."
|
||||||
|
link: 'https://developers.google.com/style/contractions'
|
||||||
|
level: suggestion
|
||||||
|
ignorecase: true
|
||||||
|
action:
|
||||||
|
name: replace
|
||||||
|
swap:
|
||||||
|
are not: aren't
|
||||||
|
cannot: can't
|
||||||
|
could not: couldn't
|
||||||
|
did not: didn't
|
||||||
|
do not: don't
|
||||||
|
does not: doesn't
|
||||||
|
has not: hasn't
|
||||||
|
have not: haven't
|
||||||
|
how is: how's
|
||||||
|
is not: isn't
|
||||||
|
it is: it's
|
||||||
|
should not: shouldn't
|
||||||
|
that is: that's
|
||||||
|
they are: they're
|
||||||
|
was not: wasn't
|
||||||
|
we are: we're
|
||||||
|
we have: we've
|
||||||
|
were not: weren't
|
||||||
|
what is: what's
|
||||||
|
when is: when's
|
||||||
|
where is: where's
|
||||||
|
will not: won't
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Use 'July 31, 2016' format, not '%s'."
|
||||||
|
link: 'https://developers.google.com/style/dates-times'
|
||||||
|
ignorecase: true
|
||||||
|
level: error
|
||||||
|
nonword: true
|
||||||
|
tokens:
|
||||||
|
- '\d{1,2}(?:\.|/)\d{1,2}(?:\.|/)\d{4}'
|
||||||
|
- '\d{1,2} (?:Jan(?:uary)?|Feb(?:ruary)?|Mar(?:ch)?|Apr(?:il)|May|Jun(?:e)|Jul(?:y)|Aug(?:ust)|Sep(?:tember)?|Oct(?:ober)|Nov(?:ember)?|Dec(?:ember)?) \d{4}'
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "In general, don't use an ellipsis."
|
||||||
|
link: 'https://developers.google.com/style/ellipses'
|
||||||
|
nonword: true
|
||||||
|
level: warning
|
||||||
|
action:
|
||||||
|
name: remove
|
||||||
|
tokens:
|
||||||
|
- '\.\.\.'
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Don't put a space before or after a dash."
|
||||||
|
link: "https://developers.google.com/style/dashes"
|
||||||
|
nonword: true
|
||||||
|
level: error
|
||||||
|
action:
|
||||||
|
name: edit
|
||||||
|
params:
|
||||||
|
- trim
|
||||||
|
- " "
|
||||||
|
tokens:
|
||||||
|
- '\s[—–]\s'
|
||||||
|
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Don't use exclamation points in text."
|
||||||
|
link: "https://developers.google.com/style/exclamation-points"
|
||||||
|
nonword: true
|
||||||
|
level: error
|
||||||
|
action:
|
||||||
|
name: edit
|
||||||
|
params:
|
||||||
|
- trim_right
|
||||||
|
- "!"
|
||||||
|
tokens:
|
||||||
|
- '\w+!(?:\s|$)'
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Avoid first-person pronouns such as '%s'."
|
||||||
|
link: 'https://developers.google.com/style/pronouns#personal-pronouns'
|
||||||
|
ignorecase: true
|
||||||
|
level: warning
|
||||||
|
nonword: true
|
||||||
|
tokens:
|
||||||
|
- (?:^|\s)I\s
|
||||||
|
- (?:^|\s)I,\s
|
||||||
|
- \bI'm\b
|
||||||
|
- \bme\b
|
||||||
|
- \bmy\b
|
||||||
|
- \bmine\b
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Don't use '%s' as a gender-neutral pronoun."
|
||||||
|
link: 'https://developers.google.com/style/pronouns#gender-neutral-pronouns'
|
||||||
|
level: error
|
||||||
|
ignorecase: true
|
||||||
|
tokens:
|
||||||
|
- he/she
|
||||||
|
- s/he
|
||||||
|
- \(s\)he
|
||||||
@@ -0,0 +1,43 @@
|
|||||||
|
extends: substitution
|
||||||
|
message: "Consider using '%s' instead of '%s'."
|
||||||
|
ignorecase: true
|
||||||
|
link: "https://developers.google.com/style/inclusive-documentation"
|
||||||
|
level: error
|
||||||
|
action:
|
||||||
|
name: replace
|
||||||
|
swap:
|
||||||
|
(?:alumna|alumnus): graduate
|
||||||
|
(?:alumnae|alumni): graduates
|
||||||
|
air(?:m[ae]n|wom[ae]n): pilot(s)
|
||||||
|
anchor(?:m[ae]n|wom[ae]n): anchor(s)
|
||||||
|
authoress: author
|
||||||
|
camera(?:m[ae]n|wom[ae]n): camera operator(s)
|
||||||
|
door(?:m[ae]|wom[ae]n): concierge(s)
|
||||||
|
draft(?:m[ae]n|wom[ae]n): drafter(s)
|
||||||
|
fire(?:m[ae]n|wom[ae]n): firefighter(s)
|
||||||
|
fisher(?:m[ae]n|wom[ae]n): fisher(s)
|
||||||
|
fresh(?:m[ae]n|wom[ae]n): first-year student(s)
|
||||||
|
garbage(?:m[ae]n|wom[ae]n): waste collector(s)
|
||||||
|
lady lawyer: lawyer
|
||||||
|
ladylike: courteous
|
||||||
|
mail(?:m[ae]n|wom[ae]n): mail carriers
|
||||||
|
man and wife: husband and wife
|
||||||
|
man enough: strong enough
|
||||||
|
mankind: human kind|humanity
|
||||||
|
manmade: manufactured
|
||||||
|
manpower: personnel
|
||||||
|
middle(?:m[ae]n|wom[ae]n): intermediary
|
||||||
|
news(?:m[ae]n|wom[ae]n): journalist(s)
|
||||||
|
ombuds(?:man|woman): ombuds
|
||||||
|
oneupmanship: upstaging
|
||||||
|
poetess: poet
|
||||||
|
police(?:m[ae]n|wom[ae]n): police officer(s)
|
||||||
|
repair(?:m[ae]n|wom[ae]n): technician(s)
|
||||||
|
sales(?:m[ae]n|wom[ae]n): salesperson or sales people
|
||||||
|
service(?:m[ae]n|wom[ae]n): soldier(s)
|
||||||
|
steward(?:ess)?: flight attendant
|
||||||
|
tribes(?:m[ae]n|wom[ae]n): tribe member(s)
|
||||||
|
waitress: waiter
|
||||||
|
woman doctor: doctor
|
||||||
|
woman scientist[s]?: scientist(s)
|
||||||
|
work(?:m[ae]n|wom[ae]n): worker(s)
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Don't put a period at the end of a heading."
|
||||||
|
link: "https://developers.google.com/style/capitalization#capitalization-in-titles-and-headings"
|
||||||
|
nonword: true
|
||||||
|
level: warning
|
||||||
|
scope: heading
|
||||||
|
action:
|
||||||
|
name: edit
|
||||||
|
params:
|
||||||
|
- trim_right
|
||||||
|
- "."
|
||||||
|
tokens:
|
||||||
|
- '[a-z0-9][.]\s*$'
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
extends: capitalization
|
||||||
|
message: "'%s' should use sentence-style capitalization."
|
||||||
|
link: "https://developers.google.com/style/capitalization#capitalization-in-titles-and-headings"
|
||||||
|
level: warning
|
||||||
|
scope: heading
|
||||||
|
match: $sentence
|
||||||
|
indicators:
|
||||||
|
- ":"
|
||||||
|
exceptions:
|
||||||
|
- Azure
|
||||||
|
- CLI
|
||||||
|
- Cosmos
|
||||||
|
- Docker
|
||||||
|
- Emmet
|
||||||
|
- gRPC
|
||||||
|
- I
|
||||||
|
- Kubernetes
|
||||||
|
- Linux
|
||||||
|
- macOS
|
||||||
|
- Marketplace
|
||||||
|
- MongoDB
|
||||||
|
- REPL
|
||||||
|
- Studio
|
||||||
|
- TypeScript
|
||||||
|
- URLs
|
||||||
|
- Visual
|
||||||
|
- VS
|
||||||
|
- Windows
|
||||||
|
- JSON
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
extends: substitution
|
||||||
|
message: "Use '%s' instead of '%s'."
|
||||||
|
link: 'https://developers.google.com/style/abbreviations'
|
||||||
|
ignorecase: true
|
||||||
|
level: error
|
||||||
|
nonword: true
|
||||||
|
action:
|
||||||
|
name: replace
|
||||||
|
swap:
|
||||||
|
'\b(?:eg|e\.g\.)(?=[\s,;])': for example
|
||||||
|
'\b(?:ie|i\.e\.)(?=[\s,;])': that is
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "'%s' doesn't need a hyphen."
|
||||||
|
link: "https://developers.google.com/style/hyphens"
|
||||||
|
level: error
|
||||||
|
ignorecase: false
|
||||||
|
nonword: true
|
||||||
|
action:
|
||||||
|
name: edit
|
||||||
|
params:
|
||||||
|
- regex
|
||||||
|
- "-"
|
||||||
|
- " "
|
||||||
|
tokens:
|
||||||
|
- '\b[^\s-]+ly-\w+\b'
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Don't use plurals in parentheses such as in '%s'."
|
||||||
|
link: "https://developers.google.com/style/plurals-parentheses"
|
||||||
|
level: error
|
||||||
|
nonword: true
|
||||||
|
action:
|
||||||
|
name: edit
|
||||||
|
params:
|
||||||
|
- trim_right
|
||||||
|
- "(s)"
|
||||||
|
tokens:
|
||||||
|
- '\b\w+\(s\)'
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Spell out all ordinal numbers ('%s') in text."
|
||||||
|
link: 'https://developers.google.com/style/numbers'
|
||||||
|
level: error
|
||||||
|
nonword: true
|
||||||
|
tokens:
|
||||||
|
- \d+(?:st|nd|rd|th)
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Use the Oxford comma in '%s'."
|
||||||
|
link: 'https://developers.google.com/style/commas'
|
||||||
|
scope: sentence
|
||||||
|
level: warning
|
||||||
|
tokens:
|
||||||
|
- '(?:[^,]+,){1,}\s\w+\s(?:and|or)'
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Use parentheses judiciously."
|
||||||
|
link: 'https://developers.google.com/style/parentheses'
|
||||||
|
nonword: true
|
||||||
|
level: suggestion
|
||||||
|
tokens:
|
||||||
|
- '\(.+\)'
|
||||||
@@ -0,0 +1,184 @@
|
|||||||
|
extends: existence
|
||||||
|
link: 'https://developers.google.com/style/voice'
|
||||||
|
message: "In general, use active voice instead of passive voice ('%s')."
|
||||||
|
ignorecase: true
|
||||||
|
level: suggestion
|
||||||
|
raw:
|
||||||
|
- \b(am|are|were|being|is|been|was|be)\b\s*
|
||||||
|
tokens:
|
||||||
|
- '[\w]+ed'
|
||||||
|
- awoken
|
||||||
|
- beat
|
||||||
|
- become
|
||||||
|
- been
|
||||||
|
- begun
|
||||||
|
- bent
|
||||||
|
- beset
|
||||||
|
- bet
|
||||||
|
- bid
|
||||||
|
- bidden
|
||||||
|
- bitten
|
||||||
|
- bled
|
||||||
|
- blown
|
||||||
|
- born
|
||||||
|
- bought
|
||||||
|
- bound
|
||||||
|
- bred
|
||||||
|
- broadcast
|
||||||
|
- broken
|
||||||
|
- brought
|
||||||
|
- built
|
||||||
|
- burnt
|
||||||
|
- burst
|
||||||
|
- cast
|
||||||
|
- caught
|
||||||
|
- chosen
|
||||||
|
- clung
|
||||||
|
- come
|
||||||
|
- cost
|
||||||
|
- crept
|
||||||
|
- cut
|
||||||
|
- dealt
|
||||||
|
- dived
|
||||||
|
- done
|
||||||
|
- drawn
|
||||||
|
- dreamt
|
||||||
|
- driven
|
||||||
|
- drunk
|
||||||
|
- dug
|
||||||
|
- eaten
|
||||||
|
- fallen
|
||||||
|
- fed
|
||||||
|
- felt
|
||||||
|
- fit
|
||||||
|
- fled
|
||||||
|
- flown
|
||||||
|
- flung
|
||||||
|
- forbidden
|
||||||
|
- foregone
|
||||||
|
- forgiven
|
||||||
|
- forgotten
|
||||||
|
- forsaken
|
||||||
|
- fought
|
||||||
|
- found
|
||||||
|
- frozen
|
||||||
|
- given
|
||||||
|
- gone
|
||||||
|
- gotten
|
||||||
|
- ground
|
||||||
|
- grown
|
||||||
|
- heard
|
||||||
|
- held
|
||||||
|
- hidden
|
||||||
|
- hit
|
||||||
|
- hung
|
||||||
|
- hurt
|
||||||
|
- kept
|
||||||
|
- knelt
|
||||||
|
- knit
|
||||||
|
- known
|
||||||
|
- laid
|
||||||
|
- lain
|
||||||
|
- leapt
|
||||||
|
- learnt
|
||||||
|
- led
|
||||||
|
- left
|
||||||
|
- lent
|
||||||
|
- let
|
||||||
|
- lighted
|
||||||
|
- lost
|
||||||
|
- made
|
||||||
|
- meant
|
||||||
|
- met
|
||||||
|
- misspelt
|
||||||
|
- mistaken
|
||||||
|
- mown
|
||||||
|
- overcome
|
||||||
|
- overdone
|
||||||
|
- overtaken
|
||||||
|
- overthrown
|
||||||
|
- paid
|
||||||
|
- pled
|
||||||
|
- proven
|
||||||
|
- put
|
||||||
|
- quit
|
||||||
|
- read
|
||||||
|
- rid
|
||||||
|
- ridden
|
||||||
|
- risen
|
||||||
|
- run
|
||||||
|
- rung
|
||||||
|
- said
|
||||||
|
- sat
|
||||||
|
- sawn
|
||||||
|
- seen
|
||||||
|
- sent
|
||||||
|
- set
|
||||||
|
- sewn
|
||||||
|
- shaken
|
||||||
|
- shaven
|
||||||
|
- shed
|
||||||
|
- shod
|
||||||
|
- shone
|
||||||
|
- shorn
|
||||||
|
- shot
|
||||||
|
- shown
|
||||||
|
- shrunk
|
||||||
|
- shut
|
||||||
|
- slain
|
||||||
|
- slept
|
||||||
|
- slid
|
||||||
|
- slit
|
||||||
|
- slung
|
||||||
|
- smitten
|
||||||
|
- sold
|
||||||
|
- sought
|
||||||
|
- sown
|
||||||
|
- sped
|
||||||
|
- spent
|
||||||
|
- spilt
|
||||||
|
- spit
|
||||||
|
- split
|
||||||
|
- spoken
|
||||||
|
- spread
|
||||||
|
- sprung
|
||||||
|
- spun
|
||||||
|
- stolen
|
||||||
|
- stood
|
||||||
|
- stridden
|
||||||
|
- striven
|
||||||
|
- struck
|
||||||
|
- strung
|
||||||
|
- stuck
|
||||||
|
- stung
|
||||||
|
- stunk
|
||||||
|
- sung
|
||||||
|
- sunk
|
||||||
|
- swept
|
||||||
|
- swollen
|
||||||
|
- sworn
|
||||||
|
- swum
|
||||||
|
- swung
|
||||||
|
- taken
|
||||||
|
- taught
|
||||||
|
- thought
|
||||||
|
- thrived
|
||||||
|
- thrown
|
||||||
|
- thrust
|
||||||
|
- told
|
||||||
|
- torn
|
||||||
|
- trodden
|
||||||
|
- understood
|
||||||
|
- upheld
|
||||||
|
- upset
|
||||||
|
- wed
|
||||||
|
- wept
|
||||||
|
- withheld
|
||||||
|
- withstood
|
||||||
|
- woken
|
||||||
|
- won
|
||||||
|
- worn
|
||||||
|
- wound
|
||||||
|
- woven
|
||||||
|
- written
|
||||||
|
- wrung
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Don't use periods with acronyms or initialisms such as '%s'."
|
||||||
|
link: 'https://developers.google.com/style/abbreviations'
|
||||||
|
level: error
|
||||||
|
nonword: true
|
||||||
|
tokens:
|
||||||
|
- '\b(?:[A-Z]\.){3,}'
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Commas and periods go inside quotation marks."
|
||||||
|
link: 'https://developers.google.com/style/quotation-marks'
|
||||||
|
level: error
|
||||||
|
nonword: true
|
||||||
|
tokens:
|
||||||
|
- '"[^"]+"[.,?]'
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Don't add words such as 'from' or 'between' to describe a range of numbers."
|
||||||
|
link: 'https://developers.google.com/style/hyphens'
|
||||||
|
nonword: true
|
||||||
|
level: warning
|
||||||
|
tokens:
|
||||||
|
- '(?:from|between)\s\d+\s?-\s?\d+'
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Use semicolons judiciously."
|
||||||
|
link: 'https://developers.google.com/style/semicolons'
|
||||||
|
nonword: true
|
||||||
|
scope: sentence
|
||||||
|
level: suggestion
|
||||||
|
tokens:
|
||||||
|
- ';'
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Don't use internet slang abbreviations such as '%s'."
|
||||||
|
link: 'https://developers.google.com/style/abbreviations'
|
||||||
|
ignorecase: true
|
||||||
|
level: error
|
||||||
|
tokens:
|
||||||
|
- 'tl;dr'
|
||||||
|
- ymmv
|
||||||
|
- rtfm
|
||||||
|
- imo
|
||||||
|
- fwiw
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "'%s' should have one space."
|
||||||
|
link: 'https://developers.google.com/style/sentence-spacing'
|
||||||
|
level: error
|
||||||
|
nonword: true
|
||||||
|
action:
|
||||||
|
name: remove
|
||||||
|
tokens:
|
||||||
|
- '[a-z][.?!] {2,}[A-Z]'
|
||||||
|
- '[a-z][.?!][A-Z]'
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "In general, use American spelling instead of '%s'."
|
||||||
|
link: 'https://developers.google.com/style/spelling'
|
||||||
|
ignorecase: true
|
||||||
|
level: warning
|
||||||
|
tokens:
|
||||||
|
- '(?:\w+)nised?'
|
||||||
|
- 'colour'
|
||||||
|
- 'labour'
|
||||||
|
- 'centre'
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Put a nonbreaking space between the number and the unit in '%s'."
|
||||||
|
link: "https://developers.google.com/style/units-of-measure"
|
||||||
|
nonword: true
|
||||||
|
level: error
|
||||||
|
tokens:
|
||||||
|
- \b\d+(?:B|kB|MB|GB|TB)
|
||||||
|
- \b\d+(?:ns|ms|s|min|h|d)
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Try to avoid using first-person plural like '%s'."
|
||||||
|
link: 'https://developers.google.com/style/pronouns#personal-pronouns'
|
||||||
|
level: warning
|
||||||
|
ignorecase: true
|
||||||
|
tokens:
|
||||||
|
- we
|
||||||
|
- we'(?:ve|re)
|
||||||
|
- ours?
|
||||||
|
- us
|
||||||
|
- let's
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Avoid using '%s'."
|
||||||
|
link: 'https://developers.google.com/style/tense'
|
||||||
|
ignorecase: true
|
||||||
|
level: warning
|
||||||
|
tokens:
|
||||||
|
- will
|
||||||
@@ -0,0 +1,80 @@
|
|||||||
|
extends: substitution
|
||||||
|
message: "Use '%s' instead of '%s'."
|
||||||
|
link: "https://developers.google.com/style/word-list"
|
||||||
|
level: warning
|
||||||
|
ignorecase: false
|
||||||
|
action:
|
||||||
|
name: replace
|
||||||
|
swap:
|
||||||
|
"(?:API Console|dev|developer) key": API key
|
||||||
|
"(?:cell ?phone|smart ?phone)": phone|mobile phone
|
||||||
|
"(?:dev|developer|APIs) console": API console
|
||||||
|
"(?:e-mail|Email|E-mail)": email
|
||||||
|
"(?:file ?path|path ?name)": path
|
||||||
|
"(?:kill|terminate|abort)": stop|exit|cancel|end
|
||||||
|
"(?:OAuth ?2|Oauth)": OAuth 2.0
|
||||||
|
"(?:ok|Okay)": OK|okay
|
||||||
|
"(?:WiFi|wifi)": Wi-Fi
|
||||||
|
'[\.]+apk': APK
|
||||||
|
'3\-D': 3D
|
||||||
|
'Google (?:I\-O|IO)': Google I/O
|
||||||
|
"tap (?:&|and) hold": touch & hold
|
||||||
|
"un(?:check|select)": clear
|
||||||
|
above: preceding
|
||||||
|
account name: username
|
||||||
|
action bar: app bar
|
||||||
|
admin: administrator
|
||||||
|
Ajax: AJAX
|
||||||
|
a\.k\.a|aka: or|also known as
|
||||||
|
Android device: Android-powered device
|
||||||
|
android: Android
|
||||||
|
API explorer: APIs Explorer
|
||||||
|
application: app
|
||||||
|
approx\.: approximately
|
||||||
|
authN: authentication
|
||||||
|
authZ: authorization
|
||||||
|
autoupdate: automatically update
|
||||||
|
cellular data: mobile data
|
||||||
|
cellular network: mobile network
|
||||||
|
chapter: documents|pages|sections
|
||||||
|
check box: checkbox
|
||||||
|
CLI: command-line tool
|
||||||
|
click on: click|click in
|
||||||
|
Cloud: Google Cloud Platform|GCP
|
||||||
|
Container Engine: Kubernetes Engine
|
||||||
|
content type: media type
|
||||||
|
curated roles: predefined roles
|
||||||
|
data are: data is
|
||||||
|
Developers Console: Google API Console|API Console
|
||||||
|
disabled?: turn off|off
|
||||||
|
ephemeral IP address: ephemeral external IP address
|
||||||
|
fewer data: less data
|
||||||
|
file name: filename
|
||||||
|
firewalls: firewall rules
|
||||||
|
functionality: capability|feature
|
||||||
|
Google account: Google Account
|
||||||
|
Google accounts: Google Accounts
|
||||||
|
Googling: search with Google
|
||||||
|
grayed-out: unavailable
|
||||||
|
HTTPs: HTTPS
|
||||||
|
in order to: to
|
||||||
|
ingest: import|load
|
||||||
|
k8s: Kubernetes
|
||||||
|
long press: touch & hold
|
||||||
|
network IP address: internal IP address
|
||||||
|
omnibox: address bar
|
||||||
|
open-source: open source
|
||||||
|
overview screen: recents screen
|
||||||
|
regex: regular expression
|
||||||
|
SHA1: SHA-1|HAS-SHA1
|
||||||
|
sign into: sign in to
|
||||||
|
sign-?on: single sign-on
|
||||||
|
static IP address: static external IP address
|
||||||
|
stylesheet: style sheet
|
||||||
|
synch: sync
|
||||||
|
tablename: table name
|
||||||
|
tablet: device
|
||||||
|
touch: tap
|
||||||
|
url: URL
|
||||||
|
vs\.: versus
|
||||||
|
World Wide Web: web
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
{
|
||||||
|
"feed": "https://github.com/errata-ai/Google/releases.atom",
|
||||||
|
"vale_version": ">=1.0.0"
|
||||||
|
}
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
extends: metric
|
||||||
|
message: "Try to keep the Automated Readability Index (%s) below 8."
|
||||||
|
link: https://en.wikipedia.org/wiki/Automated_readability_index
|
||||||
|
|
||||||
|
formula: |
|
||||||
|
(4.71 * (characters / words)) + (0.5 * (words / sentences)) - 21.43
|
||||||
|
|
||||||
|
condition: "> 8"
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
extends: metric
|
||||||
|
message: "Try to keep the Coleman–Liau Index grade (%s) below 9."
|
||||||
|
link: https://en.wikipedia.org/wiki/Coleman%E2%80%93Liau_index
|
||||||
|
|
||||||
|
formula: |
|
||||||
|
(0.0588 * (characters / words) * 100) - (0.296 * (sentences / words) * 100) - 15.8
|
||||||
|
|
||||||
|
condition: "> 9"
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
extends: metric
|
||||||
|
message: "Try to keep the Flesch–Kincaid grade level (%s) below 8."
|
||||||
|
link: https://en.wikipedia.org/wiki/Flesch%E2%80%93Kincaid_readability_tests
|
||||||
|
|
||||||
|
formula: |
|
||||||
|
(0.39 * (words / sentences)) + (11.8 * (syllables / words)) - 15.59
|
||||||
|
|
||||||
|
condition: "> 8"
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
extends: metric
|
||||||
|
message: "Try to keep the Flesch reading ease score (%s) above 70."
|
||||||
|
link: https://en.wikipedia.org/wiki/Flesch%E2%80%93Kincaid_readability_tests
|
||||||
|
|
||||||
|
formula: |
|
||||||
|
206.835 - (1.015 * (words / sentences)) - (84.6 * (syllables / words))
|
||||||
|
|
||||||
|
condition: "< 70"
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
extends: metric
|
||||||
|
message: "Try to keep the Gunning-Fog index (%s) below 10."
|
||||||
|
link: https://en.wikipedia.org/wiki/Gunning_fog_index
|
||||||
|
|
||||||
|
formula: |
|
||||||
|
0.4 * ((words / sentences) + 100 * (complex_words / words))
|
||||||
|
|
||||||
|
condition: "> 10"
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
extends: metric
|
||||||
|
message: "Try to keep the LIX score (%s) below 35."
|
||||||
|
|
||||||
|
link: https://en.wikipedia.org/wiki/Lix_(readability_test)
|
||||||
|
# Very Easy: 20 - 25
|
||||||
|
#
|
||||||
|
# Easy: 30 - 35
|
||||||
|
#
|
||||||
|
# Medium: 40 - 45
|
||||||
|
#
|
||||||
|
# Difficult: 50 - 55
|
||||||
|
#
|
||||||
|
# Very Difficult: 60+
|
||||||
|
formula: |
|
||||||
|
(words / sentences) + ((long_words * 100) / words)
|
||||||
|
|
||||||
|
condition: "> 35"
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
extends: metric
|
||||||
|
message: "Try to keep the SMOG grade (%s) below 10."
|
||||||
|
link: https://en.wikipedia.org/wiki/SMOG
|
||||||
|
|
||||||
|
formula: |
|
||||||
|
1.0430 * math.sqrt((polysyllabic_words * 30.0) / sentences) + 3.1291
|
||||||
|
|
||||||
|
condition: "> 10"
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
{
|
||||||
|
"feed": "https://github.com/errata-ai/Readability/releases.atom",
|
||||||
|
"vale_version": ">=2.13.0"
|
||||||
|
}
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
devx
|
||||||
|
Gitea
|
||||||
|
ZITADEL
|
||||||
|
OpenTofu
|
||||||
|
Ansible
|
||||||
|
Vaultwarden
|
||||||
|
Nextcloud
|
||||||
|
Vikunja
|
||||||
|
Mattermost
|
||||||
|
Prometheus
|
||||||
|
Grafana
|
||||||
|
Loki
|
||||||
|
Alertmanager
|
||||||
|
Promtail
|
||||||
|
pyproject
|
||||||
|
tofu
|
||||||
|
act_runner
|
||||||
|
actionlint
|
||||||
|
hadolint
|
||||||
|
git-cliff
|
||||||
|
pre-commit
|
||||||
|
semver
|
||||||
|
changelog
|
||||||
|
idempotent
|
||||||
|
rootless
|
||||||
|
OIDC
|
||||||
|
SSO
|
||||||
|
SAML
|
||||||
|
LDAP
|
||||||
|
pytest
|
||||||
|
molecule
|
||||||
|
ruff
|
||||||
|
pyright
|
||||||
|
bandit
|
||||||
|
Vikunja
|
||||||
|
oblachno
|
||||||
|
Oblachno
|
||||||
|
Bulgarian
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Unlabeled code block — add a language tag (```bash, ```yaml, etc.)"
|
||||||
|
level: warning
|
||||||
|
scope: raw
|
||||||
|
raw:
|
||||||
|
- '(?s)```\n(?!.*```)'
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Avoid '%s' — it's condescending in technical documentation"
|
||||||
|
level: warning
|
||||||
|
ignorecase: true
|
||||||
|
tokens:
|
||||||
|
- '\bsimply\b'
|
||||||
|
- '\bjust\b'
|
||||||
|
- '\bobviously\b'
|
||||||
|
- '\bof course\b'
|
||||||
|
- '\bas you (can )?see\b'
|
||||||
|
- '\beasily\b'
|
||||||
|
- '\btrivial\b'
|
||||||
|
- '\bstraightforward\b'
|
||||||
@@ -0,0 +1,2 @@
|
|||||||
|
# Custom Vale style for devx documentation
|
||||||
|
# Project-specific terminology and style rules
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
extends: substitution
|
||||||
|
message: "Use '%s' instead of '%s' (terminology consistency)"
|
||||||
|
level: error
|
||||||
|
ignorecase: false
|
||||||
|
swap:
|
||||||
|
'\b(?i)gitea\b': Gitea
|
||||||
|
'\b(?i)zitadel\b': ZITADEL
|
||||||
|
'\b(?i)opentofu\b': OpenTofu
|
||||||
|
'\b(?i)vaultwarden\b': Vaultwarden
|
||||||
|
'\b(?i)nextcloud\b': Nextcloud
|
||||||
|
'\b(?i)mattermost\b': Mattermost
|
||||||
@@ -0,0 +1,702 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Try to avoid using clichés like '%s'."
|
||||||
|
ignorecase: true
|
||||||
|
level: warning
|
||||||
|
tokens:
|
||||||
|
- a chip off the old block
|
||||||
|
- a clean slate
|
||||||
|
- a dark and stormy night
|
||||||
|
- a far cry
|
||||||
|
- a fine kettle of fish
|
||||||
|
- a loose cannon
|
||||||
|
- a penny saved is a penny earned
|
||||||
|
- a tough row to hoe
|
||||||
|
- a word to the wise
|
||||||
|
- ace in the hole
|
||||||
|
- acid test
|
||||||
|
- add insult to injury
|
||||||
|
- against all odds
|
||||||
|
- air your dirty laundry
|
||||||
|
- all fun and games
|
||||||
|
- all in a day's work
|
||||||
|
- all talk, no action
|
||||||
|
- all thumbs
|
||||||
|
- all your eggs in one basket
|
||||||
|
- all's fair in love and war
|
||||||
|
- all's well that ends well
|
||||||
|
- almighty dollar
|
||||||
|
- American as apple pie
|
||||||
|
- an axe to grind
|
||||||
|
- another day, another dollar
|
||||||
|
- armed to the teeth
|
||||||
|
- as luck would have it
|
||||||
|
- as old as time
|
||||||
|
- as the crow flies
|
||||||
|
- at loose ends
|
||||||
|
- at my wits end
|
||||||
|
- avoid like the plague
|
||||||
|
- babe in the woods
|
||||||
|
- back against the wall
|
||||||
|
- back in the saddle
|
||||||
|
- back to square one
|
||||||
|
- back to the drawing board
|
||||||
|
- bad to the bone
|
||||||
|
- badge of honor
|
||||||
|
- bald faced liar
|
||||||
|
- ballpark figure
|
||||||
|
- banging your head against a brick wall
|
||||||
|
- baptism by fire
|
||||||
|
- barking up the wrong tree
|
||||||
|
- bat out of hell
|
||||||
|
- be all and end all
|
||||||
|
- beat a dead horse
|
||||||
|
- beat around the bush
|
||||||
|
- been there, done that
|
||||||
|
- beggars can't be choosers
|
||||||
|
- behind the eight ball
|
||||||
|
- bend over backwards
|
||||||
|
- benefit of the doubt
|
||||||
|
- bent out of shape
|
||||||
|
- best thing since sliced bread
|
||||||
|
- bet your bottom dollar
|
||||||
|
- better half
|
||||||
|
- better late than never
|
||||||
|
- better mousetrap
|
||||||
|
- better safe than sorry
|
||||||
|
- between a rock and a hard place
|
||||||
|
- beyond the pale
|
||||||
|
- bide your time
|
||||||
|
- big as life
|
||||||
|
- big cheese
|
||||||
|
- big fish in a small pond
|
||||||
|
- big man on campus
|
||||||
|
- bigger they are the harder they fall
|
||||||
|
- bird in the hand
|
||||||
|
- bird's eye view
|
||||||
|
- birds and the bees
|
||||||
|
- birds of a feather flock together
|
||||||
|
- bit the hand that feeds you
|
||||||
|
- bite the bullet
|
||||||
|
- bite the dust
|
||||||
|
- bitten off more than he can chew
|
||||||
|
- black as coal
|
||||||
|
- black as pitch
|
||||||
|
- black as the ace of spades
|
||||||
|
- blast from the past
|
||||||
|
- bleeding heart
|
||||||
|
- blessing in disguise
|
||||||
|
- blind ambition
|
||||||
|
- blind as a bat
|
||||||
|
- blind leading the blind
|
||||||
|
- blood is thicker than water
|
||||||
|
- blood sweat and tears
|
||||||
|
- blow off steam
|
||||||
|
- blow your own horn
|
||||||
|
- blushing bride
|
||||||
|
- boils down to
|
||||||
|
- bolt from the blue
|
||||||
|
- bone to pick
|
||||||
|
- bored stiff
|
||||||
|
- bored to tears
|
||||||
|
- bottomless pit
|
||||||
|
- boys will be boys
|
||||||
|
- bright and early
|
||||||
|
- brings home the bacon
|
||||||
|
- broad across the beam
|
||||||
|
- broken record
|
||||||
|
- brought back to reality
|
||||||
|
- bull by the horns
|
||||||
|
- bull in a china shop
|
||||||
|
- burn the midnight oil
|
||||||
|
- burning question
|
||||||
|
- burning the candle at both ends
|
||||||
|
- burst your bubble
|
||||||
|
- bury the hatchet
|
||||||
|
- busy as a bee
|
||||||
|
- by hook or by crook
|
||||||
|
- call a spade a spade
|
||||||
|
- called onto the carpet
|
||||||
|
- calm before the storm
|
||||||
|
- can of worms
|
||||||
|
- can't cut the mustard
|
||||||
|
- can't hold a candle to
|
||||||
|
- case of mistaken identity
|
||||||
|
- cat got your tongue
|
||||||
|
- cat's meow
|
||||||
|
- caught in the crossfire
|
||||||
|
- caught red-handed
|
||||||
|
- checkered past
|
||||||
|
- chomping at the bit
|
||||||
|
- cleanliness is next to godliness
|
||||||
|
- clear as a bell
|
||||||
|
- clear as mud
|
||||||
|
- close to the vest
|
||||||
|
- cock and bull story
|
||||||
|
- cold shoulder
|
||||||
|
- come hell or high water
|
||||||
|
- cool as a cucumber
|
||||||
|
- cool, calm, and collected
|
||||||
|
- cost a king's ransom
|
||||||
|
- count your blessings
|
||||||
|
- crack of dawn
|
||||||
|
- crash course
|
||||||
|
- creature comforts
|
||||||
|
- cross that bridge when you come to it
|
||||||
|
- crushing blow
|
||||||
|
- cry like a baby
|
||||||
|
- cry me a river
|
||||||
|
- cry over spilt milk
|
||||||
|
- crystal clear
|
||||||
|
- curiosity killed the cat
|
||||||
|
- cut and dried
|
||||||
|
- cut through the red tape
|
||||||
|
- cut to the chase
|
||||||
|
- cute as a bugs ear
|
||||||
|
- cute as a button
|
||||||
|
- cute as a puppy
|
||||||
|
- cuts to the quick
|
||||||
|
- dark before the dawn
|
||||||
|
- day in, day out
|
||||||
|
- dead as a doornail
|
||||||
|
- devil is in the details
|
||||||
|
- dime a dozen
|
||||||
|
- divide and conquer
|
||||||
|
- dog and pony show
|
||||||
|
- dog days
|
||||||
|
- dog eat dog
|
||||||
|
- dog tired
|
||||||
|
- don't burn your bridges
|
||||||
|
- don't count your chickens
|
||||||
|
- don't look a gift horse in the mouth
|
||||||
|
- don't rock the boat
|
||||||
|
- don't step on anyone's toes
|
||||||
|
- don't take any wooden nickels
|
||||||
|
- down and out
|
||||||
|
- down at the heels
|
||||||
|
- down in the dumps
|
||||||
|
- down the hatch
|
||||||
|
- down to earth
|
||||||
|
- draw the line
|
||||||
|
- dressed to kill
|
||||||
|
- dressed to the nines
|
||||||
|
- drives me up the wall
|
||||||
|
- dull as dishwater
|
||||||
|
- dyed in the wool
|
||||||
|
- eagle eye
|
||||||
|
- ear to the ground
|
||||||
|
- early bird catches the worm
|
||||||
|
- easier said than done
|
||||||
|
- easy as pie
|
||||||
|
- eat your heart out
|
||||||
|
- eat your words
|
||||||
|
- eleventh hour
|
||||||
|
- even the playing field
|
||||||
|
- every dog has its day
|
||||||
|
- every fiber of my being
|
||||||
|
- everything but the kitchen sink
|
||||||
|
- eye for an eye
|
||||||
|
- face the music
|
||||||
|
- facts of life
|
||||||
|
- fair weather friend
|
||||||
|
- fall by the wayside
|
||||||
|
- fan the flames
|
||||||
|
- feast or famine
|
||||||
|
- feather your nest
|
||||||
|
- feathered friends
|
||||||
|
- few and far between
|
||||||
|
- fifteen minutes of fame
|
||||||
|
- filthy vermin
|
||||||
|
- fine kettle of fish
|
||||||
|
- fish out of water
|
||||||
|
- fishing for a compliment
|
||||||
|
- fit as a fiddle
|
||||||
|
- fit the bill
|
||||||
|
- fit to be tied
|
||||||
|
- flash in the pan
|
||||||
|
- flat as a pancake
|
||||||
|
- flip your lid
|
||||||
|
- flog a dead horse
|
||||||
|
- fly by night
|
||||||
|
- fly the coop
|
||||||
|
- follow your heart
|
||||||
|
- for all intents and purposes
|
||||||
|
- for the birds
|
||||||
|
- for what it's worth
|
||||||
|
- force of nature
|
||||||
|
- force to be reckoned with
|
||||||
|
- forgive and forget
|
||||||
|
- fox in the henhouse
|
||||||
|
- free and easy
|
||||||
|
- free as a bird
|
||||||
|
- fresh as a daisy
|
||||||
|
- full steam ahead
|
||||||
|
- fun in the sun
|
||||||
|
- garbage in, garbage out
|
||||||
|
- gentle as a lamb
|
||||||
|
- get a kick out of
|
||||||
|
- get a leg up
|
||||||
|
- get down and dirty
|
||||||
|
- get the lead out
|
||||||
|
- get to the bottom of
|
||||||
|
- get your feet wet
|
||||||
|
- gets my goat
|
||||||
|
- gilding the lily
|
||||||
|
- give and take
|
||||||
|
- go against the grain
|
||||||
|
- go at it tooth and nail
|
||||||
|
- go for broke
|
||||||
|
- go him one better
|
||||||
|
- go the extra mile
|
||||||
|
- go with the flow
|
||||||
|
- goes without saying
|
||||||
|
- good as gold
|
||||||
|
- good deed for the day
|
||||||
|
- good things come to those who wait
|
||||||
|
- good time was had by all
|
||||||
|
- good times were had by all
|
||||||
|
- greased lightning
|
||||||
|
- greek to me
|
||||||
|
- green thumb
|
||||||
|
- green-eyed monster
|
||||||
|
- grist for the mill
|
||||||
|
- growing like a weed
|
||||||
|
- hair of the dog
|
||||||
|
- hand to mouth
|
||||||
|
- happy as a clam
|
||||||
|
- happy as a lark
|
||||||
|
- hasn't a clue
|
||||||
|
- have a nice day
|
||||||
|
- have high hopes
|
||||||
|
- have the last laugh
|
||||||
|
- haven't got a row to hoe
|
||||||
|
- head honcho
|
||||||
|
- head over heels
|
||||||
|
- hear a pin drop
|
||||||
|
- heard it through the grapevine
|
||||||
|
- heart's content
|
||||||
|
- heavy as lead
|
||||||
|
- hem and haw
|
||||||
|
- high and dry
|
||||||
|
- high and mighty
|
||||||
|
- high as a kite
|
||||||
|
- hit paydirt
|
||||||
|
- hold your head up high
|
||||||
|
- hold your horses
|
||||||
|
- hold your own
|
||||||
|
- hold your tongue
|
||||||
|
- honest as the day is long
|
||||||
|
- horns of a dilemma
|
||||||
|
- horse of a different color
|
||||||
|
- hot under the collar
|
||||||
|
- hour of need
|
||||||
|
- I beg to differ
|
||||||
|
- icing on the cake
|
||||||
|
- if the shoe fits
|
||||||
|
- if the shoe were on the other foot
|
||||||
|
- in a jam
|
||||||
|
- in a jiffy
|
||||||
|
- in a nutshell
|
||||||
|
- in a pig's eye
|
||||||
|
- in a pinch
|
||||||
|
- in a word
|
||||||
|
- in hot water
|
||||||
|
- in the gutter
|
||||||
|
- in the nick of time
|
||||||
|
- in the thick of it
|
||||||
|
- in your dreams
|
||||||
|
- it ain't over till the fat lady sings
|
||||||
|
- it goes without saying
|
||||||
|
- it takes all kinds
|
||||||
|
- it takes one to know one
|
||||||
|
- it's a small world
|
||||||
|
- it's only a matter of time
|
||||||
|
- ivory tower
|
||||||
|
- Jack of all trades
|
||||||
|
- jockey for position
|
||||||
|
- jog your memory
|
||||||
|
- joined at the hip
|
||||||
|
- judge a book by its cover
|
||||||
|
- jump down your throat
|
||||||
|
- jump in with both feet
|
||||||
|
- jump on the bandwagon
|
||||||
|
- jump the gun
|
||||||
|
- jump to conclusions
|
||||||
|
- just a hop, skip, and a jump
|
||||||
|
- just the ticket
|
||||||
|
- justice is blind
|
||||||
|
- keep a stiff upper lip
|
||||||
|
- keep an eye on
|
||||||
|
- keep it simple, stupid
|
||||||
|
- keep the home fires burning
|
||||||
|
- keep up with the Joneses
|
||||||
|
- keep your chin up
|
||||||
|
- keep your fingers crossed
|
||||||
|
- kick the bucket
|
||||||
|
- kick up your heels
|
||||||
|
- kick your feet up
|
||||||
|
- kid in a candy store
|
||||||
|
- kill two birds with one stone
|
||||||
|
- kiss of death
|
||||||
|
- knock it out of the park
|
||||||
|
- knock on wood
|
||||||
|
- knock your socks off
|
||||||
|
- know him from Adam
|
||||||
|
- know the ropes
|
||||||
|
- know the score
|
||||||
|
- knuckle down
|
||||||
|
- knuckle sandwich
|
||||||
|
- knuckle under
|
||||||
|
- labor of love
|
||||||
|
- ladder of success
|
||||||
|
- land on your feet
|
||||||
|
- lap of luxury
|
||||||
|
- last but not least
|
||||||
|
- last hurrah
|
||||||
|
- last-ditch effort
|
||||||
|
- law of the jungle
|
||||||
|
- law of the land
|
||||||
|
- lay down the law
|
||||||
|
- leaps and bounds
|
||||||
|
- let sleeping dogs lie
|
||||||
|
- let the cat out of the bag
|
||||||
|
- let the good times roll
|
||||||
|
- let your hair down
|
||||||
|
- let's talk turkey
|
||||||
|
- letter perfect
|
||||||
|
- lick your wounds
|
||||||
|
- lies like a rug
|
||||||
|
- life's a bitch
|
||||||
|
- life's a grind
|
||||||
|
- light at the end of the tunnel
|
||||||
|
- lighter than a feather
|
||||||
|
- lighter than air
|
||||||
|
- like clockwork
|
||||||
|
- like father like son
|
||||||
|
- like taking candy from a baby
|
||||||
|
- like there's no tomorrow
|
||||||
|
- lion's share
|
||||||
|
- live and learn
|
||||||
|
- live and let live
|
||||||
|
- long and short of it
|
||||||
|
- long lost love
|
||||||
|
- look before you leap
|
||||||
|
- look down your nose
|
||||||
|
- look what the cat dragged in
|
||||||
|
- looking a gift horse in the mouth
|
||||||
|
- looks like death warmed over
|
||||||
|
- loose cannon
|
||||||
|
- lose your head
|
||||||
|
- lose your temper
|
||||||
|
- loud as a horn
|
||||||
|
- lounge lizard
|
||||||
|
- loved and lost
|
||||||
|
- low man on the totem pole
|
||||||
|
- luck of the draw
|
||||||
|
- luck of the Irish
|
||||||
|
- make hay while the sun shines
|
||||||
|
- make money hand over fist
|
||||||
|
- make my day
|
||||||
|
- make the best of a bad situation
|
||||||
|
- make the best of it
|
||||||
|
- make your blood boil
|
||||||
|
- man of few words
|
||||||
|
- man's best friend
|
||||||
|
- mark my words
|
||||||
|
- meaningful dialogue
|
||||||
|
- missed the boat on that one
|
||||||
|
- moment in the sun
|
||||||
|
- moment of glory
|
||||||
|
- moment of truth
|
||||||
|
- money to burn
|
||||||
|
- more power to you
|
||||||
|
- more than one way to skin a cat
|
||||||
|
- movers and shakers
|
||||||
|
- moving experience
|
||||||
|
- naked as a jaybird
|
||||||
|
- naked truth
|
||||||
|
- neat as a pin
|
||||||
|
- needle in a haystack
|
||||||
|
- needless to say
|
||||||
|
- neither here nor there
|
||||||
|
- never look back
|
||||||
|
- never say never
|
||||||
|
- nip and tuck
|
||||||
|
- nip it in the bud
|
||||||
|
- no guts, no glory
|
||||||
|
- no love lost
|
||||||
|
- no pain, no gain
|
||||||
|
- no skin off my back
|
||||||
|
- no stone unturned
|
||||||
|
- no time like the present
|
||||||
|
- no use crying over spilled milk
|
||||||
|
- nose to the grindstone
|
||||||
|
- not a hope in hell
|
||||||
|
- not a minute's peace
|
||||||
|
- not in my backyard
|
||||||
|
- not playing with a full deck
|
||||||
|
- not the end of the world
|
||||||
|
- not written in stone
|
||||||
|
- nothing to sneeze at
|
||||||
|
- nothing ventured nothing gained
|
||||||
|
- now we're cooking
|
||||||
|
- off the top of my head
|
||||||
|
- off the wagon
|
||||||
|
- off the wall
|
||||||
|
- old hat
|
||||||
|
- older and wiser
|
||||||
|
- older than dirt
|
||||||
|
- older than Methuselah
|
||||||
|
- on a roll
|
||||||
|
- on cloud nine
|
||||||
|
- on pins and needles
|
||||||
|
- on the bandwagon
|
||||||
|
- on the money
|
||||||
|
- on the nose
|
||||||
|
- on the rocks
|
||||||
|
- on the spot
|
||||||
|
- on the tip of my tongue
|
||||||
|
- on the wagon
|
||||||
|
- on thin ice
|
||||||
|
- once bitten, twice shy
|
||||||
|
- one bad apple doesn't spoil the bushel
|
||||||
|
- one born every minute
|
||||||
|
- one brick short
|
||||||
|
- one foot in the grave
|
||||||
|
- one in a million
|
||||||
|
- one red cent
|
||||||
|
- only game in town
|
||||||
|
- open a can of worms
|
||||||
|
- open and shut case
|
||||||
|
- open the flood gates
|
||||||
|
- opportunity doesn't knock twice
|
||||||
|
- out of pocket
|
||||||
|
- out of sight, out of mind
|
||||||
|
- out of the frying pan into the fire
|
||||||
|
- out of the woods
|
||||||
|
- out on a limb
|
||||||
|
- over a barrel
|
||||||
|
- over the hump
|
||||||
|
- pain and suffering
|
||||||
|
- pain in the
|
||||||
|
- panic button
|
||||||
|
- par for the course
|
||||||
|
- part and parcel
|
||||||
|
- party pooper
|
||||||
|
- pass the buck
|
||||||
|
- patience is a virtue
|
||||||
|
- pay through the nose
|
||||||
|
- penny pincher
|
||||||
|
- perfect storm
|
||||||
|
- pig in a poke
|
||||||
|
- pile it on
|
||||||
|
- pillar of the community
|
||||||
|
- pin your hopes on
|
||||||
|
- pitter patter of little feet
|
||||||
|
- plain as day
|
||||||
|
- plain as the nose on your face
|
||||||
|
- play by the rules
|
||||||
|
- play your cards right
|
||||||
|
- playing the field
|
||||||
|
- playing with fire
|
||||||
|
- pleased as punch
|
||||||
|
- plenty of fish in the sea
|
||||||
|
- point with pride
|
||||||
|
- poor as a church mouse
|
||||||
|
- pot calling the kettle black
|
||||||
|
- pretty as a picture
|
||||||
|
- pull a fast one
|
||||||
|
- pull your punches
|
||||||
|
- pulling your leg
|
||||||
|
- pure as the driven snow
|
||||||
|
- put it in a nutshell
|
||||||
|
- put one over on you
|
||||||
|
- put the cart before the horse
|
||||||
|
- put the pedal to the metal
|
||||||
|
- put your best foot forward
|
||||||
|
- put your foot down
|
||||||
|
- quick as a bunny
|
||||||
|
- quick as a lick
|
||||||
|
- quick as a wink
|
||||||
|
- quick as lightning
|
||||||
|
- quiet as a dormouse
|
||||||
|
- rags to riches
|
||||||
|
- raining buckets
|
||||||
|
- raining cats and dogs
|
||||||
|
- rank and file
|
||||||
|
- rat race
|
||||||
|
- reap what you sow
|
||||||
|
- red as a beet
|
||||||
|
- red herring
|
||||||
|
- reinvent the wheel
|
||||||
|
- rich and famous
|
||||||
|
- rings a bell
|
||||||
|
- ripe old age
|
||||||
|
- ripped me off
|
||||||
|
- rise and shine
|
||||||
|
- road to hell is paved with good intentions
|
||||||
|
- rob Peter to pay Paul
|
||||||
|
- roll over in the grave
|
||||||
|
- rub the wrong way
|
||||||
|
- ruled the roost
|
||||||
|
- running in circles
|
||||||
|
- sad but true
|
||||||
|
- sadder but wiser
|
||||||
|
- salt of the earth
|
||||||
|
- scared stiff
|
||||||
|
- scared to death
|
||||||
|
- sealed with a kiss
|
||||||
|
- second to none
|
||||||
|
- see eye to eye
|
||||||
|
- seen the light
|
||||||
|
- seize the day
|
||||||
|
- set the record straight
|
||||||
|
- set the world on fire
|
||||||
|
- set your teeth on edge
|
||||||
|
- sharp as a tack
|
||||||
|
- shoot for the moon
|
||||||
|
- shoot the breeze
|
||||||
|
- shot in the dark
|
||||||
|
- shoulder to the wheel
|
||||||
|
- sick as a dog
|
||||||
|
- sigh of relief
|
||||||
|
- signed, sealed, and delivered
|
||||||
|
- sink or swim
|
||||||
|
- six of one, half a dozen of another
|
||||||
|
- skating on thin ice
|
||||||
|
- slept like a log
|
||||||
|
- slinging mud
|
||||||
|
- slippery as an eel
|
||||||
|
- slow as molasses
|
||||||
|
- smart as a whip
|
||||||
|
- smooth as a baby's bottom
|
||||||
|
- sneaking suspicion
|
||||||
|
- snug as a bug in a rug
|
||||||
|
- sow wild oats
|
||||||
|
- spare the rod, spoil the child
|
||||||
|
- speak of the devil
|
||||||
|
- spilled the beans
|
||||||
|
- spinning your wheels
|
||||||
|
- spitting image of
|
||||||
|
- spoke with relish
|
||||||
|
- spread like wildfire
|
||||||
|
- spring to life
|
||||||
|
- squeaky wheel gets the grease
|
||||||
|
- stands out like a sore thumb
|
||||||
|
- start from scratch
|
||||||
|
- stick in the mud
|
||||||
|
- still waters run deep
|
||||||
|
- stitch in time
|
||||||
|
- stop and smell the roses
|
||||||
|
- straight as an arrow
|
||||||
|
- straw that broke the camel's back
|
||||||
|
- strong as an ox
|
||||||
|
- stubborn as a mule
|
||||||
|
- stuff that dreams are made of
|
||||||
|
- stuffed shirt
|
||||||
|
- sweating blood
|
||||||
|
- sweating bullets
|
||||||
|
- take a load off
|
||||||
|
- take one for the team
|
||||||
|
- take the bait
|
||||||
|
- take the bull by the horns
|
||||||
|
- take the plunge
|
||||||
|
- takes one to know one
|
||||||
|
- takes two to tango
|
||||||
|
- the more the merrier
|
||||||
|
- the real deal
|
||||||
|
- the real McCoy
|
||||||
|
- the red carpet treatment
|
||||||
|
- the same old story
|
||||||
|
- there is no accounting for taste
|
||||||
|
- thick as a brick
|
||||||
|
- thick as thieves
|
||||||
|
- thin as a rail
|
||||||
|
- think outside of the box
|
||||||
|
- third time's the charm
|
||||||
|
- this day and age
|
||||||
|
- this hurts me worse than it hurts you
|
||||||
|
- this point in time
|
||||||
|
- three sheets to the wind
|
||||||
|
- through thick and thin
|
||||||
|
- throw in the towel
|
||||||
|
- tie one on
|
||||||
|
- tighter than a drum
|
||||||
|
- time and time again
|
||||||
|
- time is of the essence
|
||||||
|
- tip of the iceberg
|
||||||
|
- tired but happy
|
||||||
|
- to coin a phrase
|
||||||
|
- to each his own
|
||||||
|
- to make a long story short
|
||||||
|
- to the best of my knowledge
|
||||||
|
- toe the line
|
||||||
|
- tongue in cheek
|
||||||
|
- too good to be true
|
||||||
|
- too hot to handle
|
||||||
|
- too numerous to mention
|
||||||
|
- touch with a ten foot pole
|
||||||
|
- tough as nails
|
||||||
|
- trial and error
|
||||||
|
- trials and tribulations
|
||||||
|
- tried and true
|
||||||
|
- trip down memory lane
|
||||||
|
- twist of fate
|
||||||
|
- two cents worth
|
||||||
|
- two peas in a pod
|
||||||
|
- ugly as sin
|
||||||
|
- under the counter
|
||||||
|
- under the gun
|
||||||
|
- under the same roof
|
||||||
|
- under the weather
|
||||||
|
- until the cows come home
|
||||||
|
- unvarnished truth
|
||||||
|
- up the creek
|
||||||
|
- uphill battle
|
||||||
|
- upper crust
|
||||||
|
- upset the applecart
|
||||||
|
- vain attempt
|
||||||
|
- vain effort
|
||||||
|
- vanquish the enemy
|
||||||
|
- vested interest
|
||||||
|
- waiting for the other shoe to drop
|
||||||
|
- wakeup call
|
||||||
|
- warm welcome
|
||||||
|
- watch your p's and q's
|
||||||
|
- watch your tongue
|
||||||
|
- watching the clock
|
||||||
|
- water under the bridge
|
||||||
|
- weather the storm
|
||||||
|
- weed them out
|
||||||
|
- week of Sundays
|
||||||
|
- went belly up
|
||||||
|
- wet behind the ears
|
||||||
|
- what goes around comes around
|
||||||
|
- what you see is what you get
|
||||||
|
- when it rains, it pours
|
||||||
|
- when push comes to shove
|
||||||
|
- when the cat's away
|
||||||
|
- when the going gets tough, the tough get going
|
||||||
|
- white as a sheet
|
||||||
|
- whole ball of wax
|
||||||
|
- whole hog
|
||||||
|
- whole nine yards
|
||||||
|
- wild goose chase
|
||||||
|
- will wonders never cease?
|
||||||
|
- wisdom of the ages
|
||||||
|
- wise as an owl
|
||||||
|
- wolf at the door
|
||||||
|
- words fail me
|
||||||
|
- work like a dog
|
||||||
|
- world weary
|
||||||
|
- worst nightmare
|
||||||
|
- worth its weight in gold
|
||||||
|
- wrong side of the bed
|
||||||
|
- yanking your chain
|
||||||
|
- yappy as a dog
|
||||||
|
- years young
|
||||||
|
- you are what you eat
|
||||||
|
- you can run but you can't hide
|
||||||
|
- you only live once
|
||||||
|
- you're the boss
|
||||||
|
- young and foolish
|
||||||
|
- young and vibrant
|
||||||
@@ -0,0 +1,32 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Try to avoid using '%s'."
|
||||||
|
ignorecase: true
|
||||||
|
level: suggestion
|
||||||
|
tokens:
|
||||||
|
- am
|
||||||
|
- are
|
||||||
|
- aren't
|
||||||
|
- be
|
||||||
|
- been
|
||||||
|
- being
|
||||||
|
- he's
|
||||||
|
- here's
|
||||||
|
- here's
|
||||||
|
- how's
|
||||||
|
- i'm
|
||||||
|
- is
|
||||||
|
- isn't
|
||||||
|
- it's
|
||||||
|
- she's
|
||||||
|
- that's
|
||||||
|
- there's
|
||||||
|
- they're
|
||||||
|
- was
|
||||||
|
- wasn't
|
||||||
|
- we're
|
||||||
|
- were
|
||||||
|
- weren't
|
||||||
|
- what's
|
||||||
|
- where's
|
||||||
|
- who's
|
||||||
|
- you're
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
extends: repetition
|
||||||
|
message: "'%s' is repeated!"
|
||||||
|
level: warning
|
||||||
|
alpha: true
|
||||||
|
action:
|
||||||
|
name: edit
|
||||||
|
params:
|
||||||
|
- truncate
|
||||||
|
- " "
|
||||||
|
tokens:
|
||||||
|
- '[^\s]+'
|
||||||
@@ -0,0 +1,183 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "'%s' may be passive voice. Use active voice if you can."
|
||||||
|
ignorecase: true
|
||||||
|
level: warning
|
||||||
|
raw:
|
||||||
|
- \b(am|are|were|being|is|been|was|be)\b\s*
|
||||||
|
tokens:
|
||||||
|
- '[\w]+ed'
|
||||||
|
- awoken
|
||||||
|
- beat
|
||||||
|
- become
|
||||||
|
- been
|
||||||
|
- begun
|
||||||
|
- bent
|
||||||
|
- beset
|
||||||
|
- bet
|
||||||
|
- bid
|
||||||
|
- bidden
|
||||||
|
- bitten
|
||||||
|
- bled
|
||||||
|
- blown
|
||||||
|
- born
|
||||||
|
- bought
|
||||||
|
- bound
|
||||||
|
- bred
|
||||||
|
- broadcast
|
||||||
|
- broken
|
||||||
|
- brought
|
||||||
|
- built
|
||||||
|
- burnt
|
||||||
|
- burst
|
||||||
|
- cast
|
||||||
|
- caught
|
||||||
|
- chosen
|
||||||
|
- clung
|
||||||
|
- come
|
||||||
|
- cost
|
||||||
|
- crept
|
||||||
|
- cut
|
||||||
|
- dealt
|
||||||
|
- dived
|
||||||
|
- done
|
||||||
|
- drawn
|
||||||
|
- dreamt
|
||||||
|
- driven
|
||||||
|
- drunk
|
||||||
|
- dug
|
||||||
|
- eaten
|
||||||
|
- fallen
|
||||||
|
- fed
|
||||||
|
- felt
|
||||||
|
- fit
|
||||||
|
- fled
|
||||||
|
- flown
|
||||||
|
- flung
|
||||||
|
- forbidden
|
||||||
|
- foregone
|
||||||
|
- forgiven
|
||||||
|
- forgotten
|
||||||
|
- forsaken
|
||||||
|
- fought
|
||||||
|
- found
|
||||||
|
- frozen
|
||||||
|
- given
|
||||||
|
- gone
|
||||||
|
- gotten
|
||||||
|
- ground
|
||||||
|
- grown
|
||||||
|
- heard
|
||||||
|
- held
|
||||||
|
- hidden
|
||||||
|
- hit
|
||||||
|
- hung
|
||||||
|
- hurt
|
||||||
|
- kept
|
||||||
|
- knelt
|
||||||
|
- knit
|
||||||
|
- known
|
||||||
|
- laid
|
||||||
|
- lain
|
||||||
|
- leapt
|
||||||
|
- learnt
|
||||||
|
- led
|
||||||
|
- left
|
||||||
|
- lent
|
||||||
|
- let
|
||||||
|
- lighted
|
||||||
|
- lost
|
||||||
|
- made
|
||||||
|
- meant
|
||||||
|
- met
|
||||||
|
- misspelt
|
||||||
|
- mistaken
|
||||||
|
- mown
|
||||||
|
- overcome
|
||||||
|
- overdone
|
||||||
|
- overtaken
|
||||||
|
- overthrown
|
||||||
|
- paid
|
||||||
|
- pled
|
||||||
|
- proven
|
||||||
|
- put
|
||||||
|
- quit
|
||||||
|
- read
|
||||||
|
- rid
|
||||||
|
- ridden
|
||||||
|
- risen
|
||||||
|
- run
|
||||||
|
- rung
|
||||||
|
- said
|
||||||
|
- sat
|
||||||
|
- sawn
|
||||||
|
- seen
|
||||||
|
- sent
|
||||||
|
- set
|
||||||
|
- sewn
|
||||||
|
- shaken
|
||||||
|
- shaven
|
||||||
|
- shed
|
||||||
|
- shod
|
||||||
|
- shone
|
||||||
|
- shorn
|
||||||
|
- shot
|
||||||
|
- shown
|
||||||
|
- shrunk
|
||||||
|
- shut
|
||||||
|
- slain
|
||||||
|
- slept
|
||||||
|
- slid
|
||||||
|
- slit
|
||||||
|
- slung
|
||||||
|
- smitten
|
||||||
|
- sold
|
||||||
|
- sought
|
||||||
|
- sown
|
||||||
|
- sped
|
||||||
|
- spent
|
||||||
|
- spilt
|
||||||
|
- spit
|
||||||
|
- split
|
||||||
|
- spoken
|
||||||
|
- spread
|
||||||
|
- sprung
|
||||||
|
- spun
|
||||||
|
- stolen
|
||||||
|
- stood
|
||||||
|
- stridden
|
||||||
|
- striven
|
||||||
|
- struck
|
||||||
|
- strung
|
||||||
|
- stuck
|
||||||
|
- stung
|
||||||
|
- stunk
|
||||||
|
- sung
|
||||||
|
- sunk
|
||||||
|
- swept
|
||||||
|
- swollen
|
||||||
|
- sworn
|
||||||
|
- swum
|
||||||
|
- swung
|
||||||
|
- taken
|
||||||
|
- taught
|
||||||
|
- thought
|
||||||
|
- thrived
|
||||||
|
- thrown
|
||||||
|
- thrust
|
||||||
|
- told
|
||||||
|
- torn
|
||||||
|
- trodden
|
||||||
|
- understood
|
||||||
|
- upheld
|
||||||
|
- upset
|
||||||
|
- wed
|
||||||
|
- wept
|
||||||
|
- withheld
|
||||||
|
- withstood
|
||||||
|
- woken
|
||||||
|
- won
|
||||||
|
- worn
|
||||||
|
- wound
|
||||||
|
- woven
|
||||||
|
- written
|
||||||
|
- wrung
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
Based on [write-good](https://github.com/btford/write-good).
|
||||||
|
|
||||||
|
> Naive linter for English prose for developers who can't write good and wanna learn to do other stuff good too.
|
||||||
|
|
||||||
|
```
|
||||||
|
The MIT License (MIT)
|
||||||
|
|
||||||
|
Copyright (c) 2014 Brian Ford
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE.
|
||||||
|
```
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Don't start a sentence with '%s'."
|
||||||
|
level: error
|
||||||
|
raw:
|
||||||
|
- '(?:[;-]\s)so[\s,]|\bSo[\s,]'
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "Don't start a sentence with '%s'."
|
||||||
|
ignorecase: false
|
||||||
|
level: error
|
||||||
|
raw:
|
||||||
|
- '(?:[;-]\s)There\s(is|are)|\bThere\s(is|are)\b'
|
||||||
@@ -0,0 +1,221 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "'%s' is too wordy."
|
||||||
|
ignorecase: true
|
||||||
|
level: warning
|
||||||
|
tokens:
|
||||||
|
- a number of
|
||||||
|
- abundance
|
||||||
|
- accede to
|
||||||
|
- accelerate
|
||||||
|
- accentuate
|
||||||
|
- accompany
|
||||||
|
- accomplish
|
||||||
|
- accorded
|
||||||
|
- accrue
|
||||||
|
- acquiesce
|
||||||
|
- acquire
|
||||||
|
- additional
|
||||||
|
- adjacent to
|
||||||
|
- adjustment
|
||||||
|
- admissible
|
||||||
|
- advantageous
|
||||||
|
- adversely impact
|
||||||
|
- advise
|
||||||
|
- aforementioned
|
||||||
|
- aggregate
|
||||||
|
- aircraft
|
||||||
|
- all of
|
||||||
|
- all things considered
|
||||||
|
- alleviate
|
||||||
|
- allocate
|
||||||
|
- along the lines of
|
||||||
|
- already existing
|
||||||
|
- alternatively
|
||||||
|
- amazing
|
||||||
|
- ameliorate
|
||||||
|
- anticipate
|
||||||
|
- apparent
|
||||||
|
- appreciable
|
||||||
|
- as a matter of fact
|
||||||
|
- as a means of
|
||||||
|
- as far as I'm concerned
|
||||||
|
- as of yet
|
||||||
|
- as to
|
||||||
|
- as yet
|
||||||
|
- ascertain
|
||||||
|
- assistance
|
||||||
|
- at the present time
|
||||||
|
- at this time
|
||||||
|
- attain
|
||||||
|
- attributable to
|
||||||
|
- authorize
|
||||||
|
- because of the fact that
|
||||||
|
- belated
|
||||||
|
- benefit from
|
||||||
|
- bestow
|
||||||
|
- by means of
|
||||||
|
- by virtue of
|
||||||
|
- by virtue of the fact that
|
||||||
|
- cease
|
||||||
|
- close proximity
|
||||||
|
- commence
|
||||||
|
- comply with
|
||||||
|
- concerning
|
||||||
|
- consequently
|
||||||
|
- consolidate
|
||||||
|
- constitutes
|
||||||
|
- demonstrate
|
||||||
|
- depart
|
||||||
|
- designate
|
||||||
|
- discontinue
|
||||||
|
- due to the fact that
|
||||||
|
- each and every
|
||||||
|
- economical
|
||||||
|
- eliminate
|
||||||
|
- elucidate
|
||||||
|
- employ
|
||||||
|
- endeavor
|
||||||
|
- enumerate
|
||||||
|
- equitable
|
||||||
|
- equivalent
|
||||||
|
- evaluate
|
||||||
|
- evidenced
|
||||||
|
- exclusively
|
||||||
|
- expedite
|
||||||
|
- expend
|
||||||
|
- expiration
|
||||||
|
- facilitate
|
||||||
|
- factual evidence
|
||||||
|
- feasible
|
||||||
|
- finalize
|
||||||
|
- first and foremost
|
||||||
|
- for all intents and purposes
|
||||||
|
- for the most part
|
||||||
|
- for the purpose of
|
||||||
|
- forfeit
|
||||||
|
- formulate
|
||||||
|
- have a tendency to
|
||||||
|
- honest truth
|
||||||
|
- however
|
||||||
|
- if and when
|
||||||
|
- impacted
|
||||||
|
- implement
|
||||||
|
- in a manner of speaking
|
||||||
|
- in a timely manner
|
||||||
|
- in a very real sense
|
||||||
|
- in accordance with
|
||||||
|
- in addition
|
||||||
|
- in all likelihood
|
||||||
|
- in an effort to
|
||||||
|
- in between
|
||||||
|
- in excess of
|
||||||
|
- in lieu of
|
||||||
|
- in light of the fact that
|
||||||
|
- in many cases
|
||||||
|
- in my opinion
|
||||||
|
- in order to
|
||||||
|
- in regard to
|
||||||
|
- in some instances
|
||||||
|
- in terms of
|
||||||
|
- in the case of
|
||||||
|
- in the event that
|
||||||
|
- in the final analysis
|
||||||
|
- in the nature of
|
||||||
|
- in the near future
|
||||||
|
- in the process of
|
||||||
|
- inception
|
||||||
|
- incumbent upon
|
||||||
|
- indicate
|
||||||
|
- indication
|
||||||
|
- initiate
|
||||||
|
- irregardless
|
||||||
|
- is applicable to
|
||||||
|
- is authorized to
|
||||||
|
- is responsible for
|
||||||
|
- it is
|
||||||
|
- it is essential
|
||||||
|
- it seems that
|
||||||
|
- it was
|
||||||
|
- magnitude
|
||||||
|
- maximum
|
||||||
|
- methodology
|
||||||
|
- minimize
|
||||||
|
- minimum
|
||||||
|
- modify
|
||||||
|
- monitor
|
||||||
|
- multiple
|
||||||
|
- necessitate
|
||||||
|
- nevertheless
|
||||||
|
- not certain
|
||||||
|
- not many
|
||||||
|
- not often
|
||||||
|
- not unless
|
||||||
|
- not unlike
|
||||||
|
- notwithstanding
|
||||||
|
- null and void
|
||||||
|
- numerous
|
||||||
|
- objective
|
||||||
|
- obligate
|
||||||
|
- obtain
|
||||||
|
- on the contrary
|
||||||
|
- on the other hand
|
||||||
|
- one particular
|
||||||
|
- optimum
|
||||||
|
- overall
|
||||||
|
- owing to the fact that
|
||||||
|
- participate
|
||||||
|
- particulars
|
||||||
|
- pass away
|
||||||
|
- pertaining to
|
||||||
|
- point in time
|
||||||
|
- portion
|
||||||
|
- possess
|
||||||
|
- preclude
|
||||||
|
- previously
|
||||||
|
- prior to
|
||||||
|
- prioritize
|
||||||
|
- procure
|
||||||
|
- proficiency
|
||||||
|
- provided that
|
||||||
|
- purchase
|
||||||
|
- put simply
|
||||||
|
- readily apparent
|
||||||
|
- refer back
|
||||||
|
- regarding
|
||||||
|
- relocate
|
||||||
|
- remainder
|
||||||
|
- remuneration
|
||||||
|
- requirement
|
||||||
|
- reside
|
||||||
|
- residence
|
||||||
|
- retain
|
||||||
|
- satisfy
|
||||||
|
- shall
|
||||||
|
- should you wish
|
||||||
|
- similar to
|
||||||
|
- solicit
|
||||||
|
- span across
|
||||||
|
- strategize
|
||||||
|
- subsequent
|
||||||
|
- substantial
|
||||||
|
- successfully complete
|
||||||
|
- sufficient
|
||||||
|
- terminate
|
||||||
|
- the month of
|
||||||
|
- the point I am trying to make
|
||||||
|
- therefore
|
||||||
|
- time period
|
||||||
|
- took advantage of
|
||||||
|
- transmit
|
||||||
|
- transpire
|
||||||
|
- type of
|
||||||
|
- until such time as
|
||||||
|
- utilization
|
||||||
|
- utilize
|
||||||
|
- validate
|
||||||
|
- various different
|
||||||
|
- what I mean to say is
|
||||||
|
- whether or not
|
||||||
|
- with respect to
|
||||||
|
- with the exception of
|
||||||
|
- witnessed
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
extends: existence
|
||||||
|
message: "'%s' is a weasel word!"
|
||||||
|
ignorecase: true
|
||||||
|
level: warning
|
||||||
|
tokens:
|
||||||
|
- clearly
|
||||||
|
- completely
|
||||||
|
- exceedingly
|
||||||
|
- excellent
|
||||||
|
- extremely
|
||||||
|
- fairly
|
||||||
|
- huge
|
||||||
|
- interestingly
|
||||||
|
- is a number
|
||||||
|
- largely
|
||||||
|
- mostly
|
||||||
|
- obviously
|
||||||
|
- quite
|
||||||
|
- relatively
|
||||||
|
- remarkably
|
||||||
|
- several
|
||||||
|
- significantly
|
||||||
|
- substantially
|
||||||
|
- surprisingly
|
||||||
|
- tiny
|
||||||
|
- usually
|
||||||
|
- various
|
||||||
|
- vast
|
||||||
|
- very
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
{
|
||||||
|
"feed": "https://github.com/errata-ai/write-good/releases.atom",
|
||||||
|
"vale_version": ">=1.0.0"
|
||||||
|
}
|
||||||
@@ -326,14 +326,14 @@ setuptools via `dynamic = ["version"]` in `pyproject.toml`.
|
|||||||
|
|
||||||
### Task ID Resolution
|
### Task ID Resolution
|
||||||
|
|
||||||
`auto_merge` resolves the task ID solely from the branch name (e.g.
|
`auto_merge` resolves the task ID solely from the branch name (for example
|
||||||
`DEVX-12-fix-foo` → `DEVX-12`). Branch names must include the task ID
|
`DEVX-12-fix-foo` → `DEVX-12`). Branch names must include the task ID
|
||||||
prefix — there is no `.taskid` file fallback. If a stale `.taskid` file
|
prefix — there is no `.taskid` file fallback. If a stale `.taskid` file
|
||||||
exists in the repo, a deprecation warning is printed advising its removal.
|
exists in the repo, a deprecation warning is printed advising its removal.
|
||||||
|
|
||||||
### Workflow `auto-merge` Job and `always()`
|
### Workflow `auto-merge` Job and `always()`
|
||||||
|
|
||||||
When `auto-merge` depends on a job that can be skipped (e.g.
|
When `auto-merge` depends on a job that can be skipped (for example
|
||||||
`molecule-tests`), the `if:` condition MUST include `always() &&`
|
`molecule-tests`), the `if:` condition MUST include `always() &&`
|
||||||
at the start. Without it, Gitea Actions skips `auto-merge` when any
|
at the start. Without it, Gitea Actions skips `auto-merge` when any
|
||||||
dependency is skipped, even if the condition explicitly allows
|
dependency is skipped, even if the condition explicitly allows
|
||||||
@@ -365,7 +365,7 @@ balanced distribution when test items have varying costs:
|
|||||||
2. **LPT assignment**: Items are sorted by weight (descending), then
|
2. **LPT assignment**: Items are sorted by weight (descending), then
|
||||||
each is assigned to the runner with the least total weight.
|
each is assigned to the runner with the least total weight.
|
||||||
|
|
||||||
This ensures heavy scenarios (e.g. `nextcloud`) are spread across
|
This ensures heavy scenarios (for example `nextcloud`) are spread across
|
||||||
different runners rather than clustered on one, reducing the
|
different runners rather than clustered on one, reducing the
|
||||||
longest-runner time from ~16 min to ~11 min with 6 runners.
|
longest-runner time from ~16 min to ~11 min with 6 runners.
|
||||||
|
|
||||||
@@ -400,7 +400,7 @@ the `[tool.devx]` section in `pyproject.toml`. This allows per-project
|
|||||||
customization without environment variables.
|
customization without environment variables.
|
||||||
|
|
||||||
**Base config** (`[tool.devx]`):
|
**Base config** (`[tool.devx]`):
|
||||||
- `task_prefix` — Task ID prefix (e.g. `"DEVX"`, `"GRM"`, `"OBL-INFRA"`)
|
- `task_prefix` — Task ID prefix (for example `"DEVX"`, `"GRM"`, `"OBL-INFRA"`)
|
||||||
- `vikunja_project_id` — Vikunja project ID
|
- `vikunja_project_id` — Vikunja project ID
|
||||||
- `repo_owner` / `repo_name` — Gitea repository coordinates
|
- `repo_owner` / `repo_name` — Gitea repository coordinates
|
||||||
- `gitea_api_url` / `vikunja_api_url` — API endpoints
|
- `gitea_api_url` / `vikunja_api_url` — API endpoints
|
||||||
|
|||||||
@@ -87,7 +87,7 @@ extra index and list devx in your dependencies:
|
|||||||
```toml
|
```toml
|
||||||
[project]
|
[project]
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"devx>=0.27.0",
|
"devx>=0.33.4",
|
||||||
]
|
]
|
||||||
|
|
||||||
[tool.pip]
|
[tool.pip]
|
||||||
@@ -101,8 +101,8 @@ pip install -e .
|
|||||||
```
|
```
|
||||||
|
|
||||||
> **Note:** If your project requires a specific devx version, pin it in
|
> **Note:** If your project requires a specific devx version, pin it in
|
||||||
> `dependencies` (e.g., `"devx==0.27.0"`) or use a version constraint
|
> `dependencies` (for example, `"devx==0.33.4"`) or use a version constraint
|
||||||
> (e.g., `"devx>=0.27.0,<0.28"`).
|
> (for example, `"devx>=0.33.4,<0.34"`).
|
||||||
|
|
||||||
### Optional extras
|
### Optional extras
|
||||||
|
|
||||||
@@ -420,7 +420,7 @@ make clean # Remove caches, build artifacts, coverage data
|
|||||||
| `make lint-deps` | pip-audit dependency vulnerability scan |
|
| `make lint-deps` | pip-audit dependency vulnerability scan |
|
||||||
| `make test-unit` | Unit tests without coverage |
|
| `make test-unit` | Unit tests without coverage |
|
||||||
| `make pytest-cov` | Unit tests with 100% coverage enforcement |
|
| `make pytest-cov` | Unit tests with 100% coverage enforcement |
|
||||||
| `make workflow-lint` | actionlint on .gitea/workflows/*.yml |
|
| `make workflow-lint` | actionlint on `.gitea/workflows/*.yml` |
|
||||||
| `make workflow-dryrun` | act_runner exec --dryrun on all workflows |
|
| `make workflow-dryrun` | act_runner exec --dryrun on all workflows |
|
||||||
| `make workflow-check` | workflow-lint + workflow-dryrun |
|
| `make workflow-check` | workflow-lint + workflow-dryrun |
|
||||||
| `make clean` | Remove caches, build artifacts, coverage data |
|
| `make clean` | Remove caches, build artifacts, coverage data |
|
||||||
|
|||||||
+2
-2
@@ -74,14 +74,14 @@ Add devx to your `pyproject.toml` dependencies and configure the registry:
|
|||||||
```toml
|
```toml
|
||||||
[project]
|
[project]
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"devx>=0.27.0",
|
"devx>=0.33.4",
|
||||||
]
|
]
|
||||||
|
|
||||||
[tool.pip]
|
[tool.pip]
|
||||||
extra-index-url = "https://git.oblachno.oblachno.fyi/api/packages/oblachno-oss/pypi/simple"
|
extra-index-url = "https://git.oblachno.oblachno.fyi/api/packages/oblachno-oss/pypi/simple"
|
||||||
```
|
```
|
||||||
|
|
||||||
Pin a specific version if needed: `"devx==0.27.0"` or `"devx>=0.27.0,<0.28"`.
|
Pin a specific version if needed: `"devx==0.33.4"` or `"devx>=0.33.4,<0.34"`.
|
||||||
|
|
||||||
### Optional extras
|
### Optional extras
|
||||||
|
|
||||||
|
|||||||
@@ -86,7 +86,7 @@ overridden via environment variables with the `DEVX_` prefix. Provides:
|
|||||||
|
|
||||||
- `GITEA_API_URL` / `VIKUNJA_API_URL` — API endpoints
|
- `GITEA_API_URL` / `VIKUNJA_API_URL` — API endpoints
|
||||||
- `REPO_OWNER` — repository owner (must be set per-project)
|
- `REPO_OWNER` — repository owner (must be set per-project)
|
||||||
- `TASK_PREFIX` / `TASK_ID_RE` — task ID prefix and regex (e.g., `DEVX-N`)
|
- `TASK_PREFIX` / `TASK_ID_RE` — task ID prefix and regex (for example, `DEVX-N`)
|
||||||
- `VIKUNJA_PROJECT_ID` — Vikunja project for task tracking
|
- `VIKUNJA_PROJECT_ID` — Vikunja project for task tracking
|
||||||
- `DEFAULT_TIMEOUT`, `DEFAULT_PER_PAGE` — HTTP client defaults
|
- `DEFAULT_TIMEOUT`, `DEFAULT_PER_PAGE` — HTTP client defaults
|
||||||
- `MAX_RETRIES`, `RETRY_BACKOFF_BASE`, `RETRY_STATUS_CODES` — retry config
|
- `MAX_RETRIES`, `RETRY_BACKOFF_BASE`, `RETRY_STATUS_CODES` — retry config
|
||||||
@@ -206,7 +206,7 @@ a layered rule system configured in `pyproject.toml` under
|
|||||||
4. **Default**: user-facing (safe default — any unknown file triggers release)
|
4. **Default**: user-facing (safe default — any unknown file triggers release)
|
||||||
|
|
||||||
Also supports custom tags (orthogonal to release impact) for CI conditional
|
Also supports custom tags (orthogonal to release impact) for CI conditional
|
||||||
execution (e.g., `ansible` tag to trigger molecule tests).
|
execution (for example, `ansible` tag to trigger molecule tests).
|
||||||
|
|
||||||
### `pr_review.py`
|
### `pr_review.py`
|
||||||
|
|
||||||
@@ -432,7 +432,7 @@ v2 failures. Supports loading custom platforms from a JSON file.
|
|||||||
3. **Tool modules** (`devx.tools.*`) may import from `devx.api_clients`,
|
3. **Tool modules** (`devx.tools.*`) may import from `devx.api_clients`,
|
||||||
`devx.config`, `devx.gitea_cli`
|
`devx.config`, `devx.gitea_cli`
|
||||||
4. **Cross-module imports** within `devx.ci.*` or `devx.tools.*` are allowed
|
4. **Cross-module imports** within `devx.ci.*` or `devx.tools.*` are allowed
|
||||||
but must be documented (e.g., `release.py` imports from
|
but must be documented (for example, `release.py` imports from
|
||||||
`classify_changes.py`)
|
`classify_changes.py`)
|
||||||
|
|
||||||
## Data flow
|
## Data flow
|
||||||
|
|||||||
@@ -93,7 +93,7 @@ Depends on `quality`, `detect-changes`, and `pr-review`. The final job in the
|
|||||||
CI workflow. Runs `python -m devx.ci.auto_merge` with the branch name, PR
|
CI workflow. Runs `python -m devx.ci.auto_merge` with the branch name, PR
|
||||||
title, repository, and PR number:
|
title, repository, and PR number:
|
||||||
|
|
||||||
1. **Read task ID** from branch name (e.g., `DEVX-12-fix-foo` → `DEVX-12`)
|
1. **Read task ID** from branch name (for example, `DEVX-12-fix-foo` → `DEVX-12`)
|
||||||
2. **Validate PR title format** — must be `{PREFIX}-N: <vikunja task title>`
|
2. **Validate PR title format** — must be `{PREFIX}-N: <vikunja task title>`
|
||||||
3. **Validate PR title matches Vikunja task** — fetches the Vikunja task and
|
3. **Validate PR title matches Vikunja task** — fetches the Vikunja task and
|
||||||
compares the title
|
compares the title
|
||||||
@@ -205,7 +205,7 @@ automation job. Runs `python -m devx.ci.release`:
|
|||||||
8. **Push** — pushes both the commit and tag to master
|
8. **Push** — pushes both the commit and tag to master
|
||||||
|
|
||||||
The script is idempotent: if there are no new conventional commits since the
|
The script is idempotent: if there are no new conventional commits since the
|
||||||
last tag, it exits without doing anything. If the tag already exists (e.g.,
|
last tag, it exits without doing anything. If the tag already exists (for example,
|
||||||
from a partial previous run), it skips tag creation and only pushes.
|
from a partial previous run), it skips tag creation and only pushes.
|
||||||
|
|
||||||
**Tag consistency**: Before releasing, the script fetches remote tags and
|
**Tag consistency**: Before releasing, the script fetches remote tags and
|
||||||
@@ -329,7 +329,7 @@ On failure, the `notify_failure` step creates a Gitea issue.
|
|||||||
### `auto_merge.py`
|
### `auto_merge.py`
|
||||||
|
|
||||||
Auto-merge PR when all CI checks pass. Reads task ID from the branch name
|
Auto-merge PR when all CI checks pass. Reads task ID from the branch name
|
||||||
(e.g., `DEVX-12-fix-foo` → `DEVX-12`). Validates PR title format, checks the
|
(for example, `DEVX-12-fix-foo` → `DEVX-12`). Validates PR title format, checks the
|
||||||
Vikunja task exists and the title matches, extracts the conventional commit
|
Vikunja task exists and the title matches, extracts the conventional commit
|
||||||
message from PR commits, and squash-merges with
|
message from PR commits, and squash-merges with
|
||||||
`{PREFIX}-N <conventional commit>` title.
|
`{PREFIX}-N <conventional commit>` title.
|
||||||
|
|||||||
@@ -48,12 +48,12 @@ Add devx to your `pyproject.toml`:
|
|||||||
```toml
|
```toml
|
||||||
[project]
|
[project]
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"devx>=0.27.0",
|
"devx>=0.33.4",
|
||||||
]
|
]
|
||||||
|
|
||||||
[project.optional-dependencies]
|
[project.optional-dependencies]
|
||||||
dev = [
|
dev = [
|
||||||
"devx[dev]>=0.27.0",
|
"devx>=0.33.4",
|
||||||
]
|
]
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
@@ -87,19 +87,26 @@ def push_to_badges_branch(badges_dir: str) -> str:
|
|||||||
|
|
||||||
Returns the commit SHA of the pushed badges branch.
|
Returns the commit SHA of the pushed badges branch.
|
||||||
"""
|
"""
|
||||||
|
import shutil
|
||||||
|
|
||||||
_run(["git", "config", "user.name", "gitea-actions-bot"]) # nosec B607
|
_run(["git", "config", "user.name", "gitea-actions-bot"]) # nosec B607
|
||||||
_run(["git", "config", "user.email", "actions@oblachno.fyi"]) # nosec B607
|
_run(["git", "config", "user.email", "actions@oblachno.fyi"]) # nosec B607
|
||||||
_run(["git", "checkout", "--orphan", "badges"]) # nosec B607
|
_run(["git", "checkout", "--orphan", "badges"]) # nosec B607
|
||||||
_run(["git", "rm", "-rf", "."]) # nosec B607
|
_run(["git", "rm", "-rf", "."]) # nosec B607
|
||||||
|
# Remove untracked files/dirs left behind (e.g. .badges/ from generate_badges)
|
||||||
|
_run(["git", "clean", "-fdx", "-e", ".git"]) # nosec B607
|
||||||
|
|
||||||
# Copy badge files to root
|
# Copy badge files to root
|
||||||
import shutil
|
|
||||||
|
|
||||||
for svg in Path(badges_dir).glob("*.svg"):
|
for svg in Path(badges_dir).glob("*.svg"):
|
||||||
shutil.copy2(svg, Path.cwd() / svg.name)
|
shutil.copy2(svg, Path.cwd() / svg.name)
|
||||||
|
|
||||||
_run(["git", "add", "./*.svg"]) # nosec B607
|
_run(["git", "add", "./*.svg"]) # nosec B607
|
||||||
_run(["git", "commit", "--no-verify", "-m", "Update badges [skip ci]"]) # nosec B607
|
# Commit even if no changes (ensures badges branch always exists)
|
||||||
|
result = _run_capture(["git", "diff", "--cached", "--name-only"]) # nosec B607
|
||||||
|
if result.stdout.strip():
|
||||||
|
_run(["git", "commit", "--no-verify", "-m", "Update badges [skip ci]"]) # nosec B607
|
||||||
|
else:
|
||||||
|
click.echo(_("No badge changes — skipping commit"))
|
||||||
_run(["git", "push", "origin", "badges", "--force"]) # nosec B607
|
_run(["git", "push", "origin", "badges", "--force"]) # nosec B607
|
||||||
click.echo(_("Badges pushed to badges branch"))
|
click.echo(_("Badges pushed to badges branch"))
|
||||||
|
|
||||||
@@ -135,6 +142,22 @@ def update_readme_with_badge_sha(badges_sha: str, repo_root: Path | None = None)
|
|||||||
_run(["git", "fetch", "origin", "master"]) # nosec B607
|
_run(["git", "fetch", "origin", "master"]) # nosec B607
|
||||||
_run(["git", "reset", "--hard", "origin/master"]) # nosec B607
|
_run(["git", "reset", "--hard", "origin/master"]) # nosec B607
|
||||||
|
|
||||||
|
# Verify version badge matches current __version__
|
||||||
|
from devx.tools.generate_badges import detect_package_name, read_version
|
||||||
|
|
||||||
|
pkg = detect_package_name(root)
|
||||||
|
current_version = read_version(root) if pkg else "unknown"
|
||||||
|
version_svg = Path(".badges") / "version.svg"
|
||||||
|
if version_svg.exists():
|
||||||
|
svg_content = version_svg.read_text()
|
||||||
|
if current_version != "unknown" and f"v{current_version}" not in svg_content:
|
||||||
|
click.echo(
|
||||||
|
_(
|
||||||
|
"WARNING: Version badge shows stale version (expected v{version}) — regenerating",
|
||||||
|
version=current_version,
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
updated_any = False
|
updated_any = False
|
||||||
for filename in FILES_WITH_BADGE_URLS:
|
for filename in FILES_WITH_BADGE_URLS:
|
||||||
filepath = root / filename
|
filepath = root / filename
|
||||||
|
|||||||
+31
-1
@@ -246,6 +246,32 @@ def update_changelog(changelog: str) -> None:
|
|||||||
f.write(updated)
|
f.write(updated)
|
||||||
|
|
||||||
|
|
||||||
|
def update_doc_versions(new_version: str) -> None:
|
||||||
|
"""Update documentation version references to match the new release.
|
||||||
|
|
||||||
|
Runs ``check_doc_versions --fix`` so that README.md and docs/*.md
|
||||||
|
always reference the latest released version.
|
||||||
|
"""
|
||||||
|
import subprocess # nosec B404
|
||||||
|
|
||||||
|
result = subprocess.run( # nosec B603
|
||||||
|
[sys.executable, "-m", "devx.tools.check_doc_versions", "--fix"],
|
||||||
|
check=False,
|
||||||
|
text=True,
|
||||||
|
capture_output=True,
|
||||||
|
)
|
||||||
|
if result.returncode == 0:
|
||||||
|
click.echo(_("Updated documentation version references to v{version}", version=new_version))
|
||||||
|
else:
|
||||||
|
click.echo(
|
||||||
|
_(
|
||||||
|
"WARNING: check_doc_versions --fix failed (rc={rc}): {err}",
|
||||||
|
rc=result.returncode,
|
||||||
|
err=result.stderr.strip()[:200],
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
def commit_release_changes(new_version: str) -> bool:
|
def commit_release_changes(new_version: str) -> bool:
|
||||||
"""Stage version file and changelog, then create a release commit.
|
"""Stage version file and changelog, then create a release commit.
|
||||||
|
|
||||||
@@ -255,7 +281,7 @@ def commit_release_changes(new_version: str) -> bool:
|
|||||||
commits are a special case generated by the release script.
|
commits are a special case generated by the release script.
|
||||||
Returns True if a commit was created, False if there were no staged changes.
|
Returns True if a commit was created, False if there were no staged changes.
|
||||||
"""
|
"""
|
||||||
run_cmd(["git", "add", INIT_FILE, CHANGELOG_FILE])
|
run_cmd(["git", "add", INIT_FILE, CHANGELOG_FILE, "README.md", "docs/"])
|
||||||
status = run_cmd(["git", "diff", "--cached", "--quiet"], check=False)
|
status = run_cmd(["git", "diff", "--cached", "--quiet"], check=False)
|
||||||
if status.returncode == 0:
|
if status.returncode == 0:
|
||||||
click.echo(_("No staged changes — version and changelog already up to date."))
|
click.echo(_("No staged changes — version and changelog already up to date."))
|
||||||
@@ -684,6 +710,7 @@ def main(dry_run: bool, skip_tests: bool, verify: bool) -> None:
|
|||||||
click.echo(_("\n[dry-run] Changelog:\n{changelog}", changelog=changelog))
|
click.echo(_("\n[dry-run] Changelog:\n{changelog}", changelog=changelog))
|
||||||
click.echo(_("[dry-run] Would update {init}", init=INIT_FILE))
|
click.echo(_("[dry-run] Would update {init}", init=INIT_FILE))
|
||||||
click.echo(_("[dry-run] Would update {changelog_file}", changelog_file=CHANGELOG_FILE))
|
click.echo(_("[dry-run] Would update {changelog_file}", changelog_file=CHANGELOG_FILE))
|
||||||
|
click.echo(_("[dry-run] Would update doc version references via check_doc_versions --fix"))
|
||||||
click.echo(_("[dry-run] Would commit: release: v{version} [skip ci]", version=new_version))
|
click.echo(_("[dry-run] Would commit: release: v{version} [skip ci]", version=new_version))
|
||||||
click.echo(_("[dry-run] Would push commit to master"))
|
click.echo(_("[dry-run] Would push commit to master"))
|
||||||
click.echo(_("[dry-run] Would create tag: v{version}", version=new_version))
|
click.echo(_("[dry-run] Would create tag: v{version}", version=new_version))
|
||||||
@@ -697,6 +724,9 @@ def main(dry_run: bool, skip_tests: bool, verify: bool) -> None:
|
|||||||
update_changelog(changelog)
|
update_changelog(changelog)
|
||||||
click.echo(_("Updated {changelog_file}", changelog_file=CHANGELOG_FILE))
|
click.echo(_("Updated {changelog_file}", changelog_file=CHANGELOG_FILE))
|
||||||
|
|
||||||
|
# Update documentation version references (README, docs/*.md)
|
||||||
|
update_doc_versions(new_version)
|
||||||
|
|
||||||
# Verify tests pass BEFORE committing or tagging.
|
# Verify tests pass BEFORE committing or tagging.
|
||||||
# This ensures we never release a version that fails tests.
|
# This ensures we never release a version that fails tests.
|
||||||
if skip_tests:
|
if skip_tests:
|
||||||
|
|||||||
+10
-1
@@ -109,7 +109,7 @@ devx-ensure-venv:
|
|||||||
.PHONY: devx-notify-failure devx-install-hooks devx-activate-scripts devx-venv devx-ensure-venv
|
.PHONY: devx-notify-failure devx-install-hooks devx-activate-scripts devx-venv devx-ensure-venv
|
||||||
.PHONY: devx-lint-ruff devx-lint-format devx-typecheck devx-lint-bandit devx-lint-deps devx-lint
|
.PHONY: devx-lint-ruff devx-lint-format devx-typecheck devx-lint-bandit devx-lint-deps devx-lint
|
||||||
.PHONY: devx-clean devx-pre-push
|
.PHONY: devx-clean devx-pre-push
|
||||||
.PHONY: devx-check-mutable-globals devx-check-dep-docs devx-check-test-coverage devx-check-docs devx-check-test-speed
|
.PHONY: devx-check-mutable-globals devx-check-dep-docs devx-check-test-coverage devx-check-docs devx-check-test-speed devx-check-doc-versions devx-vale
|
||||||
.PHONY: devx-check-api-identity-checks devx-setup-ssh-key
|
.PHONY: devx-check-api-identity-checks devx-setup-ssh-key
|
||||||
.PHONY: devx-test-unit devx-pytest-cov
|
.PHONY: devx-test-unit devx-pytest-cov
|
||||||
.PHONY: devx-setup-image devx-lint-dockerfiles
|
.PHONY: devx-setup-image devx-lint-dockerfiles
|
||||||
@@ -324,6 +324,15 @@ devx-check-test-coverage:
|
|||||||
devx-check-docs:
|
devx-check-docs:
|
||||||
@$(DEVX_PYTHON) -m devx.tools.check_agent_docs
|
@$(DEVX_PYTHON) -m devx.tools.check_agent_docs
|
||||||
|
|
||||||
|
# Check documentation version references match current package version
|
||||||
|
devx-check-doc-versions:
|
||||||
|
@$(DEVX_PYTHON) -m devx.tools.check_doc_versions --root .
|
||||||
|
|
||||||
|
# Run Vale prose linter on docs and README
|
||||||
|
devx-vale:
|
||||||
|
@export PATH="$$HOME/.local/bin:$$PATH" && \
|
||||||
|
vale --minAlertLevel=error docs/ AGENTS.md README.md
|
||||||
|
|
||||||
# Verify test suite timing
|
# Verify test suite timing
|
||||||
devx-check-test-speed:
|
devx-check-test-speed:
|
||||||
@$(DEVX_PYTHON) -m devx.tools.check_test_speed
|
@$(DEVX_PYTHON) -m devx.tools.check_test_speed
|
||||||
|
|||||||
@@ -0,0 +1,203 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
"""Check that documentation version references match the current package version.
|
||||||
|
|
||||||
|
Scans README.md and docs/*.md for version references like ``">=X.Y.Z"``,
|
||||||
|
``"==X.Y.Z"``, or ``"X.Y.Z"`` and verifies they match the current
|
||||||
|
``__version__`` from ``src/<package>/__init__.py``.
|
||||||
|
|
||||||
|
Stale version references mislead users into pinning outdated versions.
|
||||||
|
This tool catches them in CI and can auto-fix with ``--fix``.
|
||||||
|
|
||||||
|
Usage::
|
||||||
|
|
||||||
|
python3 -m devx.tools.check_doc_versions
|
||||||
|
python3 -m devx.tools.check_doc_versions --fix
|
||||||
|
python3 -m devx.tools.check_doc_versions --root . --package devx
|
||||||
|
"""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import re
|
||||||
|
import sys
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
import click
|
||||||
|
|
||||||
|
from devx.i18n import _
|
||||||
|
|
||||||
|
# Pattern to find version references in pip install / pyproject strings
|
||||||
|
# Matches: "devx>=0.27.0", "devx==0.27.0", "devx[dev]>=0.27.0", etc.
|
||||||
|
_VERSION_REF_RE = re.compile(
|
||||||
|
r'(["\'])(?P<pkg>[\w-]+)' # package name in quotes
|
||||||
|
r"(?:\[[\w,]+\])?" # optional extras like [dev]
|
||||||
|
r"\s*(?P<op>>=|==|>|<|<=|~=)\s*"
|
||||||
|
r"(?P<version>\d+\.\d+(?:\.\d+)?)" # version number
|
||||||
|
r'(?P<rest>[^"\']*)\1' # rest of string until closing quote
|
||||||
|
)
|
||||||
|
|
||||||
|
# Simpler pattern: bare version numbers in "Pin a specific version" context
|
||||||
|
_PIN_RE = re.compile(r'["\'](?P<pkg>[\w-]+)==(?P<version>\d+\.\d+(?:\.\d+)?)["\']')
|
||||||
|
|
||||||
|
|
||||||
|
def detect_package_name(repo_root: Path) -> str | None:
|
||||||
|
"""Auto-detect the Python package name from src/ directory."""
|
||||||
|
src_dir = repo_root / "src"
|
||||||
|
if not src_dir.is_dir():
|
||||||
|
return None
|
||||||
|
for entry in sorted(src_dir.iterdir()):
|
||||||
|
if not entry.is_dir():
|
||||||
|
continue
|
||||||
|
init_file = entry / "__init__.py"
|
||||||
|
if init_file.exists():
|
||||||
|
return entry.name
|
||||||
|
return None
|
||||||
|
|
||||||
|
|
||||||
|
def read_version(repo_root: Path, package: str | None = None) -> str | None:
|
||||||
|
"""Read __version__ from the package __init__.py."""
|
||||||
|
pkg = package or detect_package_name(repo_root)
|
||||||
|
if pkg is None:
|
||||||
|
return None
|
||||||
|
init_file = repo_root / "src" / pkg / "__init__.py"
|
||||||
|
if not init_file.exists():
|
||||||
|
return None
|
||||||
|
content = init_file.read_text()
|
||||||
|
match = re.search(r'__version__\s*=\s*["\']([^"\']+)["\']', content)
|
||||||
|
return match.group(1) if match else None
|
||||||
|
|
||||||
|
|
||||||
|
def find_version_refs(content: str, package: str) -> list[tuple[int, str, str, str, str]]:
|
||||||
|
"""Find all version references for the package in content.
|
||||||
|
|
||||||
|
Returns list of (line_num, full_match, operator, referenced_version, rest).
|
||||||
|
"""
|
||||||
|
refs: list[tuple[int, str, str, str, str]] = []
|
||||||
|
for match in _VERSION_REF_RE.finditer(content):
|
||||||
|
if match.group("pkg").lower() != package.lower():
|
||||||
|
continue
|
||||||
|
line_num = content[: match.start()].count("\n") + 1
|
||||||
|
refs.append(
|
||||||
|
(
|
||||||
|
line_num,
|
||||||
|
match.group(0),
|
||||||
|
match.group("op"),
|
||||||
|
match.group("version"),
|
||||||
|
match.group("rest"),
|
||||||
|
)
|
||||||
|
)
|
||||||
|
return refs
|
||||||
|
|
||||||
|
|
||||||
|
def fix_version_refs(content: str, package: str, current_version: str) -> tuple[str, int]:
|
||||||
|
"""Replace stale version references with the current version.
|
||||||
|
|
||||||
|
Also updates upper bounds like ``<0.28`` to the next minor (``<0.34``
|
||||||
|
for v0.33.4) so the constraint stays valid.
|
||||||
|
|
||||||
|
Returns (new_content, num_fixes).
|
||||||
|
"""
|
||||||
|
fixes = 0
|
||||||
|
# Compute next minor for upper bound updates
|
||||||
|
parts = current_version.split(".")
|
||||||
|
next_minor = f"{parts[0]}.{int(parts[1]) + 1}" if len(parts) >= 2 else current_version # noqa: SIM108 — clarity
|
||||||
|
|
||||||
|
# Pattern for upper bound in the "rest" part: ,<X.Y
|
||||||
|
_upper_bound_re = re.compile(r",<\d+\.\d+(?:\.\d+)?")
|
||||||
|
|
||||||
|
def replacer(match: re.Match) -> str:
|
||||||
|
nonlocal fixes
|
||||||
|
if match.group("pkg").lower() != package.lower():
|
||||||
|
return match.group(0)
|
||||||
|
old_version = match.group("version")
|
||||||
|
if old_version == current_version:
|
||||||
|
return match.group(0)
|
||||||
|
fixes += 1
|
||||||
|
quote = match.group(1)
|
||||||
|
pkg = match.group("pkg")
|
||||||
|
op = match.group("op")
|
||||||
|
rest = match.group("rest")
|
||||||
|
# Update upper bound if present
|
||||||
|
rest = _upper_bound_re.sub(f",<{next_minor}", rest)
|
||||||
|
return f"{quote}{pkg}{op}{current_version}{rest}{quote}"
|
||||||
|
|
||||||
|
new_content = _VERSION_REF_RE.sub(replacer, content)
|
||||||
|
return new_content, fixes
|
||||||
|
|
||||||
|
|
||||||
|
@click.command()
|
||||||
|
@click.option("--root", default=".", help="Repository root directory.")
|
||||||
|
@click.option("--package", default=None, help="Package name (auto-detected if not given).")
|
||||||
|
@click.option("--fix", is_flag=True, default=False, help="Auto-fix stale version references.")
|
||||||
|
@click.option("--docs-only", is_flag=True, default=False, help="Only check docs/ (skip README.md).")
|
||||||
|
def main(root: str, package: str | None, fix: bool, docs_only: bool) -> None:
|
||||||
|
"""Check that documentation version references match the current package version."""
|
||||||
|
root_path = Path(root).resolve()
|
||||||
|
pkg = package or detect_package_name(root_path)
|
||||||
|
|
||||||
|
if pkg is None:
|
||||||
|
click.echo(_("No Python package found under src/ — skipping version check."))
|
||||||
|
return
|
||||||
|
|
||||||
|
current_version = read_version(root_path, pkg)
|
||||||
|
if current_version is None:
|
||||||
|
click.echo(_("Cannot read __version__ from src/{pkg}/__init__.py — skipping.", pkg=pkg))
|
||||||
|
return
|
||||||
|
|
||||||
|
click.echo(_("Checking version references for {pkg} (current: v{version})", pkg=pkg, version=current_version))
|
||||||
|
|
||||||
|
# Collect files to check
|
||||||
|
files: list[Path] = []
|
||||||
|
if not docs_only:
|
||||||
|
readme = root_path / "README.md"
|
||||||
|
if readme.exists():
|
||||||
|
files.append(readme)
|
||||||
|
docs_dir = root_path / "docs"
|
||||||
|
if docs_dir.is_dir():
|
||||||
|
files.extend(sorted(docs_dir.rglob("*.md")))
|
||||||
|
|
||||||
|
all_issues: list[str] = []
|
||||||
|
total_fixes = 0
|
||||||
|
|
||||||
|
for filepath in files:
|
||||||
|
rel_path = filepath.relative_to(root_path)
|
||||||
|
content = filepath.read_text(encoding="utf-8")
|
||||||
|
refs = find_version_refs(content, pkg)
|
||||||
|
|
||||||
|
if not refs:
|
||||||
|
continue
|
||||||
|
|
||||||
|
stale_refs = [(line, full, op, ver, rest) for line, full, op, ver, rest in refs if ver != current_version]
|
||||||
|
|
||||||
|
if not stale_refs:
|
||||||
|
continue
|
||||||
|
|
||||||
|
if fix:
|
||||||
|
new_content, fixes = fix_version_refs(content, pkg, current_version)
|
||||||
|
if fixes > 0: # pragma: no cover — fixes > 0 when stale_refs is non-empty
|
||||||
|
filepath.write_text(new_content, encoding="utf-8")
|
||||||
|
total_fixes += fixes
|
||||||
|
click.echo(_(" Fixed {fixes} version ref(s) in {file}", fixes=fixes, file=rel_path))
|
||||||
|
continue
|
||||||
|
|
||||||
|
for line, full, _op, ver, _rest in stale_refs:
|
||||||
|
all_issues.append(f"{rel_path}:{line}: stale version '{ver}' (current: {current_version}) in '{full[:60]}'")
|
||||||
|
|
||||||
|
if fix:
|
||||||
|
if total_fixes > 0:
|
||||||
|
click.echo(_("\nFixed {n} stale version reference(s).", n=total_fixes))
|
||||||
|
else:
|
||||||
|
click.echo(_("\nNo stale version references found."))
|
||||||
|
return
|
||||||
|
|
||||||
|
if all_issues:
|
||||||
|
click.echo(_("\nFAIL: {n} stale version reference(s) found:", n=len(all_issues)))
|
||||||
|
for issue in all_issues:
|
||||||
|
click.echo(f" - {issue}")
|
||||||
|
click.echo(_("\nRun with --fix to auto-update version references."))
|
||||||
|
sys.exit(1)
|
||||||
|
else:
|
||||||
|
click.echo(_("\nPASS: All version references are current."))
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__": # pragma: no cover
|
||||||
|
main()
|
||||||
@@ -7,6 +7,7 @@ Handles installation of:
|
|||||||
- act_runner (Gitea Actions local runner, optional)
|
- act_runner (Gitea Actions local runner, optional)
|
||||||
- tea (Gitea CLI — official command-line tool for Gitea API operations)
|
- tea (Gitea CLI — official command-line tool for Gitea API operations)
|
||||||
- hadolint (Dockerfile linter)
|
- hadolint (Dockerfile linter)
|
||||||
|
- vale (prose linter for documentation quality)
|
||||||
|
|
||||||
Each tool is installed to ``~/.local/bin`` if not already on PATH.
|
Each tool is installed to ``~/.local/bin`` if not already on PATH.
|
||||||
Idempotent: skips tools that are already available.
|
Idempotent: skips tools that are already available.
|
||||||
@@ -44,6 +45,8 @@ HADOLINT_VERSION = "2.12.0"
|
|||||||
|
|
||||||
TOFU_VERSION = "1.12.3"
|
TOFU_VERSION = "1.12.3"
|
||||||
|
|
||||||
|
VALE_VERSION = "3.12.0"
|
||||||
|
|
||||||
|
|
||||||
def _arch() -> str:
|
def _arch() -> str:
|
||||||
"""Return the architecture string used by release assets (delegates to shared utility)."""
|
"""Return the architecture string used by release assets (delegates to shared utility)."""
|
||||||
@@ -196,7 +199,20 @@ def install_tofu() -> bool:
|
|||||||
return True
|
return True
|
||||||
|
|
||||||
|
|
||||||
TOOL_NAMES = ["actionlint", "git-cliff", "act_runner", "tea", "hadolint", "tofu"]
|
def install_vale() -> bool:
|
||||||
|
"""Install Vale (prose linter) if not already present. Returns True if installed/skipped."""
|
||||||
|
if _is_installed("vale"):
|
||||||
|
click.echo("vale: already installed")
|
||||||
|
return True
|
||||||
|
machine = platform.machine().lower()
|
||||||
|
arch = "64-bit" if machine in {"x86_64", "amd64"} else "arm64"
|
||||||
|
url = f"https://github.com/errata-ai/vale/releases/download/v{VALE_VERSION}/vale_{VALE_VERSION}_Linux_{arch}.tar.gz"
|
||||||
|
dest = _download_and_extract_tarball(url, "vale")
|
||||||
|
click.echo(f"vale: installed to {dest}")
|
||||||
|
return True
|
||||||
|
|
||||||
|
|
||||||
|
TOOL_NAMES = ["actionlint", "git-cliff", "act_runner", "tea", "hadolint", "tofu", "vale"]
|
||||||
|
|
||||||
|
|
||||||
def _install_tool(name: str) -> bool:
|
def _install_tool(name: str) -> bool:
|
||||||
@@ -213,6 +229,8 @@ def _install_tool(name: str) -> bool:
|
|||||||
return install_hadolint()
|
return install_hadolint()
|
||||||
if name == "tofu":
|
if name == "tofu":
|
||||||
return install_tofu()
|
return install_tofu()
|
||||||
|
if name == "vale":
|
||||||
|
return install_vale()
|
||||||
raise click.ClickException(f"Unknown tool: {name}")
|
raise click.ClickException(f"Unknown tool: {name}")
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,255 @@
|
|||||||
|
"""Tests for devx.tools.check_doc_versions."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
from click.testing import CliRunner
|
||||||
|
|
||||||
|
import devx.tools.check_doc_versions as cdv
|
||||||
|
|
||||||
|
|
||||||
|
class TestDetectPackageName:
|
||||||
|
def test_finds_package(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "myproj"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text('__version__ = "1.0.0"\n')
|
||||||
|
assert cdv.detect_package_name(tmp_path) == "myproj"
|
||||||
|
|
||||||
|
def test_no_src_dir(self, tmp_path: Path) -> None:
|
||||||
|
assert cdv.detect_package_name(tmp_path) is None
|
||||||
|
|
||||||
|
def test_no_init_py(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "myproj"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
assert cdv.detect_package_name(tmp_path) is None
|
||||||
|
|
||||||
|
|
||||||
|
class TestReadVersion:
|
||||||
|
def test_reads_version(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "myproj"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text('__version__ = "2.3.4"\n')
|
||||||
|
assert cdv.read_version(tmp_path, "myproj") == "2.3.4"
|
||||||
|
|
||||||
|
def test_no_version(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "myproj"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text("# no version here\n")
|
||||||
|
assert cdv.read_version(tmp_path, "myproj") is None
|
||||||
|
|
||||||
|
def test_no_init_file(self, tmp_path: Path) -> None:
|
||||||
|
assert cdv.read_version(tmp_path, "nonexistent") is None
|
||||||
|
|
||||||
|
|
||||||
|
class TestFindVersionRefs:
|
||||||
|
def test_finds_gte_ref(self) -> None:
|
||||||
|
content = ' "devx>=0.27.0",\n'
|
||||||
|
refs = cdv.find_version_refs(content, "devx")
|
||||||
|
assert len(refs) == 1
|
||||||
|
_, full, op, ver, _ = refs[0]
|
||||||
|
assert op == ">="
|
||||||
|
assert ver == "0.27.0"
|
||||||
|
|
||||||
|
def test_finds_eq_ref(self) -> None:
|
||||||
|
content = '"devx==0.33.4"'
|
||||||
|
refs = cdv.find_version_refs(content, "devx")
|
||||||
|
assert len(refs) == 1
|
||||||
|
_, _, op, ver, _ = refs[0]
|
||||||
|
assert op == "=="
|
||||||
|
assert ver == "0.33.4"
|
||||||
|
|
||||||
|
def test_finds_extras_ref(self) -> None:
|
||||||
|
content = '"devx[dev]>=0.27.0"'
|
||||||
|
refs = cdv.find_version_refs(content, "devx")
|
||||||
|
assert len(refs) == 1
|
||||||
|
_, _, op, ver, _ = refs[0]
|
||||||
|
assert op == ">="
|
||||||
|
assert ver == "0.27.0"
|
||||||
|
|
||||||
|
def test_finds_upper_bound(self) -> None:
|
||||||
|
content = '"devx>=0.27.0,<0.28"'
|
||||||
|
refs = cdv.find_version_refs(content, "devx")
|
||||||
|
assert len(refs) == 1
|
||||||
|
_, _, _, _, rest = refs[0]
|
||||||
|
assert "<0.28" in rest
|
||||||
|
|
||||||
|
def test_ignores_other_packages(self) -> None:
|
||||||
|
content = '"other-pkg>=1.0.0"'
|
||||||
|
refs = cdv.find_version_refs(content, "devx")
|
||||||
|
assert len(refs) == 0
|
||||||
|
|
||||||
|
def test_multiple_refs(self) -> None:
|
||||||
|
content = '"devx>=0.27.0"\n"devx==0.33.4"\n'
|
||||||
|
refs = cdv.find_version_refs(content, "devx")
|
||||||
|
assert len(refs) == 2
|
||||||
|
|
||||||
|
|
||||||
|
class TestFixVersionRefs:
|
||||||
|
def test_fixes_stale_version(self) -> None:
|
||||||
|
content = '"devx>=0.27.0"'
|
||||||
|
new, fixes = cdv.fix_version_refs(content, "devx", "0.33.4")
|
||||||
|
assert fixes == 1
|
||||||
|
assert "0.33.4" in new
|
||||||
|
assert "0.27.0" not in new
|
||||||
|
|
||||||
|
def test_no_fix_needed(self) -> None:
|
||||||
|
content = '"devx>=0.33.4"'
|
||||||
|
new, fixes = cdv.fix_version_refs(content, "devx", "0.33.4")
|
||||||
|
assert fixes == 0
|
||||||
|
assert new == content
|
||||||
|
|
||||||
|
def test_fixes_upper_bound(self) -> None:
|
||||||
|
content = '"devx>=0.27.0,<0.28"'
|
||||||
|
new, fixes = cdv.fix_version_refs(content, "devx", "0.33.4")
|
||||||
|
assert fixes == 1
|
||||||
|
assert "0.33.4" in new
|
||||||
|
assert "<0.34" in new
|
||||||
|
assert "<0.28" not in new
|
||||||
|
|
||||||
|
def test_ignores_other_packages(self) -> None:
|
||||||
|
content = '"other>=1.0.0"'
|
||||||
|
new, fixes = cdv.fix_version_refs(content, "devx", "0.33.4")
|
||||||
|
assert fixes == 0
|
||||||
|
assert new == content
|
||||||
|
|
||||||
|
|
||||||
|
class TestMain:
|
||||||
|
def test_pass_when_current(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "devx"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text('__version__ = "0.33.4"\n')
|
||||||
|
readme = tmp_path / "README.md"
|
||||||
|
readme.write_text('"devx>=0.33.4"\n')
|
||||||
|
runner = CliRunner()
|
||||||
|
result = runner.invoke(cdv.main, ["--root", str(tmp_path)])
|
||||||
|
assert result.exit_code == 0
|
||||||
|
assert "PASS" in result.output
|
||||||
|
|
||||||
|
def test_fail_when_stale(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "devx"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text('__version__ = "0.33.4"\n')
|
||||||
|
readme = tmp_path / "README.md"
|
||||||
|
readme.write_text('"devx>=0.27.0"\n')
|
||||||
|
runner = CliRunner()
|
||||||
|
result = runner.invoke(cdv.main, ["--root", str(tmp_path)])
|
||||||
|
assert result.exit_code == 1
|
||||||
|
assert "stale" in result.output
|
||||||
|
|
||||||
|
def test_fix_updates_files(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "devx"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text('__version__ = "0.33.4"\n')
|
||||||
|
readme = tmp_path / "README.md"
|
||||||
|
readme.write_text('"devx>=0.27.0"\n')
|
||||||
|
runner = CliRunner()
|
||||||
|
result = runner.invoke(cdv.main, ["--root", str(tmp_path), "--fix"])
|
||||||
|
assert result.exit_code == 0
|
||||||
|
assert "0.33.4" in readme.read_text()
|
||||||
|
|
||||||
|
def test_no_package_skips(self, tmp_path: Path) -> None:
|
||||||
|
runner = CliRunner()
|
||||||
|
result = runner.invoke(cdv.main, ["--root", str(tmp_path)])
|
||||||
|
assert result.exit_code == 0
|
||||||
|
assert "skipping" in result.output
|
||||||
|
|
||||||
|
def test_no_version_skips(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "devx"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text("# no version\n")
|
||||||
|
runner = CliRunner()
|
||||||
|
result = runner.invoke(cdv.main, ["--root", str(tmp_path)])
|
||||||
|
assert result.exit_code == 0
|
||||||
|
assert "Cannot read" in result.output
|
||||||
|
|
||||||
|
def test_docs_only_skips_readme(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "devx"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text('__version__ = "0.33.4"\n')
|
||||||
|
readme = tmp_path / "README.md"
|
||||||
|
readme.write_text('"devx>=0.27.0"\n')
|
||||||
|
docs = tmp_path / "docs"
|
||||||
|
docs.mkdir()
|
||||||
|
(docs / "index.md").write_text('"devx>=0.33.4"\n')
|
||||||
|
runner = CliRunner()
|
||||||
|
result = runner.invoke(cdv.main, ["--root", str(tmp_path), "--docs-only"])
|
||||||
|
assert result.exit_code == 0
|
||||||
|
assert "PASS" in result.output
|
||||||
|
|
||||||
|
def test_fix_no_stale(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "devx"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text('__version__ = "0.33.4"\n')
|
||||||
|
readme = tmp_path / "README.md"
|
||||||
|
readme.write_text('"devx>=0.33.4"\n')
|
||||||
|
runner = CliRunner()
|
||||||
|
result = runner.invoke(cdv.main, ["--root", str(tmp_path), "--fix"])
|
||||||
|
assert result.exit_code == 0
|
||||||
|
assert "No stale" in result.output
|
||||||
|
|
||||||
|
def test_checks_docs_dir(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "devx"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text('__version__ = "0.33.4"\n')
|
||||||
|
docs = tmp_path / "docs"
|
||||||
|
docs.mkdir()
|
||||||
|
(docs / "index.md").write_text('"devx>=0.27.0"\n')
|
||||||
|
runner = CliRunner()
|
||||||
|
result = runner.invoke(cdv.main, ["--root", str(tmp_path)])
|
||||||
|
assert result.exit_code == 1
|
||||||
|
assert "docs/index.md" in result.output
|
||||||
|
|
||||||
|
def test_detect_package_with_non_dir_entry(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
# `aaa_file.py` sorts before `devx/` so the non-dir branch is hit
|
||||||
|
(src / "aaa_file.py").touch()
|
||||||
|
pkg_dir = src / "devx"
|
||||||
|
pkg_dir.mkdir()
|
||||||
|
(pkg_dir / "__init__.py").write_text('__version__ = "1.0.0"\n')
|
||||||
|
assert cdv.detect_package_name(tmp_path) == "devx"
|
||||||
|
|
||||||
|
def test_read_version_auto_detect(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "devx"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text('__version__ = "3.2.1"\n')
|
||||||
|
assert cdv.read_version(tmp_path) == "3.2.1"
|
||||||
|
|
||||||
|
def test_read_version_no_package(self, tmp_path: Path) -> None:
|
||||||
|
assert cdv.read_version(tmp_path) is None
|
||||||
|
|
||||||
|
def test_main_with_file_without_refs(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "devx"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text('__version__ = "0.33.4"\n')
|
||||||
|
docs = tmp_path / "docs"
|
||||||
|
docs.mkdir()
|
||||||
|
(docs / "index.md").write_text("# No version refs here\n")
|
||||||
|
(docs / "other.md").write_text('"devx>=0.27.0"\n')
|
||||||
|
runner = CliRunner()
|
||||||
|
result = runner.invoke(cdv.main, ["--root", str(tmp_path)])
|
||||||
|
assert result.exit_code == 1
|
||||||
|
assert "other.md" in result.output
|
||||||
|
|
||||||
|
def test_fix_with_file_without_refs(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "devx"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text('__version__ = "0.33.4"\n')
|
||||||
|
readme = tmp_path / "README.md"
|
||||||
|
readme.write_text("# No refs\n")
|
||||||
|
runner = CliRunner()
|
||||||
|
result = runner.invoke(cdv.main, ["--root", str(tmp_path), "--fix"])
|
||||||
|
assert result.exit_code == 0
|
||||||
|
assert "No stale" in result.output
|
||||||
|
|
||||||
|
def test_fix_with_current_refs(self, tmp_path: Path) -> None:
|
||||||
|
src = tmp_path / "src" / "devx"
|
||||||
|
src.mkdir(parents=True)
|
||||||
|
(src / "__init__.py").write_text('__version__ = "0.33.4"\n')
|
||||||
|
readme = tmp_path / "README.md"
|
||||||
|
readme.write_text('"devx>=0.33.4"\n')
|
||||||
|
runner = CliRunner()
|
||||||
|
result = runner.invoke(cdv.main, ["--root", str(tmp_path), "--fix"])
|
||||||
|
assert result.exit_code == 0
|
||||||
|
assert "No stale" in result.output
|
||||||
@@ -269,6 +269,34 @@ class TestInstallTofu:
|
|||||||
assert (tmp_path / "tofu").exists()
|
assert (tmp_path / "tofu").exists()
|
||||||
|
|
||||||
|
|
||||||
|
class TestInstallVale:
|
||||||
|
def test_already_installed(self) -> None:
|
||||||
|
with patch.object(install_tools, "_is_installed", return_value=True):
|
||||||
|
assert install_tools.install_vale() is True
|
||||||
|
|
||||||
|
def test_install(self, tmp_path: Path) -> None:
|
||||||
|
import io
|
||||||
|
import tarfile
|
||||||
|
|
||||||
|
tarball_path = tmp_path / "archive.tar.gz"
|
||||||
|
binary_content = b"fake vale"
|
||||||
|
with tarfile.open(tarball_path, "w:gz") as tar:
|
||||||
|
info = tarfile.TarInfo(name="vale")
|
||||||
|
info.size = len(binary_content)
|
||||||
|
tar.addfile(info, io.BytesIO(binary_content))
|
||||||
|
|
||||||
|
with patch.object(install_tools, "_is_installed", return_value=False):
|
||||||
|
with patch.object(install_tools, "TARGET_DIR", tmp_path):
|
||||||
|
with patch.object(platform, "machine", return_value="x86_64"):
|
||||||
|
with patch.object(
|
||||||
|
install_tools,
|
||||||
|
"_download",
|
||||||
|
side_effect=lambda url, dest: Path(dest).write_bytes(tarball_path.read_bytes()),
|
||||||
|
):
|
||||||
|
assert install_tools.install_vale() is True
|
||||||
|
assert (tmp_path / "vale").exists()
|
||||||
|
|
||||||
|
|
||||||
class TestListTools:
|
class TestListTools:
|
||||||
def test_list(self, tmp_path: Path) -> None:
|
def test_list(self, tmp_path: Path) -> None:
|
||||||
with patch.object(install_tools, "TARGET_DIR", tmp_path):
|
with patch.object(install_tools, "TARGET_DIR", tmp_path):
|
||||||
@@ -308,6 +336,11 @@ class TestInstallTool:
|
|||||||
assert install_tools._install_tool("tofu") is True
|
assert install_tools._install_tool("tofu") is True
|
||||||
mock.assert_called_once()
|
mock.assert_called_once()
|
||||||
|
|
||||||
|
def test_vale(self) -> None:
|
||||||
|
with patch.object(install_tools, "install_vale", return_value=True) as mock:
|
||||||
|
assert install_tools._install_tool("vale") is True
|
||||||
|
mock.assert_called_once()
|
||||||
|
|
||||||
def test_unknown_tool(self) -> None:
|
def test_unknown_tool(self) -> None:
|
||||||
with pytest.raises(ClickException, match="Unknown tool"):
|
with pytest.raises(ClickException, match="Unknown tool"):
|
||||||
install_tools._install_tool("unknown")
|
install_tools._install_tool("unknown")
|
||||||
@@ -326,7 +359,7 @@ class TestMain:
|
|||||||
with patch.object(install_tools, "_install_tool", return_value=True) as mock_install:
|
with patch.object(install_tools, "_install_tool", return_value=True) as mock_install:
|
||||||
result = runner.invoke(install_tools.main, [])
|
result = runner.invoke(install_tools.main, [])
|
||||||
assert result.exit_code == 0
|
assert result.exit_code == 0
|
||||||
assert mock_install.call_count == 6
|
assert mock_install.call_count == 7
|
||||||
|
|
||||||
def test_install_specific_tool(self) -> None:
|
def test_install_specific_tool(self) -> None:
|
||||||
runner = CliRunner()
|
runner = CliRunner()
|
||||||
|
|||||||
@@ -68,10 +68,12 @@ class TestPushToBadgesBranch:
|
|||||||
|
|
||||||
sha_result = MagicMock()
|
sha_result = MagicMock()
|
||||||
sha_result.stdout = "abc123\n"
|
sha_result.stdout = "abc123\n"
|
||||||
|
diff_result = MagicMock()
|
||||||
|
diff_result.stdout = "coverage.svg\n"
|
||||||
default_result = MagicMock()
|
default_result = MagicMock()
|
||||||
with patch(
|
with patch(
|
||||||
"subprocess.run",
|
"subprocess.run",
|
||||||
side_effect=[default_result] * 7 + [sha_result],
|
side_effect=[default_result] * 6 + [diff_result] + [default_result, default_result, sha_result],
|
||||||
) as mock_run:
|
) as mock_run:
|
||||||
sha = push_badges.push_to_badges_branch(str(badges_dir))
|
sha = push_badges.push_to_badges_branch(str(badges_dir))
|
||||||
|
|
||||||
@@ -143,6 +145,40 @@ class TestUpdateReadmeWithBadgeSha:
|
|||||||
push_badges.update_readme_with_badge_sha("abc123def456", repo_root=tmp_path)
|
push_badges.update_readme_with_badge_sha("abc123def456", repo_root=tmp_path)
|
||||||
# Should not raise
|
# Should not raise
|
||||||
|
|
||||||
|
def test_version_verification_stale(self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
|
||||||
|
readme = tmp_path / "README.md"
|
||||||
|
readme.write_text("[]")
|
||||||
|
monkeypatch.chdir(tmp_path)
|
||||||
|
badges_dir = tmp_path / ".badges"
|
||||||
|
badges_dir.mkdir(exist_ok=True)
|
||||||
|
(badges_dir / "version.svg").write_text("version: v0.27.0")
|
||||||
|
with patch("subprocess.run"):
|
||||||
|
with patch("devx.tools.generate_badges.detect_package_name", return_value="devx"):
|
||||||
|
with patch("devx.tools.generate_badges.read_version", return_value="0.33.4"):
|
||||||
|
push_badges.update_readme_with_badge_sha("abc123def456", repo_root=tmp_path)
|
||||||
|
|
||||||
|
def test_version_verification_current(self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
|
||||||
|
readme = tmp_path / "README.md"
|
||||||
|
readme.write_text("[]")
|
||||||
|
monkeypatch.chdir(tmp_path)
|
||||||
|
badges_dir = tmp_path / ".badges"
|
||||||
|
badges_dir.mkdir(exist_ok=True)
|
||||||
|
(badges_dir / "version.svg").write_text("version: v0.33.4")
|
||||||
|
with patch("subprocess.run"):
|
||||||
|
with patch("devx.tools.generate_badges.detect_package_name", return_value="devx"):
|
||||||
|
with patch("devx.tools.generate_badges.read_version", return_value="0.33.4"):
|
||||||
|
push_badges.update_readme_with_badge_sha("abc123def456", repo_root=tmp_path)
|
||||||
|
|
||||||
|
def test_version_verification_no_badges_dir(self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
|
||||||
|
readme = tmp_path / "README.md"
|
||||||
|
readme.write_text("[]")
|
||||||
|
monkeypatch.chdir(tmp_path)
|
||||||
|
# No .badges/version.svg exists — should skip verification gracefully
|
||||||
|
with patch("subprocess.run"):
|
||||||
|
with patch("devx.tools.generate_badges.detect_package_name", return_value="devx"):
|
||||||
|
with patch("devx.tools.generate_badges.read_version", return_value="0.33.4"):
|
||||||
|
push_badges.update_readme_with_badge_sha("abc123def456", repo_root=tmp_path)
|
||||||
|
|
||||||
|
|
||||||
class TestMain:
|
class TestMain:
|
||||||
def test_success(self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
|
def test_success(self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
|
||||||
|
|||||||
@@ -27,6 +27,7 @@ from devx.ci.release import (
|
|||||||
run_tests,
|
run_tests,
|
||||||
tag_exists,
|
tag_exists,
|
||||||
update_changelog,
|
update_changelog,
|
||||||
|
update_doc_versions,
|
||||||
update_init_version,
|
update_init_version,
|
||||||
verify_alignment,
|
verify_alignment,
|
||||||
verify_tag_consistency,
|
verify_tag_consistency,
|
||||||
@@ -801,7 +802,7 @@ class TestCommitReleaseChanges:
|
|||||||
result = commit_release_changes("0.2.0")
|
result = commit_release_changes("0.2.0")
|
||||||
assert result is True
|
assert result is True
|
||||||
calls = [c.args[0] for c in mock_run_cmd.call_args_list]
|
calls = [c.args[0] for c in mock_run_cmd.call_args_list]
|
||||||
assert ["git", "add", "src/devx/__init__.py", "CHANGELOG.md"] in calls
|
assert ["git", "add", "src/devx/__init__.py", "CHANGELOG.md", "README.md", "docs/"] in calls
|
||||||
assert ["git", "commit", "--no-verify", "-m", "release: v0.2.0 [skip ci]"] in calls
|
assert ["git", "commit", "--no-verify", "-m", "release: v0.2.0 [skip ci]"] in calls
|
||||||
|
|
||||||
@patch("devx.ci.release.run_cmd")
|
@patch("devx.ci.release.run_cmd")
|
||||||
@@ -814,6 +815,21 @@ class TestCommitReleaseChanges:
|
|||||||
assert ["git", "commit", "--no-verify", "-m", "release: v0.1.0 [skip ci]"] not in calls
|
assert ["git", "commit", "--no-verify", "-m", "release: v0.1.0 [skip ci]"] not in calls
|
||||||
|
|
||||||
|
|
||||||
|
class TestUpdateDocVersions:
|
||||||
|
@patch("subprocess.run")
|
||||||
|
def test_success(self, mock_run: MagicMock) -> None:
|
||||||
|
mock_run.return_value = MagicMock(returncode=0, stdout="", stderr="")
|
||||||
|
update_doc_versions("0.33.4")
|
||||||
|
assert mock_run.called
|
||||||
|
|
||||||
|
@patch("subprocess.run")
|
||||||
|
def test_failure_warns(self, mock_run: MagicMock) -> None:
|
||||||
|
mock_run.return_value = MagicMock(returncode=1, stdout="", stderr="some error")
|
||||||
|
# Should not raise
|
||||||
|
update_doc_versions("0.33.4")
|
||||||
|
assert mock_run.called
|
||||||
|
|
||||||
|
|
||||||
class TestCreateAndPushTag:
|
class TestCreateAndPushTag:
|
||||||
@patch("devx.ci.release.tag_exists", return_value=False)
|
@patch("devx.ci.release.tag_exists", return_value=False)
|
||||||
@patch("devx.ci.release.run_cmd")
|
@patch("devx.ci.release.run_cmd")
|
||||||
|
|||||||
Reference in New Issue
Block a user