pulumi/pkg/engine/lifecycletest
Will Jones 391fe212ae
Document testing in `pulumi/pulumi` (#17161)
This commit begins the process of documenting how we test Pulumi, from
unit tests to language conformance. It's nowhere near complete yet but
the various sections have been stubbed out and anything that already
exists has been ported over and linked to other new pages where
possible. This commit is a good example of where we can start to take
advantage of Sphinx's rich cross-references, placing e.g. `README.md`
files close to the things they document (such as
`cmd/pulumi-test-language/README.md`) while folding them into a larger
section on testing using Sphinx's tables of contents (TOCs).
2024-09-05 11:51:32 +00:00
..
testdata Fix snapshot integrity on pending replacement (#17146) 2024-09-04 10:52:43 +00:00
README.md Document testing in `pulumi/pulumi` (#17161) 2024-09-05 11:51:32 +00:00
alias_test.go Update lifecycle test APIs to match provider APIs (#16793) 2024-07-26 12:14:45 +00:00
analyzer_test.go Add display to the engine tests (#16050) 2024-05-13 07:18:25 +00:00
continue_on_error_test.go Update lifecycle test APIs to match provider APIs (#16793) 2024-07-26 12:14:45 +00:00
delete_before_replace_test.go Update lifecycle test APIs to match provider APIs (#16793) 2024-07-26 12:14:45 +00:00
golang_sdk_test.go Update lifecycle test APIs to match provider APIs (#16793) 2024-07-26 12:14:45 +00:00
import_test.go Update lifecycle test APIs to match provider APIs (#16793) 2024-07-26 12:14:45 +00:00
loader_test.go Use cached loader in RPC codegen functions (#17126) 2024-09-01 05:12:16 +00:00
parameterized_test.go Ensure internal provider state doesn't clash with user config (#16837) 2024-07-30 12:22:32 +00:00
pending_delete_test.go Add display to the engine tests (#16050) 2024-05-13 07:18:25 +00:00
pending_replace_test.go Fix snapshot integrity on pending replacement (#17146) 2024-09-04 10:52:43 +00:00
provider_test.go Ensure internal provider state doesn't clash with user config (#16837) 2024-07-30 12:22:32 +00:00
pulumi_test.go create unknowns when the provider is not known during construct (#16868) 2024-08-19 07:47:31 +00:00
refresh_legacy_diff_test.go Update lifecycle test APIs to match provider APIs (#16793) 2024-07-26 12:14:45 +00:00
refresh_test.go Use int32 in Go interfaces that map to protobufs using int32 (#17068) 2024-08-28 13:45:17 +00:00
resource_reference_test.go Update lifecycle test APIs to match provider APIs (#16793) 2024-07-26 12:14:45 +00:00
retain_on_delete_test.go Update lifecycle test APIs to match provider APIs (#16793) 2024-07-26 12:14:45 +00:00
source_query_test.go Add parameterized `Call` support to the engine (#16813) 2024-07-26 15:36:53 +00:00
step_generator_test.go Update lifecycle test APIs to match provider APIs (#16793) 2024-07-26 12:14:45 +00:00
target_test.go Propagate deleted parents of untargeted resources (#17117) 2024-08-30 14:31:50 +00:00
test_plan.go Support PULUMI_SHOW_COPILOT_LINK to enable 'explainFailure' link (#17109) 2024-08-29 20:43:29 +00:00
transformation_test.go Update lifecycle test APIs to match provider APIs (#16793) 2024-07-26 12:14:45 +00:00
update_plan_test.go chore: fix some function names (#17128) 2024-09-03 08:57:30 +00:00

README.md

(lifecycle-tests)=

Lifecycle tests

Lifecycle tests exercise the Pulumi engine and serve as a specification for the behaviours and interactions of the various features that define the lifecycle of a Pulumi program. This includes, but is not limited to:

  • The operation(s) being executed (up, preview, etc.) and the options passed to that operation (--target, --target-dependents, etc.).
  • The programs being executed -- their resources, invocations, and the various options that might be associated with them (parent, retainOnDelete, etc.).
  • The state of the program before and after operations are executed.

How and when to use