python-review

Python review guidelines

This project uses Python for the SDK (python/cog/) which defines the predictor interface, type system, and HTTP/queue server.

What linters already catch (skip these)

ruff handles pycodestyle (E), Pyflakes (F), isort (I), warnings (W), bandit (S), bugbear (B), and annotations (ANN). Don't flag issues these would catch.

What to look for

Type annotations

• Required on all function signatures
• Use typing_extensions for backward compatibility
• Avoid Any where a concrete type is possible
• Check that type annotations actually match runtime behavior