purobu 0.0.1 → 0.0.2

data/README.md

@@ -105,19 +105,46 @@ heroku_api.get_config_vars('some-app').body
   # {"HEROKU_POSTGRESQL_PURPLE_URL"=>"postgres://user:pass@host:5732/database"}
 heroku_api.get_addons('some-app').body
   # [{"slug"=>"crane", "selective"=>false,
-      "configured"=>true,
-      "url"=>nil,
-      "state"=>"public",
-      "group_description"=>"Heroku Postgresql",
-      "consumes_dyno_hours"=>false,
-      "price"=>{"cents"=>0, "unit"=>"month"},
-      "attachment_name"=>"HEROKU_POSTGRESQL_TEAL",
-      "plan_description"=>"Crane",
-      "name"=>"heroku-postgresql:crane",
-      "beta"=>false,
-      "attachable"=>false,
-      "description"=>"Heroku Postgres Crane",
-      "terms_of_service"=>false}]
+  #   "configured"=>true,
+  #   "url"=>nil,
+  #   "state"=>"public",
+  #   "group_description"=>"Heroku Postgresql",
+  #   "consumes_dyno_hours"=>false,
+  #   "price"=>{"cents"=>0, "unit"=>"month"},
+  #   "attachment_name"=>"HEROKU_POSTGRESQL_TEAL",
+  #   "plan_description"=>"Crane",
+  #   "name"=>"heroku-postgresql:crane",
+  #   "beta"=>false,
+  #   "attachable"=>false,
+  #   "description"=>"Heroku Postgres Crane",
+  #   "terms_of_service"=>false}]
+```
+
+## Adding helpers
+
+You can add helpers to be used across your tests via `helpers`:
+
+```ruby
+helpers do
+  def do_it
+    # it does it
+  end
+end
+
+test do
+  verify do
+     do_it # it does it
+  end
+end
+```
+
+A `database_connection` helper is included which can be used in your tests:
+
+```ruby
+url = 'postgres://user:pass@host/database'
+database_connection(url) do |conn|
+  conn # a Sequel connection object
+end
 ```
 
 ## Meta

data/lib/purobu/database_connection.rb

@@ -0,0 +1,40 @@
+require 'sequel'
+
+module Purobu
+  class DatabaseConnection
+
+    attr_reader :url
+
+    def initialize(url)
+      @url = url
+    end
+
+    def connect
+      attempts = 0
+      begin
+        connection = Sequel.connect(url)
+      rescue => e
+        Purobu.log(connection_failure: "Connection attempt to '#{@url}' failed.")
+      end
+
+      if block_given?
+        begin
+          yield connection
+        ensure
+          connection.disconnect
+        end
+      else
+        return connection
+      end
+    end
+
+    module Helper
+      def database_connection(url, &block)
+        Purobu::DatabaseConnection.new(url).connect(&block)
+      end
+    end
+  end
+
+
+  Purobu::Helpers.register(Purobu::DatabaseConnection::Helper)
+end

data/lib/purobu/dsl.rb

@@ -1,6 +1,7 @@
 module Purobu
   class DSL
     attr_reader :runner, :files
+
     def initialize(opts = {})
       @runner = Runner.new
       @files  = opts[:files] || Dir['**/test_*.rb']

data/lib/purobu/helpers.rb

@@ -0,0 +1,23 @@
+module Purobu
+  module Helpers
+    CLASSES = [Purobu::Test, Purobu::Runner, Purobu::DSL].freeze
+
+    def self.register(helpers)
+      CLASSES.each do |klass|
+        klass.class_eval do
+          include helpers
+        end
+      end
+    end
+
+    module HelpersHelper
+      def helpers(&block)
+        ::Purobu::Helpers.register(Module.new(&block))
+      end
+      alias :helper :helpers
+    end
+    self.register(HelpersHelper)
+
+  end
+end
+

data/lib/purobu/heroku_helpers.rb

@@ -1,4 +1,5 @@
 require 'heroku-api'
+
 module Purobu
   module HerokuHelpers
     def heroku(*args)
@@ -10,3 +11,5 @@ module Purobu
     end
   end
 end
+
+Purobu::Helpers.register(Purobu::HerokuHelpers)

data/lib/purobu/runner.rb

@@ -1,8 +1,6 @@
 require 'thread'
 module Purobu
   class Runner
-    include HerokuHelpers
-
     attr_reader :tests, :thread_count
 
     def initialize

data/lib/purobu/test.rb

@@ -1,8 +1,6 @@
 require 'heroku'
 module Purobu
   class Test
-    include HerokuHelpers
-
     attr_reader :setups, :teardowns, :name
     attr_writer :exercise, :verification
 

data/lib/purobu/version.rb

@@ -1,3 +1,3 @@
 module Purobu
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/lib/purobu.rb

@@ -1,9 +1,11 @@
 require "purobu/version"
 require "purobu/log"
 require "purobu/configuration"
-require "purobu/heroku_helpers"
 require "purobu/test"
 require "purobu/runner"
 require "purobu/dsl"
+require "purobu/helpers"
+require "purobu/database_connection"
+require "purobu/heroku_helpers"
 require "purobu/heroku"
 require "purobu/reporter"

data/purobu.gemspec

@@ -4,7 +4,7 @@ require File.expand_path('../lib/purobu/version', __FILE__)
 Gem::Specification.new do |gem|
   gem.authors       = ["Harold Giménez"]
   gem.email         = ["harold.gimenez@gmail.com"]
-  gem.description   = %q{ Probe your production or staging environment for behavior correctness }
+  gem.description   = %q{ Black-box integration test framework for components on the Heroku platform. }
   gem.summary       = %q{ Black-box integration test framework for components on the Heroku platform. }
   gem.homepage      = "http://practiceovertheory.com"
 
@@ -18,6 +18,7 @@ Gem::Specification.new do |gem|
   gem.add_dependency "heroku", "2.28.2"
   gem.add_dependency "heroku-api"
   gem.add_dependency "scrolls", "0.2.1"
+  gem.add_dependency "sequel"
   gem.add_development_dependency "rspec"
   gem.add_development_dependency "fakefs"
 end

data/spec/purobu/database_connection_spec.rb

@@ -0,0 +1,34 @@
+require 'purobu'
+
+describe Purobu::DatabaseConnection, '#connect' do
+
+  let(:url) { 'postgres:///foo' }
+
+  it 'yields a connection to the given url' do
+    conn = double(:connection, close: nil)
+    conn.should_receive(:disconnect).once
+    Sequel.should_receive(:connect).with(url).and_return(conn)
+
+    expect { |block|
+      Purobu::DatabaseConnection.new(url).connect &block
+    }.to yield_with_args(conn)
+  end
+
+  it 'gives the connection object when no block is given 'do
+    conn = double(:connection, close: nil)
+    conn.should_not_receive(:disconnect)
+    Sequel.should_receive(:connect).with(url).and_return(conn)
+
+    Purobu::DatabaseConnection.new(url).connect.should == conn
+  end
+
+  it 'exposes a database_connection helper' do
+    conn = double(:conn)
+    conn.should_receive(:connect).once
+    Purobu::DatabaseConnection.stub(:new).with(url).and_return(conn)
+
+    test = Purobu::Test.new
+    test.database_connection(url)
+  end
+
+end

data/spec/purobu/helpers_spec.rb

@@ -0,0 +1,27 @@
+require 'purobu'
+
+module TestHelpers
+  def test_helper
+    throw :test_helper
+  end
+end
+
+describe Purobu::Helpers, '.register' do
+  it 'makes helpers available to tests and the runner' do
+    Purobu::Helpers.register(TestHelpers)
+
+    test = Purobu::Test.new
+    expect { test.test_helper }.to throw_symbol :test_helper
+  end
+
+  it 'exposes a helper helper' do
+    test = Purobu::Test.new
+    test.helper do
+      def test_helper
+        throw :test_helper
+      end
+    end
+
+    expect { test.test_helper }.to throw_symbol :test_helper
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: purobu
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ date: 2012-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: heroku
-  requirement: &70132005273080 !ruby/object:Gem::Requirement
+  requirement: &70336029135080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - =
@@ -21,10 +21,10 @@ dependencies:
         version: 2.28.2
   type: :runtime
   prerelease: false
-  version_requirements: *70132005273080
+  version_requirements: *70336029135080
 - !ruby/object:Gem::Dependency
   name: heroku-api
-  requirement: &70132005172240 !ruby/object:Gem::Requirement
+  requirement: &70336029134040 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70132005172240
+  version_requirements: *70336029134040
 - !ruby/object:Gem::Dependency
   name: scrolls
-  requirement: &70132005159400 !ruby/object:Gem::Requirement
+  requirement: &70336029021320 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - =
@@ -43,10 +43,21 @@ dependencies:
         version: 0.2.1
   type: :runtime
   prerelease: false
-  version_requirements: *70132005159400
+  version_requirements: *70336029021320
+- !ruby/object:Gem::Dependency
+  name: sequel
+  requirement: &70336029004160 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70336029004160
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70132005150920 !ruby/object:Gem::Requirement
+  requirement: &70336028995820 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +65,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70132005150920
+  version_requirements: *70336028995820
 - !ruby/object:Gem::Dependency
   name: fakefs
-  requirement: &70132005148440 !ruby/object:Gem::Requirement
+  requirement: &70336028987520 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,8 +76,9 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70132005148440
-description: ! ' Probe your production or staging environment for behavior correctness '
+  version_requirements: *70336028987520
+description: ! ' Black-box integration test framework for components on the Heroku
+  platform. '
 email:
 - harold.gimenez@gmail.com
 executables:
@@ -82,7 +94,9 @@ files:
 - bin/purobu
 - lib/purobu.rb
 - lib/purobu/configuration.rb
+- lib/purobu/database_connection.rb
 - lib/purobu/dsl.rb
+- lib/purobu/helpers.rb
 - lib/purobu/heroku.rb
 - lib/purobu/heroku_helpers.rb
 - lib/purobu/log.rb
@@ -91,7 +105,9 @@ files:
 - lib/purobu/test.rb
 - lib/purobu/version.rb
 - purobu.gemspec
+- spec/purobu/database_connection_spec.rb
 - spec/purobu/dsl_spec.rb
+- spec/purobu/helpers_spec.rb
 - spec/purobu/reporter_spec.rb
 - spec/purobu/runner_spec.rb
 - spec/purobu/test_spec.rb
@@ -120,7 +136,9 @@ signing_key:
 specification_version: 3
 summary: Black-box integration test framework for components on the Heroku platform.
 test_files:
+- spec/purobu/database_connection_spec.rb
 - spec/purobu/dsl_spec.rb
+- spec/purobu/helpers_spec.rb
 - spec/purobu/reporter_spec.rb
 - spec/purobu/runner_spec.rb
 - spec/purobu/test_spec.rb