resubject 0.1.1 → 0.2.0

data/.travis.yml

@@ -1,3 +1,7 @@
 language: ruby
 rvm:
-  - "1.9.3"
+  - 1.9.3
+  - 2.0.0
+env:
+  - rails=3.2
+  - rails=4.0

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+# 0.2.0
+
+- enhancements
+  - Introduce RSpec helpers
+
 # 0.1.1
 
 - bugfixes

data/Gemfile

@@ -1,6 +1,17 @@
-source 'https://rubygems.org'
+ENV['rails'] ||= '3.2'
+
+source :rubygems
+
+rails_version = ENV['rails']
+
+case rails_version
+when '3.2'
+  gem 'actionpack', "~> #{rails_version}"
+when '4.0'
+  # Waiting for beta release of actionpack
+  gem 'rails', github: 'rails/rails'
+end
 
-gem 'actionpack', '~> 3.2'
 gem 'redcarpet'
 
 # Specify your gem's dependencies in resubject.gemspec

data/README.md

@@ -10,13 +10,17 @@ Uber simple presenters using Ruby's SimpleDelegator.
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'resubject', '~> 0.1.1'
+gem 'resubject', '~> 0.2.0'
 ```
 
 And then execute:
 
     $ bundle
 
+## Ruby/Rails versions
+
+This gem is compatible with Ruby 1.9 and 2.0 and Rails 3 and 4.
+
 ## Documentation
 
 Checkout the documentation in [rdoc.info/resubject](http://rdoc.info/github/felipeelias/resubject/master/frames)
@@ -194,7 +198,45 @@ time_ago            time_ago_in_words           ActionView::Helpers::DateHelper
 date_format         to_s                        ActiveSupport::TimeWithZone
 ```
 
-More helpers will be added. Feel free to contribute with yours! Also, Check out [the extensions file](https://github.com/felipeelias/resubject/blob/master/lib/resubject/rails/extensions.rb).
+More helpers will be added. Feel free to contribute with yours! Also, Check out [the extensions file](https://github.com/felipeelias/resubject/blob/master/lib/resubject/extensions/template_methods.rb).
+
+### Helpers without rails
+
+If you'd like to use the generated helpers but you're not using Rails, you can either use `ActionView` or create your own template handler:
+
+```
+require 'action_view'
+
+post = PostPresenter.new(post, ActionView::Base.new)
+# Or
+post = PostPresenter.new(post, MyTemplateHandler.new)
+```
+
+If you want to use your own template handler and still use Resubject helpers, you may want to define the same `ActionView` helpers in your handler (or only the ones you will actually use).
+
+## Testing
+
+Resubject introduce a new context for RSpec that helps testing your presenters:
+
+```ruby
+# spec/presenters/my_presenter_spec.rb
+# require 'action_view' # require this first if you want to test action view helpers
+require 'resubject/rspec'
+require 'presenters/my_presenter'
+
+describe UserPresenter do
+  let(:object) { mock :user }
+
+  it 'has full name' do
+    object.stub(first: 'User', last: 'Name')
+    expect(subject.name).to eq 'User Name'
+  end
+end
+```
+
+By placing the file into `spec/presenters`, Resubject automatically includes the `subject` and `template` variables into your spec, so you don't need to define them on every spec.
+
+**NOTE:** Please note that the presenter is tested on isolation. It's not required but very recommended.
 
 ## Maintainers
 

data/lib/resubject.rb

@@ -1,5 +1,6 @@
 require 'resubject/version'
 require 'resubject/naming'
+require 'resubject/extensions'
 require 'resubject/presenter'
 require 'resubject/builder'
 require 'resubject/rails' if defined? Rails

data/lib/resubject/extensions.rb

@@ -0,0 +1 @@
+require 'resubject/extensions/template_methods'

data/lib/resubject/{rails/extensions.rb → extensions/template_methods.rb}

@@ -1,7 +1,9 @@
+require 'active_support/time'
+
 module Resubject
-  module Rails
+  module Extensions
     # All Rails extensions
-    module Extensions
+    module TemplateMethods
       # Generates an attribute using `number_to_currency` helper from rails
       #
       # @example

data/lib/resubject/presenter.rb

@@ -2,6 +2,8 @@ require 'delegate'
 
 module Resubject
   class Presenter < SimpleDelegator
+    extend Resubject::Extensions::TemplateMethods
+
     # the HTML helpers context
     attr_reader  :context
     alias_method :template, :context
@@ -81,5 +83,25 @@ module Resubject
         present to_model.send(attribute), *presenters
       end
     end
+
+  private
+
+    def translate(*args, &block)
+      context.t(*args, &block)
+    end
+
+    alias_method :t, :translate
+
+    def localize(*args, &block)
+      context.l(*args, &block)
+    end
+
+    alias_method :l, :localize
+
+    def helpers
+      context
+    end
+
+    alias_method :h, :helpers
   end
 end

data/lib/resubject/rails.rb

@@ -1,34 +1,13 @@
 require 'resubject/rails/engine'
-require 'resubject/rails/extensions'
 
 module Resubject
   class Presenter
-    extend Resubject::Rails::Extensions
-
     private
 
-    def translate(*args, &block)
-      context.t(*args, &block)
-    end
-
-    alias_method :t, :translate
-
-    def localize(*args, &block)
-      context.l(*args, &block)
-    end
-
-    alias_method :l, :localize
-
     def routes
       ::Rails.application.routes.url_helpers
     end
 
     alias_method :r, :routes
-
-    def helpers
-      context
-    end
-
-    alias_method :h, :helpers
   end
 end

data/lib/resubject/rspec.rb

@@ -0,0 +1,52 @@
+require 'resubject'
+
+module Resubject
+  # RSpec configuration and helpers
+  #
+  # This helper automatically creates `subject` and `template`
+  # variables for RSpec when testing your presenter.
+  #
+  # To get this working, create a spec file in `spec/presenters`
+  # and require `resubject/rspec`. You only need to define the
+  # object under test by creating a `let(:object)`, like so:
+  #
+  # @example Isolated spec for MyPresenter
+  #
+  #   # spec/presenters/my_presenter_spec.rb
+  #   require 'resubject/rspec'
+  #   require 'presenters/my_presenter'
+  #
+  #   describe MyPresenter do
+  #     let(:object) { mock :presented }
+  #
+  #     it 'has full name' do
+  #       object.stub(first: 'My', last: 'Name')
+  #       expect(subject.name).to eq 'My Name'
+  #     end
+  #   end
+  #
+  module Rspec
+    # Extend RSpec configuration for files placed in `spec/presenters`
+    def self.included(base)
+      base.instance_eval do
+        let(:template) do
+          if defined? ActionView
+            ActionView::Base.new
+          else
+            mock :template
+          end
+        end
+
+        subject do
+          described_class.new(object, template)
+        end
+      end
+    end
+  end
+end
+
+::RSpec.configure do |c|
+  c.include Resubject::Rspec,
+            type: :presenter,
+            example_group: { file_path: %r(spec/presenters) }
+end

data/lib/resubject/version.rb

@@ -1,3 +1,3 @@
 module Resubject
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/resubject.gemspec

@@ -18,7 +18,7 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
 
-  gem.add_dependency 'activesupport', '~> 3.2'
+  gem.add_dependency 'activesupport', '>= 3.2'
 
   gem.add_development_dependency "rake"
   gem.add_development_dependency "rspec", "~> 2.12.0"

data/spec/resubject/{rails/extensions_spec.rb → extensions/template_methods_spec.rb}

@@ -1,14 +1,11 @@
 require 'spec_helper'
 require 'action_view'
-require 'resubject/rails/extensions'
 
-describe Resubject::Presenter, 'extensions' do
+describe Resubject::Presenter, 'template methods' do
   let(:model) { mock :model }
 
   let(:presenter) do
     Class.new(Resubject::Presenter) do
-      extend Resubject::Rails::Extensions
-
       currency :price
       time_ago :posted_at
       percentage :rating, precision: 0

metadata

@@ -1,8 +1,8 @@
 --- !ruby/object:Gem::Specification
 name: resubject
 version: !ruby/object:Gem::Version
-  version: 0.1.1
   prerelease: 
+  version: 0.2.0
 platform: ruby
 authors:
 - Felipe Elias Philipp
@@ -10,72 +10,72 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-16 00:00:00.000000000 Z
+date: 2013-01-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
-  prerelease: false
-  requirement: !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '3.2'
+  requirement: !ruby/object:Gem::Requirement
     none: false
-  type: :runtime
-  version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '3.2'
-    none: false
+  prerelease: false
+  type: :runtime
 - !ruby/object:Gem::Dependency
   name: rake
-  prerelease: false
-  requirement: !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+  requirement: !ruby/object:Gem::Requirement
     none: false
-  type: :development
-  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
+  prerelease: false
+  type: :development
 - !ruby/object:Gem::Dependency
   name: rspec
-  prerelease: false
-  requirement: !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 2.12.0
+  requirement: !ruby/object:Gem::Requirement
     none: false
-  type: :development
-  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 2.12.0
-    none: false
+  prerelease: false
+  type: :development
 - !ruby/object:Gem::Dependency
   name: yard
-  prerelease: false
-  requirement: !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.8.3
+  requirement: !ruby/object:Gem::Requirement
     none: false
-  type: :development
-  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.8.3
-    none: false
+  prerelease: false
+  type: :development
 description: Uber simple presenters
 email:
 - felipe@applicake.com
@@ -96,18 +96,20 @@ files:
 - Rakefile
 - lib/resubject.rb
 - lib/resubject/builder.rb
+- lib/resubject/extensions.rb
+- lib/resubject/extensions/template_methods.rb
 - lib/resubject/naming.rb
 - lib/resubject/presenter.rb
 - lib/resubject/rails.rb
 - lib/resubject/rails/engine.rb
-- lib/resubject/rails/extensions.rb
 - lib/resubject/rails/helpers.rb
+- lib/resubject/rspec.rb
 - lib/resubject/version.rb
 - resubject.gemspec
 - spec/resubject/builder_spec.rb
+- spec/resubject/extensions/template_methods_spec.rb
 - spec/resubject/naming_spec.rb
 - spec/resubject/presenter_spec.rb
-- spec/resubject/rails/extensions_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/felipeelias/resubject
 licenses:
@@ -117,17 +119,23 @@ rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-  none: false
+      hash: -249672256597893339
+      segments:
+      - 0
 required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-  none: false
+      hash: -249672256597893339
+      segments:
+      - 0
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24
@@ -136,8 +144,8 @@ specification_version: 3
 summary: Uber simple presenters using Ruby's SimpleDelegator
 test_files:
 - spec/resubject/builder_spec.rb
+- spec/resubject/extensions/template_methods_spec.rb
 - spec/resubject/naming_spec.rb
 - spec/resubject/presenter_spec.rb
-- spec/resubject/rails/extensions_spec.rb
 - spec/spec_helper.rb
 has_rdoc: