So I recently inherited a legacy application that was a nightmare to maintain (tooling was clearly lacking and the codebase was pretty outdated). I quickly realized that if I ever wanted to actually enjoy working on it, I would have to give it a proper overhaul.
These are the 5 changes that had some of the biggest impact IMO:
-
uv: Being new to the Python ecosystem, I didn't want to figure out
pipvspoetryvspyenvvsvirtualenv, so I just useduvand let it handle all of that. One Rust-based tool that installs and pins Python versions, manages thevenvautomatically and locks deps in auv.lockfor reproducible builds. Installs are also a lot faster, which makes CI a lot less painful. -
Ruff:
Coming from JS, I really missed eslint --fix for automatically fixing linting issues and format code on save. Ruff brought that experience back. I know that there are plenty of linters and formatters in the Python ecosystem, but this one really stands out for me. Since it's built in Rust, it's super fast.
- Dependabot:
Instead of remembering to update dependencies every few months, I enabled Dependabot. It automatically opens PRs when updates are available and then CI tells me whether they're safe to merge. It takes only a couple of minutes to set up but saves a lot of maintenance.
- Pylance:
Without it, VS Code gives generic completions and never warns you about passing the wrong type until runtime. Pylance provides proper type-aware autocompletion, jump-to-definition (even in third-party libraries), inline documentation, and real-time type checking. I personally keep it on "basic" mode for legacy codebases, since "strict" surfaced hundreds of errors (thank you, but no thank you lol).
- Pydantic:
Pydantic is basically Python's Zod: you declare a model, pass your data in and get either a validated typed object or a ValidationError naming the exact field at fault. It really helped me keep the codebase clean, with one place defining the shape of the data instead of raw dicts floating around. I use it wherever data comes from outside, like API payloads, forms, and env vars with pydantic-settings, which fails at startup instead of mid-request.
None of these tools changed the application itself. But together they made working on it a lot less frustrating.
If it can be helped, don't want Rust nor nodejs in my toolchain. Recommending to Python coders who are very likely not Rust or node.js experts is malpractice or unethical (call it what you may). If you had a problem with any non-Python packages would be at the mercy of non-Python communities. i'm struggling just with Python community black issue 2514 now you want us to broaden that struggle?
And if people are too dumb or lazy to learn how requirement file hierarchies work, perhaps they shouldn't be Python coders.
Disclosure: author of wreck