In previous post, I started a django project with cookiecutter. Then, I added poetry to the project. In this post, I will add ruff to the project.
An extremely fast Python linter, written in Rust. Ruff aims to be orders of magnitude faster than alternative tools while integrating more functionality behind a single, common interface. Ruff can be used to replace Flake8 (plus dozens of plugins), isort, pydocstyle, yesqa, eradicate, pyupgrade, and autoflake, all while executing tens or hundreds of times faster than any individual tool.
Prerequisite
Python installed. (I am using pyenv to use different versions for other projects. For windows, you can use pyenv-win.)
I am not sure this needs to be installed in global or just to the docker container. So, I just use install this with poetry to add to the project.
poetry add ruff
This will add to the pyproject.toml and the poetry.lock file automatically.
The poetry automatically add to the outside of [tool.poetry.group.dev.dependencies]. So I manually move it to inside of dev.dependencies. Now, export to the requirements files and build the container again. As I moved it to the dev.dependencies, you can run only the first line of export and build. However, as I am not sure of it, I run them all. 🙂
Warning: The lock file is not up to date with the latest changes in pyproject.toml. You may be getting outdated dependencies. Run update to update them.
I researched and you need to update the packages using:
poetry update
Now exporting is working. Because there are some packages updated, I had to run all export. Another thing good to know, you can use poetry show --outdated command to show the packages outdated.
Additional settings on pyproject.toml for ruff
Here is my personal settings for the ruff on pyproject.toml. You can see their documentations to do your own.
Optionally, you can remove prettier, isort, and flake8 because ruff will do all the things they were doing unless you manually make some configurations of them.
Ruff can be used to replace Flake8 (plus dozens of plugins), Black, isort, pydocstyle, pyupgrade, autoflake, and more, all while executing tens or hundreds of times faster than any individual tool.
Fix ruff errors
After you added them all, if you try to commit and push, you will have a lot of errors from ruff. If you want to check ruff errors before commit, you can use ruff . command. Here are my errors.
First of all, you can use the below command to fix some errors with [*] automatically by ruff.
ruff . --fix
If you see error code E501, that is about the line length. You can add longer line length to the ruff config, or edit the code manually. To add longer line length, add below under [tool.ruff]
line-length = 120
And rest of them, you can manually edit the code or ignore them adding # noqa or like # noqa: S104 this specify the error code. Or another way is you can add more ignore error code on pyproject.toml file.
Another error on github pre-commit hook is the pytest.
E django.core.exceptions.ImproperlyConfigured: Requested setting INSTALLED_APPS, but settings are not configured. You must either define the environment variable DJANGO_SETTINGS_MODULE or call settings.configure() before accessing settings.
Basically, I need to add the django_settings_module to the local envs. you can either manually add or use below command.
export DJANGO_SETTINGS_MODULE=staff_info.settings
After I added, another error…. lol….
OSError: Error reading /app/webpack-stats.json. Are you sure webpack has generated the file and the path is correct?
FileNotFoundError: [Errno 2] No such file or directory: '/app/webpack-stats.json'
FAILED staff_info/users/tests/test_swagger.py::test_swagger_ui_not_accessible_by_normal_user
This, I know the reason, as it says, missing webpack-stats.json. .gitignore has this file, so the repo does not have this file. However, I couldn’t figure out why this needs to be ignored and what it does. I will maybe study about it later some day. for now, I just removed pytest on github by removing pytest on .github/workflows/ci.yml file.
