file_ensure_key_value
Ensure that the file contains a pair of "key separator value".
⚙️ Compatible targets: Linux
⚠️ Deprecated: This method is deprecated and should not be used.
Parameters
Name | Documentation |
---|---|
path | File name to edit (absolute path on the target node). This parameter is required. |
key | Key to define. This parameter is required. |
value | Value to define. This parameter is required. |
separator | Separator between key and value, for example "=" or " " (without the quotes). This parameter can contain only whitespaces. This parameter is required. |
Outcome conditions
You need to replace ${path}
with its actual canonified value.
- ✅ Ok:
file_ensure_key_value_${path}_ok
- ☑️ Already compliant:
file_ensure_key_value_${path}_kept
- 🟨 Repaired:
file_ensure_key_value_${path}_repaired
- ☑️ Already compliant:
- ❌ Error:
file_ensure_key_value_${path}_error
Example
method: file_ensure_key_value
params:
path: VALUE
value: VALUE
separator: VALUE
key: VALUE
Documentation
Edit (or create) the file, and ensure it contains an entry key -> value with arbitrary separator between the key and its value. If the key is already present, the method will change the value associated with this key.