Development workspace bootstrapper for the provide.io ecosystem.
Clone the repos you need into the repos/ subdirectory, run uv sync once,
and every package is installed as an editable local install — changes you make
to any repo are immediately reflected without reinstalling.
git clone git@github.com:provide-io/provide-workspace.git
cd provide-workspace
# Clone repos into the repos/ subdirectory
for repo in \
provide-foundation provide-testkit \
pyvider pyvider-components pyvider-cty pyvider-hcl pyvider-rpcplugin \
provide-foundry plating \
flavorpack wrknv tofusoup supsrc \
terraform-provider-pyvider; do
git clone git@github.com:provide-io/$repo.git repos/$repo
done
uv sync
source .venv/bin/activateFuture:
git submodule add git@github.com:provide-io/pyvider.git repos/pyviderwill work transparently once submodules are adopted.
| Package | Description |
|---|---|
| provide-foundation | Core library: structured logging, telemetry, config, resilience primitives |
| provide-testkit | Testing utilities and fixtures for provide.io packages |
| Package | Description |
|---|---|
| pyvider | Core Terraform provider framework |
| pyvider-cty | CTY type system implementation |
| pyvider-hcl | HCL parsing with CTY integration |
| pyvider-rpcplugin | gRPC plugin protocol implementation |
| pyvider-components | Standard reusable provider components |
| terraform-provider-pyvider | Official Pyvider Terraform provider |
| Package | Description |
|---|---|
| provide-foundry | Shared MkDocs theme, plugins, and doc infrastructure |
| plating | Auto-generates Terraform Registry documentation from pyvider components |
| Package | Description |
|---|---|
| flavorpack | PSPF packaging system for self-contained executable bundles |
| wrknv | Task runner and work environment management |
| tofusoup | Cross-language conformance testing for Terraform providers |
| supsrc | Automated Git commit/push utility |
┌─────────────────────────────────────────────────────────┐
│ Tools Layer │
│ flavorpack │ wrknv │ plating │ tofusoup │ supsrc │
├─────────────────────────────────────────────────────────┤
│ Framework Layer │
│ pyvider │ pyvider-cty │ pyvider-hcl │ pyvider-* │
├─────────────────────────────────────────────────────────┤
│ Foundation Layer │
│ provide-foundation │ provide-testkit │
└─────────────────────────────────────────────────────────┘
Apache-2.0. See individual package repos for details.