prof 0.29.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 40bcbedb4a82be8debb7fb4b120faa9ea9480d10
+  data.tar.gz: b3660e7602268aaa31f487c29e5b8820d85f4dab
+SHA512:
+  metadata.gz: 105928b4e69b0d47da3ae17a2e591bd09aa417899b2721297ae85d65387f755ed50e15252af1581bc8c0152d76242d25e0705797c9b1a2fb3167634432e26a92
+  data.tar.gz: 715dd614e05306fa15711845cfb03a54132e025211c5c1c0aceb87a38f4c0d8ec37cc7ced1bb02f4a6a177ab40463430bd700235a2d59a7ad4023be19d0d500e

data/LEGAL

@@ -0,0 +1,13 @@
+Copyright (c) 2014-2015 Pivotal Software, Inc. All rights reserved.
+
+Unauthorized use, copying or distribution of this source code via any
+medium is strictly prohibited without the express written consent of
+Pivotal Software, Inc.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/prof/cloud_foundry.rb

@@ -0,0 +1,145 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+# INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+# PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+# USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+require 'forwardable'
+require 'hula/cloud_foundry'
+
+require 'prof/marketplace_service'
+require 'prof/pushed_test_app'
+require 'prof/service_instance'
+
+module Prof
+  class CloudFoundry
+    extend Forwardable
+
+    attr_reader :api_url, :domain, :username, :password
+
+    def_delegators :hula_cloud_foundry,
+                   :add_public_service_broker,
+                   :app_env,
+                   :create_org,
+                   :target_org,
+                   :create_space,
+                   :target_space,
+                   :create_and_target_org,
+                   :create_and_target_space,
+                   :create_service_instance,
+                   :delete_org,
+                   :delete_space,
+                   :delete_service_instance_and_unbind,
+                   :push_app_and_start,
+                   :remove_service_broker,
+                   :service_brokers,
+                   :setup_permissive_security_group,
+                   :app_vcap_services,
+                   :marketplace
+
+    def initialize(opts = {})
+      @domain   = opts.fetch(:domain)
+      @api_url  = opts.fetch(:api_url) { "https://api.#{domain}" }
+      @username = opts.fetch(:username)
+      @password = opts.fetch(:password)
+    end
+
+    def push_app(app, &_block)
+      pushed_app_name = "cf-app-#{SecureRandom.hex(4)}"
+      deployed_app    = PushedTestApp.new(name: pushed_app_name, url: hula_cloud_foundry.url_for_app(pushed_app_name))
+
+      hula_cloud_foundry.push_app(app.path, deployed_app.name)
+
+      yield deployed_app
+    ensure
+      hula_cloud_foundry.delete_app deployed_app.name
+    end
+
+    def enable_diego_and_start_app(app)
+      hula_cloud_foundry.enable_diego_for_app(app.name)
+      hula_cloud_foundry.start_app(app.name)
+    end
+
+    def push_app_and_bind_with_service(app, service, &_block)
+      push_app(app) do |pushed_app|
+        provision_service(service) do |service_instance|
+          bind_service_and_run(pushed_app, service_instance) do
+            yield pushed_app, service_instance
+          end
+        end
+      end
+    end
+
+    def push_app_and_bind_with_service_instance(app, service_instance, &_block)
+      push_app(app) do |pushed_app|
+        bind_service_and_run(pushed_app, service_instance) do
+          yield pushed_app, service_instance
+        end
+      end
+    end
+
+    def bind_service_and_run(pushed_app, service_instance, &_block)
+      hula_cloud_foundry.bind_app_to_service(pushed_app.name, service_instance.name)
+      hula_cloud_foundry.start_app(pushed_app.name)
+
+      yield
+
+      hula_cloud_foundry.unbind_app_from_service(pushed_app.name, service_instance.name)
+    end
+
+    def provision_and_create_service_key(service, &_block)
+      provision_service(service) do |service_instance|
+        create_service_key(service_instance) do |service_key, service_key_data|
+          yield service_instance, service_key, service_key_data
+        end
+      end
+    end
+
+    def list_service_keys(service_instance)
+      hula_cloud_foundry.list_service_keys(service_instance.name)
+    end
+
+    def create_service_key(service_instance, &_block)
+      service_key_name = "#{service_instance.name}-#{SecureRandom.hex(4)}"
+      hula_cloud_foundry.create_service_key(service_instance.name, service_key_name)
+      service_key_raw = hula_cloud_foundry.service_key(service_instance.name, service_key_name)
+      service_key_data = JSON.parse(
+        service_key_raw.split("\n").slice(2..-1).join
+      )
+
+      yield service_key_name, service_key_data
+
+      hula_cloud_foundry.delete_service_key(service_instance.name, service_key_name)
+    end
+
+    def delete_service_key(service_instance, service_key)
+      hula_cloud_foundry.delete_service_key(service_instance.name, service_key)
+    end
+
+    def provision_service(service, &_block)
+      service_instance = ServiceInstance.new
+
+      hula_cloud_foundry.create_service_instance(service.name, service_instance.name, service.plan)
+
+      yield service_instance if block_given?
+
+    ensure
+      hula_cloud_foundry.delete_service_instance_and_unbind(service_instance.name)
+    end
+
+    private
+
+    def hula_cloud_foundry
+      @hula_cloud_foundry ||= Hula::CloudFoundry.new(
+        api_url:  api_url,
+        domain:   domain,
+        username: username,
+        password: password
+      )
+    end
+  end
+end

data/lib/prof/environment/cloud_foundry.rb

@@ -0,0 +1,150 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+# INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+# PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+# USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+require 'hula/bosh_director'
+require 'hula/service_broker/client'
+require 'hula/bosh_manifest'
+require 'hula/socks4_proxy_ssh'
+require 'hula/http_proxy_upstream_socks'
+
+require 'prof/cloud_foundry'
+require 'prof/ssh_gateway'
+require 'prof/uaa_client'
+
+module Prof
+  module Environment
+    class CloudFoundry
+      attr_reader :bosh_service_broker_job_name
+
+      def initialize(
+        cloud_foundry_domain:      nil,
+
+        cloud_controller_identity: 'cloud_controller',
+        cloud_controller_password: 'cc-secret',
+
+        cloud_foundry_username:    'admin',
+        cloud_foundry_password:    'admin',
+        cloud_foundry_api_url:      nil,
+
+        bosh_target:               'https://192.168.50.4:25555',
+        bosh_username:             'admin',
+        bosh_password:             'admin',
+
+        ssh_gateway_host:          '192.168.50.4',
+        ssh_gateway_username:      'vagrant',
+        ssh_gateway_password:      'vagrant',
+
+        bosh_service_broker_job_name:,
+        bosh_manifest_path:,
+
+        use_proxy:                 true
+      )
+        @cloud_foundry_domain = cloud_foundry_domain
+        @cloud_controller_identity = cloud_controller_identity
+        @cloud_controller_password = cloud_controller_password
+        @cloud_foundry_username = cloud_foundry_username
+        @cloud_foundry_password = cloud_foundry_password
+        @bosh_target = bosh_target
+        @bosh_username = bosh_username
+        @bosh_password = bosh_password
+        @ssh_gateway_host = ssh_gateway_host
+        @ssh_gateway_username = ssh_gateway_username
+        @ssh_gateway_password = ssh_gateway_password
+        @bosh_service_broker_job_name = bosh_service_broker_job_name
+        @bosh_manifest_path = bosh_manifest_path
+        @cloud_foundry_api_url = cloud_foundry_api_url
+        @use_proxy = use_proxy
+      end
+
+      def cloud_foundry
+        @cloud_foundry ||= ::Prof::CloudFoundry.new(
+          domain:   cloud_foundry_domain,
+          username: cloud_foundry_username,
+          password: cloud_foundry_password,
+          api_url:  cloud_foundry_api_url
+        )
+      end
+
+      def bosh_manifest
+        @bosh_manifest ||= Hula::BoshManifest.from_file(bosh_manifest_path)
+      end
+
+      def cloud_foundry_domain
+        @cloud_foundry_domain ||= bosh_manifest.property('cf.domain')
+      end
+
+      def service_broker
+        @service_broker ||= Hula::ServiceBroker::Client.new(
+          url: URI::HTTPS.build(host: broker_registrar_properties.fetch('host')),
+          username: broker_registrar_properties.fetch('username'),
+          password: broker_registrar_properties.fetch('password'),
+          http_client: http_json_client(use_proxy: use_proxy)
+        )
+      end
+
+      def service_broker_name
+        broker_registrar_properties.fetch('name')
+      end
+
+      def bosh_director
+        @bosh_director ||= Hula::BoshDirector.new(
+          target_url:    bosh_target,
+          username:      bosh_username,
+          password:      bosh_password,
+          manifest_path: bosh_manifest_path
+        )
+      end
+
+      def ssh_gateway
+        @ssh_gateway ||= SshGateway.new(
+          gateway_host:     ssh_gateway_host,
+          gateway_username: ssh_gateway_username,
+          gateway_password: ssh_gateway_password
+        )
+      end
+
+      def cloud_foundry_uaa
+        @cloud_foundry_uaa ||= UAAClient.new(
+          cloud_foundry_domain,
+          cloud_controller_identity,
+          cloud_controller_password
+        )
+      end
+
+      def socks4_proxy
+        @socks4_proxy ||= Hula::Socks4ProxySsh.new(
+          ssh_username: ssh_gateway_username,
+          ssh_password: ssh_gateway_password,
+          ssh_host:     ssh_gateway_host
+        ).tap(&:start)
+      end
+
+      def http_proxy
+        @http_proxy ||= Hula::HttpProxyUpstreamSocks.new(socks_proxy: socks4_proxy).tap(&:start)
+      end
+
+      private
+
+      attr_reader :cloud_controller_identity, :cloud_controller_password,
+                  :cloud_foundry_username, :cloud_foundry_password, :bosh_target, :bosh_username, :bosh_password,
+                  :ssh_gateway_host, :ssh_gateway_username, :ssh_gateway_password, :bosh_manifest_path,
+                  :cloud_foundry_api_url, :use_proxy
+
+      def broker_registrar_properties
+        bosh_manifest.job('broker-registrar').properties.fetch('broker')
+      end
+
+      def http_json_client(use_proxy:)
+        proxy = use_proxy ? http_proxy : Hula::ServiceBroker::HttpProxyNull.new
+        @http_json_client ||= Hula::ServiceBroker::HttpJsonClient.new(http_proxy: proxy)
+      end
+    end
+  end
+end

data/lib/prof/environment/pcf_drinks.rb

@@ -0,0 +1,156 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+# INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+# PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+# USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+require 'uri'
+require 'hula/bosh_director'
+require 'capybara'
+
+require 'prof/cloud_foundry'
+require 'prof/ops_manager'
+require 'prof/ops_manager_log_fetcher'
+require 'prof/ssh_gateway'
+require 'prof/uaa_client'
+
+module Prof
+  module Environment
+    class NoDirectorVm < StandardError; end
+
+    class PcfDrinks
+      def initialize(tempest_config, page: default_capybara_session)
+        @tempest_config = tempest_config
+        @page           = page
+      end
+
+      def ops_manager
+        @ops_manager ||= OpsManager.new(ops_manager_config.merge(page: page))
+      end
+
+      def cloud_foundry
+        @cloud_foundry ||= CloudFoundry.new(
+          domain:   cloud_foundry_domain,
+          username: cloud_foundry_credentials.username,
+          password: cloud_foundry_credentials.password
+        )
+      end
+
+      def cloud_foundry_domain
+        tempest_config.fetch(:cloudfoundry).fetch(:domain)
+      end
+
+      def bosh_director
+        @bosh_director ||= Hula::BoshDirector.new(
+          target_url:  bosh_director_url,
+          username:    bosh_credentials.fetch('identity'),
+          password:    bosh_credentials.fetch('password')
+        )
+      end
+
+      def ssh_gateway
+        SshGateway.new(
+          gateway_host:     ssh_gateway_config.fetch(:host),
+          gateway_username: ssh_gateway_config.fetch(:username),
+          gateway_password: ssh_gateway_config[:password],
+          ssh_key:          ssh_gateway_config[:ssh_key]
+        )
+      end
+
+      def cloud_foundry_uaa
+        @cloud_foundry_uaa ||= UAAClient.new(
+          cloud_foundry_domain,
+          cloud_controller_client_credentials.identity,
+          cloud_controller_client_credentials.password
+        )
+      end
+
+      private
+
+      attr_reader :tempest_config, :page
+
+      def default_capybara_session
+        Capybara::Session.new(Capybara.default_driver)
+      end
+
+      def log_fetcher
+        OpsManagerLogFetcher.new(
+          ssh_gateway: ssh_gateway,
+          host:        ops_manager_hostname,
+          username:    ops_manager_vm_config.fetch(:username),
+          password:    ops_manager_vm_config.fetch(:password)
+        )
+      end
+
+      def cloud_controller_client_credentials
+        @cloud_controller_client_credentials ||= ops_manager.cc_client_credentials
+      end
+
+      def forwarded_bosh_port
+        @forwarded_bosh_port ||=
+          ssh_gateway.with_port_forwarded_to(
+            director.hostname,
+            25555
+          )
+      end
+
+      def director
+        director = ops_manager.vms_for_job_type('director').first
+
+        if director.nil?
+          raise NoDirectorVm, "No director VM found for #{ops_manager.url}"
+        else
+          director
+        end
+      end
+
+      def ops_manager_hostname
+        URI.parse(ops_manager_config.fetch(:url)).hostname
+      end
+
+      def ops_manager_config
+        tempest_config.fetch(:tempest)
+      end
+
+      def ops_manager_vm_config
+        tempest_config.fetch(:tempest_vm)
+      end
+
+      def ssh_gateway_config
+        tempest_config.fetch(:proxy)
+      end
+
+      def bosh_director_url
+        return URI("https://127.0.0.1:#{forwarded_bosh_port}").to_s if !tempest_config[:proxy].nil?
+        return director.hostname
+      end
+
+      def bosh_product
+        # old versions of OpsMan (< v1.6 RC4)
+        @bosh_product ||= ops_manager
+                          .send(:opsmanager_client)
+                          .send(:product, 'microbosh')
+
+        # newer versions of OpsMan (>= v1.6 RC4)
+        @bosh_product ||= ops_manager
+                          .send(:opsmanager_client)
+                          .send(:product, 'p-bosh')
+      end
+
+      def bosh_credentials
+        # TODO: push this code into ops manager
+        @bosh_credentials ||= bosh_product
+                              .job_of_type('director')
+                              .properties.fetch('director_credentials')
+      end
+
+      def cloud_foundry_credentials
+        @cloud_foundry_credentials ||= ops_manager.cf_admin_credentials
+      end
+    end
+  end
+end

data/lib/prof/environment_manager.rb

@@ -0,0 +1,93 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+# INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+# PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+# USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+module Prof
+  class EnvironmentManager
+    class OpsManagerNotConfigured < StandardError; end
+
+    def initialize(pcf_environment)
+      @pcf_environment = pcf_environment
+    end
+
+    def isolate_cloud_foundry(&_block)
+      cloud_foundry.create_and_target_org(cf_org_name)
+      cloud_foundry.create_and_target_space(cf_space_name)
+      cloud_foundry.setup_permissive_security_group(cf_org_name, cf_space_name)
+
+      yield
+
+      cloud_foundry.delete_org(cf_org_name)
+    end
+
+    def destroy_orphan_tiles
+      orphans = orphan_tiles
+      return unless orphans.any?
+
+      puts "Removing orphaned tile(s) #{orphans.map(&:name).join(', ')}"
+      ops_manager.uninstall_tiles(orphans)
+    end
+
+    def destroy_orphan_deployments
+      orphans = orphan_deployments
+      return unless orphans.any?
+
+      puts "Removing orphaned deployment(s) '#{orphans.join(', ')}'"
+      orphans.each do |deployment_name|
+        bosh_director.delete_deployment(deployment_name, force: true)
+      end
+    end
+
+    def uninstall_tiles
+      ops_manager.uninstall_tiles(ops_manager.product_tiles)
+    end
+
+    def reset
+      raise OpsManagerNotConfigured, "Please configure #{ops_manager.url}" unless ops_manager.cf_installed?
+
+      destroy_orphan_tiles
+      destroy_orphan_deployments
+      uninstall_tiles
+    end
+
+    private
+
+    attr_reader :pcf_environment
+
+    def cf_org_name
+      @cf_org_name ||= "cf-org-#{SecureRandom.hex(4)}"
+    end
+
+    def cf_space_name
+      @cf_space_name ||= "cf-space-#{SecureRandom.hex(4)}"
+    end
+
+    def cloud_foundry
+      pcf_environment.cloud_foundry
+    end
+
+    def ops_manager
+      pcf_environment.ops_manager
+    end
+
+    def orphan_deployments
+      tile_guids = pcf_environment.ops_manager.tiles.map(&:guid)
+      pcf_environment.bosh_director.deployment_names.reject { |deployment_name| tile_guids.include?(deployment_name) }
+    end
+
+    def orphan_tiles
+      bosh_deployment_names = pcf_environment.bosh_director.deployment_names
+      pcf_environment.ops_manager.product_tiles.reject { |tile| bosh_deployment_names.include?(tile.guid) }
+    end
+
+    def bosh_director
+      pcf_environment.bosh_director
+    end
+  end
+end

data/lib/prof/external_spec/helpers/capybara.rb

@@ -0,0 +1,58 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+# INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+# PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+# USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+require 'capybara/rspec'
+require 'capybara/query'
+require 'capybara/poltergeist'
+require 'capybara/webkit'
+
+module Prof
+  module ExternalSpec
+    module Helpers
+      module Capybara
+        def setup_browser(driver = :poltergeist)
+          unless %i{poltergeist webkit}.include?(driver)
+            raise StandardError.new("invalid driver")
+          end
+
+          ::Capybara.default_wait_time = 60
+          ::Capybara.default_driver    = driver
+          ::Capybara.javascript_driver = driver
+
+          ::Capybara.register_driver :poltergeist do |app|
+            ::Capybara::Poltergeist::Driver.new(
+              app,
+              debug:             ENV.key?('DEBUG'),
+              timeout:           240,
+              js_errors:         false,
+              phantomjs_logger:  null_io_object,
+              phantomjs_options: ['--ignore-ssl-errors=yes'],
+              window_size:       [1300, 1000]
+            )
+          end
+
+          ::Capybara.register_driver :webkit do |app|
+            ::Capybara::Webkit::Driver.new(app).tap do |d|
+              d.browser.ignore_ssl_errors
+              d.browser.allow_url('*')
+            end
+          end
+        end
+
+        def null_io_object
+          f            = File.open('/dev/null')
+          io           = IO.for_fd(f.fileno)
+          io.autoclose = true
+          io
+        end
+      end
+    end
+  end
+end

data/lib/prof/external_spec/helpers/debug.rb

@@ -0,0 +1,53 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+# INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+# PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+# USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+module Prof
+  module ExternalSpec
+    module Helpers
+      module Debug
+
+        def recording_exceptions
+          yield
+        rescue Exception => ex
+          @recorded_exception = ex
+          raise
+        end
+
+        def save_exceptions
+          yield
+        rescue Exception => ex
+          ops_manager.browser do |page|
+            name = "failure"
+            puts "Saving failure data for '#{name}'"
+            page.save_page("#{name}.html")
+            page.save_screenshot("#{name}.png")
+          end
+          raise
+        end
+
+        def save_exception_output(example)
+          unless @recorded_exception
+            return unless example.respond_to?(:exception)
+            return unless example.respond_to?(:full_description)
+            return unless respond_to?(:ops_manager)
+            return unless example.exception
+          end
+
+          ops_manager.browser do |page|
+            name = example.full_description.gsub(/\W/, '_')
+            puts "Saving failure data for '#{name}'"
+            page.save_page("#{name}.html")
+            page.save_screenshot("#{name}.png")
+          end
+        end
+      end
+    end
+  end
+end