langalex-couch_potato 0.2.2 → 0.2.3

data/README.md

@@ -221,10 +221,12 @@ Couch Potato supports the usual lifecycle callbacks known from ActiveRecord:
       include CouchPotato::Persistence
     
       before_create :do_something_before_create
-      after_update :do_something_else
+      before_update {|user, db| user.do_something_on_update}
     end
 
-This will call the method do_something_before_create before creating an object and do_something_else after updating one. Supported callbacks are: :before_validation_on_create, :before_validation_on_update, :before_validation_on_save, :before_create, :after_create, :before_update, :after_update, :before_save, :after_save, :before_destroy, :after_destroy. You can also pass a Proc instead of a method name.
+This will call the method do_something_before_create before creating an object and run the given lambda before updating one. Lambda callbacks get passed the model as their first argument. Optionally if a lambda declares two arguments it also gets passed the database object. This is useful for creating other objects or querying views. Method callbacks don't receive any arguments by default but will get passed the database if they declare an argument.
+
+Supported callbacks are: :before_validation_on_create, :before_validation_on_update, :before_validation_on_save, :before_create, :after_create, :before_update, :after_update, :before_save, :after_save, :before_destroy, :after_destroy.
 
 #### Testing  
 

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
 :major: 0
 :minor: 2
-:patch: 2
+:patch: 3

data/lib/couch_potato/database.rb

@@ -5,6 +5,11 @@ module CouchPotato
   
     def initialize(couchrest_database)
       @database = couchrest_database
+      begin
+        couchrest_database.info 
+      rescue RestClient::ResourceNotFound
+        raise "Database '#{couchrest_database.name}' does not exist."
+      end
     end
     
     def view(spec)
@@ -30,16 +35,17 @@ module CouchPotato
     alias_method :save!, :save_document!
   
     def destroy_document(document)
-      document.run_callbacks(:before_destroy)
+      document.run_callbacks :before_destroy, self
       document._deleted = true
       database.delete_doc document.to_hash
-      document.run_callbacks(:after_destroy)
+      document.run_callbacks :after_destroy, self
       document._id = nil
       document._rev = nil
     end
     alias_method :destroy, :destroy_document
   
     def load_document(id)
+      raise "Can't load a document without an id (got nil)" if id.nil?
       begin
         json = database.get(id)
         Class.const_get(json['ruby_class']).json_create json
@@ -56,29 +62,29 @@ module CouchPotato
     private
   
     def create_document(document)
-      document.run_callbacks :before_validation_on_save
-      document.run_callbacks :before_validation_on_create
+      document.run_callbacks :before_validation_on_save, self
+      document.run_callbacks :before_validation_on_create, self
       return unless document.valid?
-      document.run_callbacks :before_save
-      document.run_callbacks :before_create
+      document.run_callbacks :before_save, self
+      document.run_callbacks :before_create, self
       res = database.save_doc document.to_hash
       document._rev = res['rev']
       document._id = res['id']
-      document.run_callbacks :after_save
-      document.run_callbacks :after_create
+      document.run_callbacks :after_save, self
+      document.run_callbacks :after_create, self
       true
     end
   
     def update_document(document)
-      document.run_callbacks(:before_validation_on_save)
-      document.run_callbacks(:before_validation_on_update)
+      document.run_callbacks :before_validation_on_save, self
+      document.run_callbacks :before_validation_on_update, self
       return unless document.valid?
-      document.run_callbacks :before_save
-      document.run_callbacks :before_update
+      document.run_callbacks :before_save, self
+      document.run_callbacks :before_update, self
       res = database.save_doc document.to_hash
       document._rev = res['rev']
-      document.run_callbacks :after_save
-      document.run_callbacks :after_update
+      document.run_callbacks :after_save, self
+      document.run_callbacks :after_update, self
       true
     end
   

data/lib/couch_potato/persistence/belongs_to_property.rb

@@ -1,6 +1,6 @@
 module CouchPotato
   module Persistence
-    class BelongsToProperty
+    class BelongsToProperty #:nodoc:
       attr_accessor :name
       
       def initialize(owner_clazz, name, options = {})

data/lib/couch_potato/persistence/callbacks.rb

@@ -1,6 +1,49 @@
 module CouchPotato
   module Persistence
     module Callbacks
+      
+      class Callback #:nodoc:
+        def initialize(model, name, database)
+          @model, @name, @database = model, name, database
+        end
+        
+        def run
+          if @name.is_a?(Symbol)
+            run_method_callback @name
+          elsif @name.is_a?(Proc)
+            run_lambda_callback @name
+          else
+            raise "Don't know how to handle callback of type #{name.class.name}"
+          end
+        end
+        
+        private
+        
+        def run_method_callback(name)
+          if callback_method(name).arity == 0
+            @model.send name
+          elsif callback_method(name).arity == 1
+            @model.send name, @database
+          else
+            raise "Don't know how to handle method callback with #{callback_method(name).arity} arguments"
+          end
+        end
+        
+        def callback_method(name)
+          @model.method(name)
+        end
+
+        def run_lambda_callback(lambda)
+          if lambda.arity == 1
+            lambda.call @model
+          elsif lambda.arity == 2
+            lambda.call @model, @database
+          else raise "Don't know how to handle lambda callback with #{lambda.arity} arguments"
+          end
+        end
+        
+      end
+      
       def self.included(base)
         base.extend ClassMethods
         
@@ -17,89 +60,34 @@ module CouchPotato
         end
       end
       
-      def run_callbacks(name)
+      # Runs all callbacks on a model with the given name, i.g. :after_create.
+      # 
+      # This method is called by the CouchPotato::Database object when saving/destroying an object 
+      def run_callbacks(name, database)
         return if skip_callbacks
         self.class.callbacks[name].uniq.each do |callback|
-          run_callback callback
-        end
-      end
-      
-      private
-      
-      def run_callback(name)
-        if name.is_a?(Symbol)
-          self.send name
-        elsif name.is_a?(Proc)
-          name.call self
-        else
-          raise "Don't know how to handle callback of type #{name.class.name}"
+          Callback.new(self, callback, database).run
         end
       end
       
       module ClassMethods
-        def before_validation_on_create(*names)
-          names.each do |name|
-            callbacks[:before_validation_on_create] << name
-          end
-        end
-        
-        def before_validation_on_update(*names)
-          names.each do |name|
-            callbacks[:before_validation_on_update] << name
-          end
-        end
-        
-        def before_validation_on_save(*names)
-          names.each do |name|
-            callbacks[:before_validation_on_save] << name
-          end
-        end
-        
-        def before_create(*names)
-          names.each do |name|
-            callbacks[:before_create] << name
-          end
-        end
-        
-        def before_save(*names)
-          names.each do |name|
-            callbacks[:before_save] << name
-          end
-        end
-        
-        def before_update(*names)
-          names.each do |name|
-            callbacks[:before_update] << name
-          end
-        end
-        
-        def before_destroy(*names)
-          names.each do |name|
-            callbacks[:before_destroy] << name
-          end
-        end
-
-        def after_update(*names)
-          names.each do |name|
-            callbacks[:after_update] << name
-          end
-        end
-        
-        def after_save(*names)
-          names.each do |name|
-            callbacks[:after_save] << name
-          end
-        end
-        
-        def after_create(*names)
-          names.each do |name|
-            callbacks[:after_create] << name
-          end
-        end
-
-        def after_destroy(*names)
-          names.each do |name|
-            callbacks[:after_destroy] << name
+        [
+          :before_validation_on_create,
+          :before_validation_on_update,
+          :before_validation_on_save,
+          :before_create,
+          :before_save,
+          :before_update,
+          :before_destroy,
+          :after_update,
+          :after_save,
+          :after_create,
+          :after_destroy
+        ].each do |callback|
+          define_method callback do |*names|
+            names.each do |name|
+              callbacks[callback] << name
+            end
           end
         end
       end

data/lib/couch_potato/persistence/dirty_attributes.rb

@@ -8,7 +8,8 @@ module CouchPotato
         end
       end
       
-      def dirty?
+      # returns true if a model has dirty attributes, i.e. their value has changed since the last save
+      def dirty? 
         new? || self.class.properties.inject(false) do |res, property|
           res || property.dirty?(self)
         end

data/lib/couch_potato/persistence/json.rb

@@ -5,10 +5,12 @@ module CouchPotato
         base.extend ClassMethods
       end
       
+      # returns a JSON representation of a model in order to store it in CouchDB
       def to_json(*args)
         to_hash.to_json(*args)
       end
       
+      # returns all the attributes, the ruby class and the _id and _rev of a model as a Hash
       def to_hash
         (self.class.properties).inject({}) do |props, property|
           property.serialize(props, self)
@@ -26,6 +28,8 @@ module CouchPotato
       end
       
       module ClassMethods
+        
+        # creates a model instance from JSON
         def json_create(json)
           instance = self.new
           instance._id = json[:_id] || json['_id']

data/lib/couch_potato/persistence/magic_timestamps.rb

@@ -1,5 +1,5 @@
 module CouchPotato
-  module MagicTimestamps
+  module MagicTimestamps #:nodoc:
     def self.included(base)
       base.instance_eval do
         property :created_at, :type => Time

data/lib/couch_potato/persistence/properties.rb

@@ -15,11 +15,19 @@ module CouchPotato
       end
       
       module ClassMethods
+        # returns all the property names of a model class that have been defined using the #property method
+        #
+        # example:
+        #  class Book
+        #    property :title
+        #    property :year
+        #  end
+        #  Book.property_names # => [:title, :year]
         def property_names
           properties.map(&:name)
         end
         
-        def json_create(json)
+        def json_create(json) #:nodoc:
           instance = super
           instance.attributes.each do |name, value|
             instance.instance_variable_set("@#{name}_was", value)
@@ -27,12 +35,20 @@ module CouchPotato
           instance
         end
         
+        # Declare a proprty on a model class. properties are not typed by default. You can use any of the basic types by JSON (String, Integer, Fixnum, Array, Hash). If you want a property to be of a custom class you have to define it using the :class option.
+        #
+        # example:
+        #  class Book
+        #    property :title
+        #    property :year
+        #    property :publisher, :class => Publisher
+        #  end
         def property(name, options = {})
           clazz = options.delete(:class)
           properties << (clazz || SimpleProperty).new(self, name, options)
         end
 
-        def belongs_to(name)
+        def belongs_to(name) #:nodoc:
           property name, :class => BelongsToProperty
         end
 

data/lib/couch_potato/persistence/simple_property.rb

@@ -1,6 +1,6 @@
 module CouchPotato
   module Persistence
-    class SimpleProperty
+    class SimpleProperty  #:nodoc:
       attr_accessor :name, :type
       
       def initialize(owner_clazz, name, options = {})

data/lib/couch_potato/persistence.rb

@@ -21,19 +21,52 @@ module CouchPotato
         alias_method :id, :_id
       end
     end
-    
+
+    # initialize a new instance of the model optionally passing it a hash of attributes.
+    # the attributes have to be declared using the #property method
+    # 
+    # example: 
+    #   class Book
+    #     include CouchPotato::Persistence
+    #     property :title
+    #   end
+    #   book = Book.new :title => 'Time to Relax'
+    #   book.title # => 'Time to Relax'
     def initialize(attributes = {})
       attributes.each do |name, value|
         self.send("#{name}=", value)
       end if attributes
     end
     
+    # assign multiple attributes at once.
+    # the attributes have to be declared using the #property method
+    #
+    # example:
+    #   class Book
+    #     include CouchPotato::Persistence
+    #     property :title
+    #     property :year
+    #   end
+    #   book = Book.new
+    #   book.attributes = {:title => 'Time to Relax', :year => 2009}
+    #   book.title # => 'Time to Relax'
+    #   book.year # => 2009
     def attributes=(hash)
       hash.each do |attribute, value|
         self.send "#{attribute}=", value
       end
     end
     
+    # returns all of a model's attributes that have been defined using the #property method as a Hash
+    #
+    # example:
+    #   class Book
+    #     include CouchPotato::Persistence
+    #     property :title
+    #     property :year
+    #   end
+    #   book = Book.new :year => 2009
+    #   book.attributes # => {:title => nil, :year => 2009}
     def attributes
       self.class.properties.inject({}) do |res, property|
         property.serialize(res, self)
@@ -41,15 +74,19 @@ module CouchPotato
       end
     end
     
+    # returns true if a  model hasn't been saved yet, false otherwise
     def new?
       _rev.nil?
     end
     
+    # returns the document id
+    # this is used by rails to construct URLs
+    # can be overridden to for example use slugs for URLs instead if ids
     def to_param
       _id
     end
     
-    def ==(other)
+    def ==(other) #:nodoc:
       other.class == self.class && self.to_json == other.to_json
     end
     

data/lib/couch_potato/view/custom_view_spec.rb

@@ -1,8 +1,9 @@
 module CouchPotato
   module View
     # a view for custom map/reduce functions that still returns model instances
-    # example: view :my_custom_view, :map => "function(doc) { emit(doc._id, null); }", :include_docs => true, :type => :custom, :reduce => nil
-    
+    #
+    # example:
+    #   view :my_custom_view, :map => "function(doc) { emit(doc._id, null); }", :include_docs => true, :type => :custom, :reduce => nil
     class CustomViewSpec < BaseViewSpec
       def map_function
         options[:map]

data/lib/couch_potato/view/custom_views.rb

@@ -14,8 +14,7 @@ module CouchPotato
       end
       
       module ClassMethods
-        
-        # declare a couchdb view, for examples on how to use see the *ViewSpec classes in CouchPotato::View
+        # Declare a CouchDB view, for examples on how to use see the *ViewSpec classes in CouchPotato::View
         def view(view_name, options)
           self.class.instance_eval do
             define_method view_name do |view_parameters = {}|

data/lib/couch_potato/view/model_view_spec.rb

@@ -1,7 +1,9 @@
 module CouchPotato
   module View
-    # a view to return model instances by searching its properties
-    # example: view :my_view, :key => :name
+    # A view to return model instances by searching its properties
+    #
+    # example:
+    #   view :my_view, :key => :name
     class ModelViewSpec < BaseViewSpec
       
       def view_parameters

data/lib/couch_potato/view/properties_view_spec.rb

@@ -1,7 +1,9 @@
 module CouchPotato
   module View
-    # a view to return model instances with only some properties poulated by searching its properties, e.g. for very large documents where you are only interested in some of their data
-    # example: view :my_view, :key => :name, :properties => [:name, :author], :type => :properties
+    # A view to return model instances with only some properties poulated by searching its properties, e.g. for very large documents where you are only interested in some of their data
+    #
+    # example:
+    #   view :my_view, :key => :name, :properties => [:name, :author], :type => :properties
     class PropertiesViewSpec < ModelViewSpec
       def map_function
         "function(doc) {

data/lib/couch_potato/view/raw_view_spec.rb

@@ -1,9 +1,13 @@
 module CouchPotato
-  # a view for custom map/reduce functions that returns the raw data fromcouchdb
-  # example: view :my_custom_view, :map => "function(doc) { emit(doc._id, null); }", :type => :raw, :reduce => nil
-  # optionally you can pass in a results filter which you can use to process the raw couchdb results before returning them
-  # example: view :my_custom_view, :map => "function(doc) { emit(doc._id, null); }", :type => :raw, :results_filter => lambda{|results| results['rows].map{|row| row['value']}}
   module View
+    # A view for custom map/reduce functions that returns the raw data fromcouchdb
+    #
+    # example:
+    #   view :my_custom_view, :map => "function(doc) { emit(doc._id, null); }", :type => :raw, :reduce => nil
+    # optionally you can pass in a results filter which you can use to process the raw couchdb results before returning them
+    #
+    # example:
+    #   view :my_custom_view, :map => "function(doc) { emit(doc._id, null); }", :type => :raw, :results_filter => lambda{|results| results['rows].map{|row| row['value']}}
     class RawViewSpec < BaseViewSpec
       def map_function
         options[:map]

data/lib/couch_potato/view/view_query.rb

@@ -1,6 +1,6 @@
 module CouchPotato
   module View
-
+    # Used to query views (and create them if they don't exist). Usually you won't have to use this class directly. Instead it is used internally by the CouchPotato::Database.view method.
     class ViewQuery
       def initialize(couchrest_database, design_document_name, view_name, map_function, reduce_function = nil)
         @database = couchrest_database
@@ -38,7 +38,6 @@ module CouchPotato
       def view_url
         "#{@design_document_name}/#{@view_name}"
       end
-      
 
     end
   end

data/lib/couch_potato.rb

@@ -11,14 +11,18 @@ require 'validatable'
 module CouchPotato
   Config = OpenStruct.new
   
+  # Returns a database instance which you can then use to create objects and query views. You have to set the CouchPotato::Config.database_name before this works.
   def self.database
     @@__database ||= Database.new(self.couchrest_database)
   end
   
+  # Returns the underlying CouchRest database object if you want low level access to your CouchDB. You have to set the CouchPotato::Config.database_name before this works.
   def self.couchrest_database
     @@__couchrest_database ||= CouchRest.database(full_url_to_database)
   end
   
+  private
+  
   def self.full_url_to_database
     database_name = CouchPotato::Config.database_name || raise('No Database configured. Set CouchPotato::Config.database_name')
     url = database_name

data/spec/callbacks_spec.rb

@@ -20,13 +20,23 @@ class CallbackRecorder
     self.send callback, callback
   end
   
+  view :all, :key  => :required_property
+  
   attr_accessor :lambda_works
-  before_create lambda {|model| model.lambda_works = true}
+  before_create lambda {|model| model.lambda_works = true }
+  after_create lambda {|model, db| db.view CallbackRecorder.all}
+  before_update :method_callback_with_argument
   
   def callbacks
     @callbacks ||= []
   end
   
+  private
+  
+  def method_callback_with_argument(db)
+    db.view CallbackRecorder.all
+  end
+  
 end
 
 describe "multiple callbacks at once" do
@@ -59,7 +69,7 @@ describe 'create callbacks' do
   
   before(:each) do
     @recorder = CallbackRecorder.new
-    couchrest_database = stub 'couchrest_database', :save_doc => {'id' => '1', 'rev' => '2'}
+    couchrest_database = stub 'couchrest_database', :save_doc => {'id' => '1', 'rev' => '2'}, :view => {'rows' => []}, :info => nil
     @db = CouchPotato::Database.new(couchrest_database)
   end
   
@@ -139,7 +149,7 @@ describe "update callbacks" do
   before(:each) do
     @recorder = CallbackRecorder.new :required_property => 1
     
-    couchrest_database = stub 'couchrest_database', :save_doc => {'id' => '1', 'rev' => '2'}
+    couchrest_database = stub 'couchrest_database', :save_doc => {'id' => '1', 'rev' => '2'}, :view => {'rows' => []}, :info => nil
     @db = CouchPotato::Database.new(couchrest_database)
     @db.save_document! @recorder
     
@@ -218,7 +228,7 @@ describe "destroy callbacks" do
   
   before(:each) do
     @recorder = CallbackRecorder.new :required_property => 1
-    couchrest_database = stub 'couchrest_database', :save_doc => {'id' => '1', 'rev' => '2'}, :delete_doc => nil
+    couchrest_database = stub 'couchrest_database', :save_doc => {'id' => '1', 'rev' => '2'}, :delete_doc => nil, :view => {'rows' => []}, :info => nil
     @db = CouchPotato::Database.new(couchrest_database)
     @db.save_document! @recorder
     
@@ -236,10 +246,26 @@ describe "destroy callbacks" do
   end
 end
 
+describe "method callbacks" do
+  it "should pass the database to a method with arity 1" do
+    recorder = CallbackRecorder.new
+    db = stub 'db'
+    db.should_receive(:view)
+    recorder.run_callbacks :before_update, db
+  end
+end
+
 describe "lambda callbacks" do
   it "should run the lambda" do
     recorder = CallbackRecorder.new
-    recorder.run_callbacks :before_create
+    recorder.run_callbacks :before_create, stub('db')
     recorder.lambda_works.should be_true
   end
+  
+  it "should pass the database to a lambda with arity 2" do
+    recorder = CallbackRecorder.new
+    db = stub 'db'
+    db.should_receive(:view)
+    recorder.run_callbacks :after_create, db
+  end
 end

data/spec/unit/create_spec.rb

@@ -5,7 +5,7 @@ describe "create" do
   describe "succeeds" do
     before(:each) do
       @comment = Comment.new :title => 'my_title'
-      CouchPotato::Database.new(stub('database', :save_doc => {'rev' => '123', 'id' => '456'})).save_document!(@comment)
+      CouchPotato::Database.new(stub('database', :save_doc => {'rev' => '123', 'id' => '456'}, :info => nil)).save_document!(@comment)
     end
 
     it "should assign the id" do
@@ -28,7 +28,7 @@ describe "create" do
   describe "fails" do
     before(:each) do
       @comment = Comment.new
-      CouchPotato::Database.new(stub('database')).save_document(@comment)
+      CouchPotato::Database.new(stub('database', :info => nil)).save_document(@comment)
     end
 
     it "should not assign an id" do

data/spec/unit/database_spec.rb

@@ -0,0 +1,18 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe CouchPotato::Database, 'new' do
+  it "should raise an exception if the database doesn't exist" do
+    lambda {
+      CouchPotato::Database.new CouchRest.database('couch_potato_invalid')
+    }.should raise_error('Database \'couch_potato_invalid\' does not exist.')
+  end
+end
+
+describe CouchPotato::Database, 'load' do
+  it "should raise an exception if nil given" do
+    db = CouchPotato::Database.new(stub('couchrest db', :info => nil))
+    lambda {
+      db.load nil
+    }.should raise_error("Can't load a document without an id (got nil)")
+  end
+end

data/spec/unit/dirty_attributes_spec.rb

@@ -8,7 +8,7 @@ end
 
 describe 'dirty attribute tracking' do
   before(:each) do
-    @couchrest_db = stub('database', :save_doc => {'id' => '1', 'rev' => '2'})
+    @couchrest_db = stub('database', :save_doc => {'id' => '1', 'rev' => '2'}, :info => nil)
     @db = CouchPotato::Database.new(@couchrest_db)
   end
   
@@ -68,7 +68,7 @@ describe 'dirty attribute tracking' do
   
   describe "object loaded from database" do
     before(:each) do
-      couchrest_db = stub('database', :get => {'_id' => '1', '_rev' => '2', 'food' => 'sushi', 'ruby_class' => 'Plate'})
+      couchrest_db = stub('database', :get => {'_id' => '1', '_rev' => '2', 'food' => 'sushi', 'ruby_class' => 'Plate'}, :info => nil)
       @plate = CouchPotato::Database.new(couchrest_db).load_document '1'
     end
     
@@ -94,7 +94,7 @@ describe 'dirty attribute tracking' do
   
   describe "after save" do
     it "should reset all attributes to not dirty" do
-      couchrest_db = stub('database', :get => {'_id' => '1', '_rev' => '2', 'food' => 'sushi', 'ruby_class' => 'Plate'}, :save_doc => {})
+      couchrest_db = stub('database', :get => {'_id' => '1', '_rev' => '2', 'food' => 'sushi', 'ruby_class' => 'Plate'}, :info => nil, :save_doc => {})
       db = CouchPotato::Database.new(couchrest_db)
       @plate = db.load_document '1'
       @plate.food = 'burger'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: langalex-couch_potato
 version: !ruby/object:Gem::Version 
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors: 
 - Alexander Lang
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-05-05 00:00:00 -07:00
+date: 2009-05-18 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -65,7 +65,6 @@ files:
 - lib/couch_potato/persistence/belongs_to_property.rb
 - lib/couch_potato/persistence/callbacks.rb
 - lib/couch_potato/persistence/dirty_attributes.rb
-- lib/couch_potato/persistence/inline_collection.rb
 - lib/couch_potato/persistence/json.rb
 - lib/couch_potato/persistence/magic_timestamps.rb
 - lib/couch_potato/persistence/properties.rb
@@ -90,6 +89,7 @@ files:
 - spec/unit
 - spec/unit/attributes_spec.rb
 - spec/unit/create_spec.rb
+- spec/unit/database_spec.rb
 - spec/unit/dirty_attributes_spec.rb
 - spec/unit/string_spec.rb
 - spec/unit/view_query_spec.rb

data/lib/couch_potato/persistence/inline_collection.rb

@@ -1,14 +0,0 @@
-require File.dirname(__FILE__) + '/collection'
-
-module CouchPotato
-  module Persistence
-    class InlineCollection < Collection
-      
-      def to_json(*args)
-        @items.to_json(*args)
-      end
-      
-    end
-  end
-end
-