README.md in puppetlabs_spec_helper-2.9.1 vs README.md in puppetlabs_spec_helper-2.10.0
- old
+ new
@@ -139,29 +139,30 @@
A number of the Puppet parser features, controlled via configuration during a
normal puppet run, can be controlled by exporting specific environment
variables for the spec run. These are:
-* ``FUTURE_PARSER`` - set to "yes" to enable the [future parser](http://docs.puppetlabs.com/puppet/latest/reference/experiments_future.html),
- the equivalent of setting [parser=future](http://docs.puppetlabs.com/references/latest/configuration.html#parser)
- in puppet.conf.
* ``STRICT_VARIABLES`` - set to "yes" to enable set to strict variable checking when using Puppet versions between 3.5 and 4.0;
set to "no" to disable strict variable checking on Puppet versions 4.0, and later.
See [strict_variables](http://docs.puppetlabs.com/references/latest/configuration.html#strictvariables)
in puppet.conf for details.
* ``ORDERING`` - set to the desired ordering method ("title-hash", "manifest", or "random")
to set the order of unrelated resources when applying a catalog. Leave unset for the default
behavior, currently "random". This is equivalent to setting [ordering](http://docs.puppetlabs.com/references/latest/configuration.html#ordering)
in puppet.conf.
-* ``STRINGIFY_FACTS`` - set to "no" to enable [structured facts](http://docs.puppetlabs.com/facter/2.0/fact_overview.html#writing-structured-facts),
- otherwise leave unset to retain the current default behavior. This is equivalent to setting
- [stringify_facts=false](http://docs.puppetlabs.com/references/latest/configuration.html#stringifyfacts)
- in puppet.conf.
-* ``TRUSTED_NODE_DATA`` - set to "yes" to enable [the $facts hash and trusted node data](http://docs.puppetlabs.com/puppet/latest/reference/lang_facts_and_builtin_vars.html),
- which enabled ``$facts`` and ``$trusted`` hashes. This is equivalent to setting
- [trusted_node_data=true](http://docs.puppetlabs.com/references/latest/configuration.html#trustednodedata)
- in puppet.conf.
+* The following options only affect Puppet 3.x:
+ * ``FUTURE_PARSER`` _(Puppet 3.x, starting with 3.2)_ - set to "yes" to enable the [future parser](https://docs.puppet.com/puppet/3/experiments_future.html),
+ the equivalent of setting [parser=future](https://puppet.com/docs/puppet/3.8/configuration.html#parser)
+ in puppet.conf.
+ * ``TRUSTED_NODE_DATA`` _(Puppet 3.x, starting with 3.4)_ - set to "yes" to enable [the $facts hash and trusted node data](https://puppet.com/docs/puppet/3.8/lang_facts_and_builtin_vars.html#trusted-facts),
+ which enabled ``$facts`` and ``$trusted`` hashes. This is equivalent to setting
+ [trusted_node_data=true](https://puppet.com/docs/puppet/3.8/configuration.html#trustednodedata)
+ in puppet.conf.
+ * ``STRINGIFY_FACTS`` _(Puppet 3.x, starting with 3.5)_ - set to "no" to enable [structured facts](http://docs.puppetlabs.com/facter/2.0/fact_overview.html#writing-structured-facts),
+ otherwise leave unset to retain the current default behavior. This is equivalent to setting
+ [stringify_facts=false](https://puppet.com/docs/puppet/3.8/configuration.html#stringifyfacts)
+ in puppet.conf.
As an example, to run spec tests with the future parser, strict variable checking,
and manifest ordering, you would:
FUTURE_PARSER=yes STRICT_VARIABLES=yes ORDERING=manifest rake spec
@@ -344,14 +345,18 @@
env:
- FUTURE_PARSER=yes CI_NODE_TOTAL=2 CI_NODE_INDEX=1
- FUTURE_PARSER=yes CI_NODE_TOTAL=2 CI_NODE_INDEX=2
#### Running tests tagged with test tiers
-To run tests tagged with risk levels set the ``TEST_TIERS`` environment variable to a comma-separated list of
-the appropriate tiers.
+To run tests tagged with risk levels set the ``TEST_TIERS`` environment variable to a comma-separated list of the appropriate tiers.
For example: to run tests marked ``tier_high => true`` and ``tier_medium => true`` in the same test run set the
environment variable``TEST_TIERS=high,medium``
+
+By default ``TEST_TIERS`` only accepts low, medium and high as valid tiers. If you would like to use your own keywords to set the environment variable ``TEST_TIERS_ALLOWED``.
+
+For example: to use the keywords dev, rnd, staging and production you can set
+``TEST_TIERS_ALLOWED=dev,rnd,staging,production``. Then you would be able to run tests marked ``tier_dev => true``, ``tier_production => true`` with ``TEST_TIERS=dev,production``
Note, if the ``TEST_TIERS`` environment variable is set to empty string or nil, all tiers will be executed.
Generating code coverage reports