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)

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.

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/...