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