terradart_codegen 0.35.0

terradart maintainer tooling — parses Terraform provider schema JSON and Magic Modules YAML and emits curated factory wrappers via wrap. Ships the terradart-codegen maintainer CLI.

terradart_codegen

Maintainer tooling for TerraDart. Parses terraform providers schema -json (plus optional Magic Modules YAML overlays) into a unified provider IR and emits typed Dart factory wrappers for terradart_google and other provider packages.

This package ships the terradart-codegen CLI for maintainers and contributors curating committed factories:

• terradart-codegen wrap — regenerate curated factory wrappers from wrapper_overrides/yaml/. Run with --check in CI to verify byte-identical output.
• terradart-codegen wrap-init — scaffold a new wrapper override YAML from schema + MM hints.
• terradart-codegen wrap-promote — propose enum_values and dartTypeOverrides blocks for human review.

The terradart command users run (synth, plan, apply) is terradart_cli.

End users depend on terradart_google, terradart_google_beta, terradart_appwrite, terradart_cloudflare, or terradart_aws directly; they do not run generation locally.

Installation

Activate on the same minor line as your workspace when working on the repo:

dart pub global activate terradart_codegen ^0.35.0

Check pub.dev for the latest patch. Inside the repository, dart run terradart_codegen:terradart <command> runs the same CLI without activating it.

Maintainer quickstart

From packages/terradart_codegen/:

dart run bin/terradart.dart wrap \
  --provider hashicorp/google \
  --source test/fixtures/wrap/source \
  --output ../terradart_google/lib/src

# CI parity check (no writes):
dart run bin/terradart.dart wrap \
  --provider hashicorp/google \
  --source test/fixtures/wrap/source \
  --output ../terradart_google/lib/src \
  --check

The --source directory must contain schema.json and may include mm/<resource>.yaml overlays.

For runtime primitives (Stack, Resource, writeTo), see terradart_core. For project-level documentation, see the terradart repo README and terradart.dev.