EduLint is a Python linter aimed at helping novice programmers improve their coding style. Presently, it integrates flake8 and pylint, with some tweaks to their default configuration.
This repository contains the linter itself, which is packaged and published as a Pypi package edulint
. There is also a web version running at edulint.com for easy use. Its source code is in another repository.
Are you just starting with programming in Python? Then the web UI (website, repo) might be the best choice for you.
You can install the latest release with pip:
python3 -m pip install --user edulint
Once installed, you can run it as a Python module:
python3 -m edulint check <file-to-lint>
Read the documentation for more options and configuration details.
Don't want to install Python and Edulint as a Python package? You can also run it using Docker.
docker pull edulint/edulint-cli # Optional
docker run -v ${PWD}:/app edulint/edulint-cli check some_file.py
# Additional example that lints a file with absolute path /tmp/some_file.py
docker run -v /tmp:/app edulint/edulint-cli check /app/some_file.py
It supports the same configuration options as the native Python package.
- Additional explanations for problems detected in code
- Thonny plugin
- More code quality defects (from WPS; detecting duplicate code)
- Rewrite web to React
- Add additional functionality to web (more settings, better teacher onboarding, …)
- Speed-up linting by switching to Ruff
- official VS Code plugin (3rd party plugin already exists: Github, VS Code Marketplace)
Are you interested in sponsoring this project, want to collaborate on an academic paper, or know of any interesting grants? Feel free to reach out to [email protected].
Supported: Python 3.8+ (tested up-to Python 3.12)
Python 3.7 is no-longer officially supported, as Python 3.7 is already EOL. Last version that supported it was Edulint v3.6.1. Be aware that some linting results may be different between 3.7 and 3.8 due to different parsing between package typed-ast
(<=3.7) and Python's native ast
(>=3.8).