jay_lint

This is my attempt in making my own linter using Please from Thought Machine and the python ast library

Install it via pip

pip install jay_lint

To install, on the root directory run:

pip install .

How to use?

After installing, simply run jlint followed by your file name. eg:

jlint <test.py>

How to use 'fix'?

Same as before, just add --fix after the file name eg:

jlint --fix <test.py>

TypeScript / JavaScript support

jlint also lints .ts, .tsx, .js, .jsx, .mjs files. It parses them with tree-sitter (installed with the package; needs Python 3.9+):

jlint app/page.tsx                      # one file
jlint app components lib                # directories (node_modules, .next, plz-out skipped)
jlint --fix components/Bio.tsx          # fix in place
jlint --strict --max-line-length 88 app # exit 1 if anything is reported (for CI)
jlint                                   # no arguments: use the paths from the config file

Checks (--fix can fix the ones marked fix):

The import order rules mirror eslint-plugin-import's import/order with alphabetize and newlines-between: always, so the two agree. Imports are only reordered when nothing but imports sits between them; a comment between two imports leaves them alone.

Config file

Put your settings in jlint.toml, or under [tool.jlint] in pyproject.toml, and run plain jlint. The nearest config is found by searching upwards from the current directory (jlint.toml wins over pyproject.toml), or pass one with --config path/to/file.toml.

# jlint.toml
paths = ["app", "components", "lib", "utils"]   # linted when no files are given on the command line
max-line-length = 88                            # TypeScript / JavaScript (default 100)
strict = true                                   # exit 1 if anything is reported
exclude = ["generated", "*.stories.tsx"]        # folder names or paths to skip inside directories

The same settings in pyproject.toml:

[tool.jlint]
paths = ["src"]

paths and exclude are relative to the config file. Command-line arguments override the config: files on the command line replace paths, and --max-line-length replaces max-line-length. Unknown settings and wrong types are reported as errors.

Development (Please)

Tests run under Please, pinned to the Python in .python-version (currently 3.11) so local and CI match. Please builds with its own restricted PATH, so it ignores the python3 on yours; scripts/use_uv_python.sh installs the pinned Python with uv and points Please at it (via an untracked .plzconfig.local).

./scripts/use_uv_python.sh
./pleasew test //src/...