Commit Graph

122 Commits

Author SHA1 Message Date
Martin Atkins
cbfeb0fdc8 jsonconfig: Additional details about input variables
The JSON object describing an input variable can now include two additional
properties:

- "type" provides a JSON representation of the variable's type constraint,
  if one is set. Omitted if either there is no constraint declared at all
  or if it's set to "any", which are equivalent and both mean that the
  type is completely unconstrained.

  This uses the standard cty representation of a type constraint, which
  matches how OpenTofu already describes types in the provider protocol,
  in state snapshots, and in saved plan files.
- "required" directly represents whether callers are required to provide
  a value for the variable. This is technically redundant since it is
  set to true unless "default" is also set, but this avoids the need for
  consuming software to reimplement this rule and potentially allows us to
  make this rule more complicated/subtle in future if needed.

For some reason the documentation about the JSON configuration
representation did not previously mention the "variables" property at all,
so this adds documentation for both the new properties and the pre-existing
properties.

Signed-off-by: Martin Atkins <mart@degeneration.co.uk>
2025-07-11 09:25:30 -07:00
adenhuen
6fa79a7de3 docs: update JSON Output Format page (#2885)
Signed-off-by: Ados <aden.huen@gmail.com>
2025-06-10 10:33:27 -04:00
Oleksandr Levchenkov
8589d20d50 add website docs for deprecation attrs (#2706)
Signed-off-by: ollevche <ollevche@gmail.com>
2025-04-25 12:26:40 +03:00
Nathan Baulch
ea558d9d4b Fix typos (#1905)
Signed-off-by: Nathan Baulch <nathan.baulch@gmail.com>
Signed-off-by: Christian Mesh <christianmesh1@gmail.com>
Co-authored-by: Christian Mesh <christianmesh1@gmail.com>
2024-08-29 13:20:33 -04:00
Oleksandr Levchenkov
bf058a2195 add trace log level warning to docs (#1737)
Signed-off-by: ollevche <ollevche@gmail.com>
Signed-off-by: Oleksandr Levchenkov <ollevche@gmail.com>
Co-authored-by: Janos <86970079+janosdebugs@users.noreply.github.com>
2024-06-19 10:48:57 -04:00
David Sims
54ec1a05f8 tofu test -json Machine Readable UI documentation (#1515)
Signed-off-by: David Sims <simsdj82@gmail.com>
2024-05-03 08:31:17 +02:00
Janos
a15a6c9657 Versioned docs: replacing docs links with relative variants (#1537)
Signed-off-by: Janos <86970079+janosdebugs@users.noreply.github.com>
Signed-off-by: Damian Stasik <920747+damianstasik@users.noreply.github.com>
Signed-off-by: Roman Grinovski <roman.grinovski@gmail.com>
Co-authored-by: Damian Stasik <920747+damianstasik@users.noreply.github.com>
Co-authored-by: Roman Grinovski <roman.grinovski@gmail.com>
2024-04-24 13:24:30 +02:00
Ronny Orot
e9fe0f1118 Add support for removed block (#1158)
Signed-off-by: Ronny Orot <ronny.orot@gmail.com>
2024-02-21 10:31:44 +02:00
Christian Mesh
b186fd3912 Docs update, remove additional terraform references (#1046)
Signed-off-by: Christian Mesh <christianmesh1@gmail.com>
Co-authored-by: Janos <86970079+janosdebugs@users.noreply.github.com>
2023-12-21 08:58:23 -05:00
Christian Mesh
abd324ea7c Revert "Fixes #898: Replace hashicorp and terraform references" (#995) 2023-12-11 15:10:03 -05:00
Janos
15bef1428a Fixes #898: Replace hashicorp and terraform references (#973)
Signed-off-by: Janos Bonic <86970079+janosdebugs@users.noreply.github.com>
Signed-off-by: Christian Mesh <christianmesh1@gmail.com>
Co-authored-by: Christian Mesh <christianmesh1@gmail.com>
2023-12-08 08:03:09 -05:00
Haidong Ji
8138991eed Change references to opentofu.org (#902)
Signed-off-by: Haidong Ji <ji@haidongji.com>
2023-11-24 17:07:06 +01:00
Dmitry Kisler
2d6f3753ad Align the module fetching logic with the OpenTofu registry v1 protocol (#901)
Signed-off-by: Dmitry Kisler <admin@dkisler.com>
2023-11-22 11:32:20 +01:00
RLRabinowitz
1b9148a3de Remove Terraform mentions in docs in the codebase (#713) 2023-10-12 12:11:01 +01:00
Julien Levasseur
4c0bda5386 Rename website to OpenTofu (#516)
Co-authored-by: Damian Stasik <920747+damianstasik@users.noreply.github.com>
Co-authored-by: Roman Grinovski <roman.grinovski@gmail.com>
2023-09-21 10:57:47 +01:00
Yaron Yarimi
c8acedd885 Rename github.com/placeholderplaceholderplaceholder/opentf to github.com/opentofu/opentofu (#461) 2023-09-20 14:35:35 +03:00
Damian Stasik
4cab6e72b4 Replace legacy admonition syntax (#432) 2023-09-18 13:56:28 +02:00
Damian Stasik
072d1dce56 Clean up frontmatter sections in the docs (#421) 2023-09-15 16:03:23 +02:00
Roman Grinovski
a4f9c63288 Change docs links: /opentf-> /docs (#367)
Signed-off-by: Roman Grinovski <roman.grinovski@gmail.com>
2023-09-15 14:10:27 +02:00
Kuba Martin
f14089db78 Clean up website/docs/internals (#209) 2023-08-28 17:40:26 +02:00
Elbaz
141e72246d fix tests + english 2023-08-21 19:33:20 +03:00
Kuba Martin
ebcf7455eb Rename root module name. (#4)
* Rename module name from "github.com/hashicorp/terraform" to "github.com/placeholderplaceholderplaceholder/opentf".

Signed-off-by: Jakub Martin <kubam@spacelift.io>

* Gofmt.

Signed-off-by: Jakub Martin <kubam@spacelift.io>

* Regenerate protobuf.

Signed-off-by: Jakub Martin <kubam@spacelift.io>

* Fix comments.

Signed-off-by: Jakub Martin <kubam@spacelift.io>

* Undo issue and pull request link changes.

Signed-off-by: Jakub Martin <kubam@spacelift.io>

* Undo comment changes.

Signed-off-by: Jakub Martin <kubam@spacelift.io>

* Fix comment.

Signed-off-by: Jakub Martin <kubam@spacelift.io>

* Undo some link changes.

Signed-off-by: Jakub Martin <kubam@spacelift.io>

* make generate && make protobuf

Signed-off-by: Jakub Martin <kubam@spacelift.io>

---------

Signed-off-by: Jakub Martin <kubam@spacelift.io>
2023-08-17 14:45:11 +02:00
Andrew Hickman
49f99db1c2 terraform show -json: Add Errored field to output for plan (#33372)
* Add Errored field to JSON output

* Fix test error message
2023-06-19 11:16:41 +01:00
Ashlee Boyer
32f7b8ebd0 Migrating links to new format 2023-02-23 12:55:56 -05:00
Daniel Banck
b8f3f802f5 Add website docs for metadata functions -json command (#32701)
* Add metadata functions doc to internals

* Add metadata functions to internals nav

* Review feedback

* Renamed the doc
* Fixed small typos

* Update page title
2023-02-20 14:14:32 +00:00
kmoe
4fc02469e7 docs: delete outdated Resource Lifecycle page (#32387)
* Delete lifecycle.mdx

* remove resource lifecycle link

* Update internals-nav-data.json
2023-01-06 17:06:09 +00:00
Laura Pacilio
1ce0b91e67 Merge pull request #32020 from hashicorp/fix-future-lang-2
Remove future-facing language from docs (WIP)
2022-11-29 15:09:21 -05:00
Laura Pacilio
97f9cb1645 Remove unnecessary explanation 2022-11-29 15:00:36 -05:00
Laura Pacilio
a76b634f82 Update website/docs/internals/json-format.mdx 2022-11-29 14:56:58 -05:00
Laura Pacilio
8664c9c1f8 Merge pull request #31991 from sigwinch28/patch-1
Document provider registry response property shasum
2022-11-08 17:15:28 -05:00
Joe Harrison
92719db198 Update website/docs/internals/provider-registry-protocol.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-11-08 11:04:14 +00:00
Laura Pacilio
ff9c5f1c59 Update website/docs/internals/provider-network-mirror-protocol.mdx 2022-10-24 17:40:59 -04:00
Laura Pacilio
2df5b5d8b5 Update website/docs/internals/json-format.mdx 2022-10-24 17:39:32 -04:00
Laura Pacilio
0247401266 Update website/docs/internals/json-format.mdx 2022-10-24 17:38:55 -04:00
Kevin Wang
03e262a70b chore: rewrite internal redirects (#32038) 2022-10-20 11:31:55 -04:00
Laura Pacilio
c9f5fdc6ba Update website/docs/internals/json-format.mdx 2022-10-17 19:03:40 -04:00
Laura Pacilio
31a9fde330 take out currently 2022-10-17 19:00:19 -04:00
Laura Pacilio
cf47c71291 Revert "Revert "Remove future-facing statements""
This reverts commit cb975a5fff.
2022-10-14 16:14:20 -04:00
Laura Pacilio
cb975a5fff Revert "Remove future-facing statements"
This reverts commit 0a7e221a49.
2022-10-14 15:00:22 -04:00
Laura Pacilio
0a7e221a49 Remove future-facing statements 2022-10-14 14:42:40 -04:00
Joe Harrison
a1a976c720 Document provider registry response property shasum
Add a short summary of the `shasum` property in the Provider Registry Protocol's distribution package response documentation.
The Response Properties section of the provider registry protocol does not mention the `shasum` property, but it is required and shown in the example.
2022-10-11 20:28:28 +01:00
Bryce Kalow
b54017ef83 website: content updates for developer (#31779)
Co-authored-by: Matthew Garrell <69917312+mgarrell777@users.noreply.github.com>
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
Co-authored-by: Kevin Wang <kwangsan@gmail.com>
Co-authored-by: Judith Malnick <judith@hashicorp.com>
Co-authored-by: Martin Atkins <mart@degeneration.co.uk>
Co-authored-by: HashiBot <62622282+hashibot-web@users.noreply.github.com>
2022-09-15 15:54:13 -05:00
Martin Atkins
fe7e6f970e command/jsonplan: Include new-style check results in JSON plan output
This is a new-shaped representation of check results which follows the
two-tiered structure of static objects and dynamic instances of objects,
thereby allowing consumers to see which checkable objects exist in the
configuration even if a dynamic evaluation error prevented actually
expanding them all to determine their declared instances.

Eventually we'll include this in the state too, but this initially adds it
only to the plan in order to replace the now-deprecated experimental
conditions result that was present but undocumented in Terraform v1.2.
2022-08-26 15:47:29 -07:00
Przemysław Dąbek
39f0d91530 Apply suggestions from code review
Thanks @laurapacilio!

Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-08-17 18:14:29 +02:00
Przemysław Dąbek
463340175e Use consistent naming for path and described parameters 2022-08-12 19:41:12 +02:00
James Bardin
a0b66c87cc Update website/docs/internals/json-format.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-08-02 17:35:30 -04:00
James Bardin
08fed6e296 Update website/docs/internals/json-format.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-08-02 17:35:19 -04:00
James Bardin
1e79f17ed2 Update website/docs/internals/json-format.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-08-02 17:35:09 -04:00
James Bardin
e58d74c0ca update json plan docs with drift output
Add "resource_drift" and "relevant_attributes" to the json plan
documentation.
2022-08-02 16:35:30 -04:00
Paul Schock
48b06007dd Add details reg. verbosity of debug log level
Update as a result of https://github.com/hashicorp/terraform/pull/29641
2022-06-03 12:17:52 -07:00