python-best-practices

To make Python scripts reproducible using uv, use PEP 723 inline metadata for single-file throwaway scripts and `uv init` with `uv add` for multi-file projects to manage dependencies. Execution should always be handled via `uv run` to ensure environment consistency.

The best way to add type hints for maintainability is requiring them on all function signatures and using modern typing practices. This includes using precise types like `X | None`, `list[str]`, `dict[str, Any]`, and `Final` for constants to achieve static clarity.

Yes, uv works with PEP 8 code style and single-file Python scripts by utilizing PEP 723 inline metadata. This allows you to enforce consistent readability through naming conventions, import grouping, and formatting limits while maintaining reproducible execution.

To prevent execution errors when imported, structure Python code with `if __name__ == "__main__":` guards. This safety guardrail ensures the script runs properly via `uv run` while allowing safe imports without unintended side effects.

You should use assert statements in Python type-checked code only for invariants that the type system cannot express. Reserve assertions for safety checks during development rather than runtime control flow, ensuring maintainable and predictable execution.