Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork3.1k
Code Conventions
wyattscarpenter edited this pageJul 31, 2025 ·8 revisions
Follow PEP 8.
We use the ruff linter to enforce style rules. This greatly simplifies code reviews.
All functions must have type annotations (except for test data).
Exceptions:
- We use 99 characters as the maximum line length.
- Use spaces around = signs in default parameter values in functions with annotations:
deff(x:int=1)->None: ...# OK, since f is annotateddeff(x=1)->None: ...# OK, fall back to PEP 8 if there is no annotation
It's usually better to avoid these Python features (at least in performance-sensitive code):
getattr,setattr- Mypy can't type check these calls properly
- These get compiled into slow dynamic attribute gets/sets by mypyc
functools- Type checking is sometimes limited, resulting in
Anytypes - Mypyc, our compiler, often generates better code if these are replaced with more "primitive" / lower level Python code
- Type checking is sometimes limited, resulting in
copy.deepcopy- This may be dangerous with objects with complex state such as caches (we might also add such state later)
- Performance can be hard to predict
- This can cause problems in code compiled with mypyc
- Metaclasses
- Mypyc, our compiler, generates less efficient code for metaclasses
- Type checking may be limited
- Metaclasses can make code harder to understand
Anytypes- These compromise type checking precision
- Operations on
Anytypes get compiled to slow generic operations by mypyc