formal_wear 0.1.0 → 0.3.0

data/.coveralls.yml

@@ -1 +1 @@
-service_name: travis-pro
+service_name: travis-ci

data/.rspec

@@ -1,2 +1,2 @@
 --color
---format documentation
+--format progress

data/README.md

@@ -1,6 +1,6 @@
 # FormalWear
 
-[![Build Status](https://travis-ci.org/wideopenspaces/formal_wear.png)](https://travis-ci.org/wideopenspaces/formal_wear.png) [![Code Climate](https://codeclimate.com/github/wideopenspaces/formal_wear.png)](https://codeclimate.com/github/wideopenspaces/formal_wear) [![Coverage Status](https://coveralls.io/repos/wideopenspaces/formal_wear/badge.png)](https://coveralls.io/r/wideopenspaces/formal_wear)
+[![Build Status](https://travis-ci.org/wideopenspaces/formal_wear.png)](https://travis-ci.org/wideopenspaces/formal_wear.png) [![Code Climate](https://codeclimate.com/github/wideopenspaces/formal_wear.png)](https://codeclimate.com/github/wideopenspaces/formal_wear) [![Coverage Status](https://coveralls.io/repos/wideopenspaces/formal_wear/badge.png)](https://coveralls.io/r/wideopenspaces/formal_wear) [![Dependency Status](https://gemnasium.com/wideopenspaces/formal_wear.png)](https://gemnasium.com/wideopenspaces/formal_wear)
 
 "You're going to like the way you look. I guarantee it."
 
@@ -22,7 +22,90 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+```ruby
+class TestFormalWear
+  include FormalWear
+
+  required_attr moms_id: {
+    name: "Your mom's id",
+    type: :text,
+    source: ->(s) { s.primary.thing_to_be_configured },
+  }
+
+  required_attr docs_id: {
+    name: "Your doc's id",
+    type: :text,
+    source: ->(s) { s.primary.dependent_object.another_thing_to_be_configured },
+    store: :set_my_docs_id
+  }
+
+  required_attr lambda_lambda_lambda: {
+    name: 'Revenge Of The Nerds!',
+    type: :text,
+    source: ->(s) { s.get_pledged },
+    store:  ->(s) { s.got_lambda? }
+  }
+
+  protected
+
+  def after_save
+    # no-op
+  end
+
+  def set_moms_id
+    # no-op
+  end
+
+  def set_my_docs_id
+    # no-op
+  end
+
+  def got_lambda?
+    # no-op
+  end
+
+  def get_pledged
+    primary.dependent_object.another_thing_to_be_configured
+  end
+end
+```
+
+Including FormalWear into your class adds a `required_attrs` and `required_attr` methods.
+Specifying a required attr, like so:
+
+```ruby
+  required_attr lambda_lambda_lambda: {
+    name: 'Revenge Of The Nerds!',
+    type: :text,
+    source: ->(s) { s.get_pledged },
+    store:  ->(s) { s.got_lambda? }
+  }
+```
+
+adds the attribute to the list of required_fields, and populates it from the source specified
+in its hash when your class is initialized.
+
+### Instantiating
+
+```ruby
+  TestFormalWear.new(primary_object)
+```
+
+... where primary object you will use to fetch values from their source. (TODO: add support for multiple sources)
+
+### Specifying sources
+
+The source option takes a lambda that accepts `self` as its argument. This allows you to use a
+method within your class to fetch the information needed from its source, or to directly fetch it
+using the `primary` object set when you instantiated the class.
+
+Source is a required attribute, but it can return nil if you feel so inclined. It's a bit like going commando
+under that tuxedo, though.
+
+## TODO
+
+* Update this readme
+* (Maybe?) Add helper methods for providing data for working with forms
 
 ## Contributing
 

data/lib/formal_wear/class_methods.rb

@@ -1,15 +1,5 @@
 module FormalWear
   module ClassMethods
-    def required_attrs(attrs)
-      validate_attrs!(attrs)
-
-      required = class_variable_get(:@@required_fields) || {}
-      class_variable_set(:@@required_fields, required.merge(attrs))
-
-      create_accessors(attrs.keys)
-    end
-    def required_attr(a); required_attrs(a); end
-
     def create_accessors(keys)
       keys.each { |k| self.send(:attr_accessor, k) unless method_defined?(k) }
     end
@@ -17,8 +7,12 @@ module FormalWear
     def validate_attrs!(attrs)
       attrs.each do |a, opts|
         opts.assert_valid_keys(*ALLOWED_KEYS)
-        opts.assert_required_keys(*REQUIRED_KEYS)
+        opts.assert_required_keys(*required_keys(opts))
       end
     end
+
+    def required_keys(opts)
+      opts[:type] == :select ? REQUIRED_KEYS + [:select_options] : REQUIRED_KEYS
+    end
   end
 end

data/lib/formal_wear/instance_methods.rb

@@ -3,22 +3,36 @@ module FormalWear
     ### THE NITTY GRITTY STARTS HERE
 
     # Start the configuration process
-    def initialize(primary)
-      @primary = primary
+    def initialize(options = {})
+      set_sources(options)
       update_sources
     end
 
     def required_attributes
-      required_fields.dup.each do |field, options|
-        options.slice!(:name, :type)
+      sanitize_and_fill_attributes(required_fields)
+    end
+
+    def optional_attributes
+      sanitize_and_fill_attributes(optional_fields)
+    end
+
+    def attributes
+      {}.tap do |h|
+        h.merge!(required_attributes: required_attributes) if required_attributes
+        h.merge!(optional_attributes: optional_attributes) if optional_attributes
       end
     end
+    alias_method :to_h, :attributes
 
     # Return the list of required fields for this configurator
     def required_fields
       @@required_fields
     end
 
+    def optional_fields
+      @@optional_fields
+    end
+
     def required_fields_without_custom_stores
       required_fields.reject { |f,o| custom_store?(o) }
     end
@@ -27,16 +41,10 @@ module FormalWear
       required_fields.select { |f,o| custom_store?(o) }
     end
 
-    def to_h
-      {}.merge(required_attributes: required_attributes).tap do |h|
-        required_fields.keys.each { |k| h[k] = self.send(k) }
-      end
-    end
-
     def update(attrs)
-      raise ArgumentError, "update requires a Hash"
+      raise ArgumentError, "update requires a Hash" unless attrs.is_a?(Hash)
       attrs.each do |field, value|
-        self.send(:"#{field}=", value) if instance_method_defined?(field)
+        send(:"#{field}=", value) if respond_to?(field)
       end
     end
 
@@ -67,6 +75,26 @@ module FormalWear
       after_save
     end
 
+    def sanitize_and_fill_attributes(fields)
+      fields.deep_dup.each do |field, options|
+        fill_attributes!(field, options)
+        sanitize_attributes!(options)
+      end
+    end
+
+    def sanitize_attributes!(options)
+      options.slice!(:name, :type, :value, :values)
+    end
+
+    def fill_attributes!(field, options)
+      options[:value]   = self.send(field)
+      populate_select_values(options) if options[:type] == :select
+    end
+
+    def populate_select_values(options)
+      options[:values]  = options[:select_options].call(self)
+    end
+
     def set_field(field, options)
       custom_store?(options) ? set_via_custom_store(field, options) : self.send(:"set_#{field}")
     end
@@ -97,6 +125,27 @@ module FormalWear
       custom_store?(options) && options[:store].try(:lambda?)
     end
 
+    def set_sources(options)
+      set_primary(options) and return unless options.is_a?(Hash)
+      if options[:sources].present?
+        @sources = options[:sources]
+        set_source_readers
+      end
+    end
+
+    def set_primary(source)
+      @primary = source
+    end
+
+    def set_source_readers
+      @sources.each { |alt, obj| set_source_reader(alt, obj) }
+    end
+
+    def set_source_reader(alt, obj)
+      class_eval { attr_reader alt }
+      instance_variable_set(:"@#{alt}", obj)
+    end
+
     # When donning formal_wear, pre-populate from source if available
     def update_sources
       required_fields.each do |field, options|

data/lib/formal_wear/suit.rb

@@ -0,0 +1,19 @@
+module FormalWear
+  module Suit
+    def self.up(klass)
+      class << klass
+        [:optional, :required].each do |kind|
+          define_method :"#{kind}_attrs" do |attrs|
+            validate_attrs!(attrs)
+
+            var = class_variable_get(:"@@#{kind}_fields") || {}
+            class_variable_set(:"@@#{kind}_fields", var.merge(attrs))
+
+            create_accessors(attrs.keys)
+          end
+          alias :"#{kind}_attr" :"#{kind}_attrs"
+        end
+      end
+    end
+  end
+end

data/lib/formal_wear/version.rb

@@ -1,3 +1,3 @@
 module FormalWear
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

data/lib/formal_wear.rb

@@ -1,6 +1,7 @@
 require 'formal_wear/version'
 require 'formal_wear/class_methods'
 require 'formal_wear/instance_methods'
+require 'formal_wear/suit'
 require 'hash_assertions'
 require 'active_support/core_ext'
 require 'active_support/concern'
@@ -17,6 +18,8 @@ module FormalWear
     include FormalWear::InstanceMethods
 
     attr_reader :primary
-    cattr_reader :required_fields
+    cattr_reader :required_fields, :optional_fields
+
+    FormalWear::Suit.up(self)
   end
-end
+end

data/spec/bare_object_spec.rb

@@ -0,0 +1,66 @@
+require 'spec_helper'
+require_relative './support/bare_object'
+
+describe BareObject do
+  let(:obj) { BareObject }
+
+  context 'including FormalWear' do
+    before { obj.send(:include, FormalWear) }
+
+    context 'when required_attr is invoked' do
+      before do
+        obj.class_eval do
+          required_attr dynamic_id: {
+            name: "Test",
+            type: :text,
+            source: ->(s) { nil },
+          }
+        end
+      end
+
+      it 'sets a class variable called @@required_fields' do
+        obj.class_variable_defined?(:@@required_fields).should be_true
+      end
+
+      it 'adds the given field to @@required_fields' do
+        obj.class_variable_get(:@@required_fields).keys.should include(:dynamic_id)
+      end
+
+      it 'adds a reader for the field' do
+        obj.method_defined?(:dynamic_id).should be_true
+      end
+
+      it 'adds a writer for the field' do
+        obj.method_defined?(:dynamic_id=).should be_true
+      end
+    end
+
+    context 'when optional_attr is invoked' do
+      before do
+        obj.class_eval do
+          optional_attr optional_id: {
+            name: "Test",
+            type: :text,
+            source: ->(s) { nil },
+          }
+        end
+      end
+
+      it 'sets a class variable called @@optional_attr' do
+        obj.class_variable_defined?(:@@optional_fields).should be_true
+      end
+
+      it 'adds the given field to @@optional_attr' do
+        obj.class_variable_get(:@@optional_fields).keys.should include(:optional_id)
+      end
+
+      it 'adds a reader for the field' do
+        obj.method_defined?(:optional_id).should be_true
+      end
+
+      it 'adds a writer for the field' do
+        obj.method_defined?(:optional_id=).should be_true
+      end
+    end
+  end
+end

data/spec/completed_object_spec.rb

@@ -0,0 +1,43 @@
+require 'spec_helper'
+require_relative './support/test_formal_wear'
+
+describe 'a configurator with completed setup' do
+  let(:ready_primary) { ExternalObjectOne.new('Formal', 'Wear') }
+  let(:ready_config) { TestFormalWear.new(ready_primary)  }
+
+  subject { ready_config }
+
+  context 'when initialized' do
+    describe '#moms_id' do
+      it 'is equal to ExternalObjectOne.thing_to_be_configured' do
+        subject.moms_id.should == subject.primary.thing_to_be_configured
+      end
+    end
+
+    describe '#docs_id' do
+      it 'is equal to ExternalObjectTwo.another_thing_to_be_configured' do
+        subject.docs_id.should == subject.primary.dependent_object.another_thing_to_be_configured
+      end
+    end
+
+    describe '#lambda_lambda_lambda' do
+      it 'equals ExternalObjectTwo.yet_another_thing_to_be_configured' do
+        subject.lambda_lambda_lambda = subject.primary.dependent_object.yet_another_thing_to_be_configured
+      end
+
+      it 'equals the method cited in its source attr' do
+        subject.lambda_lambda_lambda = subject.send(:get_pledged)
+      end
+    end
+
+    describe '#i_am_optional' do
+      it 'is defined' do
+        subject.respond_to?(:i_am_optional).should be_true
+      end
+
+      it 'is nil' do
+        subject.i_am_optional.should be_nil
+      end
+    end
+  end
+end

data/spec/new_object_spec.rb

@@ -0,0 +1,248 @@
+require 'spec_helper'
+require_relative './support/test_formal_wear'
+
+describe 'a new FormalWear-ing object' do
+  let(:primary) { ExternalObjectOne.new(nil, nil)}
+  let(:config) { TestFormalWear.new(primary) }
+
+  subject { config }
+
+  it 'has a required_fields method' do
+    subject.should respond_to(:required_fields)
+  end
+
+  describe '#required_fields' do
+    subject { config.required_fields }
+    it { should be_a(Hash) }
+
+    it "should mirror class's @@required_fields" do
+      subject.should == config.class.class_variable_get(:@@required_fields)
+    end
+
+    it 'contains the appropriate required fields' do
+      subject.keys.should =~ [:moms_id, :docs_id, :lambda_lambda_lambda]
+    end
+  end
+
+  describe '#optional_fields' do
+    subject { config.optional_fields }
+    it { should be_a(Hash) }
+
+    it "should mirror class's @@optional_fields" do
+      subject.should == config.class.class_variable_get(:@@optional_fields)
+    end
+
+    it 'contains the appropriate optional fields' do
+      subject.keys.should =~ [:i_am_optional]
+    end
+  end
+
+  it 'has a valid? method' do
+    subject.should respond_to(:valid?)
+  end
+
+  it 'has a getter method for each of the required fields' do
+    subject.required_fields.keys.each do |k|
+      subject.should respond_to(k)
+    end
+  end
+
+  it 'has a setter method for each of the required fields' do
+    subject.required_fields.keys.each do |k|
+      subject.should respond_to(:"#{k}=")
+    end
+  end
+
+  context 'when a required field has a "store" key' do
+    context 'that is a symbol' do
+      it 'responds to a method corresponding to that symbol' do
+        subject.should respond_to(subject.required_fields[:docs_id][:store])
+      end
+    end
+  end
+
+  context 'when a required field does not have a "store" key' do
+    it 'responds to a set_xxx method for each required field' do
+      config.required_fields_without_custom_stores.each do |field, options|
+        subject.should respond_to(:"set_#{field}")
+      end
+    end
+  end
+
+  context 'when supplied with only one source object' do
+    let(:config) { TestFormalWear.new(ExternalObjectTwo.new(nil)) }
+
+    it 'sets an instance variable called primary containing the source' do
+      config.instance_variable_defined?(:@primary).should be_true
+    end
+
+    it 'allows access to the primary object correctly' do
+      config.primary.yet_another_thing_to_be_configured.should == 'Stuff'
+    end
+  end
+
+  context 'when supplied with a Hash of source objects' do
+    let(:config) { TestFormalWear.new(sources: {
+        object_two: ExternalObjectTwo.new("I am a secondary") } ) }
+
+    it 'sets an instance variable called sources containing the sources' do
+      config.instance_variable_defined?(:@sources).should be_true
+    end
+
+    it 'sets instance variables for each source object by name' do
+      config.instance_variable_defined?(:@object_two).should be_true
+    end
+
+    it 'sets a reader for each source object' do
+      config.respond_to?(:object_two).should be_true
+    end
+
+    it 'allows access to the source object correctly' do
+      config.object_two.another_thing_to_be_configured.should == "I am a secondary"
+    end
+  end
+
+  describe '#attributes' do
+    context 'given an object that contains required and optional attrs' do
+      it 'returns a hash containing appropriate keys' do
+        config.attributes.keys.should include(:required_attributes, :optional_attributes)
+      end
+    end
+  end
+
+  describe '#required_attributes' do
+    it 'removes all options except name, type and value' do
+      config.required_attributes.each do |r,o|
+        o.should_not include([:source, :store, :select_options])
+      end
+    end
+
+    it 'adds value to the options' do
+      config.required_attributes.each do |r,o|
+        o.should include(:value)
+      end
+    end
+
+    context 'given type :text' do
+      it 'does not add values to the options' do
+        config.required_attributes.each do |r,o|
+          o.should_not include(:values)
+        end
+      end
+    end
+  end
+
+  describe '#optional_attributes' do
+    it 'removes all options except name, type and value' do
+      config.optional_attributes.each do |r,o|
+        o.should_not include([:source, :store, :select_options])
+      end
+    end
+
+    it 'adds value to the options' do
+      config.optional_attributes.each do |r,o|
+        o.should include(:value)
+      end
+    end
+  end
+
+  describe '#valid?' do
+    subject { config }
+
+    context 'when none of the required fields are set' do
+      before do
+        config.moms_id = nil
+      end
+
+      it 'returns false' do
+        config.valid?.should be_false
+      end
+    end
+
+    context 'when not all of the required fields are set' do
+      before do
+        config.moms_id = 'zztop'
+      end
+
+      it 'returns false' do
+        config.valid?.should be_false
+      end
+    end
+
+    context 'when all of the required fields are set' do
+      before do
+        config.moms_id = config.docs_id = config.lambda_lambda_lambda = '1'
+      end
+
+      it 'returns true' do
+        config.valid?.should be_true
+      end
+    end
+  end
+
+  describe '#update' do
+    context 'given anything other than a hash' do
+      subject { config.update("Bob") }
+
+      it 'raises an ArgumentError' do
+        expect { subject }.to raise_error(ArgumentError, 'update requires a Hash' )
+      end
+    end
+
+    context 'given a hash of params' do
+      subject { config.update(docs_id: 1, nonexistent_id: 4) }
+      it 'does not raise an error' do
+        expect { subject }.to_not raise_error(ArgumentError)
+      end
+
+      it 'updates local attributes based on input' do
+        subject
+        config.docs_id.should == 1
+      end
+
+      it 'should ignore attributes that do not exist' do
+        subject
+        config.try(:nonexistent_id).should be_nil
+      end
+    end
+  end
+
+  describe '#save' do
+    subject { config }
+
+    context 'when not valid?' do
+      it 'returns false' do
+        subject.save.should be_false
+      end
+    end
+
+    context 'when valid?' do
+      before do
+        subject.moms_id = subject.docs_id = subject.lambda_lambda_lambda = '1'
+        subject.required_fields_without_custom_stores.keys.each do |k|
+          subject.expects("set_#{k}").returns(true)
+        end
+
+        subject.required_fields_with_custom_stores.each do |field, opt|
+          if opt[:store].is_a?(Symbol)
+            subject.expects(opt[:store]).returns(true)
+            subject.expects(:"set_#{field}").never
+          elsif opt[:store].try(:lambda?)
+           subject.expects(:got_lambda?).returns(true)
+          end
+        end
+
+        subject.expects(:after_save).returns(true)
+      end
+
+      it 'calls the set_xxx methods for each required field' do
+        subject.save
+      end
+
+      it 'calls #after_save' do
+        # condition met by expectation above
+        subject.save
+      end
+    end
+  end
+end

data/spec/required_attr_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe 'Class#required_attr method' do
+  context 'when given unallowed field options' do
+    it 'raises an ArgumentError' do
+      expect { require_relative('./support/forbidden_option_tester') }.to raise_error(ArgumentError, "Unknown key: extraneous")
+    end
+  end
+
+  context 'when missing required field options' do
+    it 'raises an ArgumentError' do
+      expect { require_relative('./support/missing_option_tester') }.to raise_error(ArgumentError, /Missing required key:/)
+    end
+  end
+end

data/spec/select_source_spec.rb

@@ -0,0 +1,68 @@
+require 'spec_helper'
+require_relative './support/bare_object'
+require_relative './support/select_source'
+
+describe BareObject do
+  let(:obj) { BareObject }
+
+  context 'including FormalWear' do
+    before { obj.send(:include, FormalWear) }
+
+    context 'when required_attr is invoked' do
+      context 'with a field of type :select' do
+        context 'without select_options specified' do
+          it 'should raise an error' do
+            expect {
+              obj.class_eval do
+                required_attr unselect_me: {
+                  name: 'Broken select',
+                  type: :select,
+                  source: ->(s) { SelectSource.first },
+                }
+              end
+            }.to raise_error
+          end
+        end
+
+        context 'with select_options specified' do
+          before do
+            obj.class_eval do
+              required_attr select_me: {
+                name: "Selected",
+                type: :select,
+                source: ->(s) { SelectSource.first },
+                select_options: ->(s) { SelectSource.all }
+              }
+            end
+          end
+
+          context 'a new BareObject' do
+            subject { BareObject.new }
+            context '#required_attributes' do
+              it 'includes select_me' do
+                subject.required_attributes.keys.should include(:select_me)
+              end
+
+              context '[:select_me]' do
+                let(:new_obj) { BareObject.new }
+                let(:select_me) { new_obj.required_attributes[:select_me] }
+                subject { select_me }
+
+                it 'includes a values key' do
+                  subject.keys.should include(:values)
+                end
+
+                context '[:values]' do
+                  subject { select_me[:values] }
+                  it 'contains the data specified in the select_options key' do
+                    subject.should == SelectSource.all
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/spec/support/bare_object.rb

@@ -0,0 +1,2 @@
+class BareObject
+end

data/spec/support/forbidden_option_tester.rb

@@ -0,0 +1,10 @@
+class ForbiddenOptionTester
+  include FormalWear
+
+  required_attr moms_id: {
+    name: "Your mom's id",
+    type: :text,
+    source: ->(s) { s.primary.thing_to_be_configured },
+    extraneous: :thing
+  }
+end

data/spec/support/missing_option_tester.rb

@@ -0,0 +1,7 @@
+class MissingOptionTester
+  include FormalWear
+
+  required_attr moms_id: {
+    name: "Your mom's id"
+  }
+end

data/spec/support/select_source.rb

@@ -0,0 +1,13 @@
+class SelectSource
+  def self.all
+    [
+      { id: 1, name: 'Option 1' },
+      { id: 2, name: 'Option 2' },
+      { id: 3, name: 'Option 3' }
+    ]
+  end
+
+  def self.first
+    all.first
+  end
+end

data/spec/{test_formal_wear.rb → support/test_formal_wear.rb}

@@ -23,6 +23,12 @@ class TestFormalWear
     store:  ->(s) { s.got_lambda? }
   }
 
+  optional_attr i_am_optional: {
+    name: 'Test optional',
+    type: 'text',
+    source: ->(s) { nil }
+  }
+
   protected
 
   def after_save
@@ -42,7 +48,7 @@ class TestFormalWear
   end
 
   def get_pledged
-    primary.dependent_object.another_thing_to_be_configured
+    primary.dependent_object.yet_another_thing_to_be_configured
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: formal_wear
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-03 00:00:00.000000000 Z
+date: 2013-07-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -111,10 +111,19 @@ files:
 - lib/formal_wear.rb
 - lib/formal_wear/class_methods.rb
 - lib/formal_wear/instance_methods.rb
+- lib/formal_wear/suit.rb
 - lib/formal_wear/version.rb
+- spec/bare_object_spec.rb
+- spec/completed_object_spec.rb
+- spec/new_object_spec.rb
+- spec/required_attr_spec.rb
+- spec/select_source_spec.rb
 - spec/spec_helper.rb
-- spec/test_formal_wear.rb
-- spec/test_formal_wear_spec.rb
+- spec/support/bare_object.rb
+- spec/support/forbidden_option_tester.rb
+- spec/support/missing_option_tester.rb
+- spec/support/select_source.rb
+- spec/support/test_formal_wear.rb
 homepage: https://github.com/wideopenspaces/formal_wear
 licenses: []
 post_install_message: 
@@ -140,6 +149,14 @@ signing_key:
 specification_version: 3
 summary: You're going to like the way you look. I guarantee it.
 test_files:
+- spec/bare_object_spec.rb
+- spec/completed_object_spec.rb
+- spec/new_object_spec.rb
+- spec/required_attr_spec.rb
+- spec/select_source_spec.rb
 - spec/spec_helper.rb
-- spec/test_formal_wear.rb
-- spec/test_formal_wear_spec.rb
+- spec/support/bare_object.rb
+- spec/support/forbidden_option_tester.rb
+- spec/support/missing_option_tester.rb
+- spec/support/select_source.rb
+- spec/support/test_formal_wear.rb

data/spec/test_formal_wear_spec.rb

@@ -1,151 +0,0 @@
-require 'spec_helper'
-require 'test_formal_wear'
-
-describe TestFormalWear do
-  let(:primary) { ExternalObjectOne.new(nil, nil)}
-  let(:config) { TestFormalWear.new(primary) }
-
-  describe 'a configurator with completed setup' do
-    let(:ready_primary) { ExternalObjectOne.new('Formal', 'Wear') }
-    let(:ready_config) { TestFormalWear.new(ready_primary)  }
-
-    subject { ready_config }
-
-    context 'when initialized' do
-      describe '#moms_id' do
-        it 'is equal to ExternalObjectOne.thing_to_be_configured' do
-          subject.moms_id.should == subject.primary.thing_to_be_configured
-        end
-      end
-
-      describe '#docs_id' do
-        it 'is equal to ExternalObjectTwo.another_thing_to_be_configured' do
-          subject.docs_id.should == subject.primary.dependent_object.another_thing_to_be_configured
-        end
-      end
-    end
-  end
-
-  describe 'a new configurator object' do
-    subject { config }
-
-    it 'has a required_fields method' do
-      subject.should respond_to(:required_fields)
-    end
-
-    describe '#required_fields' do
-      subject { config.required_fields }
-      it { should be_a(Hash) }
-
-      it 'contains the appropriate required fields' do
-        subject.keys.should =~ [:moms_id, :docs_id, :lambda_lambda_lambda]
-      end
-    end
-
-    it 'has a valid? method' do
-      subject.should respond_to(:valid?)
-    end
-
-    it 'has a getter method for each of the required fields' do
-      subject.required_fields.keys.each do |k|
-        subject.should respond_to(k)
-      end
-    end
-
-    it 'has a setter method for each of the required fields' do
-      subject.required_fields.keys.each do |k|
-        subject.should respond_to(:"#{k}=")
-      end
-    end
-
-    context 'when a required field has a "store" key' do
-      context 'that is a symbol' do
-        it 'responds to a method corresponding to that symbol' do
-          subject.should respond_to(subject.required_fields[:docs_id][:store])
-        end
-      end
-    end
-
-    context 'when a required field does not have a "store" key' do
-      it 'responds to a set_xxx method for each required field' do
-        config.required_fields_without_custom_stores.each do |field, options|
-          subject.should respond_to(:"set_#{field}")
-        end
-      end
-    end
-  end
-
-  describe '#valid?' do
-    subject { config }
-
-    context 'when none of the required fields are set' do
-      before do
-        config.moms_id = nil
-      end
-
-      it 'returns false' do
-        config.valid?.should be_false
-      end
-    end
-
-    context 'when not all of the required fields are set' do
-      before do
-        config.moms_id = 'zztop'
-      end
-
-      it 'returns false' do
-        config.valid?.should be_false
-      end
-    end
-
-    context 'when all of the required fields are set' do
-      before do
-        config.moms_id = config.docs_id = config.lambda_lambda_lambda = '1'
-      end
-
-      it 'returns true' do
-        config.valid?.should be_true
-      end
-    end
-  end
-
-  describe '#save' do
-    subject { config }
-
-    context 'when not valid?' do
-      it 'returns false' do
-        subject.save.should be_false
-      end
-    end
-
-    context 'when valid?' do
-      before do
-        subject.moms_id = subject.docs_id = subject.lambda_lambda_lambda = '1'
-        subject.required_fields_without_custom_stores.keys.each do |k|
-          subject.expects("set_#{k}").returns(true)
-        end
-
-        subject.required_fields_with_custom_stores.each do |field, opt|
-          if opt[:store].is_a?(Symbol)
-            subject.expects(opt[:store]).returns(true)
-            subject.expects(:"set_#{field}").never
-          elsif opt[:store].try(:lambda?)
-           subject.expects(:got_lambda?).returns(true)
-          end
-        end
-
-        subject.expects(:after_save).returns(true)
-      end
-
-      it 'calls the set_xxx methods for each required field' do
-        subject.save
-      end
-
-      it 'calls #after_save' do
-        # condition met by expectation above
-        subject.save
-      end
-    end
-  end
-
-end