daylight 0.9.0.rc1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/README.md +113 -0
- data/app/controllers/daylight_documentation/documentation_controller.rb +27 -0
- data/app/helpers/daylight_documentation/documentation_helper.rb +57 -0
- data/app/views/daylight_documentation/documentation/_header.haml +4 -0
- data/app/views/daylight_documentation/documentation/index.haml +12 -0
- data/app/views/daylight_documentation/documentation/model.haml +114 -0
- data/app/views/layouts/documentation.haml +22 -0
- data/config/routes.rb +8 -0
- data/doc/actions.md +70 -0
- data/doc/benchmarks.md +17 -0
- data/doc/contribute.md +80 -0
- data/doc/develop.md +1205 -0
- data/doc/environment.md +109 -0
- data/doc/example.md +3 -0
- data/doc/framework.md +31 -0
- data/doc/install.md +128 -0
- data/doc/principles.md +42 -0
- data/doc/testing.md +107 -0
- data/doc/usage.md +970 -0
- data/lib/daylight/api.rb +293 -0
- data/lib/daylight/associations.rb +247 -0
- data/lib/daylight/client_reloader.rb +45 -0
- data/lib/daylight/collection.rb +161 -0
- data/lib/daylight/errors.rb +94 -0
- data/lib/daylight/inflections.rb +7 -0
- data/lib/daylight/mock.rb +282 -0
- data/lib/daylight/read_only.rb +88 -0
- data/lib/daylight/refinements.rb +63 -0
- data/lib/daylight/reflection_ext.rb +67 -0
- data/lib/daylight/resource_proxy.rb +226 -0
- data/lib/daylight/version.rb +10 -0
- data/lib/daylight.rb +27 -0
- data/rails/daylight/api_controller.rb +354 -0
- data/rails/daylight/documentation.rb +13 -0
- data/rails/daylight/helpers.rb +32 -0
- data/rails/daylight/params.rb +23 -0
- data/rails/daylight/refiners.rb +186 -0
- data/rails/daylight/server.rb +29 -0
- data/rails/daylight/tasks.rb +37 -0
- data/rails/extensions/array_ext.rb +9 -0
- data/rails/extensions/autosave_association_fix.rb +49 -0
- data/rails/extensions/has_one_serializer_ext.rb +111 -0
- data/rails/extensions/inflections.rb +6 -0
- data/rails/extensions/nested_attributes_ext.rb +94 -0
- data/rails/extensions/read_only_attributes.rb +35 -0
- data/rails/extensions/render_json_meta.rb +99 -0
- data/rails/extensions/route_options.rb +47 -0
- data/rails/extensions/versioned_url_for.rb +22 -0
- data/spec/config/dependencies.rb +2 -0
- data/spec/config/factory_girl.rb +4 -0
- data/spec/config/simplecov_rcov.rb +26 -0
- data/spec/config/test_api.rb +1 -0
- data/spec/controllers/documentation_controller_spec.rb +24 -0
- data/spec/dummy/README.rdoc +28 -0
- data/spec/dummy/Rakefile +6 -0
- data/spec/dummy/app/assets/images/.keep +0 -0
- data/spec/dummy/app/assets/javascripts/application.js +13 -0
- data/spec/dummy/app/assets/stylesheets/application.css +13 -0
- data/spec/dummy/app/controllers/application_controller.rb +5 -0
- data/spec/dummy/app/controllers/concerns/.keep +0 -0
- data/spec/dummy/app/helpers/application_helper.rb +2 -0
- data/spec/dummy/app/mailers/.keep +0 -0
- data/spec/dummy/app/models/.keep +0 -0
- data/spec/dummy/app/models/concerns/.keep +0 -0
- data/spec/dummy/app/views/layouts/application.html.erb +14 -0
- data/spec/dummy/bin/bundle +3 -0
- data/spec/dummy/bin/rails +4 -0
- data/spec/dummy/bin/rake +4 -0
- data/spec/dummy/config/application.rb +24 -0
- data/spec/dummy/config/boot.rb +5 -0
- data/spec/dummy/config/database.yml +25 -0
- data/spec/dummy/config/environment.rb +5 -0
- data/spec/dummy/config/environments/development.rb +29 -0
- data/spec/dummy/config/environments/production.rb +80 -0
- data/spec/dummy/config/environments/test.rb +36 -0
- data/spec/dummy/config/initializers/backtrace_silencers.rb +7 -0
- data/spec/dummy/config/initializers/daylight.rb +1 -0
- data/spec/dummy/config/initializers/filter_parameter_logging.rb +4 -0
- data/spec/dummy/config/initializers/inflections.rb +16 -0
- data/spec/dummy/config/initializers/mime_types.rb +5 -0
- data/spec/dummy/config/initializers/secret_token.rb +12 -0
- data/spec/dummy/config/initializers/session_store.rb +3 -0
- data/spec/dummy/config/initializers/wrap_parameters.rb +14 -0
- data/spec/dummy/config/locales/en.yml +23 -0
- data/spec/dummy/config/routes.rb +59 -0
- data/spec/dummy/config.ru +4 -0
- data/spec/dummy/lib/assets/.keep +0 -0
- data/spec/dummy/log/.keep +0 -0
- data/spec/dummy/public/404.html +58 -0
- data/spec/dummy/public/422.html +58 -0
- data/spec/dummy/public/500.html +57 -0
- data/spec/dummy/public/favicon.ico +0 -0
- data/spec/helpers/documentation_helper_spec.rb +82 -0
- data/spec/lib/daylight/api_spec.rb +178 -0
- data/spec/lib/daylight/associations_spec.rb +325 -0
- data/spec/lib/daylight/collection_spec.rb +235 -0
- data/spec/lib/daylight/errors_spec.rb +111 -0
- data/spec/lib/daylight/mock_spec.rb +144 -0
- data/spec/lib/daylight/read_only_spec.rb +118 -0
- data/spec/lib/daylight/refinements_spec.rb +80 -0
- data/spec/lib/daylight/reflection_ext_spec.rb +50 -0
- data/spec/lib/daylight/resource_proxy_spec.rb +325 -0
- data/spec/rails/daylight/api_controller_spec.rb +421 -0
- data/spec/rails/daylight/helpers_spec.rb +41 -0
- data/spec/rails/daylight/params_spec.rb +45 -0
- data/spec/rails/daylight/refiners_spec.rb +178 -0
- data/spec/rails/extensions/array_ext_spec.rb +51 -0
- data/spec/rails/extensions/has_one_serializer_ext_spec.rb +135 -0
- data/spec/rails/extensions/nested_attributes_ext_spec.rb +177 -0
- data/spec/rails/extensions/render_json_meta_spec.rb +140 -0
- data/spec/rails/extensions/route_options_spec.rb +309 -0
- data/spec/rails/extensions/versioned_url_for_spec.rb +46 -0
- data/spec/spec_helper.rb +43 -0
- data/spec/support/migration_helper.rb +40 -0
- metadata +422 -0
@@ -0,0 +1,144 @@
|
|
1
|
+
require 'spec_helper'
|
2
|
+
require 'daylight/mock'
|
3
|
+
|
4
|
+
describe Daylight::Mock do
|
5
|
+
class MiniTest::Spec ; end
|
6
|
+
class MiniTest::Test ; end
|
7
|
+
|
8
|
+
class TestClient < Daylight::API
|
9
|
+
has_many :test_client_children, through: :associated, class_name: 'TestClientChild'
|
10
|
+
end
|
11
|
+
|
12
|
+
class TestClientChild < Daylight::API ; end
|
13
|
+
|
14
|
+
# All clients will do this in their spec_helper.rb/test_helper.rb
|
15
|
+
Daylight::Mock.setup
|
16
|
+
|
17
|
+
describe 'return values' do
|
18
|
+
describe 'show' do
|
19
|
+
it "returns a single object of the correct type" do
|
20
|
+
TestClient.find(1).should be_instance_of(TestClient)
|
21
|
+
end
|
22
|
+
|
23
|
+
it "has the correct ID" do
|
24
|
+
TestClient.find(1).id.should == 1
|
25
|
+
end
|
26
|
+
end
|
27
|
+
|
28
|
+
describe 'index' do
|
29
|
+
it "returns a list of objects of the correct type" do
|
30
|
+
results = TestClient.find(:all)
|
31
|
+
results.should respond_to(:size)
|
32
|
+
results.first.should be_instance_of(TestClient)
|
33
|
+
end
|
34
|
+
|
35
|
+
it "seeds the objects with ids" do
|
36
|
+
TestClient.find(:all).all? {|z| z.id.present? }.should be_true
|
37
|
+
end
|
38
|
+
|
39
|
+
it "seeds the objects with any filters" do
|
40
|
+
TestClient.where(foo: 'bar').all? {|z| z.foo == 'bar' }.should be_true
|
41
|
+
end
|
42
|
+
end
|
43
|
+
|
44
|
+
describe 'associated' do
|
45
|
+
it "returns a list of objects of the associated type" do
|
46
|
+
results = TestClient.find(1).test_client_children
|
47
|
+
results.should respond_to(:size)
|
48
|
+
results.first.should be_instance_of(TestClientChild)
|
49
|
+
end
|
50
|
+
|
51
|
+
it "seeds the responses with ids" do
|
52
|
+
TestClient.find(1).test_client_children.all? {|z| z.id.present? }.should be_true
|
53
|
+
end
|
54
|
+
|
55
|
+
it "seeds the objects with any filters" do
|
56
|
+
TestClient.find(1).test_client_children.where(foo: 'bar').all? {|z| z.foo == 'bar' }.should be_true
|
57
|
+
end
|
58
|
+
end
|
59
|
+
|
60
|
+
describe 'update' do
|
61
|
+
it "returns a new object with the updated attributes" do
|
62
|
+
object = TestClient.find(1)
|
63
|
+
object.update_attributes(name: 'wibble').should be_true
|
64
|
+
end
|
65
|
+
end
|
66
|
+
|
67
|
+
describe 'create' do
|
68
|
+
it "returns the created object" do
|
69
|
+
object = TestClient.new(name: 'foo')
|
70
|
+
object.name = 'foo'
|
71
|
+
object.save.should be_true
|
72
|
+
object.id.should_not be_nil
|
73
|
+
end
|
74
|
+
end
|
75
|
+
|
76
|
+
describe 'destroy' do
|
77
|
+
it "returns a new object with the updated attributes" do
|
78
|
+
object = TestClient.find(1)
|
79
|
+
object.destroy.should be_true
|
80
|
+
end
|
81
|
+
end
|
82
|
+
end
|
83
|
+
|
84
|
+
describe 'recorder' do
|
85
|
+
it "keeps track of call counts across actions" do
|
86
|
+
TestClient.find(123)
|
87
|
+
TestClient.find(456)
|
88
|
+
|
89
|
+
daylight_mock.shown(:test_clients).count.should == 2
|
90
|
+
end
|
91
|
+
|
92
|
+
it "keeps track of the requests" do
|
93
|
+
TestClient.find(:all)
|
94
|
+
|
95
|
+
daylight_mock.indexed(:test_client).first.request.method.should == :get
|
96
|
+
end
|
97
|
+
|
98
|
+
it "keeps track of the responses" do
|
99
|
+
object = TestClient.find(1)
|
100
|
+
object.update_attributes(name: 'wibble')
|
101
|
+
|
102
|
+
daylight_mock.updated(:test_client).first.status.should == 201
|
103
|
+
end
|
104
|
+
|
105
|
+
it "returns the last response" do
|
106
|
+
TestClient.find(123)
|
107
|
+
TestClient.find(456)
|
108
|
+
|
109
|
+
daylight_mock.last_shown(:test_clients).response.id.should == 456
|
110
|
+
end
|
111
|
+
|
112
|
+
describe :target_object do
|
113
|
+
it "sets the target_object value for examination on update" do
|
114
|
+
object = TestClient.find(1)
|
115
|
+
object.update_attributes(code: 'wibble')
|
116
|
+
|
117
|
+
daylight_mock.last_updated(:test_clients).target_object.code.should == 'wibble'
|
118
|
+
end
|
119
|
+
|
120
|
+
it "sets the target_object value for examination on create" do
|
121
|
+
object = TestClient.new(code: 'foo')
|
122
|
+
object.name = 'foo'
|
123
|
+
object.save.should be_true
|
124
|
+
|
125
|
+
daylight_mock.last_created(:test_clients).target_object.code.should == 'foo'
|
126
|
+
end
|
127
|
+
end
|
128
|
+
|
129
|
+
end
|
130
|
+
|
131
|
+
describe 'minitest setup' do
|
132
|
+
let(:minitest) { Minitest::Test.new }
|
133
|
+
|
134
|
+
it "adds our mock methods to Minitest::Test" do
|
135
|
+
minitest.should respond_to(:daylight_mock)
|
136
|
+
end
|
137
|
+
|
138
|
+
it "captures API requests" do
|
139
|
+
minitest.should_receive(:stub_request).and_return stub_request(:any, /.*/)
|
140
|
+
minitest.before_setup
|
141
|
+
end
|
142
|
+
end
|
143
|
+
|
144
|
+
end
|
@@ -0,0 +1,118 @@
|
|
1
|
+
require 'spec_helper'
|
2
|
+
|
3
|
+
class TestReadOnly < Daylight::API
|
4
|
+
self.password = nil
|
5
|
+
|
6
|
+
has_one :child, class_name: 'TestReadOnly'
|
7
|
+
end
|
8
|
+
|
9
|
+
describe Daylight::ReadOnly do
|
10
|
+
def parse_xml(xml)
|
11
|
+
data = Hash.from_xml(xml)
|
12
|
+
|
13
|
+
if data.is_a?(Hash) && data.keys.size == 1
|
14
|
+
data.values.first
|
15
|
+
else
|
16
|
+
data
|
17
|
+
end
|
18
|
+
end
|
19
|
+
|
20
|
+
describe "read only attributes" do
|
21
|
+
before do
|
22
|
+
data = {
|
23
|
+
test_read_only: { name: "foo", immutable: "readme"},
|
24
|
+
meta: { test_read_only: { read_only: ["immutable"], nested_resources: ["test_resource"] } }
|
25
|
+
}
|
26
|
+
|
27
|
+
stub_request(:any, %r{#{TestReadOnly.site}}).to_return(body: data.to_json)
|
28
|
+
end
|
29
|
+
|
30
|
+
it "is defined" do
|
31
|
+
test = TestReadOnly.find(1)
|
32
|
+
|
33
|
+
test.read_only.should == ["immutable"]
|
34
|
+
end
|
35
|
+
|
36
|
+
it "is accessible" do
|
37
|
+
test = TestReadOnly.find(1)
|
38
|
+
|
39
|
+
test.immutable.should == 'readme'
|
40
|
+
end
|
41
|
+
|
42
|
+
it "cannot be set" do
|
43
|
+
test = TestReadOnly.find(1)
|
44
|
+
|
45
|
+
lambda { test.immutable = 'foo' }.should raise_error(NoMethodError)
|
46
|
+
end
|
47
|
+
|
48
|
+
it "does not respond to setter" do
|
49
|
+
test = TestReadOnly.find(1)
|
50
|
+
|
51
|
+
test.should_not respond_to(:immutable=)
|
52
|
+
end
|
53
|
+
|
54
|
+
it "is excluded when generating json" do
|
55
|
+
json = TestReadOnly.find(1).to_json
|
56
|
+
|
57
|
+
JSON.parse(json).keys.should_not include('immutable')
|
58
|
+
end
|
59
|
+
|
60
|
+
it "is excluded when generating json with child resource" do
|
61
|
+
test1 = TestReadOnly.find(1)
|
62
|
+
test2 = TestReadOnly.find(1)
|
63
|
+
test1.attributes['child'] = test2
|
64
|
+
|
65
|
+
json = JSON.parse(test1.to_json)
|
66
|
+
json.keys.should_not include('immutable')
|
67
|
+
|
68
|
+
json['child'].keys.should_not include('immutable')
|
69
|
+
end
|
70
|
+
|
71
|
+
it "is excluded when generating json with children collection" do
|
72
|
+
test1 = TestReadOnly.find(1)
|
73
|
+
test2 = TestReadOnly.find(1)
|
74
|
+
test1.attributes['children'] = [test2]
|
75
|
+
|
76
|
+
json = JSON.parse(test1.to_json)
|
77
|
+
json.keys.should_not include('immutable')
|
78
|
+
|
79
|
+
json['children'].map(&:keys).flatten.should_not include('immutable')
|
80
|
+
end
|
81
|
+
|
82
|
+
it "is excluded xml" do
|
83
|
+
xml = TestReadOnly.find(1).to_xml
|
84
|
+
|
85
|
+
parse_xml(xml).keys.should_not include('immutable')
|
86
|
+
end
|
87
|
+
|
88
|
+
it "is excluded when generating json with child resource" do
|
89
|
+
test1 = TestReadOnly.find(1)
|
90
|
+
test2 = TestReadOnly.find(1)
|
91
|
+
test1.attributes['child'] = test2
|
92
|
+
|
93
|
+
xml = parse_xml(test1.to_xml)
|
94
|
+
xml.keys.should_not include('immutable')
|
95
|
+
|
96
|
+
xml['child'].keys.should_not include('immutable')
|
97
|
+
end
|
98
|
+
|
99
|
+
it "is excluded when generating json with children collection" do
|
100
|
+
test1 = TestReadOnly.find(1)
|
101
|
+
test2 = TestReadOnly.find(1)
|
102
|
+
test1.attributes['children'] = [test2]
|
103
|
+
|
104
|
+
xml = parse_xml(test1.to_xml)
|
105
|
+
xml.keys.should_not include('immutable')
|
106
|
+
|
107
|
+
xml['children'].map(&:keys).flatten.should_not include('immutable')
|
108
|
+
end
|
109
|
+
|
110
|
+
it "always loads read_only attributes from the server" do
|
111
|
+
test = TestReadOnly.new
|
112
|
+
test.read_only.should == []
|
113
|
+
|
114
|
+
test.save
|
115
|
+
test.read_only.should == ['immutable']
|
116
|
+
end
|
117
|
+
end
|
118
|
+
end
|
@@ -0,0 +1,80 @@
|
|
1
|
+
require 'spec_helper'
|
2
|
+
|
3
|
+
describe Daylight do
|
4
|
+
|
5
|
+
class RefinementTestClass < Daylight::API
|
6
|
+
self.password = nil
|
7
|
+
|
8
|
+
scopes :foo, :bar
|
9
|
+
end
|
10
|
+
|
11
|
+
before do
|
12
|
+
data = [{name: 'one'}, {name: 'two'}]
|
13
|
+
stub_request(:get, %r{#{RefinementTestClass.site}}).to_return(body: data.to_json)
|
14
|
+
end
|
15
|
+
|
16
|
+
describe Daylight::Refinements do
|
17
|
+
|
18
|
+
it 'allows developers to define which scopes their models support' do
|
19
|
+
RefinementTestClass.should respond_to(:foo)
|
20
|
+
RefinementTestClass.should respond_to(:bar)
|
21
|
+
|
22
|
+
RefinementTestClass.scopes :baz
|
23
|
+
|
24
|
+
RefinementTestClass.should respond_to(:baz)
|
25
|
+
end
|
26
|
+
|
27
|
+
it 'keeps track of scopes' do
|
28
|
+
RefinementTestClass.scope_names.should include(:foo)
|
29
|
+
RefinementTestClass.scope_names.should include(:bar)
|
30
|
+
end
|
31
|
+
|
32
|
+
it 'allows addition of scopes' do
|
33
|
+
names = RefinementTestClass.scope_names
|
34
|
+
names.should include(:foo)
|
35
|
+
names.should include(:bar)
|
36
|
+
|
37
|
+
RefinementTestClass.scopes :baz
|
38
|
+
|
39
|
+
names = RefinementTestClass.scope_names
|
40
|
+
names.should include(:foo)
|
41
|
+
names.should include(:bar)
|
42
|
+
names.should include(:baz)
|
43
|
+
end
|
44
|
+
|
45
|
+
it 'supports first' do
|
46
|
+
resource = RefinementTestClass.first
|
47
|
+
|
48
|
+
resource.should be_kind_of(ActiveResource::Base)
|
49
|
+
resource.name.should == 'one'
|
50
|
+
end
|
51
|
+
|
52
|
+
it 'supports first with arguments' do
|
53
|
+
resource = RefinementTestClass.first(params: {order: 'name'})
|
54
|
+
|
55
|
+
resource.should be_kind_of(ActiveResource::Base)
|
56
|
+
resource.name.should == 'one'
|
57
|
+
end
|
58
|
+
|
59
|
+
[:where, :find_by, :order, :limit, :offset].each do |method|
|
60
|
+
it "delegates '#{method}' to ResourceProxy" do
|
61
|
+
RefinementTestClass.should respond_to(method)
|
62
|
+
end
|
63
|
+
end
|
64
|
+
|
65
|
+
describe "ResourceProxy class" do
|
66
|
+
it "added to subclasses" do
|
67
|
+
RefinementTestClass.should be_const_defined(:ResourceProxy)
|
68
|
+
end
|
69
|
+
|
70
|
+
it "accessible from subclass" do
|
71
|
+
RefinementTestClass.send(:resource_proxy_class).should == RefinementTestClass::ResourceProxy
|
72
|
+
end
|
73
|
+
|
74
|
+
it "produce a new instance" do
|
75
|
+
RefinementTestClass.send(:resource_proxy).class.should == RefinementTestClass::ResourceProxy
|
76
|
+
end
|
77
|
+
end
|
78
|
+
|
79
|
+
end
|
80
|
+
end
|
@@ -0,0 +1,50 @@
|
|
1
|
+
require 'spec_helper'
|
2
|
+
|
3
|
+
describe Daylight::ReflectionExt do
|
4
|
+
|
5
|
+
module TestAPI
|
6
|
+
module V1; end
|
7
|
+
end
|
8
|
+
|
9
|
+
class TestFallback < Daylight::API; end
|
10
|
+
|
11
|
+
class TestAPI::V1::Comment < Daylight::API; end
|
12
|
+
|
13
|
+
class TestAPI::V1::Post < Daylight::API
|
14
|
+
has_many :comments
|
15
|
+
has_many :top_comments, class_name: 'test_api/v1/comment'
|
16
|
+
|
17
|
+
belongs_to :test_fallback
|
18
|
+
end
|
19
|
+
|
20
|
+
before do
|
21
|
+
post_data = {id: 1, title: 'Test Post', test_fallback_id: 3}
|
22
|
+
comments_data = [{body: 'comment 1'}, {body: 'comment 2'}]
|
23
|
+
fallback_data = {id: 3, name: 'Fallback'}
|
24
|
+
|
25
|
+
stub_request(:get, %r{#{TestAPI::V1::Post.element_path(1)}}).to_return(body: post_data.to_json)
|
26
|
+
stub_request(:get, %r{#{TestAPI::V1::Comment.collection_path}}).to_return(body: comments_data.to_json)
|
27
|
+
stub_request(:get, %r{#{TestFallback.element_path(3)}}).to_return(body: fallback_data.to_json)
|
28
|
+
end
|
29
|
+
|
30
|
+
it 'expands class name with namespace and version' do
|
31
|
+
comments = TestAPI::V1::Post.find(1).comments
|
32
|
+
|
33
|
+
comments.size.should == 2
|
34
|
+
comments.first.should be_kind_of(TestAPI::V1::Comment)
|
35
|
+
end
|
36
|
+
|
37
|
+
|
38
|
+
it 'still overrides classname' do
|
39
|
+
comments = TestAPI::V1::Post.find(1).top_comments
|
40
|
+
|
41
|
+
comments.size.should == 2
|
42
|
+
comments.first.should be_kind_of(TestAPI::V1::Comment)
|
43
|
+
end
|
44
|
+
|
45
|
+
it 'falls back to old behavior when class with expanded_name cannot be determined' do
|
46
|
+
fallback = TestAPI::V1::Post.find(1).test_fallback
|
47
|
+
|
48
|
+
fallback.should be_kind_of(TestFallback)
|
49
|
+
end
|
50
|
+
end
|