basic_assumption 0.2.1

data/README.md

@@ -0,0 +1,5 @@
+BasicAssumption
+===============
+
+A clone of DecentExposure, with less shared-state in its specs.
+

data/VERSION

@@ -0,0 +1 @@
+0.1

data/lib/basic_assumption.rb

@@ -0,0 +1,25 @@
+module BasicAssumption
+  def self.extended(base)
+    base.default_assumption {}
+  end
+
+  def default_assumption(&block)
+    define_method(:default_assumption) do
+      block
+    end
+  end
+
+  def assume(name, &block)
+    define_method(name) do
+      @basic_assumptions       ||= {}
+      @basic_assumptions[name] ||= if block_given?
+        instance_eval(&block)
+      else
+        instance_exec(name, &default_assumption)
+      end
+    end
+    after_assumption(name)
+  end
+
+  def after_assumption(name); end
+end

data/rails/init.rb

@@ -0,0 +1,14 @@
+begin
+  require File.join(File.dirname(__FILE__), 'lib', 'basic_assumption')
+rescue LoadError
+  require 'basic_assumption'
+end
+
+ActionController::Base.class_eval do
+  extend BasicAssumption
+
+  def self.after_assumption(name)
+    hide_action name
+    helper_method name
+  end
+end

data/spec/lib/basic_assumption_spec.rb

@@ -0,0 +1,140 @@
+require 'spec_helper'
+require 'action_controller'
+
+class Extender
+  def quack
+    {:foo => :bar}
+  end
+end
+
+describe BasicAssumption do
+
+  context "when a class extends BasicAssumption" do
+
+    let(:extender_class) { Class.new(Extender) }
+    let(:extender_instance) { extender_class.new }
+    before(:each) do
+      extender_class.extend(BasicAssumption)
+    end
+
+    it "declares named resources via #assume" do
+      expect {
+        extender_class.class_eval do
+          assume :resource_name
+        end
+      }.to_not raise_error(NoMethodError)
+    end
+
+    it "declares an instance method of the given name" do
+      extender_class.class_eval do
+        assume :my_method_name
+      end
+      extender_instance.should respond_to(:my_method_name)
+    end
+
+    context "the instance method" do
+      context "when no block was passed to assume" do
+        it "returns nil by default" do
+          extender_class.class_eval do
+            assume :by_default
+          end
+          extender_instance.by_default.should be_nil
+        end
+
+        context "when the default is overridden" do
+          it "returns the result of the overriding block" do
+            extender_class.class_eval do
+              default_assumption { 'overridden' }
+              assume :overriden
+            end
+            extender_instance.overriden.should eql('overridden')
+          end
+
+          it "executes the default in the context of the extending instance" do
+            extender_class.class_eval do
+              default_assumption { quack }
+              assume(:access_instance)
+            end
+            extender_instance.access_instance.should eql({:foo => :bar})
+          end
+
+          it "passes the name into the default block" do
+            extender_class.class_eval do
+              default_assumption { |name| name }
+              assume(:given_name)
+            end
+            extender_instance.given_name.should eql(:given_name)
+          end
+        end
+      end
+
+      context "when a block was passed" do
+        it "invokes the block as the method implementation" do
+          extender_class.class_eval do
+            assume(:resource) { 'this is my resource' }
+          end
+          extender_instance.resource.should eql('this is my resource')
+        end
+
+        it "executes in the context of the extending instance" do
+          extender_class.class_eval do
+            assume(:access_instance) { quack }
+          end
+          extender_instance.access_instance.should eql({:foo => :bar})
+        end
+      end
+
+      it "memoizes the result for further calls" do
+        extender_class.class_eval do
+          assume(:random_once) { "#{rand(1_000_000)} #{rand(1_000_000)}" }
+        end
+        extender_instance.random_once.should eql(extender_instance.random_once)
+      end
+    end
+  end
+
+  context "within Rails" do
+    before(:all) do
+      require 'rails/init.rb'
+    end
+    let(:controller_class) { Class.new(::ActionController::Base) }
+    let(:controller_instance) { controller_class.new }
+
+    it "is extended by ActionController::Base" do
+      ::ActionController::Base.should respond_to(:assume)
+    end
+
+    context "the instance method created by #assume" do
+      it "is hidden from being an action" do
+        controller_class.should_receive(:hide_action).with(:resource_name)
+        controller_class.class_eval do
+          assume(:resource_name)
+        end
+      end
+
+      it "is visible in views" do
+        controller_class.should_receive(:helper_method).with(:resource_name)
+        controller_class.class_eval do
+          assume(:resource_name)
+        end
+      end
+    end
+
+    context "classes derived from ActionController::Base" do
+      before do
+        ::ActionController::Base.class_eval do
+          default_assumption { |name| "#{name}#{name}" }
+        end
+      end
+      let(:derived_class) { Class.new(controller_class) }
+      let(:derived_instance) { derived_class.new }
+
+      it "inherit the default assumption" do
+        derived_class.class_eval do
+          assume(:twice)
+        end
+        derived_instance.twice.should eql('twicetwice')
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'basic_assumption'

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification 
+name: basic_assumption
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 1
+  version: 0.2.1
+platform: ruby
+authors: 
+- Matt Yoho
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-04-17 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  version_requirements: *id001
+description: "\n    Allows a simple declarative idiom for accessing resources in controllers and views\n    "
+email: mby@mattyoho.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- README.md
+- VERSION
+- lib/basic_assumption.rb
+- rails/init.rb
+has_rdoc: true
+homepage: http://github.com/mattyoho/basic_assumption
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Allows a simple declarative idiom for resources in controllers and views
+test_files: 
+- spec/spec_helper.rb
+- spec/lib/basic_assumption_spec.rb