pinky-tools
Update date : 2026-06-01
Local dev CLI for Snowflake data engineers — run stored procedures locally, generate README docs, and validate naming conventions.
- explanation/design.md — vision, existing modules, Phase 0 tooling. Not for: feature scope (→ features.md), decisions (→ adr/)
- explanation/features.md — MVP scope, post-MVP roadmap, backlog, out-of-scope. Not for: design rationale (→ design.md)
- reference/generated/api/run.md — API reference: local SP runner. Not for: hand-written content — edit docstrings in src/
- reference/generated/api/readme.md — API reference: README generator (AST). Not for: hand-written content — edit docstrings in src/
- reference/generated/api/regression.md — API reference: output comparator. Not for: hand-written content — edit docstrings in src/
- reference/generated/api/validate_name.md — API reference: naming convention validator. Not for: hand-written content — edit docstrings in src/
- adr/0001-click-over-argparse.md — click over argparse (aligned with pinky-provider)
- adr/0002-i18n-env-var-from-day-one.md — i18n via SNOWFLAKE_TOOLS_LOCALE env var, key-based templates, EN/FR
- adr/0003-export-last-select-wins.md — pinky export: last SELECT in the file = the one exported
- adr/0004-export-col-transform-not-in-yaml.md — pinky export: transforms go in SQL, not YAML
- adr/0005-export-queries-path-convention.md — pinky export: queries path convention