acfs 0.33.0 → 0.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1cc35ab459cc7cafb260bc23139c460efa0df1db
-  data.tar.gz: 23e6f2e80ea093ee6b7f7ea73ec1988d5d9f10a4
+  metadata.gz: 79f96815f2139c2a96c6c79a311904567483e720
+  data.tar.gz: 0dd9f4379210854cda16b5e6e70868c8201d093d
 SHA512:
-  metadata.gz: 943d5d5f24721cd8e706d959a9e91a7c96b68c927ad87891186f8a42c6295b5453ecdee2dbbb338fe0d8f40b46655ac4a3b2c73d6c460e80e265fe2a27aa9e87
-  data.tar.gz: e18da76fce520a89a42fb5a1f9bd3d7924648ffaf4535b4f05aa7616a20462a2abef95287ec6be12a704107e4647209de7760788968bb8530d54f834d77d87ce
+  metadata.gz: 4d39d8dcb64e34c8f9ed4962c417958f2de27a811a8caf039cec4ebf2c892fda5839fe17ebfef515e75eab8482bb13976a1c512ff938ef460e9cfd3a98b264ab
+  data.tar.gz: 0d054784e48f8c4e9fd7973fb3d8abaf333066960353d653fff930933b0ad041f8ae6d724eaccf8ec54ad37d98b727e8914ebf1b61053072c19368c6e27eff29

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.34.0
+
+* Add support for will_paginate view helper used with `Acfs::Collection`s
+* Add support for pagination header added by [paginate-responder](https://github.com/jgraichen/paginate-responder)
+* Improve `Resource#new?` detection by using `loaded?` instead of presence of `:id` attribute
+
 ## 0.33.0
 
 * Do not raise errors on unknown attributes by default, add :unknown option.

data/doc/file.README.html

@@ -389,7 +389,7 @@ Modified Headers, conflict detection, ...</li>
 </div></div>
 
     <div id="footer">
-  Generated on Thu Feb 27 23:15:46 2014 by
+  Generated on Fri Mar  7 20:03:40 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.1).
 </div>

data/lib/acfs/collection.rb

@@ -1,12 +1,14 @@
 require 'delegate'
 
 require 'acfs/model/loadable'
+require 'acfs/collections/paginatable'
 
 module Acfs
 
   class Collection < ::Delegator
     include Model::Loadable
     include Acfs::Util::Callbacks
+    include Collections::Paginatable
 
     def initialize
       super([])

data/lib/acfs/collections/paginatable.rb

@@ -0,0 +1,16 @@
+module Acfs::Collections
+  module Paginatable
+    def total_pages
+      @total_pages
+    end
+
+    def current_page
+      @current_page
+    end
+
+    def setup_pagination(params, header)
+      @current_page = Integer(params.fetch(:page, 1)) rescue params[:page]
+      @total_pages  = Integer(header['X-Total-Pages']) if header['X-Total-Pages']
+    end
+  end
+end

data/lib/acfs/model/persistence.rb

@@ -39,7 +39,7 @@ module Acfs
       # @return [Boolean] True if resource is newly created, false otherwise.
       #
       def new?
-        read_attribute(:id).nil?
+        !loaded?
       end
       alias :new_record? :new?
 

data/lib/acfs/model/query_methods.rb

@@ -75,10 +75,11 @@ module Acfs::Model
         collection = ::Acfs::Collection.new
         collection.__callbacks__ << block if block
 
-        operation :list, params: params do |data|
+        operation :list, params: params do |data, header|
           data.each do |obj|
             collection << create_resource(obj)
           end
+          collection.setup_pagination params, header
           collection.loaded!
           collection.__invoke__
         end
@@ -137,7 +138,7 @@ module Acfs::Model
         model = Acfs::Util::ResourceDelegator.new self.new
 
         opts[:params] ||= {}
-        opts[:params].merge!({ id: id })
+        opts[:params].merge!({ id: id }) unless id.nil?
 
         model.__callbacks__ << block unless block.nil?
 

data/lib/acfs/operation.rb

@@ -50,7 +50,7 @@ module Acfs
       request = ::Acfs::Request.new url, method: method, params: params, data: data
       request.on_complete do |response|
         handle_failure response unless response.success?
-        callback.call response.data
+        callback.call response.data, response.headers
       end
       request
     end

data/lib/acfs/parameter_decoder.rb

@@ -0,0 +1,37 @@
+module Acfs::ParameterDecoder
+
+  module Functions
+    def self.deep_decode(hash)
+      return hash unless hash.is_a? Hash
+
+      hash.each_pair do |key, value|
+        if value.is_a? Hash
+          deep_decode(value)
+          hash[key] = decode_typhoeus_array(value)
+        end
+      end
+    end
+
+    def self.decode_typhoeus_array(hash)
+      if typhoeus_encoded? hash
+        hash.inject([]) do |memo, (key, val)|
+          memo[Integer(key)] = val
+          memo
+        end
+      else
+        hash
+      end
+    end
+
+    def self.typhoeus_encoded?(hash)
+      return false if hash.empty?
+      self.keys.sort == (0...hash.keys.size).map { |i| i.to_s }
+    end
+  end
+
+  def self.included(base)
+    base.send :before_filter do
+      Functions.deep_decode params
+    end
+  end
+end

data/lib/acfs/singleton_resource.rb

@@ -72,16 +72,7 @@ module Acfs
       #   @return [ self ] Resource object.
       #
       def find(*attrs, &block)
-        opts = { params: attrs.extract_options! }
-
-        model = Util::ResourceDelegator.new self.new
-
-        operation :read, opts do |data|
-          model.__setobj__ create_resource data, origin: model.__getobj__
-          block.call model unless block.nil?
-        end
-
-        model
+        find_single nil, params: attrs.extract_options!, &block
       end
 
       # @api public

data/lib/acfs/stub.rb

@@ -47,7 +47,8 @@ module Acfs
       if (err = opts[:raise])
         raise_error op, err, opts[:return]
       elsif (data = opts[:return])
-        op.call data
+        headers = opts[:headers] || {}
+        op.call data, headers
       else
         raise ArgumentError, 'Unsupported stub.'
       end

data/lib/acfs/version.rb

@@ -1,7 +1,7 @@
 module Acfs
   module VERSION
     MAJOR = 0
-    MINOR = 33
+    MINOR = 34
     PATCH = 0
     STAGE = nil
 

data/spec/acfs/collection_spec.rb

@@ -0,0 +1,42 @@
+require 'spec_helper'
+
+describe Acfs::Collection do
+  describe 'Pagination' do
+    let(:params) { Hash.new }
+    let!(:collection) { MyUser.all params }
+
+    subject { Acfs.run; collection }
+
+    context 'without explicit page parameter' do
+      before do
+        stub_request(:get, 'http://users.example.org/users').to_return response([{id: 1, name: 'Anon', age: 12, born_at: 'Berlin'}],
+                                                                                headers: {'X-Total-Pages' => '2'})
+      end
+
+      its(:total_pages) { should eq 2 }
+      its(:current_page) { should eq 1 }
+    end
+
+    context 'with page parameter' do
+      let(:params) { {page: 2} }
+      before do
+        stub_request(:get, 'http://users.example.org/users?page=2').to_return response([{id: 1, name: 'Anon', age: 12, born_at: 'Berlin'}],
+                                                                                       headers: {'X-Total-Pages' => '2'})
+      end
+
+      its(:total_pages) { should eq 2 }
+      its(:current_page) { should eq 2 }
+    end
+
+    context 'with non-numerical page parameter' do
+      let(:params) { {page: 'e546f5'} }
+      before do
+        stub_request(:get, 'http://users.example.org/users?page=e546f5').to_return response([{id: 1, name: 'Anon', age: 12, born_at: 'Berlin'}],
+                                                                                       headers: {'X-Total-Pages' => '2'})
+      end
+
+      its(:total_pages) { should eq 2 }
+      its(:current_page) { should eq 'e546f5' }
+    end
+  end
+end

data/spec/acfs/model/query_methods_spec.rb

@@ -8,43 +8,18 @@ describe Acfs::Model::QueryMethods do
       context 'with successful response' do
         before do
           stub_request(:get, 'http://users.example.org/users/1').to_return response({id: 1, name: 'Anon', age: 12, born_at: 'Berlin'})
-          stub_request(:get, 'http://users.example.org/users/2').to_return response({id: 2, type: 'Customer', name: 'Clare Customer', age: 24 })
+          stub_request(:get, 'http://users.example.org/users/2').to_return response({id: 2, type: 'Customer', name: 'Clare Customer', age: 24})
         end
 
+        let(:action) { lambda { |cb=nil| model.find 1, &cb } }
+        it_behaves_like 'a query method with multi-callback support'
+
         it 'should load a single remote resource' do
-          user = model.find 1
+          user = action.call
           Acfs.run
 
           expect(user.attributes).to eq(
-            {id: 1, name: 'Anon', age: 12, born_at: 'Berlin'}.stringify_keys)
-        end
-
-        it 'should invoke callback after model is loaded' do
-          proc = Proc.new { }
-          expect(proc).to receive(:call) do |user|
-            expect(user).to equal @user
-            expect(user).to be_loaded
-          end
-
-          @user = model.find 1, &proc
-          Acfs.run
-        end
-
-        it 'should invoke multiple callback after model is loaded' do
-          proc1 = Proc.new { }
-          proc2 = Proc.new { }
-          expect(proc1).to receive(:call) do |user|
-            expect(user).to equal @user
-            expect(user).to be_loaded
-          end
-          expect(proc2).to receive(:call) do |user|
-            expect(user).to equal @user
-            expect(user).to be_loaded
-          end
-
-          @user = model.find 1, &proc1
-          Acfs.add_callback(@user, &proc2)
-          Acfs.run
+                                         {id: 1, name: 'Anon', age: 12, born_at: 'Berlin'}.stringify_keys)
         end
 
         context 'with resource type inheritance' do
@@ -65,7 +40,7 @@ describe Acfs::Model::QueryMethods do
 
       context 'with 404 response' do
         before do
-          stub_request(:get, 'http://users.example.org/users/1').to_return response({ error: 'not found' }, status: 404)
+          stub_request(:get, 'http://users.example.org/users/1').to_return response({error: 'not found'}, status: 404)
         end
 
         it 'should raise a NotFound error' do
@@ -94,10 +69,10 @@ describe Acfs::Model::QueryMethods do
 
     context 'with multiple ids' do
       before do
-        stub_request(:get, 'http://users.example.org/users/1').to_return response({ id: 1, name: 'Anon', age: 12 })
-        stub_request(:get, 'http://users.example.org/users/2').to_return response({ id: 2, name: 'Johnny', age: 42 })
-        stub_request(:get, 'http://users.example.org/users/3').to_return response({ id: 3, type: 'Customer', name: 'Anon', age: 12 })
-        stub_request(:get, 'http://users.example.org/users/4').to_return response({ id: 4, name: 'Johnny', age: 42 })
+        stub_request(:get, 'http://users.example.org/users/1').to_return response({id: 1, name: 'Anon', age: 12})
+        stub_request(:get, 'http://users.example.org/users/2').to_return response({id: 2, name: 'Johnny', age: 42})
+        stub_request(:get, 'http://users.example.org/users/3').to_return response({id: 3, type: 'Customer', name: 'Anon', age: 12})
+        stub_request(:get, 'http://users.example.org/users/4').to_return response({id: 4, name: 'Johnny', age: 42})
       end
 
       context 'with successful response' do
@@ -106,12 +81,12 @@ describe Acfs::Model::QueryMethods do
           Acfs.run
 
           expect(users.size).to be == 2
-          expect(users[0].attributes).to be == { id: 1, name: 'Anon', age: 12 }.stringify_keys
-          expect(users[1].attributes).to be == { id: 2, name: 'Johnny', age: 42 }.stringify_keys
+          expect(users[0].attributes).to be == {id: 1, name: 'Anon', age: 12}.stringify_keys
+          expect(users[1].attributes).to be == {id: 2, name: 'Johnny', age: 42}.stringify_keys
         end
 
         it 'should invoke callback after all models are loaded' do
-          proc = Proc.new { }
+          proc = Proc.new {}
           expect(proc).to receive(:call) do |users|
             expect(users).to be === @users
             expect(users.size).to be == 2
@@ -123,8 +98,8 @@ describe Acfs::Model::QueryMethods do
         end
 
         it 'should invoke multiple callback after all models are loaded' do
-          proc1 = Proc.new { }
-          proc2 = Proc.new { }
+          proc1 = Proc.new {}
+          proc2 = Proc.new {}
           expect(proc1).to receive(:call) do |users|
             expect(users).to be === @users
             expect(users.size).to be == 2
@@ -152,7 +127,7 @@ describe Acfs::Model::QueryMethods do
 
       context 'with one 404 response' do
         before do
-          stub_request(:get, 'http://users.example.org/users/1').to_return response({ error: 'not found' }, status: 404)
+          stub_request(:get, 'http://users.example.org/users/1').to_return response({error: 'not found'}, status: 404)
         end
 
         it 'should raise resource not found error' do
@@ -169,12 +144,12 @@ describe Acfs::Model::QueryMethods do
     let(:pc) { PC }
     let(:mac) { Mac }
     before do
-      stub_request(:get, 'http://computers.example.org/computers').to_return response([{ id: 1, type: 'PC' }, { id: 2, type: 'Computer' }, { id: 3, type: 'Mac' }])
+      stub_request(:get, 'http://computers.example.org/computers').to_return response([{id: 1, type: 'PC'}, {id: 2, type: 'Computer'}, {id: 3, type: 'Mac'}])
     end
 
     it 'should invoke multiple callback after all models are loaded' do
-      proc1 = Proc.new { }
-      proc2 = Proc.new { }
+      proc1 = Proc.new {}
+      proc2 = Proc.new {}
       expect(proc1).to receive(:call) do |computers|
         expect(computers).to be === @computers
         expect(computers.size).to be == 3
@@ -216,21 +191,21 @@ describe Acfs::Model::QueryMethods do
 
         context 'with another resource as type instead' do
           before do
-            stub_request(:get, 'http://computers.example.org/computers').to_return response([{ id: 1, type: 'MyUser' }, { id: 2, type: 'Computer' }, { id: 3, type: 'Mac' }])
+            stub_request(:get, 'http://computers.example.org/computers').to_return response([{id: 1, type: 'MyUser'}, {id: 2, type: 'Computer'}, {id: 3, type: 'Mac'}])
           end
           it_behaves_like 'with invalid type'
         end
 
         context 'with a random string as type instead' do
           before do
-            stub_request(:get, 'http://computers.example.org/computers').to_return response([{ id: 1, type: 'PC' }, { id: 2, type: 'noValidType' }, { id: 3, type: 'Mac' }])
+            stub_request(:get, 'http://computers.example.org/computers').to_return response([{id: 1, type: 'PC'}, {id: 2, type: 'noValidType'}, {id: 3, type: 'Mac'}])
           end
           it_behaves_like 'with invalid type'
         end
 
         context 'with a non-string as type instead' do
           before do
-            stub_request(:get, 'http://computers.example.org/computers').to_return response([{ id: 1, type: 'PC' }, { id: 2, type: 'Computer' }, { id: 3, type: 42 }])
+            stub_request(:get, 'http://computers.example.org/computers').to_return response([{id: 1, type: 'PC'}, {id: 2, type: 'Computer'}, {id: 3, type: 42}])
           end
           it_behaves_like 'with invalid type'
         end
@@ -264,7 +239,7 @@ describe Acfs::Model::QueryMethods do
         before { stub_request(:get, 'http://users.example.org/users?age=24').to_return response([{id: 1, name: 'Mike', age: 24}, {id: 4, type: 'Maria', age: 24}, {id: 7, type: 'James', age: 24}]) }
 
         it 'should invoke callback after model is loaded' do
-          proc = Proc.new { }
+          proc = Proc.new {}
 
           expect(proc).to receive(:call) do |user|
             expect(user).to eql @user.__getobj__
@@ -277,8 +252,8 @@ describe Acfs::Model::QueryMethods do
         end
 
         it 'should invoke multiple callbacks after model is loaded' do
-          proc1 = Proc.new { }
-          proc2 = Proc.new { }
+          proc1 = Proc.new {}
+          proc2 = Proc.new {}
 
           expect(proc1).to receive(:call) do |user|
             expect(user).to eql @user.__getobj__
@@ -307,7 +282,7 @@ describe Acfs::Model::QueryMethods do
       let(:model) { Single }
 
       it '.find_by should not be defined' do
-        expect{ model.find_by }.to raise_error NoMethodError
+        expect { model.find_by }.to raise_error NoMethodError
       end
     end
   end
@@ -317,7 +292,7 @@ describe Acfs::Model::QueryMethods do
     it_behaves_like 'find_by'
 
     context 'standard resource' do
-      let(:model){ MyUser }
+      let(:model) { MyUser }
       let!(:user) { model.send described_method, age: 24 }
       subject { Acfs.run; user }
 
@@ -327,7 +302,7 @@ describe Acfs::Model::QueryMethods do
         it { should be_nil }
 
         it 'should invoke callback after model is loaded' do
-          proc = Proc.new { }
+          proc = Proc.new {}
 
           expect(proc).to receive(:call) do |user|
             expect(user).to eql @user.__getobj__
@@ -339,8 +314,8 @@ describe Acfs::Model::QueryMethods do
         end
 
         it 'should invoke multiple callbacks after model is loaded' do
-          proc1 = Proc.new { }
-          proc2 = Proc.new { }
+          proc1 = Proc.new {}
+          proc2 = Proc.new {}
 
           expect(proc1).to receive(:call) do |user|
             expect(user).to eql @user.__getobj__
@@ -364,7 +339,7 @@ describe Acfs::Model::QueryMethods do
     it_behaves_like 'find_by'
 
     context 'standard resource' do
-      let(:model){ MyUser }
+      let(:model) { MyUser }
       let!(:user) { model.send described_method, age: 24 }
       subject { Acfs.run; user }
 
@@ -373,16 +348,16 @@ describe Acfs::Model::QueryMethods do
 
         it 'should raise an ResourceNotFound error' do
           model.find_by! age: 24
-          expect{ Acfs.run }.to raise_error Acfs::ResourceNotFound
+          expect { Acfs.run }.to raise_error Acfs::ResourceNotFound
         end
 
         it 'should not invoke callback after model could not be loaded' do
-          proc = Proc.new { }
+          proc = Proc.new {}
 
           expect(proc).not_to receive(:call)
 
           model.find_by! age: 24, &proc
-          expect{ Acfs.run }.to raise_error
+          expect { Acfs.run }.to raise_error
         end
       end
     end

data/spec/acfs/model/validation_spec.rb

@@ -95,6 +95,7 @@ describe Acfs::Model::Validation do
     end
 
     context 'on changed resource' do
+      before { model.loaded! }
       let(:model) { super().tap { |m| m.id = 1 } }
 
       it 'should validate with `save` context' do

data/spec/acfs/singleton_resource_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe Acfs::SingletonResource do
+  let(:model) { Single }
+
+  describe '.find' do
+    before do
+      stub_request(:get, 'http://users.example.org/singles').to_return response({id:1})
+    end
+
+    let(:action) { lambda{|cb| model.find &cb }}
+    it_should_behave_like 'a query method with multi-callback support'
+  end
+
+end

data/spec/acfs/stub_spec.rb

@@ -154,6 +154,20 @@ describe Acfs::Stub do
           expect(computers.last).to be_a Mac
         end
       end
+
+      context 'with header' do
+        before do
+          Acfs::Stub.resource Comment, :list,
+          return: [{ id: 1, text: 'Foo' }, { id: 2, text: 'Bar' }],
+          headers: headers
+        end
+
+        let!(:comments) { Comment.all }
+        let(:headers) { {'X-Total-Pages' => '2'} }
+        subject { Acfs.run; comments }
+
+        its(:total_pages) { should eq 2 }
+      end
     end
 
     context 'with update action' do

data/spec/spec_helper.rb

@@ -1,6 +1,4 @@
 require 'rspec'
-require 'rspec/its'
-require 'rspec/collection_matchers'
 require 'webmock/rspec'
 
 if ENV['CI'] || (defined?(:RUBY_ENGINE) && RUBY_ENGINE != 'rbx')

data/spec/support/shared/find_callbacks.rb

@@ -0,0 +1,48 @@
+shared_examples 'a query method with multi-callback support' do
+  let(:cb) { Proc.new }
+
+  it 'should invoke callback' do
+    expect { |cb|
+      action.call cb
+      Acfs.run
+    }.to yield_with_args
+  end
+
+  it 'should invoke multiple callbacks' do
+    expect { |cb|
+      object = action.call cb
+      Acfs.add_callback object, &cb
+      Acfs.run
+    }.to yield_control.exactly(2).times
+  end
+
+  describe 'callback' do
+    it 'should be invoked with resource' do
+      proc = Proc.new { }
+      expect(proc).to receive(:call) do |res|
+        expect(res).to equal @object
+        expect(res).to be_loaded
+      end
+
+      @object = action.call proc
+      Acfs.run
+    end
+
+    it 'should invoke multiple callback with loaded resource' do
+      proc1 = Proc.new { }
+      proc2 = Proc.new { }
+      expect(proc1).to receive(:call) do |user|
+        expect(user).to equal @object
+        expect(user).to be_loaded
+      end
+      expect(proc2).to receive(:call) do |user|
+        expect(user).to equal @object
+        expect(user).to be_loaded
+      end
+
+      @object = action.call proc1
+      Acfs.add_callback(@object, &proc2)
+      Acfs.run
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: acfs
 version: !ruby/object:Gem::Version
-  version: 0.33.0
+  version: 0.34.0
 platform: ruby
 authors:
 - Jan Graichen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-02-28 00:00:00.000000000 Z
+date: 2014-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -124,6 +124,7 @@ files:
 - lib/acfs/adapter/base.rb
 - lib/acfs/adapter/typhoeus.rb
 - lib/acfs/collection.rb
+- lib/acfs/collections/paginatable.rb
 - lib/acfs/configuration.rb
 - lib/acfs/errors.rb
 - lib/acfs/global.rb
@@ -156,6 +157,7 @@ files:
 - lib/acfs/model/service.rb
 - lib/acfs/model/validation.rb
 - lib/acfs/operation.rb
+- lib/acfs/parameter_decoder.rb
 - lib/acfs/request.rb
 - lib/acfs/request/callbacks.rb
 - lib/acfs/resource.rb
@@ -171,6 +173,7 @@ files:
 - lib/acfs/util.rb
 - lib/acfs/version.rb
 - lib/acfs/yard.rb
+- spec/acfs/collection_spec.rb
 - spec/acfs/configuration_spec.rb
 - spec/acfs/middleware/json_decoder_spec.rb
 - spec/acfs/middleware/msgpack_decoder_spec.rb
@@ -193,12 +196,14 @@ files:
 - spec/acfs/response/status_spec.rb
 - spec/acfs/service/middleware_spec.rb
 - spec/acfs/service_spec.rb
+- spec/acfs/singleton_resource_spec.rb
 - spec/acfs/stub_spec.rb
 - spec/acfs_spec.rb
 - spec/fixtures/config.yml
 - spec/spec_helper.rb
 - spec/support/response.rb
 - spec/support/service.rb
+- spec/support/shared/find_callbacks.rb
 homepage: https://github.com/jgraichen/acfs
 licenses:
 - MIT
@@ -224,6 +229,7 @@ signing_key:
 specification_version: 4
 summary: An abstract API base client for service oriented application.
 test_files:
+- spec/acfs/collection_spec.rb
 - spec/acfs/configuration_spec.rb
 - spec/acfs/middleware/json_decoder_spec.rb
 - spec/acfs/middleware/msgpack_decoder_spec.rb
@@ -246,10 +252,12 @@ test_files:
 - spec/acfs/response/status_spec.rb
 - spec/acfs/service/middleware_spec.rb
 - spec/acfs/service_spec.rb
+- spec/acfs/singleton_resource_spec.rb
 - spec/acfs/stub_spec.rb
 - spec/acfs_spec.rb
 - spec/fixtures/config.yml
 - spec/spec_helper.rb
 - spec/support/response.rb
 - spec/support/service.rb
+- spec/support/shared/find_callbacks.rb
 has_rdoc: