PSS: Add parsing of `.tfmigrate.hcl` files to define state migration operations#38526

Merged

SarahFrench merged 17 commits into

mainfrom

pss/TF-36919-parse-tfmigrate-hcl-files

May 19, 2026

Commits on May 6, 2026

feat: Parsing a configuration directory can include .tfmigrate.hcl files including `migrate_from_backend` blocks.
SarahFrench
committed
feat: Add ability to parse `state_store_provider` blocks from .tfmigrate.hcl files
SarahFrench
committed
feat: Block using both `migrate_from_backend` and `state_store_provider` blocks across multiple .tfmigrate.hcl files
SarahFrench
committed
feat: Add validation that catches if a `state_store_provider` block is missing its counterpart `migrate_from_state_store` block
SarahFrench
committed
feat: Add ability to parse `migrate_from_state_store` blocks from .tfmigrate.hcl files. Add tests for error paths and happy path.
SarahFrench
committed
refactor: Avoid potentially nil `mod` variable
SarahFrench
committed
fix: Add validation checks to ensure the same provider is described across migrate_from_state_store and state_store_provider blocks. When they match, copy provider data across to description of the…
SarahFrench
committed
feat: Add validation that blocks .tfmigrate.hcl files being present but empty.
SarahFrench
committed
refactor: Replace if...else blocks with switch statement for clarity.
SarahFrench
committed
feat: Add validation that state_store_provider blocks contain only a single provider. Also, add early returns to avoid repeated or incorrect error diagnostics.
SarahFrench
committed
test: Add test case demonstrating parsing of objects inside the state_store_provider block
SarahFrench
committed
test: Reorganise and group test cases for error scenarios parsing .tfmigrate.hcl files
SarahFrench
committed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

PSS: Add parsing of `.tfmigrate.hcl` files to define state migration operations#38526

PSS: Add parsing of `.tfmigrate.hcl` files to define state migration operations#38526
SarahFrench merged 17 commits into
mainfrom
pss/TF-36919-parse-tfmigrate-hcl-files

Commits on May 6, 2026

feat: Parsing a configuration directory can include .tfmigrate.hcl files including `migrate_from_backend` blocks.

feat: Add ability to parse `state_store_provider` blocks from .tfmigrate.hcl files

feat: Block using both `migrate_from_backend` and `state_store_provider` blocks across multiple .tfmigrate.hcl files

feat: Add validation that catches if a `state_store_provider` block is missing its counterpart `migrate_from_state_store` block

feat: Add ability to parse `migrate_from_state_store` blocks from .tfmigrate.hcl files. Add tests for error paths and happy path.

refactor: Avoid potentially nil `mod` variable

fix: Add validation checks to ensure the same provider is described across migrate_from_state_store and state_store_provider blocks. When they match, copy provider data across to description of the…

feat: Add validation that blocks .tfmigrate.hcl files being present but empty.

refactor: Replace if...else blocks with switch statement for clarity.

feat: Add validation that state_store_provider blocks contain only a single provider. Also, add early returns to avoid repeated or incorrect error diagnostics.

test: Add test case demonstrating parsing of objects inside the state_store_provider block

test: Reorganise and group test cases for error scenarios parsing .tfmigrate.hcl files

Commits on May 8, 2026

refactor: Parse version attr value as version and then make constraint, instead of directly parsing as constraint and trying to validate the type of constraint it is

Respond to reviewer feedback

Commits on May 11, 2026

Change language to use from blocks, with nested state_store or backed, instead of migrate_from_x blocks.

refactor: StateMigrationInstructions field names simplified + use embedding to simplify StateMigrationFile struct.

test: Update tests to assert diagnostic sources that reference from blocks.