Python Expert

Conventions for clean, idiomatic Python. Load whenever you read, edit, or write Python source files.

firebase Updated
Screenshot of Genkit Developer UI showing traces

File contents

Python expert

When working with Python in this workspace, follow these conventions:

  • Type-hint everything. Parameters, returns, attributes, locals where the type isn't obvious.
  • Prefer dataclasses for simple data containers over hand-written __init__s.
  • Raise specific exceptions (ValueError, KeyError, LookupError) with informative messages. Avoid bare Exception.
  • Don't swallow errors. Don't except Exception: pass. Let unexpected errors propagate.
  • Match the surrounding style. If the file uses single quotes and 4-space indent, match it. Don't reformat unrelated lines.
  • Comments explain why, not what. Skip narration like # loop over items; only comment non-obvious intent.
  • Small, focused edits. When fixing a bug, change only what's necessary. Leave the rest of the file untouched so the diff stays readable.

firebase/genkit commit 220f2f1734

Frequently asked questions

npx get-skill add firebase/python-expert