beaker 2.47.1 → 2.48.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    N2EyOTk3ODFjZGY3YzkxYjRiZDQ3MmMzODdiYjk5YTgyZDAxYzE3Mw==
+    ZDM0MmY4ZTg1ODM1YzAyY2YzYTYzOTkzMDdlMDg0OTU0ZTNlMmRhNg==
   data.tar.gz: !binary |-
-    ZjFhMjEzOWI0NWVlODMwZDA5NmVhMDA2YjI4YmM4M2U3NzNkM2I1ZA==
+    MzI5YzAyNTNkOWE2N2M5ZDE2MTA5NGQ3ZjE3MzE3ZmU4MWZlYzA3NA==
 SHA512:
   metadata.gz: !binary |-
-    NGMwOTlmYTEwYzA5ZDE3YTJkYmNjYTRkYjZiMTgzMGYzNTAwOGFkNGU0Nzkz
-    MWFiZjlhNmU1Zjk2YmFkN2Y0NjJjYjIwMjBjMjkzYTUxYjM5OGI1ZjcwNTU3
-    MDk2NTIwMTcxYjFjYzJhZGFmNTRkZWFmYjU3MjE0MWExNjQ2ZjI=
+    MWVkNTFjZjQ4ZmQ1ZjJiYzhmM2ZkMDE2NDAyODM4ZTYwOGFmZmRjYTUzZjQw
+    ZWVlMzBmZjAzOGY1OGYxZWFjMzkyOTM4MDBlODU2MTdhNDEyMzljMDYwZWY5
+    Zjk4Mjk2MzczMmJkN2U0MWNlZjdmMmY1Njc4OWRkOGIwNzI0OGE=
   data.tar.gz: !binary |-
-    ZDU1ZDUyNmI4ODAwYWRjYTg3ZGNlYTM5Y2IyYzhhNWU1YTIyY2E1MjMzZTk1
-    Yjg1OTE5ZGIxN2EzNTkyYTBkN2MzMGNjNmVjYmNhMWQ5YTI3YjAyNzI5MzM3
-    MDkwZmMyODgzNjMxYTBkNWFkZjMyOThhNjMwZGVkNDdmZTVjMzc=
+    ZGRhMTg4MTQ5NTFiMDIxY2VmNGNlNTdkODg4NDY5YThkZDJmZTk1ZTUzODNh
+    YTZlNmI4MDY3YzQ0MDE4YjJhYzkxMjVmYWExZjU1M2NiNGUzOTU4NGI1Mzc3
+    OWVkN2RmZDJlMjU3MTZiNDJjOGRiYmVhYzdjNzM2MWFlMzhlMGY=

data/CONTRIBUTING.md

@@ -32,19 +32,19 @@
     why this is a problem, and how the patch fixes the problem when applied.
 ````
 
-* During the time that you are working on your patch the master Beaker branch may have changed - you'll want to [rebase](http://git-scm.com/book/en/Git-Branching-Rebasing) before you submit your PR with `git rebase master`.  A successful rebase ensures that your patch will cleanly merge into Beaker.
-* Submitted patches will be smoke tested through a series of acceptance level tests that ensures basic Beaker functionality - the results of these tests will be evaluated by a Beaker team member.  Failures associated with the submitted patch will result in the patch being rejected.
+* During the time that you are working on your patch the master Beaker branch may have changed - you'll want to [rebase](http://git-scm.com/book/en/Git-Branching-Rebasing) on top of [Beaker's](https://github.com/puppetlabs/beaker) master branch before you submit your PR.  A successful rebase ensures that your PR will cleanly merge into Beaker.
 
 ### Testing
 
+* Submitted PR's will be tested in a series of spec and acceptance level tests - the results of these tests will be evaluated by a Beaker team member, as test results are currently not accessible by the public. Testing failures that require code changes will be communicated in the PR discussion.
 * Make sure you have added [RSpec](http://rspec.info/) tests that exercise your new code.  These test should be located in the appropriate `beaker/spec/` subdirectory.  The addition of new methods/classes or the addition of code paths to existing methods/classes requires additional RSpec coverage.
-  * Beaker uses RSpec 3.1.0+, and you should **NOT USE** deprecated `should`/`stub` methods - **USE** `expect`/`allow`.  Use of deprecated RSpec methods will result in your patch being rejected.  See a nice blog post from 2013 on [RSpec's new message expectation syntax](http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/).
+  * Beaker uses RSpec 3.1.0+, and you should **NOT USE** deprecated `should`/`stub` methods - **USE** `expect`/`allow`. See a nice blog post from 2013 on [RSpec's new message expectation syntax](http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/).
   * Run the tests to assure nothing else was accidentally broken, using `rake test`
-    * **Bonus**: if possible ensure that `rake test` runs without failures for additional Ruby versions (1.9, 2.0, etc). Beaker supports Ruby 1.9+, and breakage of support for older/newer rubies will cause a patch to be rejected.
+    * **Bonus**: if possible ensure that `rake test` runs without failures for additional Rubies (versions 1.9.3 and above).
 
 ### Documentation
 
-* Make sure that you have added documentation using [Yard](http://yardoc.org/), new methods/classes without appropriate documentation will be rejected.
+* Make sure that you have added documentation using [Yard](http://yardoc.org/) as necessary for any new code introduced.
 * More user friendly documentation will be required for PRs unless exempted. Documentation lives in the [docs/ folder](docs).
 
 ## Making Trivial Changes

data/HISTORY.md

@@ -1,6 +1,7 @@
 # default - History
 ## Tags
-* [LATEST - 15 Jul, 2016 (7c89a4d0)](#LATEST)
+* [LATEST - 27 Jul, 2016 (f4d394e2)](#LATEST)
+* [2.47.1 - 15 Jul, 2016 (da89c35b)](#2.47.1)
 * [2.47.0 - 13 Jul, 2016 (bf4cbcf0)](#2.47.0)
 * [2.46.0 - 8 Jul, 2016 (3a650c95)](#2.46.0)
 * [2.45.0 - 29 Jun, 2016 (c0b56972)](#2.45.0)
@@ -124,7 +125,292 @@
 * [pe1.2 - 6 Sep, 2011 (ba3dadd2)](#pe1.2)
 
 ## Details
-### <a name = "LATEST">LATEST - 15 Jul, 2016 (7c89a4d0)
+### <a name = "LATEST">LATEST - 27 Jul, 2016 (f4d394e2)
+
+* (GEM) update beaker version to 2.48.0 (f4d394e2)
+
+* Merge pull request #1198 from kevpl/docs_in_parallel_link (dbc5be2d)
+
+
+```
+Merge pull request #1198 from kevpl/docs_in_parallel_link
+
+(MAINT) fixed broken link to run_in_parallel.md
+```
+* (MAINT) fixed broken link to run_in_parallel.md (ad883530)
+
+
+```
+(MAINT) fixed broken link to run_in_parallel.md
+
+[skip ci]
+```
+* Merge pull request #1195 from kevpl/docs_parallel_mv (cdb3aa5b)
+
+
+```
+Merge pull request #1195 from kevpl/docs_parallel_mv
+
+(MAINT) moved run_in_parallel doc for re-org - BKR-846
+```
+* Merge pull request #1196 from johnduarte/maint-skip-file-install-test (5452e132)
+
+
+```
+Merge pull request #1196 from johnduarte/maint-skip-file-install-test
+
+(MAINT) confined file install acceptance to win/osx
+```
+* (MAINT) confined file install acceptance to win/osx (dfd22f1f)
+
+
+```
+(MAINT) confined file install acceptance to win/osx
+
+This commit confines the `acceptance/tests/install/from_file.rb`
+test to Windows and OSX which are currently the only platforms supported
+by the test.
+```
+* (MAINT) moved run_in_parallel doc for re-org - BKR-846 (3c83094a)
+
+
+```
+(MAINT) moved run_in_parallel doc for re-org - BKR-846
+
+[skip ci]
+```
+* Merge pull request #1192 from johnduarte/generic-pkg-installers (8e923264)
+
+
+```
+Merge pull request #1192 from johnduarte/generic-pkg-installers
+
+(MAINT) add generic dmg and msi installers
+```
+* Merge pull request #1189 from tvpartytonight/maint_add_ci_test_description (746e87eb)
+
+
+```
+Merge pull request #1189 from tvpartytonight/maint_add_ci_test_description
+
+(MAINT) Improve CONTRIBUTING.md testing section
+```
+* Merge pull request #1171 from kevpl/docs_big_reorg (b4937b06)
+
+
+```
+Merge pull request #1171 from kevpl/docs_big_reorg
+
+(BKR-846) re-organized docs
+```
+* Merge pull request #1186 from kevpl/bkr745_rhel6_install (755ecbe4)
+
+
+```
+Merge pull request #1186 from kevpl/bkr745_rhel6_install
+
+(BKR-745) added el support for s390x dev installs
+```
+* Merge pull request #1190 from samwoods1/print_line (72df3b1a)
+
+
+```
+Merge pull request #1190 from samwoods1/print_line
+
+(BKR-556) Print line number from test file in stack in summary on fail
+```
+* Merge pull request #1188 from er0ck/docs/master/maint-remove_TODO_from_lets_write_a_test_doc (dc906de4)
+
+
+```
+Merge pull request #1188 from er0ck/docs/master/maint-remove_TODO_from_lets_write_a_test_doc
+
+(maint) remove TODO from lets_write_a_test doc
+```
+* Merge pull request #1194 from dylanratcliffe/BKR-891 (75587154)
+
+
+```
+Merge pull request #1194 from dylanratcliffe/BKR-891
+
+(BKR-891) Remove uppercasing
+```
+* Merge pull request #1185 from kevpl/docs_preserved_hosts (afc21313)
+
+
+```
+Merge pull request #1185 from kevpl/docs_preserved_hosts
+
+(MAINT) added preserved hosts doc
+```
+* Merge pull request #1193 from puppetlabs/qeng3198/simple-archiving-mechanism (ea263617)
+
+
+```
+Merge pull request #1193 from puppetlabs/qeng3198/simple-archiving-mechanism
+
+(QENG-3198) Mechanism for archiving SUT files
+```
+* (BKR-891) Removed uppercasing assumptions (b5aff42c)
+
+* (BKR-891) Removed more uppercasing (c62c915b)
+
+* (BRK-891) Fixed Tests (986934ac)
+
+* (BKR-891) Remove uppercasing (64c6e1fe)
+
+* Merge pull request #1148 from johnduarte/bkr-847-forgeapi-puppet-com (5f145359)
+
+
+```
+Merge pull request #1148 from johnduarte/bkr-847-forgeapi-puppet-com
+
+(BKR-847) Support puppet.com in forge stubs
+```
+* (QENG-3198) Mechanism for archiving SUT files (f51f66a4)
+
+
+```
+(QENG-3198) Mechanism for archiving SUT files
+
+This commit adds a new host helpers method called `archive_file_from`
+that is intended to be used in post-suites for grabbing arbitrary files
+from the SUTs and puts them in a known location where the Jenkins
+Archive Artifact plugin can find them and present them with the build
+results.
+
+The implementation is basically thin wrapper around `scp_from` that sets
+up a particular directory structure with a hardcoded root directory.
+This hardcoded root directory will need to be added to the Jenkins
+acceptance job configurations so they can be published along with the
+rest of the build results.
+```
+* (MAINT) Improve CONTRIBUTING.md testing section (7828489c)
+
+* (BKR-556) Print line number from test file in stack in summary on fail (f45c57ec)
+
+* (maint) remove TODO from lets write a test doc (d2b739f5)
+
+
+```
+(maint) remove TODO from lets write a test doc
+
+[skip ci]
+```
+* (BKR-745) added el support for s390x dev installs (6fa03aa0)
+
+* Merge pull request #1182 from tvpartytonight/QENG-4068 (7df594b2)
+
+
+```
+Merge pull request #1182 from tvpartytonight/QENG-4068
+
+(QENG-4068) Remove unnecessary gem documentation dependencies
+```
+* Merge pull request #1179 from randomvariable/BKR-882 (afa4d84c)
+
+
+```
+Merge pull request #1179 from randomvariable/BKR-882
+
+(BKR-882) Explicitly refer to AWS SDK v1 gem
+```
+* (MAINT) add generic dmg and msi installers (d89dceb0)
+
+
+```
+(MAINT) add generic dmg and msi installers
+
+This commit adds a generic dmg installer to the OS X package facility.
+This allows either a either a local file location or a URL to be specified
+to install a dmg on an OS X host. It is based on the existing `install_dmg`
+method, but requires the Volume location and package name to be specified by
+the caller. These values cannot be introspected without making assumptions
+about the packaging.
+
+It also adds a generic msi installer as a helper. It is based on the
+`install_msi_on` helper. The additional helper requirements make it a larger
+effort to port to the Windows package facility which is not pursued in this
+commit. The interface of the `generic_install_msi_on` method is the same as
+the `install_msi_on`, it simply removes the validations that are puppet
+specific.
+```
+* (MAINT) added preserved hosts doc (e279c34a)
+
+
+```
+(MAINT) added preserved hosts doc
+
+[skip ci]
+```
+* (BKR-883) Add docs for Beaker rake tasks (#1180) (8eed7d02)
+
+
+```
+(BKR-883) Add docs for Beaker rake tasks (#1180)
+
+* (BKR-883) Add docs for Beaker rake tasks
+
+* (BKR-883) - moving doc to the right location
+
+* Added unit test.
+
+* Revert "Added unit test."
+
+This reverts commit dc5fba2ee1015a7d0b808ef786676d90bbae52e6.
+```
+* (QENG-4068) Remove yardoc testing in 1.9.3 (1e1a29ae)
+
+
+```
+(QENG-4068) Remove yardoc testing in 1.9.3
+
+This commit removes yardoc testing with ruby 1.9.3, allowing us
+to remove gems necessary for yardoc in 1.9.3 only.
+```
+* (QENG-4068) Remove unnecessary gem documentation dependencies (6e70277d)
+
+
+```
+(QENG-4068) Remove unnecessary gem documentation dependencies
+
+These gems are not necessary for beaker itself, and they do not need to
+be specified in the the gemspec.
+```
+* (BKR-882) Explicitly refer to AWS SDK v1 gem (e801cac8)
+
+
+```
+(BKR-882) Explicitly refer to AWS SDK v1 gem
+
+The AWS SDK gem has had a backwards compatible major release.
+However, in projects that want to use both v1 and v2 of the SDK gem, the .gemspec must refer to 'aws-sdk-v1' to satisfy Bundler dependency management.
+```
+* (BKR-846) re-organized docs (f3e01b0c)
+
+
+```
+(BKR-846) re-organized docs
+
+[skip ci]
+```
+* (BKR-847) Support puppet.com in forge stubs (41a95e89)
+
+
+```
+(BKR-847) Support puppet.com in forge stubs
+
+This commit adds an `alias_spec` parameter to the `stub_hosts_on`
+and the `with_host_stubbed_on` to facilitate adding multiple host aliases when
+stubbing hosts.
+
+This commit also updates the `stub_forge_on` and `with_forge_stubbed_on`
+methods to add the `puppet.com` and `puppetlabs.com` variants of `forge`
+and `forgeapi` in order to support both domain names.
+```
+### <a name = "2.47.1">2.47.1 - 15 Jul, 2016 (da89c35b)
+
+* (HISTORY) update beaker history for gem release 2.47.1 (da89c35b)
 
 * (GEM) update beaker version to 2.47.1 (7c89a4d0)
 

data/README.md

@@ -1,27 +1,44 @@
 # Beaker
 
-Beaker is an acceptance testing harness for Puppet PE and other Puppet Projects.  It can also be used as a virtual machine provisioner - setting up machines, running any configuration on those machines and then exiting.
+Beaker is a test harness focused on acceptance testing via interactions
+between multiple (virtual) machines. It provides platform abstraction between
+different Systems Under Test (SUTs), and it can also be used as a virtual machine
+provisioner - setting up machines, running any commands on those machines,
+and then exiting.
 
-Beaker runs tests written in Ruby with an additional DSL API.  This gives you access to all standard Ruby along with acceptance testing specific commands.
+Beaker runs tests written in Ruby, and provides additional Domain-Specific
+Language (DSL) methods.  This gives you access to all standard Ruby along with
+acceptance testing specific commands.
 
 # Installation
 
-See [Beaker Installation](docs/Beaker-Installation.md).
+See [Beaker Installation](docs/tutorials/installation.md).
 
 # Documentation
 
-Documentation for Beaker can be found in this repository in [the docs/ folder](docs/README.md).
+Documentation for Beaker can be found in this repository in
+[the docs/ folder](docs/README.md).
 
-The [Getting Started](docs/How-To-Beaker.md) is a great place to start for new Beaker users.
+## Table of Contents
 
-#Beaker Libraries
-
-Beaker functionality has been extended through the use of libraries available as gems. See the
-[complete list](docs/Beaker-Libraries.md) for available gems. See the [beaker-template documentation](https://github.com/puppetlabs/beaker-template/blob/master/README.md) for documentation on creating beaker-libraries.
+- [Tutorials](docs/tutorials) take you by the hand through the steps to setup a
+beaker run. Start here if you’re new to Beaker or test development.
+- [Concepts](docs/concepts) discuss key topics and concepts at a fairly high
+level and provide useful background information and explanation.
+- [Rubydocs](http://rubydoc.info/github/puppetlabs/beaker/frames) contains the
+technical reference for APIs and other aspects of Beaker. They describe how it
+works and how to use it but assume that you have a basic understanding of key concepts.
+- [How-to guides](docs/how_to) are recipes. They guide you through the steps
+involved in addressing key problems and use-cases. They are more advanced than
+tutorials and assume some knowledge of how Beaker works.
 
-# Beaker API
+#Beaker Libraries
 
-[RubyDoc Beaker Documentation Server](http://rubydoc.info/github/puppetlabs/beaker/frames)
+Beaker functionality has been extended through the use of libraries available as
+gems. See the [complete list](docs/concepts/beaker_libraries.md) for available
+gems. See the
+[beaker-template documentation](https://github.com/puppetlabs/beaker-template/blob/master/README.md)
+for documentation on creating beaker-libraries.
 
 # License
 
@@ -29,11 +46,15 @@ See [LICENSE](LICENSE) file.
 
 # Support & Issues
 
-Please log tickets and issues at our [Beaker Issue Tracker](https://tickets.puppetlabs.com/issues/?jql=project%20%3D%20BKR).  In addition there is an active #puppet-dev channel on Freenode.
+Please log tickets and issues at our
+[Beaker Issue Tracker](https://tickets.puppetlabs.com/issues/?jql=project%20%3D%20BKR).
+In addition there is an active #puppet-dev channel on Freenode.
 
-For additional information on filing tickets, please check out our [CONTRIBUTOR doc](CONTRIBUTING.md),
-and for ticket lifecycle information, checkout our [ticket process doc](docs/meta/ticket_process.md).
+For additional information on filing tickets, please check out our
+[CONTRIBUTOR doc](CONTRIBUTING.md), and for ticket lifecycle information,
+checkout our [ticket process doc](docs/concepts/ticket_process.md).
 
 # Maintainers
 
-For information on project maintainers, please check out our [MAINTAINERS doc](MAINTAINERS.md).
+For information on project maintainers, please check out our
+[MAINTAINERS doc](MAINTAINERS.md).

data/Rakefile

@@ -1,7 +1,7 @@
 require 'open3'
 require 'securerandom'
 require 'beaker-hostgenerator'
-
+require 'beaker'
 HOSTS_PRESERVED  = 'log/latest/hosts_preserved.yml'
 
 task :default => [ 'test:spec' ]
@@ -27,7 +27,7 @@ task :history do
 end
 
 task :travis do
-  Rake::Task['yard'].invoke
+  Rake::Task['yard'].invoke if !Beaker::Shared::Semvar.version_is_less(RUBY_VERSION, '2.0.0')
   Rake::Task['spec'].invoke
 end
 
@@ -256,8 +256,8 @@ end
 #
 ###########################################################
 DOCS_DIR = 'yard_docs'
-DOCS_DAEMON = "yard server --reload --daemon --server thin --docroot #{DOCS_DIR}"
-FOREGROUND_SERVER = "bundle exec yard server --reload --verbose --server thin lib/beaker --docroot #{DOCS_DIR}"
+DOCS_DAEMON = "yard server --reload --daemon --docroot #{DOCS_DIR}"
+FOREGROUND_SERVER = "bundle exec yard server --reload --verbose lib/beaker --docroot #{DOCS_DIR}"
 
 def running?( cmdline )
   ps = `ps -ef`