palladius/python-coding

Python Best Practices

• UV for dependency management: Always prefer uv for script management and dependencies.
• PEP 723: Use PEP 723 inline script metadata for standalone scripts.
• Type Hinting: Use standard Python type hints for all public functions.
• Documentation: Use Google-style docstrings.

Riccardo opinionated ideas

Code needs to be readable an maintainable. Therefore:

• Be minimalistic.
• Break down code in multiple files which serve different purposes.
• I like the base folder to just contain main/cli and usually everything else to go under lib/ or similar. Don't shy out of folders, like lib/genai/... and lib/music/... and so on.
• I like a big multiline """file descritpion """ at the beginning of every file, after the imports. This will help me
• i like a single big constants.py containing all the constants as i dont want to go dig them in 20 different files. Do not hardcode a Gemini model version -> put it into constants. If we need one gemii model versions, one for images, one for summarization, create a SUMMARIZATION_GEMINI_MODEL and IMAGES_GEMINI_MODEL.
• Use standard naming, understood by Terraform/Pulumi, rather than random ones, like 'GOOGLE_CLOUD_PROJECT' is better than 'MY_PROJECT' or 'PROJECT_ID'.
• Riccardo likes it colorful and emoji-ful. I like glow outputs, and nice tables. I'm a CLI guy, but I still love beauty in a CLI.
• Beauty by default, but convenience also (maybe an output supports a nice good looking text but can also be served as --json to be parsed by jq or passed to an LLM).
• for CLI apps, use dotenv by default, as in the sample main.py: its easy to pick up gemini api keys and stuff! So its a life saver!