conglomerate 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: dac49f10d492b562ad8a9e9e01dd510d1e153f4d
-  data.tar.gz: 2135e7554e814fed47ab509555027451703e01f6
+  metadata.gz: 299095559c8ba18987524ef7e2702c2f2ad341b6
+  data.tar.gz: 65a914ac9c9c2a31086c39d1577685347339b568
 SHA512:
-  metadata.gz: d5e31a22776e551119a344bad716c5bc79d09de0de18ce939e22e624b79b96b1ab37a5bb611cf13664b2d8e17cc7ef9d65a6295df45601f836f260ca0851170e
-  data.tar.gz: 7215b0dae33f4acaef3549d2a4ab39f87abd94a91f2caea55e4392a4c46209b9d2cdbf63184aad1a6360e0af5820438450dcbaac6036c7bd4a5cef38ba5b0f8c
+  metadata.gz: 2374f028927ee394aabeb148a0513c9dd2b1a59e9cd3c68a926c98c9bd1b12391ad13d19c39eccabdc7cf9e56dd446c9c0f1a31dbe2451bd2d430a348f0efa1d
+  data.tar.gz: 9a7c73782ab8de2f30131cc60f5449941159b3168b5c228e1af4810f12a49372cd18265e7a3170712c592bd0b288f6324bb0eb45c8fb3d76cdb180f482c57a18

data/README.md

@@ -1,8 +1,7 @@
 # Conglomerate
 
 [![Gem Version](https://badge.fury.io/rb/conglomerate.png)](http://badge.fury.io/rb/conglomerate)
-[![Semaphore](https://semaphoreapp.com/api/v1/projects/7b914dac-6aa6-43dd-94a9-53698ef1922a/120842/shields_badge.png
-)](https://semaphoreapp.com/minter/conglomerate)
+[ ![Codeship Status for teamsnap/conglomerate](https://www.codeship.io/projects/7210a3f0-de00-0131-af05-5236ebb52643/status)](https://www.codeship.io/projects/24758)
 [![Code Climate](https://codeclimate.com/github/teamsnap/conglomerate.png)](https://codeclimate.com/github/teamsnap/conglomerate)
 [![Coverage Status](https://coveralls.io/repos/teamsnap/conglomerate/badge.png?branch=master)](https://coveralls.io/r/teamsnap/conglomerate?branch=master)
 [![Dependency Status](https://gemnasium.com/teamsnap/conglomerate.png)](https://gemnasium.com/teamsnap/conglomerate)
@@ -36,20 +35,29 @@ Or install it yourself as:
 ```ruby
 # Step 1: Create a serializer
 class TeamSerializer
-  include Conglomerate.serializer
+  include Conglomerate::RootBuilder
 
   href { teams_url }
-  item_href { |item| team_url(item.id) }
 
-  attribute :id
-  attribute :name, :template => true
-  attribute :event_ids, :rel => :events { |item| event_url(item.event_ids.join(",")) }
+  item "Team" do |item|
+    href { team_url(item.id) }
 
-  link :root { root_url }
+    datum :id
+    datum :name
+    datum :event_ids
 
-  query :search, :data => :id { search_teams_url }
+    link :events, :href => Proc.new { event_url(item.event_ids.join(",")) }
+  end
+
+  link :root, :href => Proc.new { root_url }
+
+  query :search, :href => Proc.new { search_items_url } do
+    datum :id
+  end
 
-  command :populate, :data => :id { populate_teams_url }
+  template do
+    datum :name
+  end
 end
 
 # Step 2: Serialize any object
@@ -107,15 +115,6 @@ end
         ]
       }
     ],
-    "commands": [
-      {
-        "rel": "populate",
-        "href": "http://example.com/teams/populate",
-        "data": [
-          {"name": "id", "value": ""}
-        ]
-      }
-    ],
     "template": {
       "data": [
         {"name": "name", "value": ""}

data/lib/conglomerate.rb

@@ -11,6 +11,20 @@ require_relative "conglomerate/query"
 require_relative "conglomerate/command"
 require_relative "conglomerate/collection"
 require_relative "conglomerate/tree_deserializer"
+require_relative "conglomerate/root"
+
+require_relative "conglomerate/mixin_ivar_helper"
+require_relative "conglomerate/builder_call"
+
+require_relative "conglomerate/builder_serializer"
+require_relative "conglomerate/particle_builder"
+require_relative "conglomerate/link_builder"
+require_relative "conglomerate/datum_builder"
+require_relative "conglomerate/query_builder"
+require_relative "conglomerate/template_builder"
+require_relative "conglomerate/item_builder"
+require_relative "conglomerate/collection_builder"
+require_relative "conglomerate/root_builder"
 
 module Conglomerate
   def self.serialize(serializable)

data/lib/conglomerate/builder_call.rb

@@ -0,0 +1,87 @@
+module Conglomerate
+  class BuilderCall
+    attr_accessor :name, :opts, :block, :builder, :array, :iterates
+
+    def initialize(name: nil, opts: {}, block:, builder:, array:, iterates:)
+      self.name = name
+      self.opts = opts
+      self.block = block
+      self.builder = builder
+      self.array = array
+      self.iterates = iterates
+    end
+
+    def run(context, objects, attrs, attr_name)
+      BuilderCallInstance.new(self, context, objects, attrs, attr_name).run
+    end
+
+    private
+
+    class BuilderCallInstance
+      extend Forwardable
+
+      attr_accessor :bc, :context, :objects, :attrs, :attr_name
+
+      delegate [:name, :opts, :block, :builder, :array, :iterates] => :bc
+
+      def initialize(bc, context, objects, attrs, attr_name)
+        self.bc = bc
+        self.context = context
+        self.objects = objects
+        self.attrs = attrs
+        self.attr_name = attr_name
+      end
+
+      def run
+        return unless should_run?
+
+        if iterates
+          attrs[attr_name] ||= []
+
+          objects.each do |item|
+            attrs[attr_name] << invoke(item)
+          end
+        elsif array
+          attrs[attr_name] ||= []
+          attrs[attr_name] << invoke
+        else
+          attrs[attr_name] = invoke
+        end
+      end
+
+      def invoke(item = nil)
+        serializer = builder.serializer
+        builder_klass = Class.new do
+          include serializer
+        end
+
+        if item
+          builder_klass.class_exec(item, &block) if block
+        else
+          builder_klass.class_eval(&block) if block
+        end
+
+        builder = builder_klass.new(objects, :name => name, :context => context)
+
+        attrs = {}
+
+        opts.each do |key, value|
+          attrs[key] = value_from_proc(value)
+        end
+
+        builder.build(attrs)
+      end
+
+      def value_from_proc(value)
+        value = context.instance_eval(&value) if value.respond_to?(:call)
+        value
+      end
+
+      private
+
+      def should_run?
+        !opts[:if] || (opts[:if] && opts[:if].call)
+      end
+    end
+  end
+end

data/lib/conglomerate/builder_serializer.rb

@@ -0,0 +1,78 @@
+module Conglomerate
+  module BuilderSerializer
+    include Conglomerate::MixinIvarHelper
+
+    mi_ivar_accessor :objects, :context, :_builder_name
+
+    def initialize(objects, name: nil, context: nil)
+      self.objects = [*objects].compact
+      self.context = context
+      self._builder_name = name.to_s
+    end
+
+    def build(attrs = {})
+      internal_build(attrs)
+    end
+
+    def serialize
+      Conglomerate.serialize(build)
+    end
+
+    private
+
+    attr_accessor :object
+
+    def internal_build(attrs = {})
+      builder_values.each do |name|
+        value = get_class_value(name)
+        value = value_from_proc(value)
+        attrs[name.to_sym] = value if attrs[name.to_sym] == nil
+      end
+
+      builder_builders.each do |b|
+        run_builder_calls(b, attrs)
+      end
+
+      self.object = builder_type.new(attrs)
+
+      object
+    end
+
+    def run_builder_calls(b, attrs)
+      calls = builder_calls[b[:command]] || []
+
+      calls.each do |call|
+        call.run(context, objects, attrs, b[:name])
+      end
+    end
+
+    def builder_type
+      self.class.instance_variable_get("@_builder_type")
+    end
+
+    def builder_values
+      self.class.instance_variable_get("@_builder_values")
+    end
+
+    def builder_calls
+      self.class.instance_variable_get("@_builder_calls")
+    end
+
+    def builder_builders
+      self.class.instance_variable_get("@_builder_builders")
+    end
+
+    def get_class_value(name)
+      self.class.instance_variable_get("@#{name}")
+    end
+
+    def value_from_proc(value)
+      value = context.instance_eval(&value) if value.respond_to?(:call)
+      value
+    end
+
+    def context
+      instance_variable_get("@context")
+    end
+  end
+end

data/lib/conglomerate/collection_builder.rb

@@ -0,0 +1,13 @@
+module Conglomerate
+  module CollectionBuilder
+    include Conglomerate::ParticleBuilder
+
+    builds Conglomerate::Collection
+
+    value :href
+    builder :item, Conglomerate::ItemBuilder, :name => :items, :array => true, :iterates => true
+    builder :link, Conglomerate::LinkBuilder, :name => :links, :array => true
+    builder :query, Conglomerate::QueryBuilder, :name => :queries, :array => true
+    builder :template, Conglomerate::TemplateBuilder, :name => :template
+  end
+end

data/lib/conglomerate/datum.rb

@@ -3,7 +3,7 @@ module Conglomerate
     include Conglomerate::Particle
 
     attribute :name, :type => String, :required => true
-    attribute :value
+    attribute :value, :cull => false
     attribute :prompt, :type => String
   end
 end

data/lib/conglomerate/datum_builder.rb

@@ -0,0 +1,25 @@
+module Conglomerate
+  module DatumBuilder
+    include Conglomerate::ParticleBuilder
+
+    builds Conglomerate::Datum
+
+    module BuildOverride
+      def build(attrs = {})
+        item = objects.first
+        val = item.send(_builder_name) if item
+
+        attrs = {
+          :name => _builder_name,
+          :value => val
+        }.merge(attrs)
+
+        super(attrs)
+      end
+    end
+
+    value :name
+    value :value
+    value :prompt
+  end
+end

data/lib/conglomerate/ext/commands.rb

@@ -0,0 +1,36 @@
+module Conglomerate
+  class Command
+    include Conglomerate::Particle
+
+    attribute :href, :type => String, :required => true
+    attribute :rel, :type => String, :required => true
+    attribute :name, :type => String
+    attribute :prompt, :type => String
+
+    array :data, :contains => Datum
+  end
+
+  class CommandBuilder
+    include Conglomerate::ParticleBuilder
+
+    builds Conglomerate::Command
+
+    module BuildOverride
+      def build(attrs = {})
+        instance_variable_set("@objects", nil)
+        super(attrs.merge({
+          :rel => _builder_name
+        }))
+      end
+    end
+
+    value :href
+    value :rel
+    value :name
+    value :prompt
+
+    builder :datum, Conglomerate::DatumBuilder, :name => :data, :array => true
+  end
+end
+
+Conglomerate::CollectionBuilder.send(:builder, :command, Conglomerate::CommandBuilder, :name => :commands, :array => true)

data/lib/conglomerate/item_builder.rb

@@ -0,0 +1,11 @@
+module Conglomerate
+  module ItemBuilder
+    include Conglomerate::ParticleBuilder
+
+    builds Conglomerate::Item
+
+    value :href
+    builder :datum, Conglomerate::DatumBuilder, :name => :data, :array => true
+    builder :link, Conglomerate::LinkBuilder, :name => :links, :array => true
+  end
+end

data/lib/conglomerate/link_builder.rb

@@ -0,0 +1,21 @@
+module Conglomerate
+  module LinkBuilder
+    include Conglomerate::ParticleBuilder
+
+    builds Conglomerate::Link
+
+    module BuildOverride
+      def build(attrs = {})
+        super(attrs.merge({
+          :rel => _builder_name
+        }))
+      end
+    end
+
+    value :href
+    value :rel
+    value :name
+    value :render
+    value :prompt
+  end
+end

data/lib/conglomerate/mixin_ivar_helper.rb

@@ -0,0 +1,53 @@
+module Conglomerate
+  module MixinIvarHelper
+    def self.included(klass)
+      klass.send(:extend, ClassMethods)
+    end
+
+    private
+
+    module ClassMethods
+      def mc_ivar_writer(*names)
+        names.each do |name|
+          self.send(:define_singleton_method, "#{name}=") do |val|
+            instance_variable_set("@#{name}", val)
+          end
+        end
+      end
+
+      def mc_ivar_reader(*names)
+        names.each do |name|
+          self.send(:define_singleton_method,name) do
+            instance_variable_get("@#{name}")
+          end
+        end
+      end
+
+      def mi_ivar_writer(*names)
+        names.each do |name|
+          self.send(:define_method, "#{name}=") do |val|
+            instance_variable_set("@#{name}", val)
+          end
+        end
+      end
+
+      def mi_ivar_reader(*names)
+        names.each do |name|
+          self.send(:define_method,name) do
+            instance_variable_get("@#{name}")
+          end
+        end
+      end
+
+      def mc_ivar_accessor(*names)
+        mc_ivar_writer(*names)
+        mc_ivar_reader(*names)
+      end
+
+      def mi_ivar_accessor(*names)
+        mi_ivar_writer(*names)
+        mi_ivar_reader(*names)
+      end
+    end
+  end
+end

data/lib/conglomerate/particle.rb

@@ -61,7 +61,7 @@ module Conglomerate
             attr_metadata = self.class.attributes[attr]
 
             if type = attr_metadata[:type]
-              raise "TypeMismatch" if !val.is_a?(type)
+              raise "TypeMismatch" if !val.is_a?(type) && val != nil
             end
 
             self.instance_variable_set("@#{attr}", val)

data/lib/conglomerate/particle_builder.rb

@@ -0,0 +1,95 @@
+module Conglomerate
+  module ParticleBuilder
+    def self.included(object)
+      object.send(:extend, ClassMethods)
+    end
+
+    private
+
+    def objects
+      instance_variable_get("@objects")
+    end
+
+    def name
+      instance_variable_get("@_builder_name").to_s
+    end
+
+    module ClassMethods
+      def self.extended(klass)
+        klass.instance_variable_set("@class_methods", Module.new)
+        klass.instance_variable_set("@values", [])
+        klass.instance_variable_set("@builders", [])
+      end
+
+      def serializer
+        mod = Module.new
+        mod.send(:include, Conglomerate::MixinIvarHelper)
+        mod.send(:mc_ivar_accessor, :class_methods, :values, :_builder_type, :_builder_calls, :_builder_builders, :build_override_mod)
+
+        mod.class_methods = class_methods
+        mod.values = values.dup
+        mod._builder_type = instance_variable_get("@type")
+        mod._builder_builders = builders.dup
+
+        begin
+          mod.build_override_mod = self::BuildOverride
+        rescue NameError
+        end
+
+        mod.define_singleton_method(:included) do |klass|
+          klass.send(:extend, class_methods)
+          klass.send(:include, Conglomerate::BuilderSerializer)
+          klass.send(:include, build_override_mod) if build_override_mod
+          klass.instance_variable_set("@_builder_values", values)
+          klass.instance_variable_set("@_builder_type", _builder_type)
+          klass.instance_variable_set("@_builder_calls", {})
+          klass.instance_variable_set("@_builder_builders", _builder_builders)
+        end
+        mod
+      end
+
+      private
+
+      include Conglomerate::MixinIvarHelper
+      mi_ivar_reader :values, :builders, :class_methods
+
+      def builds(type)
+        instance_variable_set("@type", type)
+      end
+
+      def value(name)
+        class_methods.send(:define_method, name) do |&block|
+          instance_variable_set("@#{name}", block)
+        end
+
+        values << name
+      end
+
+      def builder(command, builder, opts={})
+        name = opts[:name] || command
+        array = opts[:array] || false
+        iterates = opts[:iterates] || false
+
+        class_methods.send(:define_method, command) do |name=nil, opts={}, &block|
+          instance_variable_get("@_builder_calls")[command] ||= []
+          instance_variable_get("@_builder_calls")[command] << Conglomerate::BuilderCall.new({
+            :name => name,
+            :opts => opts,
+            :block => block,
+            :builder => builder,
+            :array => array,
+            :iterates => iterates
+          })
+        end
+
+        builders << {
+          :command => command,
+          :builder => builder,
+          :array => array,
+          :name => name,
+          :iterates => iterates
+        }
+      end
+    end
+  end
+end

data/lib/conglomerate/query_builder.rb

@@ -0,0 +1,23 @@
+module Conglomerate
+  module QueryBuilder
+    include Conglomerate::ParticleBuilder
+
+    builds Conglomerate::Query
+
+    module BuildOverride
+      def build(attrs = {})
+        instance_variable_set("@objects", nil)
+        super(attrs.merge({
+          :rel => _builder_name
+        }))
+      end
+    end
+
+    value :href
+    value :rel
+    value :name
+    value :prompt
+
+    builder :datum, Conglomerate::DatumBuilder, :name => :data, :array => true
+  end
+end

data/lib/conglomerate/root_builder.rb

@@ -0,0 +1,9 @@
+module Conglomerate
+  module RootBuilder
+    include Conglomerate::ParticleBuilder
+
+    builds Conglomerate::Root
+
+    builder :collection, Conglomerate::CollectionBuilder
+  end
+end

data/lib/conglomerate/template_builder.rb

@@ -0,0 +1,16 @@
+module Conglomerate
+  module TemplateBuilder
+    include Conglomerate::ParticleBuilder
+
+    builds Conglomerate::Template
+
+    module BuildOverride
+      def build(attrs = {})
+        instance_variable_set("@objects", nil)
+        super
+      end
+    end
+
+    builder :datum, Conglomerate::DatumBuilder, :name => :data, :array => true
+  end
+end

data/lib/conglomerate/tree_serializer.rb

@@ -9,10 +9,21 @@ module Conglomerate
         serialize_particle(item)
       elsif Conglomerate::Array === item
         serialize_array(item)
-      elsif Array === item
+      elsif ::Array === item
         serialize_array(item)
       elsif item.is_a?(Numeric) || item.is_a?(String) || item.nil?
         item
+      elsif item.respond_to?(:to_s)
+        case item
+        when DateTime
+          item.to_time.utc.iso8601.sub(/\+00:00$/, "Z")
+        when Time
+          item.utc.iso8601.sub(/\+00:00$/, "Z")
+        when Date
+          item.strftime("%Y-%m-%d")
+        else
+          item
+        end
       end
     end
 
@@ -26,7 +37,7 @@ module Conglomerate
       attributes.inject({}) do |hash, (attr, attr_metadata)|
         hash.tap do |h|
           attribute = particle.send(attr)
-          attribute ||= attr_metadata[:default]
+          attribute = attr_metadata[:default] if attribute == nil
 
           unless attr_metadata[:cull] && cull_attribute(attribute)
             h[attr.to_s] = serialize(attribute)
@@ -42,7 +53,7 @@ module Conglomerate
     end
 
     def cull_attribute(attribute)
-      !attribute || (Conglomerate::Array === attribute && attribute.empty?)
+      (attribute == nil) || (Conglomerate::Array === attribute && attribute.empty?)
     end
   end
 end

data/lib/conglomerate/version.rb

@@ -1,3 +1,3 @@
 module Conglomerate
-  VERSION = "0.10.0"
+  VERSION = "0.11.0"
 end

data/spec/command_ext_spec.rb

@@ -0,0 +1,56 @@
+require_relative "spec_helper"
+require_relative "../lib/conglomerate"
+require_relative "../lib/conglomerate/ext/commands"
+
+class CommandExtTestSerializer
+  include Conglomerate::RootBuilder.serializer
+
+  collection do
+    command :populate do
+      prompt { "test 123" }
+      href { populate_items_url }
+      datum :id
+    end
+  end
+end
+
+describe "Conglomerate Command Ext" do
+  let(:object) do
+    double(
+      "Object",
+      :id => 1
+    )
+  end
+
+  let(:context) do
+    double(
+      "Context",
+      :populate_items_url => "https://example.com/items/populate"
+    )
+  end
+
+  let(:test_serializer) do
+    CommandExtTestSerializer.new(object, :context => context).serialize
+  end
+
+  let(:test_collection) do
+    test_serializer["collection"]
+  end
+
+  context "#command" do
+    it "adds a command template to the collection" do
+      expect(test_collection["commands"]).to match_array(
+        [
+          {
+            "href" => "https://example.com/items/populate",
+            "rel" => "populate",
+            "prompt" => "test 123",
+            "data" => [
+              {"name" => "id", "value" => nil}
+            ]
+          }
+        ]
+      )
+    end
+  end
+end

data/spec/particle_builder_spec.rb

@@ -0,0 +1,249 @@
+require_relative "spec_helper"
+require_relative "../lib/conglomerate"
+
+class ConglomerateTestParticleSerializer
+  include Conglomerate::RootBuilder.serializer
+
+  collection do
+    href { test_url }
+
+    item "RSpec::Mocks::Double" do |item|
+      href { item_url(item.id) }
+
+      datum :description, :prompt => "awesome"
+      datum :id
+      datum :event_id
+      datum :roster_id
+      datum :team_ids
+
+      datum :event_date_time
+      datum :event_date
+      datum :event_time
+
+      datum :is_available
+
+      link :event, :href => Proc.new{ event_url(item.event_id) }
+      link :roster, :href => Proc.new{ roster_url(item.roster_id) }, :if => Proc.new{ item.roster_id }
+      link :teams, :href => Proc.new{ team_url(item.team_ids.join(",")) }
+      link :users, :href => Proc.new{ users_search_url(:object_id => item.id) }
+    end
+
+    link :events, :href => Proc.new { events_url }
+    query :search, :href => Proc.new { search_items_url } do
+      datum :id
+    end
+
+    template do
+      datum :repeats, :prompt => "true|false"
+      datum :description, :prompt => "awesome"
+    end
+  end
+end
+
+class ConglomerateExtraTestParticleSerializer
+  include Conglomerate::RootBuilder.serializer
+
+  collection do
+    item do
+      datum :id
+    end
+  end
+end
+
+class ConglomerateNullParticleSerializer
+  include Conglomerate::RootBuilder.serializer
+
+  collection do
+  end
+end
+
+describe Conglomerate do
+  let(:object) do
+    double(
+      "Object",
+      :id => 1,
+      :description => "Tasty Burgers",
+      :event_date_time => DateTime.parse("1981-11-28T10:00:00+00:00"),
+      :event_date => Date.parse("1981-11-28"),
+      :event_time => Time.parse("1981-11-28T10:00:00+00:00"),
+      :event_id => 2,
+      :roster_id => nil,
+      :team_ids => [1,2],
+      :user_ids => [],
+      :is_available => false
+    )
+  end
+
+  let(:context) do
+    request = double("Request", :original_url => "https://example.com/items")
+    double(
+      "Context",
+      :request => request,
+      :search_items_url => "https://example.com/items/search",
+      :populate_items_url => "https://example.com/items/populate",
+    ).tap do |context|
+      allow(context).to receive(:item_url).with(1) {
+        "https://example.com/items/1"
+      }
+      allow(context).to receive(:event_url).with(2) {
+        "https://example.com/events/2"
+      }
+      allow(context).to receive(:events_url) {
+        "https://example.com/events"
+      }
+      allow(context).to receive(:team_url).with("1,2") {
+        "https://example.com/teams/1,2"
+      }
+      allow(context).to receive(:test_url) { "abc" }
+      allow(context).to receive(:users_search_url).with(:object_id => 1) {
+        "def"
+      }
+    end
+  end
+
+  let(:test_serializer) do
+    ConglomerateTestParticleSerializer.new(object, :context => context).serialize
+  end
+
+  let(:extra_test_serializer) do
+    ConglomerateExtraTestParticleSerializer.new(object, :context => context).serialize
+  end
+
+  let(:null_serializer) do
+    ConglomerateNullParticleSerializer.new(object, :context => context).serialize
+  end
+
+  let(:test_collection) { test_serializer["collection"] }
+
+  let(:extra_test_collection) { extra_test_serializer["collection"] }
+
+  let(:null_collection) { null_serializer["collection"] }
+
+  describe "#version" do
+    it "sets version to 1.0" do
+      expect(null_collection["version"]).to eq("1.0")
+      expect(test_collection["version"]).to eq("1.0")
+    end
+  end
+
+  describe "#href" do
+    it "in context, uses the block to set the collection href" do
+      expect(test_collection["href"]).to eq("abc")
+    end
+
+    it "isn't included if the href is nil" do
+      expect(null_collection["href"]).to be_nil
+    end
+  end
+
+  describe "#query" do
+    it "doesn't include any query templates if none are provided" do
+      expect(null_collection.keys).to_not include("queries")
+    end
+
+    it "adds a query template to the collection" do
+      expect(test_collection["queries"]).to match_array(
+        [
+          {
+            "href" => "https://example.com/items/search",
+            "rel" => "search",
+            "data" => [
+              {"name" => "id", "value" => nil}
+            ]
+          }
+        ]
+      )
+    end
+  end
+
+  describe "#attribute(s)" do
+    context "items" do
+      it "skips items if there are no attributes" do
+        expect(null_collection.keys).to_not include("items")
+      end
+
+      it "doesn't have an items array if items is empty" do
+        test_serializer = ConglomerateTestParticleSerializer
+        .new(nil, :context => context)
+        .serialize
+        test_collection = test_serializer["collection"]
+        expect(test_collection.keys).to_not include("items")
+      end
+
+      it "includes an items array if attributes and objects present" do
+        expect(test_collection["items"]).to eq(
+          [
+            {
+              "href" => "https://example.com/items/1",
+              "data" => [
+                {"name" => "description", "value" => "Tasty Burgers", "prompt" => "awesome"},
+                {"name" => "id", "value" => 1},
+                {"name" => "event_id", "value" => 2},
+                {"name" => "roster_id", "value" => nil},
+                {"name" => "team_ids", "value" => [1,2]},
+                {"name" => "event_date_time", "value" => "1981-11-28T10:00:00Z"},
+                {"name" => "event_date", "value" => "1981-11-28"},
+                {"name" => "event_time", "value" => "1981-11-28T10:00:00Z"},
+                {"name" => "is_available", "value" => false}
+              ],
+              "links" => [
+                {"rel" => "event", "href" => "https://example.com/events/2"},
+                {"rel" => "teams", "href" => "https://example.com/teams/1,2"},
+                {"rel" => "users", "href" => "def"}
+              ]
+            }
+          ]
+        )
+      end
+
+      it "doesn't include links if there are none" do
+        expect(extra_test_collection["items"]).to eq(
+          [
+            {
+              "data" => [
+                {"name" => "id", "value" => 1}
+              ]
+            }
+          ]
+        )
+      end
+    end
+
+    context "template" do
+      it "skips template if there are no attributes for a template" do
+        expect(null_collection.keys).to_not include("template")
+      end
+
+      it "includes a valid template if attributes have them" do
+        expect(test_collection["template"]["data"]).to match_array(
+          [
+            {"name" => "description", "value" => nil, "prompt" => "awesome"},
+            {"name" => "repeats", "value" => nil, "prompt" => "true|false"}
+          ]
+        )
+      end
+    end
+  end
+
+  describe "#link" do
+    it "skips links if there are none present" do
+      expect(null_collection.keys).to_not include("links")
+    end
+
+    it "adds links if they are present" do
+      expect(test_collection["links"]).to match_array(
+        [
+          {"rel" => "events", "href" => "https://example.com/events"}
+        ]
+      )
+    end
+  end
+
+  describe "#item_link" do
+    it "adds links if they are present" do
+      expect(test_collection["items"][0]["links"]).to include(
+        {"rel" => "teams", "href" => "https://example.com/teams/1,2"}
+      )
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: conglomerate
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Shane Emmons
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-06-03 00:00:00.000000000 Z
+date: 2014-06-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -68,25 +68,39 @@ files:
 - conglomerate.gemspec
 - lib/conglomerate.rb
 - lib/conglomerate/array.rb
+- lib/conglomerate/builder_call.rb
+- lib/conglomerate/builder_serializer.rb
 - lib/conglomerate/collection.rb
+- lib/conglomerate/collection_builder.rb
 - lib/conglomerate/command.rb
 - lib/conglomerate/datum.rb
+- lib/conglomerate/datum_builder.rb
 - lib/conglomerate/error.rb
+- lib/conglomerate/ext/commands.rb
 - lib/conglomerate/item.rb
+- lib/conglomerate/item_builder.rb
 - lib/conglomerate/link.rb
+- lib/conglomerate/link_builder.rb
+- lib/conglomerate/mixin_ivar_helper.rb
 - lib/conglomerate/particle.rb
+- lib/conglomerate/particle_builder.rb
 - lib/conglomerate/query.rb
+- lib/conglomerate/query_builder.rb
 - lib/conglomerate/root.rb
+- lib/conglomerate/root_builder.rb
 - lib/conglomerate/serializer.rb
 - lib/conglomerate/template.rb
+- lib/conglomerate/template_builder.rb
 - lib/conglomerate/tree_deserializer.rb
 - lib/conglomerate/tree_serializer.rb
 - lib/conglomerate/version.rb
 - spec/collection_spec.rb
+- spec/command_ext_spec.rb
 - spec/command_spec.rb
 - spec/conglomerate_spec.rb
 - spec/datum_spec.rb
 - spec/link_spec.rb
+- spec/particle_builder_spec.rb
 - spec/particle_spec.rb
 - spec/query_spec.rb
 - spec/spec_helper.rb
@@ -117,10 +131,12 @@ specification_version: 4
 summary: A library to serialize Ruby objects into collection+json
 test_files:
 - spec/collection_spec.rb
+- spec/command_ext_spec.rb
 - spec/command_spec.rb
 - spec/conglomerate_spec.rb
 - spec/datum_spec.rb
 - spec/link_spec.rb
+- spec/particle_builder_spec.rb
 - spec/particle_spec.rb
 - spec/query_spec.rb
 - spec/spec_helper.rb