shape 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7721ae7dec761e6fc7df7c801c2fa4e2176d07d4
+  data.tar.gz: ccbbc447f0038018e40a1f1e75d8e2c4444a5562
+SHA512:
+  metadata.gz: 878acd9eab21ba6c2732285de0b2810f71038b801764060ccf29c5eee1222b8e4c7cf5f43cfa80423d90b5d9d40a74ec4d3be0ab64697576fb2e1e4d24698c72
+  data.tar.gz: aa47f8d4ac3e7bcd5e08332f111d7b706e63810d70ea8bc86775b9279da5da02e13c22bdcb6f23802b4e525c074085ac1b9b76b3b7feca0d4df0392a646b2288

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :development do
+  gem 'awesome_print'
+  gem 'rspec'
+  gem 'rspec-rails'
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 TODO: Write your name
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,29 @@
+# Shape
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'shape'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install shape
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/lib/shape.rb

@@ -0,0 +1,12 @@
+require 'active_support/all'
+require 'shape/version'
+require 'shape/base'
+require 'shape/property_shaper'
+require 'shape/data_visitor'
+require 'shape/renderers'
+
+module Shape
+  extend ActiveSupport::Concern
+  include Shape::Base
+  include Shape::Renderers
+end

data/lib/shape/base.rb

@@ -0,0 +1,130 @@
+require 'active_support/concern'
+
+module Shape
+  module Base
+
+    extend ActiveSupport::Concern
+
+    attr_accessor :_source
+    attr_accessor :_parent
+
+    protected :_parent
+
+    def initialize(source = nil, options = {})
+      self._source = source
+      self._parent = options.delete(:parent)
+      self.delegate_properties_from
+    end
+
+    #def source_name
+      #_source.class.name
+    #end
+    #protected :source_name
+    #
+
+    protected
+
+    def delegate_properties_from
+      self.class._properties_from.each do |from, except|
+        Array(_source.send(from)).each do |name|
+          unless except.include?(name.to_sym)
+            property(name) do
+              from do
+                _source.send(:[], name)
+              end
+            end
+          end
+        end
+      end
+    end
+
+
+    module ClassMethods
+
+      def shape(source, options={})
+        self.new(source, options)
+      end
+
+      def shaper_context
+        @shaper_context || self
+      end
+
+      # Expose a property as {<property_name>: "..."}
+      # To expose a property using a different attribute on the resource:
+      #
+      #   property :display, from: :display_name
+      #
+      # To expose a property with inline definition:
+      #
+      #   property :display do
+      #     from do
+      #       #{last_name}, #{first_name}
+      #     end
+      #   end
+      #
+      # To expose a decorated collection:
+      #
+      #   property :practices, with: PracticeDecorator
+      #
+      #
+      # To expose a decorated collection with view context
+      #
+      #   property :practices, with: PracticeDecorator, context: {view: :summary}
+      #
+      def property(property_name, options={}, &block)
+        properties[property_name] = Shape::PropertyShaper.new(
+          shaper_context, property_name, options, &block
+        )
+      end
+      alias_method :association, :property
+
+      def properties_from(name, options={})
+        except = Array(options[:except])
+        _properties_from << [name, except]
+      end
+
+      def associations
+        @associations ||= {}
+      end
+
+      def properties
+        @properties ||= {}
+      end
+
+      def _properties_from
+        @properties_from ||= []
+      end
+
+      # @overload delegate(*methods, options = {})
+      #   Overrides {http://api.rubyonrails.org/classes/Module.html#method-i-delegate Module.delegate}
+      #   to make `:_source` the default delegation target.
+      #
+      #   @return [void]
+      def delegate(*methods)
+        options = methods.extract_options!
+        super *methods, options.reverse_merge(to: :_source)
+      end
+
+      def shape_collection(collection, options = {})
+        Array(collection).map do |item|
+          self.shape(item, options.clone)
+        end
+      end
+
+    protected
+      def delegate_property(name)
+        if !shaper_context.method_defined?(name)
+          shaper_context.delegate(name)
+          shaper_context.send(:protected, name)
+        end
+      end
+
+
+    end
+    # Allows properties to be added in an instance..
+    include ClassMethods
+    def shaper_context
+      @shaper_context || self.class
+    end
+  end
+end

data/lib/shape/data_visitor.rb

@@ -0,0 +1,32 @@
+module Shape
+  module DataVisitor
+
+    def visit(visitor = lambda {|x| x})
+      data_visitor(properties_to_visit, visitor)
+    end
+
+  protected
+
+    def properties_to_visit
+      self.class.properties.merge(self.properties)
+    end
+
+    def data_visitor(properties = self.properties_to_visit, visitor = lambda {|x| x})
+      properties.each_with_object({}) do |(name, property), obj|
+        if property.options.present? && property.options[:with]
+          result = self.send(name)
+          if result.respond_to?(:visit)
+            obj[name] = result.visit(visitor)
+          elsif result.is_a?(Enumerable)
+            obj[name] = result.each_with_object([]) do |item, results|
+              results << item.visit(visitor)
+            end
+          end
+        else
+          obj[name] = visitor.call(self.send(name))
+        end
+      end
+    end
+
+  end
+end

data/lib/shape/property_shaper.rb

@@ -0,0 +1,82 @@
+module Shape
+  # = Property Shaper
+  # Keeps track of property info and context
+  # when shaping shaper views.
+  #
+  # We'll use the PropertyShaper objects
+  # later to recursively build the data.
+  #
+  # Allows anything inside a property block
+  # to call methods in the context of the
+  # Shape dsl allowing for nested properties.
+  #
+  # Example:
+  #
+  #   property :address do
+  #     property :street_address do
+  #       property :addr_line1
+  #       property :addr_line2
+  #     end
+  #     property :city
+  #     # ...
+  #   end
+  class PropertyShaper
+    include Shape::Base::ClassMethods
+
+    attr_accessor :name
+    attr_accessor :shaper_context
+    attr_accessor :options
+
+    def initialize(shaper_context, name, options={}, &block)
+      self.shaper_context = shaper_context
+      self.name = name
+      self.options = options
+
+      if block
+        instance_eval(&block)
+      else
+        from = options[:from] || name
+        define_accessor(name, from)
+        delegate_property(from)
+      end
+    end
+
+    def from(&block)
+      unless shaper_context.method_defined?(name.to_sym)
+        shaper_context.send(:define_method, name, &block)
+      end
+    end
+
+    protected
+
+    def define_accessor(name, source_name)
+      if !shaper_context.method_defined?(name.to_sym)
+        _options = self.options
+        self.from do
+          return nil unless _source
+          result = begin
+            _source.send(source_name)
+            rescue NoMethodError
+              # If source doesn't have a corresponding method, try accessing it
+              # via element accessor.
+              if _source.respond_to?(:[])
+                _source.send(:[], source_name)
+              else
+                raise
+              end
+          end
+          if with = _options[:with]
+            if result.respond_to?(:join)
+              with.shape_collection(result, parent: self)
+            else
+              with.shape(result, parent: self)
+            end
+          else
+            result
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/shape/renderers.rb

@@ -0,0 +1,14 @@
+module Shape
+  module Renderers
+    include Shape::DataVisitor
+
+    def as_json(*args)
+      visit(lambda {|x| x.as_json})
+    end
+
+    def to_hash(*args)
+      visit
+    end
+    alias_method :to_h, :to_hash
+  end
+end

data/lib/shape/version.rb

@@ -0,0 +1,3 @@
+module Shape
+  VERSION = '0.0.1'
+end

data/lib/shape/view_decorator.rb

@@ -0,0 +1,55 @@
+module Shape
+  # = View Decorator
+  # Allows for creating different, composable
+  # decorator views
+  #
+  # Example:
+  #
+  #   property :href
+  #   property :addr_line1
+  #   property :addr_line2
+  #   property :city
+  #   # ...
+  #
+  #   view :with_lat_long do
+  #     property :latitude
+  #     property :longitude
+  #   end
+  #
+  #   view :with_facilities do
+  #     link :facilities
+  #   end
+  #
+  #   view :full do
+  #     view :with_lat_long    # nests with_lat_long view
+  #     view :with_facilities  # nests with_facilities view
+  #   end
+  #
+  #
+  # To use a decorator view, pass the view in to
+  # the decorator context. For example:
+  #
+  #   @address = AddressDecorator.new(
+  #     Address.find(params[:id]),
+  #     context: {view: :full})
+  #
+  #
+  class ViewDecorator
+    include Shape::Base::ClassMethods
+    attr_accessor :name
+    attr_accessor :decorator_context
+    attr_accessor :options
+
+    def initialize(decorator_context, name, options={}, &block)
+      self.decorator_context = decorator_context
+      self.name = name
+      self.options = options
+
+      if block
+        instance_eval(&block)
+      else
+        views[name] = decorator_context.views[name]
+      end
+    end
+  end
+end

data/shape.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require 'shape/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'shape'
+  s.version     = Shape::VERSION
+  s.summary     = 'Shape your api'
+  s.description = 'Shape your api. Extracted from Vitals Platform.'
+  s.authors     = ['Robin Curry', 'Brandon Westcott', 'Tim Morgan']
+  s.email       = ['robin.curry@vitals.com', 'brandon.westcott@vitals.com', 'tim.morgan@vitals.com']
+  s.homepage    = 'https://github.com/robincurry/shape'
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'activesupport', '>= 3.0'
+end

data/spec/association_shaper_spec.rb

@@ -0,0 +1,186 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Property child associations" do
+
+  context 'Given an object with method attributes' do
+
+    let(:source) {
+      OpenStruct.new.tap do |person|
+      person.name  = 'John Smith'
+      person.age   = 34
+      person.ssn   = 123456789
+      person.children = [
+        OpenStruct.new.tap do |child|
+        child.name  = 'Jimmy Smith'
+        end,
+          OpenStruct.new.tap do |child|
+          child.name  = 'Jane Smith'
+          end,
+      ]
+      end
+    }
+
+    context 'and Parent and Child Shape decorators' do
+
+      before do
+        stub_const('ChildDecorator', Class.new do
+          include Shape::Base
+          property :name
+        end)
+
+        stub_const('ParentDecorator', Class.new do
+          include Shape::Base
+          property :name
+          property :years_of_age, from: :age
+
+          association :children, with: ChildDecorator
+        end)
+      end
+
+      context 'when shaped by the decorator' do
+
+        subject {
+          ParentDecorator.new(source)
+        }
+
+        it 'exposes and shapes children associations' do
+          expect(subject.children.map(&:name)).to eq(['Jimmy Smith', 'Jane Smith'])
+        end
+
+      end
+
+    end
+
+  end
+
+  context 'Given a hash with attributes' do
+
+    let(:source) {
+      {
+        name: 'John Smith',
+        age: 34,
+        ssn: 123456789,
+        children: [
+          {
+            name: 'Jimmy Smith'
+          },
+          {
+            name: 'Jane Smith'
+          }
+        ]
+      }
+    }
+
+
+    context 'and Parent and Child Shape decorators' do
+
+      before do
+        stub_const('ChildDecorator', Class.new do
+          include Shape::Base
+          property :legal_name, from: :name
+        end)
+
+        stub_const('ParentDecorator', Class.new do
+          include Shape::Base
+          property :name
+          property :years_of_age, from: :age
+
+          association :children, with: ChildDecorator
+        end)
+      end
+
+      context 'when shaped by the decorator' do
+
+        subject {
+          ParentDecorator.new(source)
+        }
+
+        it 'exposes and shapes children associations' do
+          expect(subject.children.map(&:legal_name)).to eq(['Jimmy Smith', 'Jane Smith'])
+        end
+
+      end
+
+    end
+
+  end
+
+  context 'Given a hash with deeply nested attributes' do
+
+    let(:source) {
+      {
+        name: 'John Smith',
+        age: 34,
+        ssn: 123456789,
+        children: [
+          {
+            name: 'Jimmy Smith',
+            children: [
+              {
+                name: 'Suzy Smith'
+              },
+              {
+                name: 'Sally Smith'
+              }
+            ]
+          },
+          {
+            name: 'Jane Smith',
+            children: [
+              {
+                name: 'Sam Smith'
+              },
+              {
+                name: 'Tim Smith'
+              },
+            ]
+          }
+        ]
+      }
+    }
+
+
+    context 'and Parent and Child Shape decorators' do
+
+      before do
+        stub_const('NestedChildDecorator', Class.new do
+          include Shape::Base
+          property :name
+        end)
+
+        stub_const('ChildDecorator', Class.new do
+          include Shape::Base
+          property :legal_name, from: :name
+          association :children, with: NestedChildDecorator
+        end)
+
+        stub_const('ParentDecorator', Class.new do
+          include Shape::Base
+          property :name
+          property :years_of_age, from: :age
+
+          association :children, with: ChildDecorator
+        end)
+      end
+
+      context 'when shaped by the decorator' do
+
+        subject {
+          ParentDecorator.new(source)
+        }
+
+        it 'exposes and shapes children associations' do
+          expect(subject.children.map(&:legal_name)).to eq(['Jimmy Smith', 'Jane Smith'])
+        end
+
+        it 'exposes and shapes nested children associations' do
+          expect(subject.children.first.children.map(&:name)).to eq(['Suzy Smith', 'Sally Smith'])
+        end
+
+      end
+
+    end
+
+  end
+
+end

data/spec/base_spec.rb

@@ -0,0 +1,217 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Shape::Base do
+
+  context 'Given an object with method attributes' do
+
+    let(:source) {
+      OpenStruct.new.tap do |person|
+      person.name  = 'John Smith'
+      person.age   = 34
+      person.ssn   = 123456789
+      person.children = [
+        OpenStruct.new.tap do |child|
+        child.name  = 'Jimmy Smith'
+        end,
+          OpenStruct.new.tap do |child|
+          child.name  = 'Jane Smith'
+          end,
+      ]
+      end
+    }
+
+    context 'and a Shape decorator' do
+
+      before do
+        stub_const('MockDecorator', Class.new do
+          include Shape::Base
+          property :name
+          property :years_of_age, from: :age
+        end)
+
+      end
+
+      context 'when shaped by the decorator' do
+
+        subject {
+          MockDecorator.new(source)
+        }
+
+        it 'exposes defined properties from source' do
+          expect(subject.name).to eq('John Smith')
+        end
+
+        it 'exposes defined properties renamed from source' do
+          expect(subject.years_of_age).to eq(34)
+        end
+
+        it 'does not expose unspecified attributes' do
+          expect(subject).to_not respond_to(:ssn)
+          expect(subject).to_not respond_to(:age)
+        end
+      end
+    end
+
+    context 'and Parent and Child Shape decorators' do
+
+      before do
+        stub_const('ChildDecorator', Class.new do
+          include Shape::Base
+          property :name
+        end)
+
+        stub_const('ParentDecorator', Class.new do
+          include Shape::Base
+          property :name
+          property :years_of_age, from: :age
+
+          association :children, with: ChildDecorator
+        end)
+      end
+
+      context 'when shaped by the decorator' do
+
+        subject {
+          ParentDecorator.new(source)
+        }
+
+        it 'exposes and shapes children associations' do
+          expect(subject.children.map(&:name)).to eq(['Jimmy Smith', 'Jane Smith'])
+        end
+
+      end
+
+    end
+
+  end
+
+  context 'Given a hash with method attributes' do
+
+    let(:source) {
+      {
+        name: 'John Smith',
+        age: 34,
+        ssn: 123456789,
+        children: [
+          {
+            name: 'Jimmy Smith'
+          },
+          {
+            name: 'Jane Smith'
+          }
+        ]
+      }
+    }
+
+    context 'and a Shape decorator' do
+
+      before do
+        stub_const('MockDecorator', Class.new do
+          include Shape::Base
+          property :name
+          property :years_of_age, from: :age
+        end)
+
+      end
+
+      context 'when shaped by the decorator' do
+
+        subject {
+          MockDecorator.new(source)
+        }
+
+        it 'exposes defined properties from source' do
+          expect(subject.name).to eq('John Smith')
+        end
+
+        it 'exposes defined properties renamed from source' do
+          expect(subject.years_of_age).to eq(34)
+        end
+
+        it 'does not expose unspecified attributes' do
+          expect(subject).to_not respond_to(:ssn)
+          expect(subject).to_not respond_to(:age)
+        end
+      end
+
+    end
+
+    context 'and Parent and Child Shape decorators' do
+
+      before do
+        stub_const('ChildDecorator', Class.new do
+          include Shape::Base
+          property :legal_name, from: :name
+        end)
+
+        stub_const('ParentDecorator', Class.new do
+          include Shape::Base
+          property :name
+          property :years_of_age, from: :age
+
+          association :children, with: ChildDecorator
+        end)
+      end
+
+      context 'when shaped by the decorator' do
+
+        subject {
+          ParentDecorator.new(source)
+        }
+
+        it 'exposes and shapes children associations' do
+          expect(subject.children.map(&:legal_name)).to eq(['Jimmy Smith', 'Jane Smith'])
+        end
+
+      end
+
+    end
+
+    context 'and a Shape decorator with properties_from' do
+
+      before do
+        stub_const('MockDecorator', Class.new do
+          include Shape::Base
+          properties_from(:keys)
+        end)
+
+      end
+
+      context 'when shaped by the decorator' do
+
+        subject {
+          MockDecorator.new(source)
+        }
+
+        it 'exposes defined properties from source for each key' do
+          expect(subject).to respond_to(:name, :age, :ssn, :children)
+          expect(subject.name).to eq('John Smith')
+        end
+      end
+
+    end
+
+    context 'and a Shape decorator with properties_from with an except list' do
+
+      before do
+        stub_const('MockDecorator', Class.new do
+          include Shape::Base
+          properties_from(:keys, except: :ssn)
+        end)
+      end
+
+      context 'when shaped by the decorator' do
+
+        subject {
+          MockDecorator.new(source)
+        }
+
+        it 'should not expose defined properties for the exceptions' do
+          expect(subject).to_not respond_to(:ssn)
+        end
+      end
+
+    end
+  end
+
+end

data/spec/data_visitor_spec.rb

@@ -0,0 +1,57 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Shape::DataVisitor do
+
+  context 'Given a decorated class that implements Shape::DataVisitor' do
+
+    before do
+      stub_const('PersonDecorator', Class.new do
+        include Shape::Base
+        include Shape::DataVisitor
+        property :name
+        property :age
+        association :spouse, with: self
+      end)
+    end
+
+    let(:source) {
+      OpenStruct.new.tap do |person|
+        person.name  = 'John Smith'
+        person.age   = 34
+        person.spouse = OpenStruct.new.tap do |spouse|
+          spouse.name  = 'Jane Smith'
+          spouse.age = 32
+        end
+      end
+    }
+
+    context 'when I visit the object without providing a visitor' do
+      subject {
+        PersonDecorator.new(source).visit
+      }
+
+      it 'returns the raw visited data' do
+        expect(subject[:name]).to eq('John Smith')
+        expect(subject[:age]).to eq(34)
+        expect(subject[:spouse][:name]).to eq('Jane Smith')
+        expect(subject[:spouse][:age]).to eq(32)
+      end
+    end
+
+    context 'when I visit the object with a string visitor' do
+      subject {
+        PersonDecorator.new(source).visit(lambda do |data|
+          data.to_s
+        end)
+      }
+
+      it 'returns the visited data as strings' do
+        expect(subject[:name]).to eq('John Smith')
+        expect(subject[:age]).to eq('34')
+        expect(subject[:spouse][:age]).to eq('32')
+      end
+    end
+
+  end
+
+end

data/spec/property_shaper_spec.rb

@@ -0,0 +1,139 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Shape::PropertyShaper do
+
+  context 'Given an object with method attributes' do
+
+    let(:source) {
+      OpenStruct.new.tap do |person|
+      person.name  = 'John Smith'
+      person.age   = 34
+      person.ssn   = 123456789
+      person.children = [
+        OpenStruct.new.tap do |child|
+        child.name  = 'Jimmy Smith'
+        end,
+        OpenStruct.new.tap do |child|
+        child.name  = 'Jane Smith'
+        end,
+      ]
+      end
+    }
+
+    context 'and a Shape decorator' do
+
+      before do
+        stub_const('MockDecorator', Class.new do
+          include Shape::Base
+          property :name
+          property :years_of_age, from: :age
+        end)
+
+      end
+
+      context 'when shaped by the decorator' do
+
+        subject {
+          MockDecorator.new(source)
+        }
+
+        it 'exposes defined properties from source' do
+          expect(subject.name).to eq('John Smith')
+        end
+
+        it 'exposes defined properties renamed from source' do
+          expect(subject.years_of_age).to eq(34)
+        end
+
+        it 'does not expose unspecified attributes' do
+          expect(subject).to_not respond_to(:ssn)
+          expect(subject).to_not respond_to(:age)
+        end
+      end
+    end
+
+  end
+
+  context 'Given a hash with attributes' do
+
+    let(:source) do
+      {
+        name: 'John Smith',
+        age: 34,
+        ssn: 123456789,
+        children: [
+          {
+            name: 'Jimmy Smith'
+          },
+          {
+            name: 'Jane Smith'
+          }
+        ]
+      }
+    end
+
+    context 'and a Shape decorator' do
+
+      before do
+        stub_const('MockDecorator', Class.new do
+          include Shape::Base
+          property :name
+          property :years_of_age, from: :age
+        end)
+
+      end
+
+      context 'when shaped by the decorator' do
+
+        subject {
+          MockDecorator.new(source)
+        }
+
+        it 'exposes defined properties from source' do
+          expect(subject.name).to eq('John Smith')
+        end
+
+        it 'exposes defined properties renamed from source' do
+          expect(subject.years_of_age).to eq(34)
+        end
+
+        it 'does not expose unspecified attributes' do
+          expect(subject).to_not respond_to(:ssn)
+          expect(subject).to_not respond_to(:age)
+        end
+      end
+
+    end
+
+    context 'and a Shape decorator with property with:' do
+
+      before do
+        stub_const('ChildDecorator', Class.new do
+          include Shape::Base
+          property :name
+        end)
+
+        stub_const('MockDecorator', Class.new do
+          include Shape::Base
+          property :children, with: ChildDecorator
+        end)
+
+      end
+
+      context 'when shaped by the decorator' do
+
+        subject {
+          MockDecorator.new(source)
+        }
+
+        it 'exposes and shapes each child element of the property with the provided decorator' do
+          expect(subject.children.map(&:name)).to eq(['Jimmy Smith', 'Jane Smith'])
+        end
+
+      end
+
+    end
+
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require 'rspec'
+require 'shape'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+# Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  # Use color in STDOUT
+  config.color_enabled = true
+
+  # Use color not only in STDOUT but also in pagers and files
+  config.tty = true
+end

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification
+name: shape
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Robin Curry
+- Brandon Westcott
+- Tim Morgan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Shape your api. Extracted from Vitals Platform.
+email:
+- robin.curry@vitals.com
+- brandon.westcott@vitals.com
+- tim.morgan@vitals.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/shape.rb
+- lib/shape/base.rb
+- lib/shape/data_visitor.rb
+- lib/shape/property_shaper.rb
+- lib/shape/renderers.rb
+- lib/shape/version.rb
+- lib/shape/view_decorator.rb
+- shape.gemspec
+- spec/association_shaper_spec.rb
+- spec/base_spec.rb
+- spec/data_visitor_spec.rb
+- spec/property_shaper_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/robincurry/shape
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.6
+signing_key: 
+specification_version: 4
+summary: Shape your api
+test_files:
+- spec/association_shaper_spec.rb
+- spec/base_spec.rb
+- spec/data_visitor_spec.rb
+- spec/property_shaper_spec.rb
+- spec/spec_helper.rb