Sha256: 9cd25e345076c3a71385aef62951f8fc961d954ce9ae518b38b24f383e8fe0a1
Contents?: true
Size: 1.59 KB
Versions: 13
Compression:
Stored size: 1.59 KB
Contents
---
title: About the yaml Resource
---
# yaml
Use the `yaml` InSpec audit resource to test configuration data in a Yaml file.
<br>
## Syntax
A `yaml` resource block declares the configuration data to be tested. Assume the following Yaml file:
name: foo
array:
- zero
- one
This file can be queried using:
describe yaml('filename.yml') do
its('name') { should eq 'foo' }
its(['array', 1]) { should eq 'one' }
end
where
* `name` is a configuration setting in a Yaml file
* `should eq 'foo'` tests a value of `name` as read from a Yaml file versus the value declared in the test
Like the `json` resource, the `yaml` resource can read a file, run a command, or accept content inline:
describe yaml('config.yaml') do
its(['driver', 'name']) { should eq 'vagrant' }
end
describe yaml({ command: 'retrieve_data.py --yaml' }) do
its('state') { should eq 'open' }
end
describe yaml({ content: \"key1: value1\nkey2: value2\" }) do
its('key2') { should cmp 'value2' }
end
<br>
## Examples
The following examples show how to use this InSpec audit resource.
### Test a kitchen.yml file driver
describe yaml('.kitchen.yaml') do
its('driver.name') { should eq('vagrant') }
end
<br>
## Matchers
This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
### name
The `name` matcher tests the value of `name` as read from a Yaml file versus the value declared in the test:
its('name') { should eq 'foo' }
Version data entries
13 entries across 13 versions & 1 rubygems