terraform/website/docs
Martin Atkins 3268a7eaba command/output: Raw output mode
So far the output command has had a default output format intended for
human consumption and a JSON output format intended for machine
consumption.

However, until Terraform v0.14 the default output format for primitive
types happened to be _almost_ a raw string representation of the value,
and so users started using that as a more convenient way to access
primitive-typed output values from shell scripts, avoiding the need to
also use a tool like "jq" to decode the JSON.

Recognizing that primitive-typed output values are common and that
processing them with shell scripts is common, this commit introduces a new
-raw mode which is explicitly intended for that use-case, guaranteeing
that the result will always be the direct result of a string conversion
of the output value, or an error if no such conversion is possible.

Our policy elsewhere in Terraform is that we always use JSON for
machine-readable output. We adopted that policy because our other
machine-readable output has typically been complex data structures rather
than single primitive values. A special mode seems justified for output
values because it is common for root module output values to be just
strings, and so it's pragmatic to offer access to the raw value directly
rather than requiring a round-trip through JSON.
2020-12-09 10:10:02 -08:00
..
backends website: Fix a random typo in azurerm backend 2020-11-18 10:47:52 -08:00
cli Fix apt install typo (#27074) 2020-12-03 10:23:14 -04:00
commands command/output: Raw output mode 2020-12-09 10:10:02 -08:00
configuration Update setproduct.html.md (#27184) 2020-12-08 10:05:37 -04:00
configuration-0-11 website: Update all links to {expressions,modules,resources}.html 2020-11-17 16:30:51 -08:00
import website: Update all Learn crosslinks (#26442) 2020-10-02 11:02:59 -07:00
internals website: Fix inconsistencies in the registry protocol page 2020-11-16 10:06:27 -08:00
modules website: Fix link to external documentation "Git URLs" 2020-12-03 13:24:56 -08:00
plugins website: Fix several broken links (#27091) 2020-12-03 13:54:38 -04:00
providers website: Document alternatives to terraform_remote_state 2020-11-17 09:41:54 -08:00
provisioners Fix docs for 0.15 for vendor provisioners 2020-12-08 16:51:50 -05:00
state Merge pull request #26723 from hashicorp/oct20_language_and_cli_docs 2020-11-11 19:31:05 -08:00
cli-index.html.md website: Add new "glue"/overview pages for CLI and language docs 2020-11-11 19:13:23 -08:00