mmtrix_rpm 1.0.0.1

data/lib/mmtrix/recipes/capistrano_legacy.rb

@@ -0,0 +1,98 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+make_notify_task = Proc.new do
+
+  namespace :mmtrix do
+
+    # on all deployments, notify Mmtrix
+    desc "Record a deployment in Mmtrix (mmtrix.com)"
+    task :notice_deployment, :roles => :app, :except => {:no_release => true } do
+      rails_env = fetch(:mmtrix_rails_env, fetch(:rails_env, "production"))
+
+      require 'mmtrix/cli/command'
+
+      begin
+        # allow overrides to be defined for revision, description, changelog, appname, and user
+        rev         = fetch(:mmtrix_revision)    if exists?(:mmtrix_revision)
+        description = fetch(:mmtrix_desc)        if exists?(:mmtrix_desc)
+        changelog   = fetch(:mmtrix_changelog)   if exists?(:mmtrix_changelog)
+        appname     = fetch(:mmtrix_appname)     if exists?(:mmtrix_appname)
+        user        = fetch(:mmtrix_user)        if exists?(:mmtrix_user)
+        license_key = fetch(:mmtrix_license_key) if exists?(:mmtrix_license_key)
+
+        unless scm == :none
+          changelog = lookup_changelog(changelog)
+          rev       = lookup_rev(rev)
+        end
+
+        new_revision = rev
+        deploy_options = {
+          :environment => rails_env,
+          :revision    => new_revision,
+          :changelog   => changelog,
+          :description => description,
+          :appname     => appname,
+          :user        => user,
+          :license_key => license_key
+        }
+
+        logger.debug "Uploading deployment to Mmtrix"
+        deployment = Mmtrix::Cli::Deployments.new deploy_options
+        deployment.run
+        logger.info "Uploaded deployment information to Mmtrix"
+
+      rescue Mmtrix::Cli::Command::CommandFailure => e
+        logger.info e.message
+      rescue Capistrano::CommandError
+        logger.info "Unable to notify Mmtrix of the deployment... skipping"
+      rescue => e
+        logger.info "Error creating Mmtrix deployment (#{e})\n#{e.backtrace.join("\n")}"
+      end
+    end
+
+    def lookup_changelog(changelog)
+      if !changelog
+        logger.debug "Getting log of changes for Mmtrix Deployment details"
+        from_revision = source.next_revision(current_revision)
+
+        if scm == :git
+          log_command = "git log --no-color --pretty=format:'  * %an: %s' " +
+            "--abbrev-commit --no-merges #{previous_revision}..#{real_revision}"
+        else
+          log_command = "#{source.log(from_revision)}"
+        end
+
+        changelog = `#{log_command}`
+      end
+      changelog
+    end
+
+    def lookup_rev(rev)
+      if rev.nil?
+        rev = source.query_revision(source.head()) do |cmd|
+          logger.debug "executing locally: '#{cmd}'"
+          `#{cmd}`
+        end
+
+        rev = rev[0..6] if scm == :git
+      end
+      rev
+    end
+  end
+end
+
+require 'capistrano/version'
+
+if defined?(Capistrano::Version::MAJOR) && Capistrano::Version::MAJOR < 2
+  STDERR.puts "Unable to load #{__FILE__}\nMmtrix Capistrano hooks require at least version 2.0.0"
+else
+  instance = Capistrano::Configuration.instance
+
+  if instance
+    instance.load(&make_notify_task)
+  else
+    make_notify_task.call
+  end
+end

data/lib/mmtrix/recipes.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+# When installed as a plugin, this is loaded automatically.
+#
+# When installed as a gem, you need to add
+#  require 'mmtrix/recipes'
+# to deploy.rb
+#
+# Defines mmtrix:notice_deployment, which sends information about the deploy
+# to Mmtrix. The task will run on all app release roles. If it fails, it will
+# not affect the execution of subsequent tasks or cause a rollback.
+#
+# @api public
+#
+
+require 'capistrano/version'
+
+if defined?(Capistrano::VERSION) && Capistrano::VERSION.to_s.split('.').first.to_i >= 3
+  require 'mmtrix/recipes/capistrano3'
+else
+  require 'mmtrix/recipes/capistrano_legacy'
+end

data/lib/mmtrix/timer_lib.rb

@@ -0,0 +1,31 @@
+# encoding: utf-8
+# This file is distributed under Ruby's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+# Copyright:  (C) 2008 David Vollbracht & Philippe Hanrigou
+
+# This code was borrowed from the system_timer gem under the terms
+# of the Ruby license.  It has been slightly modified.
+
+# Defines the constant TimerLib to the appropriate timeout library
+module Mmtrix #:nodoc:
+
+  begin
+    # Try to use the SystemTimer gem instead of Ruby's timeout library
+    # when running on Ruby 1.8.x. See:
+    #   http://ph7spot.com/articles/system_timer
+    # We don't want to bother trying to load SystemTimer on jruby,
+    # ruby 1.9+ and rbx.
+    if !defined?(RUBY_ENGINE) || (RUBY_ENGINE == 'ruby' && RUBY_VERSION < '1.9.0')
+      require 'system_timer'
+      TimerLib = SystemTimer
+    else
+      require 'timeout'
+      TimerLib = Timeout
+    end
+  rescue LoadError
+    require 'timeout'
+    TimerLib = Timeout
+  end
+
+end

data/lib/mmtrix/version.rb

@@ -0,0 +1,70 @@
+#!/usr/bin/ruby
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+
+module Mmtrix
+  module VERSION #:nodoc:
+    def self.build_version_string(*parts)
+      parts.compact.join('.')
+    end
+
+    MAJOR = 1
+    MINOR = 0
+    TINY  = 0
+
+    begin
+      require File.join(File.dirname(__FILE__), 'build')
+    rescue LoadError
+      BUILD = nil
+    end
+
+    STRING = build_version_string(MAJOR, MINOR, TINY, BUILD)
+  end
+
+  # Helper class for managing version comparisons
+  class VersionNumber
+    attr_reader :parts
+    include Comparable
+    def initialize(version_string)
+      version_string ||= '1.0.0'
+      @parts = version_string.split('.').map{|n| n =~ /^\d+$/ ? n.to_i : n}
+    end
+    def major_version; @parts[0]; end
+    def minor_version; @parts[1]; end
+    def tiny_version; @parts[2]; end
+
+    def <=>(other)
+      other = self.class.new(other) if other.is_a? String
+      self.class.compare(self.parts, other.parts)
+    end
+
+    def to_s
+      @parts.join(".")
+    end
+
+    def hash
+      @parts.hash
+    end
+
+    def eql? other
+      (self <=> other) == 0
+    end
+
+    private
+    def self.compare(parts1, parts2)
+      a, b = parts1.first, parts2.first
+      case
+        when a.nil? && b.nil? then 0
+        when a.nil? then b.is_a?(Fixnum) ?  -1 : 1
+        when b.nil? then -compare(parts2, parts1)
+        when a.to_s == b.to_s then compare(parts1[1..-1], parts2[1..-1])
+        when a.is_a?(String) then b.is_a?(Fixnum) ?  -1 : (a <=> b)
+        when b.is_a?(String) then -compare(parts2, parts1)
+        else # they are both fixnums, not nil
+          a <=> b
+      end
+    end
+  end
+end

data/lib/mmtrix_rpm.rb

@@ -0,0 +1,54 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+# == Mmtrix Initialization
+#
+# When installed as a gem, you can activate the Mmtrix agent one of the following ways:
+#
+# For Rails, add:
+#    config.gem 'mmtrix_rpm'
+# to your initialization sequence.
+#
+# For merb, do
+#    dependency 'mmtrix_rpm'
+# in the Merb config/init.rb
+#
+# For Sinatra, do
+#    require 'mmtrix_rpm'
+# after requiring 'sinatra'.
+#
+# For other frameworks, or to manage the agent manually, invoke Mmtrix::Agent#manual_start
+# directly.
+#
+
+require 'mmtrix/control'
+if defined?(Merb) && defined?(Merb::BootLoader)
+  module Mmtrix
+    class MerbBootLoader < Merb::BootLoader
+      after Merb::BootLoader::ChooseAdapter
+      def self.run
+        Mmtrix::Control.instance.init_plugin
+      end
+    end
+  end
+elsif defined?(Rails::VERSION)
+  if Rails::VERSION::MAJOR.to_i >= 3
+    module Mmtrix
+      class Railtie < Rails::Railtie
+
+        initializer "mmtrix_rpm.start_plugin" do |app|
+          Mmtrix::Control.instance.init_plugin(:config => app.config)
+        end
+      end
+    end
+  else
+    # After version 2.0 of Rails we can access the configuration directly.
+    # We need it to add dev mode routes after initialization finished.
+    config = nil
+    config = Rails.configuration if Rails.respond_to?(:configuration)
+    Mmtrix::Control.instance.init_plugin :config => config
+  end
+else
+  Mmtrix::Control.instance.init_plugin
+end

data/lib/sequel/extensions/mmtrix_instrumentation.rb

@@ -0,0 +1,79 @@
+# -*- ruby -*-
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require 'sequel' unless defined?( Sequel )
+require 'mmtrix_rpm' unless defined?( Mmtrix )
+require 'mmtrix/agent/instrumentation/sequel_helper'
+require 'mmtrix/agent/datastores/metric_helper'
+
+module Sequel
+
+  # Mmtrix's Sequel instrumentation is implemented via a plugin for
+  # Sequel::Models, and an extension for Sequel::Databases. Every database
+  # handle that Sequel knows about when Mmtrix is loaded will automatically
+  # be instrumented, but if you're using a version of Sequel before 3.47.0,
+  # you'll need to add the extension yourself if you create any after the
+  # instrumentation is loaded:
+  #
+  #     db = Sequel.connect( ... )
+  #     db.extension :mmtrix_instrumentation
+  #
+  # Versions 3.47.0 and later use `Database.extension` to automatically
+  # install the extension for new connections.
+  #
+  # == Disabling
+  #
+  # If you don't want your models or database connections to be instrumented,
+  # you can disable them by setting `disable_database_instrumentation` in
+  # your `mmtrix.yml` to `true`. It will also honor the
+  # `disable_activerecord_instrumentation` setting.
+  #
+  module MmtrixInstrumentation
+
+    # Instrument all queries that go through #execute_query.
+    def log_yield(sql, args=nil) #THREAD_LOCAL_ACCESS
+      rval = nil
+      product = Mmtrix::Agent::Instrumentation::SequelHelper.product_name_from_adapter(self.class.adapter_scheme)
+      metrics = Mmtrix::Agent::Datastores::MetricHelper.metrics_from_sql(product, sql)
+      scoped_metric = metrics.first
+
+      Mmtrix::Agent::MethodTracer.trace_execution_scoped(metrics) do
+        t0 = Time.now
+        begin
+          rval = super
+        ensure
+          notice_sql(sql, scoped_metric, args, t0, Time.now)
+        end
+      end
+
+      return rval
+    end
+
+    THREAD_SAFE_CONNECTION_POOL_CLASSES = [
+      (defined?(::Sequel::ThreadedConnectionPool) && ::Sequel::ThreadedConnectionPool)
+    ].freeze
+
+    def notice_sql(sql, metric_name, args, start, finish)
+      state    = Mmtrix::Agent::TransactionState.tl_get
+      duration = finish - start
+
+      explainer = Proc.new do |*|
+        if THREAD_SAFE_CONNECTION_POOL_CLASSES.include?(self.pool.class)
+          self[ sql ].explain
+        else
+          Mmtrix::Agent.logger.log_once(:info, :sequel_explain_skipped, "Not running SQL explains because Sequel is not in recognized multi-threaded mode")
+          nil
+        end
+      end
+      Mmtrix::Agent.instance.transaction_sampler.notice_sql(sql, self.opts, duration, state, explainer)
+      Mmtrix::Agent.instance.sql_sampler.notice_sql(sql, metric_name, self.opts, duration, state, explainer)
+    end
+
+  end # module MmtrixInstrumentation
+
+  Mmtrix::Agent.logger.debug "Registering the :mmtrix_instrumentation extension."
+  Database.register_extension(:mmtrix_instrumentation, MmtrixInstrumentation)
+
+end # module Sequel

data/lib/sequel/plugins/mmtrix_instrumentation.rb

@@ -0,0 +1,65 @@
+# -*- ruby -*-
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require 'sequel' unless defined?( Sequel )
+require 'mmtrix_rpm' unless defined?( Mmtrix )
+require 'mmtrix/agent/instrumentation/sequel_helper'
+require 'mmtrix/agent/datastores/metric_helper'
+
+module Sequel
+  module Plugins
+
+    # Sequel::Model instrumentation for the Mmtrix agent.
+    module MmtrixInstrumentation
+
+      # Meta-programming for creating method tracers for the Sequel::Model plugin.
+      module MethodWrapping
+        # Install a method named +method_name+ that will trace execution
+        # with a metric name derived from +operation_name+ (or +method_name+ if +operation_name+
+        # isn't specified).
+        def wrap_sequel_method(method_name, operation_name=method_name)
+          define_method(method_name) do |*args, &block|
+            klass = self.is_a?(Class) ? self : self.class
+
+            product = Mmtrix::Agent::Instrumentation::SequelHelper.product_name_from_adapter(db.adapter_scheme)
+            metrics = ::Mmtrix::Agent::Datastores::MetricHelper.metrics_for(product, operation_name, klass.name)
+
+            Mmtrix::Agent::MethodTracer.trace_execution_scoped(metrics) do
+              Mmtrix::Agent.disable_all_tracing { super(*args, &block) }
+            end
+          end
+        end
+
+      end # module MethodTracer
+
+      # Methods to be added to Sequel::Model instances.
+      module InstanceMethods
+        extend Sequel::Plugins::MmtrixInstrumentation::MethodWrapping
+
+        wrap_sequel_method :delete
+        wrap_sequel_method :destroy
+        wrap_sequel_method :update
+        wrap_sequel_method :update_all
+        wrap_sequel_method :update_except
+        wrap_sequel_method :update_fields
+        wrap_sequel_method :update_only
+        wrap_sequel_method :save
+
+      end # module InstanceMethods
+
+
+      # Methods to be added to Sequel::Model classes.
+      module ClassMethods
+        extend Sequel::Plugins::MmtrixInstrumentation::MethodWrapping
+
+        wrap_sequel_method :[], "get"
+        wrap_sequel_method :all
+        wrap_sequel_method :first
+        wrap_sequel_method :create
+      end # module ClassMethods
+
+    end # module MmtrixInstrumentation
+  end # module Plugins
+end # module Sequel

data/lib/tasks/all.rb

@@ -0,0 +1,8 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+# This is required to load in task definitions from merb
+Dir.glob(File.join(File.dirname(__FILE__),'*.rake')) do |file|
+  load file
+end

data/lib/tasks/config.html.erb

@@ -0,0 +1,28 @@
+<% sections.each do |(section_key, section_name, section_description, configs)| %>
+<h2 id="<%=section_key%>"><%=section_name%></h2>
+
+<%= "<p>#{section_description}</p>" unless section_description.nil? %>
+
+<dl class="clamshell-list">
+  <% configs.each do |config|%>
+  <!-- ********** <%= config[:key] %> ********** -->
+  <dt id="<%=config[:key]%>"><%=config[:key]%></dt>
+  <dd>
+  <table class="specs">
+    <tbody>
+      <tr>
+        <th>Type</th>
+        <td><%=config[:type]%></td>
+      </tr>
+      <tr>
+        <th>Default</th>
+        <td><%=config[:default]%></td>
+      </tr>
+    </tbody>
+  </table>
+
+  <p><%=config[:description]%></p>
+  </dd>
+  <% end %>
+</dl>
+<% end %>

data/lib/tasks/config.rake

@@ -0,0 +1,134 @@
+namespace :mmtrix do
+  namespace :config do
+    desc "Describe available Mmtrix configuration settings."
+
+    GENERAL   = "general"
+    DISABLING = "disabling"
+
+    SECTION_DESCRIPTIONS = {
+      GENERAL              => 'These settings are available for agent configuration. Some settings depend on your Mmtrix subscription level.',
+      DISABLING            => 'Use these settings to toggle instrumentation types during agent startup.',
+      "transaction_tracer" => 'The <a href="/docs/apm/traces/transaction-traces/transaction-traces">transaction traces</a> feature collects detailed information from a selection of transactions, including a summary of the calling sequence, a breakdown of time spent, and a list of SQL queries and their query plans (on mysql and postgresql). Available features depend on your Mmtrix subscription level.',
+      "error_collector"    => 'The agent collects and reports all uncaught exceptions by default. These configuration options allow you to customize the error collection.',
+      "browser_monitoring" => 'Mmtrix Browser\'s <a href="/docs/browser/mmtrix-browser/page-load-timing/page-load-timing-process">page load timing</a> feature (sometimes referred to as real user monitoring or RUM) gives you insight into the performance real users are experiencing with your website. This is accomplished by measuring the time it takes for your users\' browsers to download and render your web pages by injecting a small amount of JavaScript code into the header and footer of each page.',
+      "analytics_events"   => '<a href="/docs/insights/mmtrix-insights/understanding-insights/mmtrix-insights">Mmtrix Insights</a> is a software analytics resource to gather and visualize data about your software and what it says about your business. With it you can quickly and easily create real-time dashboards to get immediate answers about end-user experiences, clickstreams, mobile activities, and server transactions.'
+    }
+
+    NAME_OVERRIDES = {
+      "slow_sql"     => "Slow SQL",
+      "xray_session" => "X-Ray Session"
+    }
+
+    def output(format)
+      config_hash = build_config_hash
+      sections = flatten_config_hash(config_hash)
+
+      puts build_erb(format).result(binding)
+    end
+
+    def build_config_hash
+      sections = Hash.new {|hash, key| hash[key] = []}
+      Mmtrix::Agent::Configuration::DEFAULTS.each do |key, value|
+        next unless value[:public]
+
+        section_key = GENERAL
+        section = key.to_s.match(/(.*)\.(.*)/)
+
+        if section
+          section_key = section[1]
+          key = section[2]
+        elsif key.to_s.match(/^disable_/)
+          section_key = DISABLING
+          key = key.to_s
+        end
+
+        sections[section_key] << {
+          :key         => format_key(section_key, key),
+          :type        => format_type(value[:type]),
+          :description => format_description(value),
+          :default     => format_default_value(value)
+        }
+      end
+      sections
+    end
+
+    def flatten_config_hash(config_hash)
+      sections = []
+      sections << pluck(GENERAL, config_hash)
+      sections << pluck("transaction_tracer", config_hash)
+      sections << pluck("error_collector",    config_hash)
+      sections << pluck("browser_monitoring", config_hash)
+      sections << pluck("analytics_events",   config_hash)
+      sections.concat(config_hash.to_a.sort_by { |a| a.first})
+
+      add_data_to_sections(sections)
+
+      sections
+    end
+
+    def add_data_to_sections(sections)
+      sections.each do |section|
+        section_key = section[0]
+        section.insert(1, format_name(section_key))
+        section.insert(2, SECTION_DESCRIPTIONS[section_key])
+      end
+    end
+
+    def format_key(section_key, key)
+      if section_key == GENERAL || section_key == DISABLING
+        key.to_s
+      else
+        "#{section_key}.#{key}"
+      end
+    end
+
+    def format_name(key)
+      name = NAME_OVERRIDES[key]
+      return name if name
+
+      key.split("_").
+          each { |fragment| fragment[0] = fragment[0].upcase }.
+          join(" ")
+    end
+
+    def format_type(type)
+      if type == Mmtrix::Agent::Configuration::Boolean
+        "Boolean"
+      else
+        type
+      end
+    end
+
+    def format_description(value)
+      description = value[:description]
+      description = "<b>DEPRECATED</b> #{description}" if value[:deprecated]
+      description
+    end
+
+    def format_default_value(spec)
+      if spec[:default].is_a?(Proc)
+        '(Dynamic)'
+      else
+        spec[:default].inspect
+      end
+    end
+
+    def pluck(key, config_hash)
+      value = config_hash.delete(key)
+      [key, value]
+    end
+
+    def build_erb(format)
+      require 'erb'
+      path = File.join(File.dirname(__FILE__), "config.#{format}.erb")
+      template = File.read(File.expand_path(path))
+      ERB.new(template)
+    end
+
+    task :docs, [:format] => [] do |t, args|
+      require File.expand_path(File.join(File.dirname(__FILE__), "..", "mmtrix", "agent", "configuration", "default_source.rb"))
+      format = args[:format] || "text"
+      output(format)
+    end
+  end
+end

data/lib/tasks/config.text.erb

@@ -0,0 +1,7 @@
+<% sections.each do |(section_key, section_name, section_description, configs)| %><% configs.each do |config|%>
+<%=config[:key]%>
+<%=config[:description]%>
+
+Type:    <%=config[:type]%>
+Default: <%=config[:default]%>
+------------------------------<% end %><% end %>

data/lib/tasks/install.rake

@@ -0,0 +1,11 @@
+namespace :mmtrix do
+  desc "Install a default config/mmtrix.yml file"
+  task :install do
+    load File.expand_path(File.join(File.dirname(__FILE__), "..", "..", "install.rb"))
+  end
+
+  desc "Gratefulness is always appreciated"
+  task :thanks do
+    puts "The Ruby agent team is grateful to Jim Weirich for his kindness and his code. He will be missed."
+  end
+end

data/lib/tasks/multiverse.rake

@@ -0,0 +1,2 @@
+# Guts of task are in a .rb file to allow requiring from external gems
+require "#{File.join(File.dirname(__FILE__))}/multiverse"

data/lib/tasks/multiverse.rb

@@ -0,0 +1,50 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+#
+# Rake task for running Ruby agent multiverse tests. This file may be required
+# from third party gems. It is also used by the agent itself to run multiverse.
+#
+# Multiverse tests are grouped in (potentially multiverse) "suite" directories.
+# These suites are found by default under ./test/multiverse. That location can
+# be overridden with ENV['SUITES_DIRECTORY'].
+#
+# The first parameter to this task is a suite directory name to run.  If
+# excluded, multiverse will run all suites it finds.
+#
+# Additional parameters are allowed to multiverse. Many parameters can be
+# combined.
+#
+# Some examples:
+#
+#   # Runs ./test/multiverse/*
+#   bundle exec rake test:multiverse
+#
+#   # Runs ./test/multiverse/my_gem
+#   bundle exec rake test:multiverse[my_gem]
+#
+#   # With verbose logging and debugging via pry
+#   bundle exec rake test:multiverse[my_gem,verbose,debug]
+#
+#   # Runs only first set of gems defined in my_gem's Envfile
+#   bundle exec rake test:multiverse[my_gem,env=0]
+#
+#   # Runs tests matching the passed name (via Minitest's built-in filtering)
+#   bundle exec rake test:multiverse[my_gem,name=MyGemTest]
+#
+#   # Runs with a specific test seed
+#   bundle exec rake test:multiverse[my_gem,seed=1337]
+
+namespace :test do
+  desc "Run functional test suite for Mmtrix"
+  task :multiverse, [:suite, :param1, :param2, :param3, :param4] => [] do |t, args|
+    # Assumed that we're starting from the root of the gem unless already set
+    ENV['SUITES_DIRECTORY'] ||= File.expand_path(File.join("test", "multiverse"))
+
+    agent_root = File.expand_path(File.join(__FILE__, "..", "..", ".."))
+    require File.expand_path(File.join(agent_root, 'test', 'multiverse', 'lib', 'multiverse', 'environment'))
+
+    opts = Multiverse::Runner.parse_args(args)
+    Multiverse::Runner.run(args.suite, opts)
+  end
+end