# TOML<no value>
// <!-- Required for asciidoctor -->
:toc:
// Set toclevels to be at least your hugo [markup.tableOfContents.endLevel] config key
:toclevels: 4

[cols="1^,1^,1^",options=header]
|===
| source | condition | target
| &#10004; | &#10004; | &#10004;
|===

== Description

**source**

The TOML "source" retrieves an information from a TOML file.

**condition**

The TOML "condition" tests that an information exist in a TOML file.

**target**

The TOML "target" ensures that a TOML file content a specific value at specific location.

== Parameters

{{< resourceparameters "sources" "toml" >}}

=== Query

The TOML resource relies on link:https://daseldocs.tomwright.me/[Dasel] to query toml files.

== Example

[source,yaml]
----
# updatecli.yaml
{{<include "assets/code_example/docs/plugins/resources/toml/updatecli.d/default.yaml">}}
----

== Important

The library used to manipulate TOML files, drops comments. More information is available on
link:https://github.com/TomWright/dasel/issues/178[tomwright/dasel#178]. Until we find a solution, a potential workaround is to use the resource `file` like in the following example:

[source,yaml]
----
# updatecli.yaml
{{<include "assets/code_example/docs/plugins/resources/toml/updatecli.d/fallback.yaml">}}
----