Manage your exceptions in Python like a PRO
Currently in BETA. Inspired by this blog post.
I shared the building process of this tool here.
“For those who like dinosaurs 🦖 and clean try/except ✨ blocks.”
Installation and usage
Installation
pip install tryceratops
Usage
tryceratops [filename or dir...]
You can enable experimental analyzers by running:
tryceratops --experimental [filename or dir...]
You can ignore specific violations by using: --ignore TCXXX
repeatedly:
tryceratops --ignore TC201 --ignore TC202 [filename or dir...]
You can exclude dirs by using: --exclude dir/path
repeatedly:
tryceratops --exclude tests --exclude .venv [filename or dir...]
Violations
All violations and its descriptions can be found in docs.
Ignoring violations
If you want to ignore a violation in a specific file, you can either:
- Add a comment with
notc
to the top of the file you want to ignore - Add a comment with
notc
to the line you want to ignore - Add a comment with
notc: CODE
to the line you want to ignore a specific violation
Example:
def verbose_reraise_1():
try:
a = 1
except Exception as ex:
raise ex # notc: TC202
Pre-commit
If you wish to use pre-commit, add this:
- repo: https://github.com/guilatrova/tryceratops
rev: v0.2.3
hooks:
- id: tryceratops
Configuration
You can set up a pyproject.toml
file to set rules.
This is useful to avoid reusing the same CLI flags over and over again and helps to define the structure of your project.
Example:
[tool.tryceratops]
exclude = ["samples"]
ignore = ["TC002", "TC200", "TC300"]
experimental = true
CLI flags always overwrite the config file.
License
MIT
Credits
Thanks to God for the inspiration 🙌 ☁️ ☀️
Logo icon was made by https://www.freepik.com
The black project for insights.