rspec-rails 2.14.2 → 6.1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (114) hide show
  1. checksums.yaml +5 -5
  2. checksums.yaml.gz.sig +0 -0
  3. data/.document +1 -1
  4. data/.yardopts +4 -2
  5. data/Capybara.md +6 -57
  6. data/Changelog.md +859 -37
  7. data/{License.txt → LICENSE.md} +5 -2
  8. data/README.md +304 -372
  9. data/lib/generators/rspec/channel/channel_generator.rb +12 -0
  10. data/lib/generators/rspec/{observer/templates/observer_spec.rb → channel/templates/channel_spec.rb.erb} +2 -2
  11. data/lib/generators/rspec/controller/controller_generator.rb +25 -7
  12. data/lib/generators/rspec/controller/templates/controller_spec.rb +5 -5
  13. data/lib/generators/rspec/controller/templates/request_spec.rb +19 -0
  14. data/lib/generators/rspec/controller/templates/routing_spec.rb +13 -0
  15. data/lib/generators/rspec/controller/templates/view_spec.rb +2 -2
  16. data/lib/generators/rspec/feature/feature_generator.rb +29 -0
  17. data/lib/generators/rspec/feature/templates/feature_singular_spec.rb +5 -0
  18. data/lib/generators/rspec/feature/templates/feature_spec.rb +5 -0
  19. data/lib/generators/rspec/generator/generator_generator.rb +24 -0
  20. data/lib/generators/rspec/generator/templates/generator_spec.rb +6 -0
  21. data/lib/generators/rspec/helper/helper_generator.rb +3 -2
  22. data/lib/generators/rspec/helper/templates/helper_spec.rb +2 -2
  23. data/lib/generators/rspec/install/install_generator.rb +61 -5
  24. data/lib/generators/rspec/install/templates/spec/rails_helper.rb +84 -0
  25. data/lib/generators/rspec/integration/integration_generator.rb +15 -13
  26. data/lib/generators/rspec/job/job_generator.rb +13 -0
  27. data/lib/generators/rspec/job/templates/job_spec.rb.erb +7 -0
  28. data/lib/generators/rspec/mailbox/mailbox_generator.rb +14 -0
  29. data/lib/generators/rspec/mailbox/templates/mailbox_spec.rb.erb +7 -0
  30. data/lib/generators/rspec/mailer/mailer_generator.rb +11 -3
  31. data/lib/generators/rspec/mailer/templates/mailer_spec.rb +7 -7
  32. data/lib/generators/rspec/mailer/templates/preview.rb +13 -0
  33. data/lib/generators/rspec/model/model_generator.rb +21 -6
  34. data/lib/generators/rspec/model/templates/fixtures.yml +1 -1
  35. data/lib/generators/rspec/model/templates/model_spec.rb +2 -2
  36. data/lib/generators/rspec/request/request_generator.rb +17 -0
  37. data/lib/generators/rspec/request/templates/request_spec.rb +10 -0
  38. data/lib/generators/rspec/scaffold/scaffold_generator.rb +91 -147
  39. data/lib/generators/rspec/scaffold/templates/api_controller_spec.rb +129 -0
  40. data/lib/generators/rspec/scaffold/templates/api_request_spec.rb +131 -0
  41. data/lib/generators/rspec/scaffold/templates/controller_spec.rb +74 -82
  42. data/lib/generators/rspec/scaffold/templates/edit_spec.rb +13 -17
  43. data/lib/generators/rspec/scaffold/templates/index_spec.rb +6 -12
  44. data/lib/generators/rspec/scaffold/templates/new_spec.rb +7 -15
  45. data/lib/generators/rspec/scaffold/templates/request_spec.rb +153 -0
  46. data/lib/generators/rspec/scaffold/templates/routing_spec.rb +19 -12
  47. data/lib/generators/rspec/scaffold/templates/show_spec.rb +5 -12
  48. data/lib/generators/rspec/system/system_generator.rb +24 -0
  49. data/lib/generators/rspec/system/templates/system_spec.rb +9 -0
  50. data/lib/generators/rspec/view/templates/view_spec.rb +2 -2
  51. data/lib/generators/rspec/view/view_generator.rb +5 -4
  52. data/lib/generators/rspec.rb +35 -10
  53. data/lib/rspec/rails/active_record.rb +25 -0
  54. data/lib/rspec/rails/adapters.rb +60 -47
  55. data/lib/rspec/rails/configuration.rb +220 -0
  56. data/lib/rspec/rails/example/channel_example_group.rb +93 -0
  57. data/lib/rspec/rails/example/controller_example_group.rb +189 -138
  58. data/lib/rspec/rails/example/feature_example_group.rb +43 -20
  59. data/lib/rspec/rails/example/helper_example_group.rb +28 -26
  60. data/lib/rspec/rails/example/job_example_group.rb +23 -0
  61. data/lib/rspec/rails/example/mailbox_example_group.rb +80 -0
  62. data/lib/rspec/rails/example/mailer_example_group.rb +30 -14
  63. data/lib/rspec/rails/example/model_example_group.rb +8 -7
  64. data/lib/rspec/rails/example/rails_example_group.rb +12 -2
  65. data/lib/rspec/rails/example/request_example_group.rb +21 -17
  66. data/lib/rspec/rails/example/routing_example_group.rb +49 -40
  67. data/lib/rspec/rails/example/system_example_group.rb +172 -0
  68. data/lib/rspec/rails/example/view_example_group.rb +179 -134
  69. data/lib/rspec/rails/example.rb +4 -33
  70. data/lib/rspec/rails/extensions/active_record/proxy.rb +5 -11
  71. data/lib/rspec/rails/extensions.rb +0 -1
  72. data/lib/rspec/rails/feature_check.rb +51 -0
  73. data/lib/rspec/rails/file_fixture_support.rb +18 -0
  74. data/lib/rspec/rails/fixture_file_upload_support.rb +45 -0
  75. data/lib/rspec/rails/fixture_support.rb +74 -24
  76. data/lib/rspec/rails/matchers/action_cable/have_broadcasted_to.rb +173 -0
  77. data/lib/rspec/rails/matchers/action_cable/have_streams.rb +58 -0
  78. data/lib/rspec/rails/matchers/action_cable.rb +65 -0
  79. data/lib/rspec/rails/matchers/action_mailbox.rb +73 -0
  80. data/lib/rspec/rails/matchers/active_job.rb +465 -0
  81. data/lib/rspec/rails/matchers/base_matcher.rb +179 -0
  82. data/lib/rspec/rails/matchers/be_a_new.rb +69 -62
  83. data/lib/rspec/rails/matchers/be_new_record.rb +24 -21
  84. data/lib/rspec/rails/matchers/be_valid.rb +42 -33
  85. data/lib/rspec/rails/matchers/have_enqueued_mail.rb +227 -0
  86. data/lib/rspec/rails/matchers/have_http_status.rb +385 -0
  87. data/lib/rspec/rails/matchers/have_rendered.rb +55 -31
  88. data/lib/rspec/rails/matchers/redirect_to.rb +30 -29
  89. data/lib/rspec/rails/matchers/relation_match_array.rb +2 -2
  90. data/lib/rspec/rails/matchers/routing_matchers.rb +107 -93
  91. data/lib/rspec/rails/matchers/send_email.rb +122 -0
  92. data/lib/rspec/rails/matchers.rb +23 -14
  93. data/lib/rspec/rails/tasks/rspec.rake +8 -18
  94. data/lib/rspec/rails/vendor/capybara.rb +10 -11
  95. data/lib/rspec/rails/version.rb +3 -1
  96. data/lib/rspec/rails/view_assigns.rb +3 -21
  97. data/lib/rspec/rails/view_path_builder.rb +29 -0
  98. data/lib/rspec/rails/view_rendering.rb +102 -63
  99. data/lib/rspec/rails/view_spec_methods.rb +56 -0
  100. data/lib/rspec/rails.rb +10 -10
  101. data/lib/rspec-rails.rb +69 -3
  102. data.tar.gz.sig +0 -0
  103. metadata +123 -95
  104. metadata.gz.sig +0 -0
  105. data/lib/autotest/rails_rspec2.rb +0 -85
  106. data/lib/generators/rspec/install/templates/.rspec +0 -1
  107. data/lib/generators/rspec/install/templates/spec/spec_helper.rb.tt +0 -49
  108. data/lib/generators/rspec/integration/templates/request_spec.rb +0 -15
  109. data/lib/generators/rspec/observer/observer_generator.rb +0 -12
  110. data/lib/rspec/rails/extensions/active_record/base.rb +0 -58
  111. data/lib/rspec/rails/matchers/have_extension.rb +0 -36
  112. data/lib/rspec/rails/mocks.rb +0 -274
  113. data/lib/rspec/rails/module_inclusion.rb +0 -19
  114. data/lib/rspec/rails/vendor/webrat.rb +0 -33
@@ -1,36 +0,0 @@
1
- require 'active_support'
2
- require 'active_support/core_ext/module/aliasing'
3
- require 'rspec/matchers/built_in/have'
4
-
5
- module RSpec::Rails::Matchers
6
- module HaveExtensions
7
- extend ActiveSupport::Concern
8
-
9
- # @api private
10
- #
11
- # Enhances the failure message for `should have(n)` matchers
12
- def failure_message_for_should_with_errors_on_extensions
13
- return "expected #{relativities[@relativity]}#{@expected} errors on :#{@args[0]}, got #{@actual}" if @collection_name == :errors_on
14
- return "expected #{relativities[@relativity]}#{@expected} error on :#{@args[0]}, got #{@actual}" if @collection_name == :error_on
15
- return failure_message_for_should_without_errors_on_extensions
16
- end
17
-
18
- # @api private
19
- #
20
- # Enhances the description for `should have(n)` matchers
21
- def description_with_errors_on_extensions
22
- return "have #{relativities[@relativity]}#{@expected} errors on :#{@args[0]}" if @collection_name == :errors_on
23
- return "have #{relativities[@relativity]}#{@expected} error on :#{@args[0]}" if @collection_name == :error_on
24
- return description_without_errors_on_extensions
25
- end
26
-
27
- included do
28
- alias_method_chain :failure_message_for_should, :errors_on_extensions
29
- alias_method_chain :description, :errors_on_extensions
30
- end
31
- end
32
- end
33
-
34
- RSpec::Matchers::BuiltIn::Have.class_eval do
35
- include RSpec::Rails::Matchers::HaveExtensions
36
- end
@@ -1,274 +0,0 @@
1
- require 'active_support'
2
- require 'active_support/deprecation'
3
- require 'active_support/core_ext'
4
- require 'active_model'
5
-
6
- module RSpec
7
- module Rails
8
-
9
- class IllegalDataAccessException < StandardError; end
10
-
11
- module Mocks
12
-
13
- module ActiveModelInstanceMethods
14
- # Stubs `persisted?` to return false and `id` to return nil
15
- # @return self
16
- def as_new_record
17
- RSpec::Mocks.allow_message(self, :persisted?).and_return(false)
18
- RSpec::Mocks.allow_message(self, :id).and_return(nil)
19
- self
20
- end
21
-
22
- # Returns true by default. Override with a stub.
23
- def persisted?
24
- true
25
- end
26
-
27
- # Returns false for names matching <tt>/_before_type_cast$/</tt>,
28
- # otherwise delegates to super.
29
- def respond_to?(message, include_private=false)
30
- message.to_s =~ /_before_type_cast$/ ? false : super
31
- end
32
- end
33
-
34
- # Starting with Rails 4.1, ActiveRecord associations are inversible
35
- # by default. This class represents an association from the mocked
36
- # model's perspective.
37
- #
38
- # @private
39
- class Association
40
- attr_accessor :target, :inversed
41
-
42
- def initialize(association_name)
43
- @association_name = association_name
44
- end
45
- end
46
-
47
- module ActiveRecordInstanceMethods
48
- # Stubs `persisted?` to return `false` and `id` to return `nil`.
49
- def destroy
50
- RSpec::Mocks.allow_message(self, :persisted?).and_return(false)
51
- RSpec::Mocks.allow_message(self, :id).and_return(nil)
52
- end
53
-
54
- # Transforms the key to a method and calls it.
55
- def [](key)
56
- send(key)
57
- end
58
-
59
- # Returns the opposite of `persisted?`
60
- def new_record?
61
- !persisted?
62
- end
63
-
64
- # Returns an object representing an association from the mocked
65
- # model's perspective. For use by Rails internally only.
66
- def association(association_name)
67
- @associations ||= Hash.new { |h, k| h[k] = Association.new(k) }
68
- @associations[association_name]
69
- end
70
- end
71
-
72
- # Creates a test double representing `string_or_model_class` with common
73
- # ActiveModel methods stubbed out. Additional methods may be easily
74
- # stubbed (via add_stubs) if `stubs` is passed. This is most useful for
75
- # impersonating models that don't exist yet.
76
- #
77
- # NOTE that only ActiveModel's methods, plus <tt>new_record?</tt>, are
78
- # stubbed out implicitly. <tt>new_record?</tt> returns the inverse of
79
- # <tt>persisted?</tt>, and is present only for compatibility with
80
- # extension frameworks that have yet to update themselves to the
81
- # ActiveModel API (which declares <tt>persisted?</tt>, not
82
- # <tt>new_record?</tt>).
83
- #
84
- # `string_or_model_class` can be any of:
85
- #
86
- # * A String representing a Class that does not exist
87
- # * A String representing a Class that extends ActiveModel::Naming
88
- # * A Class that extends ActiveModel::Naming
89
- def mock_model(string_or_model_class, stubs = {})
90
- if String === string_or_model_class
91
- if Object.const_defined?(string_or_model_class)
92
- model_class = Object.const_get(string_or_model_class)
93
- else
94
- model_class = Object.const_set(string_or_model_class, Class.new do
95
- extend ActiveModel::Naming
96
- def self.primary_key; :id; end
97
- end)
98
- end
99
- else
100
- model_class = string_or_model_class
101
- end
102
-
103
- unless model_class.kind_of? ActiveModel::Naming
104
- raise ArgumentError.new <<-EOM
105
- The mock_model method can only accept as its first argument:
106
- * A String representing a Class that does not exist
107
- * A String representing a Class that extends ActiveModel::Naming
108
- * A Class that extends ActiveModel::Naming
109
-
110
- It received #{model_class.inspect}
111
- EOM
112
- end
113
-
114
- stubs = stubs.reverse_merge(:id => next_id)
115
- stubs = stubs.reverse_merge(:persisted? => !!stubs[:id],
116
- :destroyed? => false,
117
- :marked_for_destruction? => false,
118
- :valid? => true,
119
- :blank? => false)
120
-
121
- double("#{model_class.name}_#{stubs[:id]}", stubs).tap do |m|
122
- m.singleton_class.class_eval do
123
- include ActiveModelInstanceMethods
124
- include ActiveRecordInstanceMethods if defined?(ActiveRecord)
125
- include ActiveModel::Conversion
126
- include ActiveModel::Validations
127
- end
128
- if defined?(ActiveRecord)
129
- [:save, :update_attributes, :update].each do |key|
130
- if stubs[key] == false
131
- RSpec::Mocks.allow_message(m.errors, :empty?).and_return(false)
132
- end
133
- end
134
- end
135
- m.__send__(:__mock_proxy).instance_eval(<<-CODE, __FILE__, __LINE__)
136
- def @object.is_a?(other)
137
- #{model_class}.ancestors.include?(other)
138
- end unless #{stubs.has_key?(:is_a?)}
139
-
140
- def @object.kind_of?(other)
141
- #{model_class}.ancestors.include?(other)
142
- end unless #{stubs.has_key?(:kind_of?)}
143
-
144
- def @object.instance_of?(other)
145
- other == #{model_class}
146
- end unless #{stubs.has_key?(:instance_of?)}
147
-
148
- def @object.__model_class_has_column?(method_name)
149
- #{model_class}.respond_to?(:column_names) && #{model_class}.column_names.include?(method_name.to_s)
150
- end
151
-
152
- def @object.has_attribute?(attr_name)
153
- __model_class_has_column?(attr_name)
154
- end unless #{stubs.has_key?(:has_attribute?)}
155
-
156
- def @object.respond_to?(method_name, include_private=false)
157
- __model_class_has_column?(method_name) ? true : super
158
- end unless #{stubs.has_key?(:respond_to?)}
159
-
160
- def @object.method_missing(m, *a, &b)
161
- respond_to?(m) ? null_object? ? self : nil : super
162
- end
163
-
164
- def @object.class
165
- #{model_class}
166
- end unless #{stubs.has_key?(:class)}
167
-
168
- def @object.to_s
169
- "#{model_class.name}_#{to_param}"
170
- end unless #{stubs.has_key?(:to_s)}
171
- CODE
172
- yield m if block_given?
173
- end
174
- end
175
-
176
- module ActiveModelStubExtensions
177
- # Stubs `persisted` to return false and `id` to return nil
178
- def as_new_record
179
- RSpec::Mocks.allow_message(self, :persisted?).and_return(false)
180
- RSpec::Mocks.allow_message(self, :id).and_return(nil)
181
- self
182
- end
183
-
184
- # Returns `true` by default. Override with a stub.
185
- def persisted?
186
- true
187
- end
188
- end
189
-
190
- module ActiveRecordStubExtensions
191
- # Stubs `id` (or other primary key method) to return nil
192
- def as_new_record
193
- self.__send__("#{self.class.primary_key}=", nil)
194
- super
195
- end
196
-
197
- # Returns the opposite of `persisted?`.
198
- def new_record?
199
- !persisted?
200
- end
201
-
202
- # Raises an IllegalDataAccessException (stubbed models are not allowed to access the database)
203
- # @raises IllegalDataAccessException
204
- def connection
205
- raise RSpec::Rails::IllegalDataAccessException.new("stubbed models are not allowed to access the database")
206
- end
207
- end
208
-
209
- # Creates an instance of `Model` with `to_param` stubbed using a
210
- # generated value that is unique to each object. If `Model` is an
211
- # `ActiveRecord` model, it is prohibited from accessing the database*.
212
- #
213
- # For each key in `stubs`, if the model has a matching attribute
214
- # (determined by `respond_to?`) it is simply assigned the submitted values.
215
- # If the model does not have a matching attribute, the key/value pair is
216
- # assigned as a stub return value using RSpec's mocking/stubbing
217
- # framework.
218
- #
219
- # <tt>persisted?</tt> is overridden to return the result of !id.nil?
220
- # This means that by default persisted? will return true. If you want
221
- # the object to behave as a new record, sending it `as_new_record` will
222
- # set the id to nil. You can also explicitly set :id => nil, in which
223
- # case persisted? will return false, but using `as_new_record` makes the
224
- # example a bit more descriptive.
225
- #
226
- # While you can use stub_model in any example (model, view, controller,
227
- # helper), it is especially useful in view examples, which are
228
- # inherently more state-based than interaction-based.
229
- #
230
- # @example
231
- #
232
- # stub_model(Person)
233
- # stub_model(Person).as_new_record
234
- # stub_model(Person, :to_param => 37)
235
- # stub_model(Person) {|person| person.first_name = "David"}
236
- def stub_model(model_class, stubs={})
237
- model_class.new.tap do |m|
238
- m.extend ActiveModelStubExtensions
239
- if defined?(ActiveRecord) && model_class < ActiveRecord::Base
240
- m.extend ActiveRecordStubExtensions
241
- primary_key = model_class.primary_key.to_sym
242
- stubs = stubs.reverse_merge(primary_key => next_id)
243
- stubs = stubs.reverse_merge(:persisted? => !!stubs[primary_key])
244
- else
245
- stubs = stubs.reverse_merge(:id => next_id)
246
- stubs = stubs.reverse_merge(:persisted? => !!stubs[:id])
247
- end
248
- stubs = stubs.reverse_merge(:blank? => false)
249
-
250
- stubs.each do |message, return_value|
251
- if m.respond_to?("#{message}=")
252
- m.__send__("#{message}=", return_value)
253
- else
254
- RSpec::Mocks.allow_message(m, message).and_return(return_value)
255
- end
256
- end
257
-
258
- yield m if block_given?
259
- end
260
- end
261
-
262
- private
263
-
264
- @@model_id = 1000
265
-
266
- def next_id
267
- @@model_id += 1
268
- end
269
-
270
- end
271
- end
272
- end
273
-
274
- RSpec.configuration.include RSpec::Rails::Mocks
@@ -1,19 +0,0 @@
1
- module RSpec::Rails
2
- module ModuleInclusion
3
- # @deprecated No replacement.
4
- #
5
- # Will be removed from rspec-rails-3.0
6
- #
7
- # This was never intended to be a public API and is no longer needed
8
- # internally. As it happens, there are a few blog posts citing its use, so
9
- # I'm leaving it here, but deprecated.
10
- def include_self_when_dir_matches(*path_parts)
11
- lambda do |c|
12
- RSpec.deprecate('include_self_when_dir_matches')
13
- c.include self, :example_group => {
14
- :file_path => Regexp.compile(path_parts.join('[\\\/]'))
15
- }
16
- end
17
- end
18
- end
19
- end
@@ -1,33 +0,0 @@
1
- begin
2
- require 'webrat'
3
- rescue LoadError
4
- end
5
-
6
- RSpec.configure do |c|
7
- if defined?(Webrat)
8
- c.include Webrat::Matchers, :type => :request
9
- c.include Webrat::Matchers, :type => :controller
10
- c.include Webrat::Matchers, :type => :view
11
- c.include Webrat::Matchers, :type => :helper
12
- c.include Webrat::Matchers, :type => :mailer
13
-
14
- c.include Webrat::Methods, :type => :request
15
- c.include Webrat::Methods, :type => :controller
16
-
17
- module RequestInstanceMethods
18
- def last_response
19
- @response
20
- end
21
- end
22
-
23
- c.include RequestInstanceMethods, :type => :request
24
-
25
- c.before :type => :controller do
26
- Webrat.configure {|w| w.mode = :rails}
27
- end
28
-
29
- c.before :type => :request do
30
- Webrat.configure {|w| w.mode = :rack}
31
- end
32
- end
33
- end