Code Repositories
Module Summary
Explore how Code Repositories host your transform logic — Python or SQL — with built-in checks, previews, and collaboration.
Anatomy of a Code Repository
A Code Repository is a Git repository hosted inside Foundry. It contains your transform source code, a configuration file that declares inputs and outputs, and any supporting libraries.
You edit code in the browser-based Code Editor or clone the repo locally with the Foundry CLI. Changes go through branches and pull requests just like any modern Git workflow.
Preview and Checks
Before merging, you can preview a transform — Foundry runs it on a sample of the input data and shows you the output schema and sample rows. This catches type errors, null-handling bugs, and logic mistakes before they reach production.
Checks run automatically on every branch push: linting, type validation, and dependency resolution. If a check fails, the merge is blocked.
Multi-Transform Repositories
A single repository can contain many transforms. Foundry reads the declared inputs and outputs to build a dependency graph — it knows which transform to run first. This means you can organise related transforms together (e.g., all revenue-pipeline logic in one repo) while Foundry handles the build order.
Key Takeaways
- Code Repositories are Git repos hosted inside Foundry.
- You can edit in-browser or clone locally with the Foundry CLI.
- Preview runs transforms on sample data to catch errors early.
- Automatic checks block broken code from merging to main.