reLint
Regular Expression Linter
Write your own linting rules using regular expressions.
Sponsors
Installation
uvx relint
# or, if you have super advanced linting expressions
uvx --with "relint[regex]" relint
Examples & Recipes – The reLint Cookbook
Usage
You can write your own regular rules in a YAML file, like so:
- name: No ToDo
pattern: '(?i)todo' # case insensitive flag
hint: Get it done right away!
filePattern: .*\.(py|js)
error: false
The name attribute is the name of your linter, the pattern can be
any regular expression. The linter does lint entire files, therefore
your expressions can match multiple lines and include newlines.
You can narrow down the file types your linter should be working with,
by providing the optional filePattern attribute. The default is .*.
The optional error attribute allows you to only show a warning but not
exit with a bad (non-zero) exit code. The default is true.
The following command will lint all files in the current directory:
relint -c .relint.yml FILE FILE2 ...
The default configuration file name is .relint.yml within your working
directory, but you can provide any YAML or JSON file.
If you prefer linting changed files (cached on git) you can use the
option --diff [-d] or --git-diff [-g]:
git diff --unified=0 | relint my_file.py --diff
pre-commit
You can automate the linting process by adding a
pre-commit hook to your project. Add the
following entry to your .pre-commit-config.yaml:
- repo: https://github.com/codingjoe/relint
rev: 1.4.0
hooks:
- id: relint
args: [-W] # optional, if you want to fail on warnings during commit
Release files for relint 3.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| relint-3.5.0.tar.gz | 7.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| relint-3.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 15.1 kB
Release files / relint-3.5.0.tar.gz
| Download URL | relint-3.5.0.tar.gz |
|---|---|
| Size | 7.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eb920b74adc3931a93f58d1952eb7928ade32c1d588ce175aa994da71a22cad0
|
|
BLAKE2b-256 checksum How to use checksums |
9104eb470ec2aec83d7291f1e950530cbf3b7dd7d9ade6ad2a3f83d479f6c68a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 30, 2026.
Transparency logRelease files / relint-3.5.0-py3-none-any.whl
| Download URL | relint-3.5.0-py3-none-any.whl |
|---|---|
| Size | 8.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
490cfe39194c48b85643d05b40d1d526a73355ce9cb8f18fcad6915a48bd677f
|
|
BLAKE2b-256 checksum How to use checksums |
24ae84337e50cef33d500382082640cda28db0f6353e553794ea3e9b84433dc1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 30, 2026.
Transparency log