Warning
🚧 Work in Progress: This page is currently under construction. Content may be incomplete or subject to change. To contribute, see the contribution guide.
Code Standards
Coding conventions adopted by the Technology department at Patria.
Languages in use
| Language | Primary use | Standard |
|---|---|---|
| Python | Data pipelines, APIs (Cloud Run), automations | PEP 8 + Black + isort |
| TypeScript | N8N automations, integrations, portals | ESLint + Prettier |
| SQL | BigQuery transformations, analytical queries | dbt style guide (adapted) |
General principles
- Readability > cleverness: code is read far more than it is written
- Tests: every critical function must have a unit test
- Inline documentation: docstrings on public functions, comments on non-obvious logic
- No credentials in code: always via environment variables or Secret Manager