09d8355f43
When rendering a diff between current state and projected state, we only show resources and outputs which have changes. However, we show a full structural diff for these values, which includes all attributes and blocks for a changed resource or output. The result can be a very long diff, which makes it difficult to verify what the changed fields are. This commit adds an experimental concise diff renderer, which suppresses most unchanged fields, only displaying the most relevant changes and some identifying context. This means: - Always show all identifying attributes, initially defined as `id`, `name`, and `tags`, even if unchanged; - Only show changed, added, or removed primitive values: `string`, `number`, or `bool`; - Only show added or removed elements in unordered collections and structural types: `map`, `set`, and `object`; - Show added or removed elements with any surrounding unchanged elements for sequence types: `list` and `tuple`; - Only show added or removed nested blocks, or blocks with changed attributes. If any attributes, collection elements, or blocks are hidden, a count is kept and displayed at the end of the parent scope. This ensures that it is clear that the diff is only displaying a subset of the resource. The experiment is currently enabled by default, but can be disabled by setting the TF_X_CONCISE_DIFF environment variable to 0. |
||
|---|---|---|
| .. | ||
| acctest | ||
| config | ||
| copy | ||
| customdiff | ||
| didyoumean | ||
| encryption | ||
| experiment | ||
| hashcode | ||
| hilmapstructure | ||
| logging | ||
| mutexkv | ||
| pathorcontents | ||
| plugin | ||
| resource | ||
| schema | ||
| shadow | ||
| signalwrapper | ||
| slowmessage | ||
| structure | ||
| validation | ||
| variables | ||
| wrappedreadline | ||
| wrappedstreams | ||
| README.md | ||
README.md
Helper Libraries
This folder contains helper libraries for Terraform plugins. A running joke is that this is "Terraform standard library" for plugins. The goal of the packages in this directory are to provide high-level helpers to make it easier to implement the various aspects of writing a plugin for Terraform.