Updated to latest rspec
[gitorious:georgyos-clone.git] / vendor / plugins / rspec / CHANGES
1 == Version 1.1.5 (in git)
2
3 * Added additional characters to be escaped in step strings (patch from Jake Cahoon). Closes #417.
4 * Disable color codes on STDOUT when STDOUT.tty? is false (patch from Tim Pope). Closes #413.
5 * mock(:null_object=>true) plays nice with HTML (patch from Gerrit Kaiser). Closes #230.
6 * a step definition with no block is treated as pending
7
8 == Version 1.1.4
9
10 Maintenance release.
11
12 Note: we've removed the metaclass method from Object. There were some
13 generated specs that used it, and they will now break. Just replace the
14 metaclass call with (class << self; self; end) and all will be well.
15
16 * added hash_including mock argument matcher. Closes #332 (patch from Rick DeNatale)
17 * pending steps print out yellow in stories (patch from Kyle Hargraves)
18 * Deprecation warnings for specs that assume auto-inclusion of modules. Closes #326 (patch from Scott Taylor)
19 * mock.should_not_receive(:anything) fails fast (once again)
20 * Patch from Antti Tarvainen to stop files from being loaded repeatedly when running heckle. Closes #333.
21 * Fixed bug in which session object in example was not the same instance used in the controller. Closes #331. 
22 * Applied patch from Antti Tarvainen to fix bug where heckle runs rspec runs heckle runs rspec etc. Closes #280.
23 * Applied patch from Zach Dennis to merge :steps functionality to :steps_for. Closes #324.
24 * Applied patch from Ryan Davis to add eval of block passed to raise_error matcher. Closes #321.
25 * alias :context :describe in example_group_methods. Closes #312.
26 * Applied patch from Ben Mabey to make the Story runner exit with a non-0 exit code on failing stories. Closes #228.
27 * Applied patch from Coda Hale to get the :red hook called in autotest. Closes #279.
28 * Applied patch from Patrick Ritchie to support --drb in spec.opts. Closes #274, #293.
29 * Moved metaclass method from Object to an internal module which gets included where it is needed.
30 * Applied patch from Dayo Esho: and_yield clobbers return value from block. Closes #217.
31 * Applied patch from Bob Cotton:  ExampleGroupFactory.default resets previously registered types. Closes #222.
32 * Applied patch from Mike Williams to support the lib directory in rails apps with the Textmate Alternate File command. Closes #276.
33 * ExampleGroupMethods#xspecify aliases #xit
34 * A SharedExampleGroup can be created within another ExampleGroup.
35 * Applied patch from Bob Cotton: Nested ExampleGroups do not have a spec_path. Closes #224.
36 * Add before_suite and after_suite callbacks to ExampleGroupMethods and Options. Closes #210.
37 * The after(:suite) callback lambda is passed a boolean representing whether the suite passed or failed
38 * Added NestedTextFormatter. Closes #366.
39 * decoupled mock framework from global extensions used by rspec - supports use of flexmock or mocha w/ rails
40 * Applied patch from Roman Chernyatchik to allow the user to pass in the ruby version into spectask. Closes #325, #370
41
42 == Version 1.1.3
43
44 Maintenance release.
45 Notice to autotest users: you must also upgrade to ZenTest-3.9.0.
46
47 * Tightened up exceptions list in autotest/rails_spec. Closes #264.
48 * Applied patch from Ryan Davis for ZenTest-3.9.0 compatibility
49 * Applied patch from Kero to add step_upcoming to story listeners. Closes #253.
50 * Fixed bug where the wrong named error was not always caught by "should raise_error"
51 * Applied patch from Luis Lavena: No coloured output on Windows due missing RUBYOPT. Closes #244.
52 * Applied patch from Craig Demyanovich to add support for "should_not render_template" to rspec_on_rails. Closes #241.
53 * Added --pattern (-p for short) option to control what files get loaded. Defaults to '**/*_spec.rb'
54 * Exit with non-0 exit code if examples *or tests* (in test/unit interop mode) fail. Closes #203.
55 * Moved at_exit hook to a method in Spec::Runner which only runs if specs get loaded. Closes #242.
56 * Applied patch from kakutani ensuring that base_view_path gets cleared after each view example. Closes #235.
57 * More tweaks to regexp step names
58 * Fixed focused specs in nested ExampleGroups. Closes #225.
59
60 == Version 1.1.2
61
62 Minor bug fixes/enhancements.
63 Notice to autotest users: you must also upgrade to ZenTest-3.8.0.
64
65 * RSpec's Autotest subclasses compatible with ZenTest-3.8.0 (thanks to Ryan Davis for making it easier on Autotest subs).
66 * Applied patch from idl to add spec/lib to rake stats. Closes #226.
67 * calling setup_fixtures and teardown_fixtures for Rails >= r8570. Closes #219.
68 * Applied patch from Josh Knowles using ActiveSupport's Inflector (when available) to make 'should have' read a bit better. Closes #197.
69 * Fixed regression in 1.1 that caused failing examples to fail to generate their own names. Closes #209.
70 * Applied doc patch from Jens Krämer for capturing content_for
71 * Applied patch from Alexander Lang to clean up story steps after each story. Closes #198.
72 * Applied patch from Josh Knowles to support 'string_or_response.should have_text(...)'. Closes #193.
73 * Applied patch from Ian Dees to quiet the Story Runner backtrace. Closes #183.
74 * Complete support for defining steps with regexp 'names'.
75
76 == Version 1.1.1
77
78 Bug fix release.
79
80 * Fix regression in 1.1.0 that caused transactions to not get rolled back between examples.
81 * Applied patch from Bob Cotton to reintroduce ExampleGroup.description_options. Closes LH[#186]
82
83 == Version 1.1.0
84
85 The "tell me a story and go nest yourself" release.
86
87 * Applied patch from Mike Vincent to handle generators rails > 2.0.1. Closes LH[#181]
88 * Formatter.pending signature changed so it gets passed an ExampleGroup instance instead of the name ( LH[#180])
89 * Fixed LH[#180] Spec::Rails::Example::ModelExampleGroup and friends show up in rspec/rails output
90 * Spec::Rails no longer loads ActiveRecord extensions if it's disabled in config/boot.rb
91 * Applied LH[#178] small annoyances running specs with warnings enabled (Patch from Mikko Lehtonen)
92 * Tighter integration with Rails fixtures. Take advantage of fixture caching to get performance improvements (Thanks to Pat Maddox, Nick Kallen, Jonathan Barnes, and Curtis)
93
94 == Version 1.1.0-RC1
95
96 Textmate Bundle users - this release adds a new RSpec bundle that highlights describe, it, before and after and
97 provides navigation to descriptions and examples (rather than classes and methods). When you first install this,
98 it is going to try to hijack all of your .rb files. All you need to do is open a .rb file that does not end with
99 'spec.rb' and change the bundle selection from RSpec to Ruby. TextMate will do the right thing from then on.
100
101 Shortcuts for tab-activated snippets all follow the TextMate convention of 2 or 3 letters of the first word, followed by the first letter of each subsequent word. So "should have_at_least" would be triggered by shhal.
102
103 We reduced the scope for running spec directories, files, a single file or individual spec in TextMate to source.ruby.rspec. This allowed us to restore the standard Ruby shortcuts:
104
105 CMD-R runs all the specs in one file
106 CMD-SHIFT-R runs an individual spec
107 CMD-OPT-R runs any files or directories selected in the TextMate drawer
108
109 rspec_on_rails users - don't forget to run script/generate rspec
110
111 * Added shared_examples_for method, which you can (should) use instead of describe Foo, :shared => true
112 * Applied LH[#168] Fix describe Object, "description contains a # in it" (Patch from Martin Emde)
113 * Applied LH[#15] Reverse loading of ActionView::Base helper modules (Patch from Mark Van Holstyn)
114 * Applied LH[#149] Update contribute page to point towards lighthouse (Patch from Josh Knowles)
115 * Applied LH[#142] verify_rcov fails with latest rcov (Patch from Kyle Hargraves)
116 * Applied LH[#10] Allow stubs to yield and return values (Patch from Pat Maddox)
117 * Fixed LH[#139] version.rb in trunk missing svn last changed number
118 * Applied LH[#14] Adding support for by_at_least/by_at_most in Change matcher (Patch from Saimon Moore)
119 * Applied LH[#12] Fix for TM when switching to alternate file (Patch from Trevor Squires)
120 * Applied LH[#133] ExampleMatcher should match against before(:all) (Patch from Bob Cotton)
121 * Applied LH[#134] Only load spec inside spec_helper.rb (Patch from Mark Van Holstyn)
122 * RSpec now bails immediately if there are examples with identical names.
123 * Applied LH[#132]  Plain Text stories should support Given and Given: (Patch from Jarkko Laine)
124 * Applied patch from Pat Maddox: Story Mediator - the glue that binds the plain text story parser with the rest of the system
125 * Applied LH[#16] Have SimpleMatchers expose their description for specdocs (Patch from Bryan Helmkamp)
126 * Stories now support --colour
127 * Changed the DSL modules to Example (i.e. Spec::Example instead of Spec::DSL)
128 * Applied [#15608] Story problem if parenthesis used in Given, When, Then or And (Patch from Sinclair Bain)
129 * Applied [#15659] GivenScenario fails when it is a RailsStory (Patch from Nathan Sutton)
130 * Fixed [#15639] rcov exclusion configuration. (Spec::Rails projects can configure rcov with spec/rcov.opts)
131 * The rdoc formatter (--format rdoc) is gone. It was buggy and noone was using it.
132 * Changed Spec::DSL::Behaviour to Spec::DSL::ExampleGroup
133 * Changed Spec::DSL::SharedBehaviour to Spec::DSL::SharedExampleGroup
134 * Applied [#14023] Small optimization for heavily proxied objects. (Patch from Ian Leitch)
135 * Applied [#13943] ProfileFormatter (Top 10 slowest examples) (Patch from Ian Leitch)
136 * Fixed [#15232] heckle is not working correctly in trunk (as of r2801)
137 * Applied [#14399] Show pending reasons in HTML report (Patch from Bryan Helmkamp)
138 * Discovered fixed: [#10263] mock "leak" when setting an expectation in a block passed to mock#should_receive
139 * Fixed [#14671] Spec::DSL::ExampleRunner gives "NO NAME because of --dry-run" for every example for 'rake spec:doc'
140 * Fixed [#14543] rspec_scaffold broken with Rails 2.0
141 * Removed Patch [#10577] Rails with Oracle breaks 0.9.2 - was no longer necessary since we moved describe to the Main object (instead of Object)
142 * Fixed [#14527] specs run twice on rails 1.2.4 and rspec/rspec_on_rails trunk
143 * Applied [#14043] Change output ordering to show pending before errors (Patch from Mike Mangino)
144 * Applied [#14095] Don't have ./script/generate rspec create previous_failures.txt (Patch from Bryan Helmkamp)
145 * Applied [#14254] Improved error handling for Object#should and Object#should_not (Patch from Antti Tarvainen)
146 * Applied [#14186] Remove dead code from message_expecation.rb (Patch from Antti Tarvainen)
147 * Applied [#14183] Tiny improvement on mock_spec.rb (Patch from Antti Tarvainen)
148 * Applied [#14208] Fix to Mock#method_missing raising NameErrors instead of MockExpectationErrors (Patch from Antti Tarvainen)
149 * Applied [#14255] Fixed examples in mock_spec.rb and shared_behaviour_spec.rb (Patch from Antti Tarvainen)
150 * Applied [#14362] partially mocking objects that define == can blow up (Patch from Pat Maddox)
151 * test_ methods with an arity of 0 defined in a describe block or Example object will be run as an Example, providing a seamless transition from Test::Unit
152 * Removed BehaviourRunner
153 * Fixed [#13969] Spec Failures on Trunk w/ Autotest
154 * Applied [#14156] False positives with should_not (Patch from Antti Tarvainen)
155 * Applied [#14170] route_for and params_from internal specs fixed (Patch from Antti Tarvainen)
156 * Fixed [#14166] Cannot build trunk
157 * Applied [#14142] Fix for bug #11602: Nested #have_tag specifications fails on the wrong line number (Patch from Antti Tarvainen)
158 * Removed warn_if_no_files argument and feature
159 * Steps (Given/When/Then) with no blocks are treated as pending
160 * Applied [#13913] Scenario should treat no code block as pending (Patch from Evan Light)
161 * Fixed [#13370] Weird mock expectation error (Patch from Mike Mangino)
162 * Applied [#13952] Fix for performance regression introduced in r2096 (Patch from Ian Leitch)
163 * Applied [#13881] Dynamically include Helpers that are included on ActionView::Base (Patch from Brandon Keepers)
164 * Applied [#13833] ActionView::Helpers::JavaScriptMacrosHelper removed after 1.2.3 (Patch from Yurii Rashkovskii)
165 * Applied [#13814] RSpec on Rails w/ fixture-scenarios (Patch from Shintaro Kakutani)
166 * Add ability to define Example subclass instead of using describe
167 * Applied Patch from James Edward Gray II to improve syntax highlighting in TextMate
168 * Fixed [#13579] NoMethodError not raised for missing helper methods
169 * Fixed [#13713] form helper method 'select' can not be called when calling custom helper methods from specs
170 * Example subclasses Test::Unit::TestCase
171 * Added stub_everything method to create a stub that will return itself for any message it doesn't understand
172 * Added stories directory with stories/all.rb and stories/helper.rb when you script/generate rspec
173 * Applied [#13554] Add "And" so you can say Given... And... When... Then... And...
174 * Applied [#11254] RSpec syntax coloring and function pop-up integration in TextMate (Patch from Wincent Colaiuta)
175 * Applied [#13143] ActionView::Helpers::RecordIdentificationHelper should be included if present (Patch from Jay Levitt)
176 * Applied [#13567] patch to allow stubs to yield consecutive values (Patch from Rupert Voelcker)
177 * Applied [#13559] reverse version of route_for (Patch from Rupert Voelcker)
178 * Added [#13532] /lib specs should get base EvalContext
179 * Applied [#13451] Add a null_object option to mock_model (Patch from James Deville)
180 * Applied [#11919] Making non-implemented specs easy in textmate (Patch from Scott Taylor)
181 * Applied [#13274] ThrowSymbol recognized a NameError triggered by Kernel#method_missing as a thrown Symbol
182 * Applied [#12722] the alternate file command does not work in rails views due to scope (Patch from Carl Porth)
183 * Behaviour is now a Module that is used by Example class methods and SharedBehaviour
184 * Added ExampleDefinition
185 * Added story runner framework based on rbehave [#12628]
186 * Applied [#13336] Helper directory incorrect for rake stats in statsetup task (Patch from Curtis Miller)
187 * Applied [#13339] Add the ability for spec_parser to parse describes with :behaviour_type set (Patch from Will Leinweber and Dav Yaginuma)
188 * Fixed [#13271] incorrect behaviour with expect_render and stub_render
189 * Applied [#13129] Fix failing specs in spec_distributed (Patch from Bob Cotton)
190 * Applied [#13118] Rinda support for Spec::Distributed (Patch from Bob Cotton)
191 * Removed BehaviourEval
192 * Removed Behaviour#inherit
193 * Moved implementation of install_dependencies to example_rails_app
194 * Renamed RSPEC_DEPS to VENDOR_DEPS
195 * Added Example#not_implemented?
196 * You can now stub!(:msg).with(specific args)
197 * describe("A", Hash, "with one element") will generate description "A Hash with one element" (Tip from Ola Bini)
198 * Applied [#13016] [DOC] Point out that view specs render, well, a view (Patch from Jay Levitt)
199 * Applied [#13078] Develop rspec with autotest (Patch from Scott Taylor)
200 * Fixed [#13065] Named routes throw a NoMethodError in Helper specs (Patches from James Deville and Mike Mangino)
201 * Added (back) the verbose attribute in Spec::Rake::SpecTask
202 * Changed documentation to point at the new http svn URL, which is more accessible.
203
204 == Version 1.0.8
205
206 Another bugfix release - this time to resolve the version mismatch
207
208 == Version 1.0.7
209
210 Quick bugfix release to ensure that you don't have to have the rspec gem installed
211 in order to use autotest with rspec_on_rails.
212
213 * Fixed [#13015] autotest gives failure in 'spec_command' after upgrade 1.0.5 to 1.0.6
214
215 == Version 1.0.6
216
217 The "holy cow, batman, it's been a long time since we released and there are a ton of bug
218 fixes, patches and even new features" release.
219
220 Warning: Spec::Rails users: In fixing 11508, we've removed the raise_controller_errors method. As long as you
221 follow the upgrade instructions and run 'script/generate rspec' you'll be fine, but if you skip this
222 step you need to manually go into spec_helper.rb and remove the call to that method (if present - it
223 might not be if you haven't upgraded in a while).
224
225 Warning: Implementors of custom formatters. Formatters will now be sent an Example object instead of just a 
226 String for #example_started, #example_passed and #example_failed. In certain scenarios 
227 (Spec::Ui with Spec::Distributed), the formatter must ask the Example for its sequence number instead of
228 keeping track of a sequence number internal to the formatter. Most of you shouldn't need to upgrade
229 your formatters though - the Example#to_s method returns the example name/description, so you should be
230 able to use the passed Example instance as if it were a String.
231
232 * Applied [#12986] Autotest Specs + Refactoring (Patch from Scott Tayler)
233 * Added a #close method to formatters, which allows them to gracefully close streams.
234 * Applied [#12935] Remove requirement that mocha must be installed as a gem when used as mocking framework. (Patch from Ryan Kinderman).
235 * Fixed [#12893] RSpec's Autotest should work with rspec's trunk
236 * Fixed [#12865] Partial mock error when object has an @options instance var
237 * Applied [#12701] Allow checking of content captured with content_for in view specs (Patch from Jens Kr�mer)
238 * Applied [#12817] Cannot include same shared behaviour when required with absolute paths (Patch from Ian Leitch)
239 * Applied [#12719] rspec_on_rails should not include pagination helper (Patch from Matthijs Langenberg)
240 * Fixed [#12714] helper spec not finding rails core helpers
241 * Applied [#12611] should_not redirect_to implementation (Patch from Yurii Rashkovskii)
242 * Applied [#12682] Not correctly aliasing original 'stub!' and 'should_receive' methods for ApplicationController (Patch from Matthijs Langenberg)
243 * Disabled controller.should_receive(:render) and controller.stub!(:render). Use expect_render or stub_render instead.
244 * Applied [#12484] Allow a Behaviour's Description to flow through to the Formatter (Patch from Bob Cotton)
245 * Fixed [#12448] The spec:plugins rake task from rspec_on_rails should ignore specs from the rspec_on_rails plugin
246 * Applied [#12300] rr integration (patch from Kyle Hargraves)
247 * Implemented [#12284] mock_with :rr (integration with RR mock framework: http://rubyforge.org/projects/pivotalrb/)
248 * Applied [#12237] (tiny) added full path to mate in switch_command (Patch from Carl Porth)
249 * Formatters will now be sent an Example object instead of just a String for certain methods
250 * All Spec::Rake::SpecTask attributes can now be procs, which allows for lazy evaluation.
251 * Changed the Spec::Ui interfaces slightly. See examples.
252 * Applied [#12174] mishandling of paths with spaces in spec_mate switch_command (Patch from Carl Porth)
253 * Implemented [#8315] File "Go to..." functionality
254 * Applied [#11917] Cleaner Spec::Ui error for failed Selenium connection (Patch from Ian Dees)
255 * Applied [#11888] rspec_on_rails spews out warnings when assert_select is used with an XML response (Patch from Ian Leitch)
256 * Applied [#12010] Nicer failure message formatting (Patch from Wincent Colaiuta)
257 * Applied [#12156] smooth open mate patch (Patch from Ienaga Eiji)
258 * Applied [#10577] Rails with Oracle breaks 0.9.2. (Patch from Sinclair Bain)
259 * Fixed [#12079] auto-generated example name incomplete: should have 1 error on ....]
260 * Applied [#12066] Docfix for mocks/mocks.page (Patch from Kyle Hargraves)
261 * Fixed [#11891] script/generate rspec_controller fails to create appropriate views (from templates) on edge rails
262 * Applied [#11921] Adds the correct controller_name from derived_controller_name() to the ViewExampleGroupController (Patch from Eloy Duran)
263 * Fixed [#11903] config.include with behaviour_type 'hash' does not work
264 * Examples without blocks and pending is now reported with a P instead of a *
265 * Pending blocks that now pass are rendered blue
266 * New behaviour for after: If an after block raises an error, the other ones will still run instead of bailing at the first. 
267 * Made it possible to run spec from RSpec.tmbundle with --drb against a Rails spec_server.
268 * Applied [#11868] Add ability for pending to optionally hold a failing block and to fail when it passes (Patch from Bob Cotton)
269 * Fixed [#11843] watir_behaviour missing from spec_ui gem
270 * Added 'switch between source and spec file' command in Spec::Mate (based on code from Ruy Asan)
271 * Applied [#11509] Documentation - RSpec requires hpricot
272 * Applied [#11807] Daemonize spec_server and rake tasks to manage them. (patch from Kyosuke MOROHASHI)
273 * Added pending(message) method
274 * Fixed [#11777] should render_template doesn't check paths correctly
275 * Fixed [#11749] Use of 'rescue => e' does not catch all exceptions
276 * Fixed [#11793] should raise_error('with a message') does not work correctly
277 * Fixed [#11774] Mocks should respond to :kind_of? in the same way they respond to :is_a?
278 * Fixed [#11508] Exceptions are not raised for Controller Specs (removed experimental raise_controller_errors)
279 * Applied [#11615] Partial mock methods give ambiguous failures when given a method name as a String (Patch from Jay Phillips)
280 * Fixed [#11545] Rspec doesn't handle should_receive on ActiveRecord associations (Patch from Ian White)
281 * Fixed [#11514] configuration.use_transactional_fixtures is ALWAYS true, regardless of assignment
282 * Improved generated RESTful controller examples to cover both successful and unsuccessful POST and PUT
283 * Changed TextMate snippets for controllers to pass controller class names to #describe rather than controller_name.
284 * Changed TextMate snippets for mocks to use no_args() and any_args() instead of the deprecated Symbols.
285 * Applied [#11500] Documentation: no rails integration specs in 1.0
286 * Renamed SpecMate's shortcuts for running all examples and focused examples to avoid conflicts (CMD-d and CMD-i)
287 * Added a TextMate snippet for custom matchers, lifted from Geoffrey Grosenbach's RSpec peepcode show.
288 * The translator translates mock constraints to the new matchers that were introduced in 1.0.4
289 * Documented environment variables for Spec::Rake::SpecTask. Renamed SPECOPTS and RCOVOPTS to SPEC_OPTS and RCOV_OPTS.
290 * Fixed [#10534] Windows: undefined method 'controller_name'
291
292 == Version 1.0.5
293 Bug fixes. Autotest plugin tweaks.
294
295 * Fixed [#11378] fix to 10814 broke drb (re-opened #10814)
296 * Fixed [#11223] Unable to access flash from rails helper specs
297 * Fixed [#11337] autotest runs specs redundantly
298 * Fixed [#11258] windows: autotest won't run
299 * Applied [#11253] Tweaks to autotest file mappings (Patch from Wincent Colaiuta)
300 * Applied [#11252] Should be able to re-load file containing shared behaviours without raising an exception (Patch from Wincent Colaiuta)
301 * Fixed [#11247] standalone autotest doesn't work because of unneeded autotest.rb
302 * Applied [#11221] Autotest support does not work w/o Rails Gem installed (Patch from Josh Knowles)
303
304 == Version 1.0.4
305 The getting ready for JRuby release.
306
307 * Fixed [#11181] behaviour_type scoping of config.before(:each) is not working
308 * added mock argument constraint matchers (anything(), boolean(), an_instance_of(Type)) which work with rspec or mocha
309 * added mock argument constraint matchers (any_args(), no_args()) which only work with rspec
310 * deprecated rspec's symbol mock argument constraint matchers (:any_args, :no_args, :anything, :boolean, :numeric, :string)
311 * Added tarball of rspec_on_rails to the release build to support folks working behind a firewall that blocks svn access.
312 * Fixed [#11137] rspec incorrectly handles flash after resetting the session
313 * Fixed [#11143] Views code for ActionController::Base#render broke between 1.0.0 and 1.0.3 on Rails Edge r6731
314 * Added raise_controller_errors for controller examples in Spec::Rails
315
316 == Version 1.0.3
317 Bug fixes.
318
319 * Fixed [#11104] Website uses old specify notation
320 * Applied [#11101] StringHelpers.starts_with?(prefix) assumes a string parameter for _prefix_
321 * Removed 'rescue nil' which was hiding errors in controller examples.
322 * Fixed [#11075] controller specs fail when using mocha without integrated_views
323 * Fixed problem with redirect_to failing incorrectly against edge rails.
324 * Fixed [#11082] RspecResourceGenerator should be RspecScaffoldGenerator
325 * Fixed [#10959] Focused Examples do not work for Behaviour defined with constant with modules
326
327 == Version 1.0.2
328 This is just to align the version numbers in rspec and rspec_on_rails.
329
330 == Version 1.0.1
331 This is a maintenance release with mostly cleaning up, and one minor enhancement -
332 Modules are automatically included when described directly.
333
334 * Renamed Spec::Rails' rspec_resource generator to rspec_scaffold.
335 * Removed Spec::Rails' be_feed matcher since it's based on assert_select_feed which is not part of Rails (despite that docs for assert_select_encoded says it is).
336 * describe(SomeModule) will include that module in the examples. Like for Spec::Rails helpers, but now also in core.
337 * Header in HTML report will be yellow instead of red if there is one failed example
338 * Applied [#10951] Odd instance variable name in rspec_model template (patch from Kyle Hargraves)
339 * Improved integration with autotest (Patches from Ryan Davis and David Goodland)
340 * Some small fixes to make all specs run on JRuby.
341
342 == Version 1.0.0
343 The stake in the ground release. This represents a commitment to the API as it is. No significant
344 backwards compatibility changes in the API are expected after this release.
345
346 * Fixed [#10923] have_text matcher does not support should_not
347 * Fixed [#10673] should > and should >= broken
348 * Applied [#10921] Allow verify_rcov to accept greater than threshold coverage %'s via configuration
349 * Applied [#10920] Added support for not implemented examples (Patch from Chad Humphries and Ken Barker)
350 * Patch to allow not implemented examples.  This works by not providing a block to the example. (Patch from Chad Humphries, Ken Barker)
351 * Yanked support for Rails 1.1.6 in Spec::Rails
352 * RSpec.tmbundle uses CMD-SHIFT-R to run focused examples now.
353 * Spec::Rails now bundles a spec:rcov task by default (suggestion from Kurt Schrader)
354 * Fixed [#10814] Runner loads shared code, test cases require them again
355 * Fixed [#10753] Global before and after
356 * Fixed [#10774] Allow before and after to be specified in config II
357 * Refactored Spec::Ui examples to use new global before and after blocks.
358 * Added instructions about how to get Selenium working with Spec::Ui (spec_ui/examples/selenium/README.txt)
359 * Fixed [#10805] selenium.rb missing from gem?
360 * Added rdocs explaining how to deal with errors in Rails' controller actions
361 * Applied [#10770] Finer grained includes.
362 * Fixed [#10747] Helper methods defined in shared specs are not visible when shared spec is used
363 * Fixed [#10748] Shared descriptions in separate files causes 'already exists' error
364 * Applied [#10698] Running with --drb executes specs twice (patch from Ruy Asan)
365 * Fixed [#10871] 0.9.4 - Focussed spec runner fails to run specs in descriptions with type and string when there is no leading space in the string
366
367 == Version 0.9.4
368 This release introduces massive improvements to Spec::Ui - the user interface functional testing
369 extension to RSpec. There are also some minor bug fixes to the RSpec core.
370
371 * Massive improvements to Spec::Ui. Complete support for all Watir's ie.xxx(how, what) methods. Inline screenshots and HTML.
372 * Reactivated --timeout, which had mysteriously been deactivated in a recent release.
373 * Fixed [#10669] Kernel#describe override does not cover Kernel#context
374 * Applied [#10636] Added spec for OptionParser in Runner (Patch from Scott Taylor)
375 * Added [#10516] should_include should be able to accept multiple items
376 * Applied [#10631] redirect_to matcher doesn't respect request.host (Patch from Tim Lucas)
377 * Each formatter now flushes their own IO. This is to avoid buffering of output.
378 * Fixed [#10670] IVarProxy#delete raises exception when instance variable does not exist
379
380 == Version 0.9.3
381 This is a bugfix release.
382
383 * Fixed [#10594] Failing Custom Matcher show NAME NOT GENERATED description
384 * describe(SomeType, "#message") will not add a space: "SomeType#message" (likewise for '.')
385 * describe(SomeType, "message") will have a decription with a space: "SomeType message"
386 * Applied [#10566] prepend_before and prepend_after callbacks
387 * Applied [#10567] Call setup and teardown using before and after callbacks
388
389 == Version 0.9.2
390 This is a quick maintenance release. 
391
392 * Added some website love
393 * Fixed [#10542] reverse predicate matcher syntax
394 * Added a spec:translate Rake task to make 0.9 translation easier with Spec:Rails
395 * Better translation of should_redirect_to
396 * Fixed --colour support for Windows. This is a regression that was introduced in 0.9.1
397 * Applied [#10460] Make SpecRunner easier to instantiate without using commandline args
398
399 == Version 0.9.1
400
401 This release introduces #describe and #it (aliased as #context and #specify for
402 backwards compatibility). This allows you to express specs like this:
403
404   describe SomeClass do # Creates a Behaviour
405     it "should do something" do # Creates an Example
406     end
407   end
408
409 The command line features four new options that give you more control over what specs
410 are being run and in what order. This can be used to verify that your specs are
411 independent (by running in opposite order with --reverse). It can also be used to cut 
412 down feedback time by running the most recently modified specs first (--loadby mtime --reverse).
413
414 Further, --example replaces the old --spec option, and it can now take a file name of
415 spec names as an alternative to just a spec name. The --format failing_examples:file.txt 
416 option allows you to output an --example compatible file, which makes it possible to only 
417 rerun the specs that failed in the last run. Spec::Rails uses all of these four options 
418 by default to optimise your RSpec experience.
419
420 There is now a simple configuration model. For Spec::Rails, you do something like this:
421
422   Spec::Runner.configure do |config|
423     config.use_transactional_fixtures = true
424     config.use_instantiated_fixtures  = false
425     config.fixture_path = RAILS_ROOT + '/spec/fixtures'
426   end
427
428 You can now use mocha or flexmock with RSpec if you prefer either to
429 RSpec's own mock framework. Just put this:
430
431   Spec::Runner.configure do |config|
432     config.mock_with :mocha
433   end
434   
435 or this:
436
437   Spec::Runner.configure do |config|
438     config.mock_with :flexmock
439   end
440
441 in a file that is loaded before your specs. You can also
442 configure included modules and predicate_matchers:
443
444   Spec::Runner.configure do |config|
445     config.include SomeModule
446     config.predicate_matchers[:does_something?] = :do_something
447   end
448
449 See Spec::DSL::Behaviour for more on predicate_matchers
450
451 * Sugar FREE!
452 * Added [10434 ] Please Make -s synonymous with -e for autotest compat. This is temporary until autotest uses -e instead of -s.
453 * Fixed [#10133] custom predicate matchers
454 * Applied [#10473] Add should exist (new matcher) - Patch from Bret Pettichord
455 * Added another formatter: failing_behaviours. Writes the names of the failing behaviours for use with --example.
456 * Applied [#10315] Patch to fix pre_commit bug 10313 - pre_commit_rails: doesn't always build correctly (Patch from Antii Tarvainen)
457 * Applied [#10245] Patch to HTML escape the behavior name when using HTML Formatter (Patch from Josh Knowles)
458 * Applied [#10410] redirect_to does not behave consistently with regards to query string parameter ordering (Patch from Nicholas Evans)
459 * Applied [#9605] Patch for ER 9472, shared behaviour (Patch by Bob Cotton)
460 * The '--format rdoc' option no longer causes a dry-run by default. --dry-run must be used explicitly.
461 * It's possible to specify the output file in the --format option (See explanation in --help)
462 * Several --format options may be specified to output several formats in one run.
463 * The --out option is gone. Use --format html:path/to/my.html instead (or similar).
464 * Spec::Runner::Formatter::BaseTextFormatter#initialize only takes one argument - an IO. dry_run and color are setters.
465 * Made Spec::Ui *much* easier to install. It will be released separately. Check out trunk/spec_ui/examples
466 * HTML reports now include a syntax highlighted snippet of the source code where the spec failed (needs the syntax gem)
467 * Added [#10262] Better Helper testing of Erb evaluation block helpers
468 * Added [#9735] support flexmock (thanks to Jim Weirich for his modifications to flexmock to support this)
469 * Spec::Rails controller specs will no longer let mock exception ripple through to the response.
470 * Fixed [#9260] IvarProxy does not act like a hash.
471 * Applied [#9458] The rspec_scaffold generator does not take into account class nesting (Patch from Steve Tendon)
472 * Applied [#9132] Rakefile spec:doc can fail without preparing database (Patch from Steve Ross)
473 * Applied [#9678] Custom runner command line switch, and multi-threaded runner (Patch from Bob Cotton)
474 * Applied [#9926] Rakefile - RSPEC_DEPS constant as an Array of Hashes instead of an Array of Arrays (Patch from Scott Taylor)
475 * Applied [#9925] Changed ".rhtml" to "template" in REST spec generator (Patch from Scott Taylor)
476 * Applied [#9852] Patch for RSpec's Website using Webgen 0.4.2 (Patch from Scott Taylor)
477 * Fixed [#6523] Run rspec on rails without a db
478 * Fixed [#9295] rake spec should run anything in the spec directory (not just rspec's standard dirs)
479 * Added [#9786] infer controller and helper names from the described type
480 * Fixed [#7795] form_tag renders action='/view_spec' in view specs
481 * Fixed [#9767] rspec_on_rails should not define rescue_action on controllers
482 * Fixed [#9421] --line doesn't work with behaviours that use class names
483 * Fixed [#9760] rspec generators incompatible with changes to edge rails
484 * Added [#9786] infer controller and helper names from the described type
485 * Applied a simplified version of [#9282] Change to allow running specs from textmate with rspec installed as a rails plugin (and no rspec gem installed)
486 * Applied [#9700] Make Spec::DSL::Example#name public / Add a --timeout switch. A great way to prevent specs from getting slow.
487 * In Rails, script/generate rspec will generate a spec.opts file that optimises faster/more efficient running of specs.
488 * Added [#9522] support using rspec's expectations with test/unit
489 * Moved rspec_on_rails up to the project root, simplifying the download url
490 * Fixed [#8103] RSpec not installing spec script correctly.
491 * The --spec option is replaced by the --example option.
492 * The --loadby option no longer supports a file argument. Use --example file_name instead.
493 * The --example option can now take a file name as an argument. The file should contain example names.
494 * Internal classes are named Behaviour/Example (rather than Context/Specification).
495 * You can now use mocha by saying config.mock_with :mocha in a spec_helper
496 * before_context_eval is replaced by before_eval.
497 * Applied [#9509] allow spaced options in spec.opts
498 * Applied [#9510] Added File for Ruby 1.8.6
499 * Applied [#9511] Clarification to README file in spec/
500 * Moved all of the Spec::Rails specs down to the plugins directory - now you can run the specs after you install.
501 * Updated RSpec.tmbundle to the 0.9 syntax and replaced context/specify with describe/it.
502 * Applied [#9232] ActionController::Base#render is sometimes protected (patch from Dan Manges)
503 * Added --reverse option, allowing contexts/specs to be run in reverse order. 
504 * Added --loadby option, allowing better control over load order for spec files. mtime and file.txt supported.
505 * Implemented [#8696] --order option (see --reverse and --loadby)
506 * Added describe/it as aliases for context/specify - suggestion from Dan North.
507 * Applied [#7637] [PATCH] add skip-migration option to rspec_scaffold generator
508 * Added [#9167] string.should have_tag
509 * Changed script/rails_spec_server to script/spec_server and added script/spec (w/ path to vendor/plugins/rspec)
510 * Fixed [#8897] Error when mixing controller spec with/without integrated views and using template system other than rhtml
511 * Updated sample app specs to 0.9 syntax
512 * Updated generated specs to 0.9 syntax
513 * Applied [#8994] trunk: generated names for be_ specs (Multiple patches from Yurii Rashkovskii)
514 * Applied [#9983]: Allow before and after to be called in BehaviourEval. This is useful for shared examples.
515
516 == Version 0.8.2
517
518 Replaced assert_select fork with an assert_select wrapper for have_tag. This means that "should have_rjs" no longer supports :hide or :effect, but you can still use should_have_rjs for those.
519
520 == Version 0.8.1
521
522 Quick "in house" bug-fix
523
524 == Version 0.8.0
525
526 This release introduces a new approach to handling expectations using Expression Matchers.
527
528 See Upgrade[http://rspec.rubyforge.org/upgrade.html], Spec::Expectations, Spec::Matchers and RELEASE-PLAN for more info.
529
530 This release also improves the spec command line by adding DRb support and making it possible to
531 store command line options in a file. This means a more flexible RSpec experience with Rails, 
532 Rake and editor plugins like TextMate.
533
534 It also sports myriad new features, bug fixes, patches and general goodness:
535
536 * Fixed [#8928] rspec_on_rails 0.8.0-RC1 controller tests make double call to setup_with_fixtures
537 * Fixed [#8925] Documentation bug in 0.8.0RC1 rspec website
538 * Applied [#8132] [PATCH] RSpec breaks "rake db:sessions:create" in a rails project that has the rspec_on_rails plugin (Patch from Erik Kastner)
539 * Fixed [#8789] --line and --spec not working when the context has parenhesis in the name
540 * Added [#8783] auto generate spec names from last expectation
541 * --heckle now fails if the heckled class or module is not found.
542 * Fixed [#8771] Spec::Mocks::BaseExpectation#with converts hash params to array of arrays with #collect
543 * Fixed [#8750] should[_not]_include backwards compatibility between 0.8.0-RC1 and 0.7.5.1 broken
544 * Fixed [#8646] Context Runner does not report on Non standard exceptions and return a 0 return code
545 * RSpec on Rails' spec_helper.rb will only force RAILS_ENV to test if it was not specified on the command line.
546 * Fixed [#5485] proc#should_raise and proc#should_not_raise output
547 * Added [#8484] should_receive with blocks
548 * Applied [#8218] heckle_runner.rb doesn't work with heckle >= 1.2.0 (Patch from Michal Kwiatkowski)
549 * Fixed [#8240] Cryptic error message when no controller_name
550 * Applied [#7461] [PATCH] Contexts don't call Module::included when they include a module
551 * Removed unintended block of test/unit assertions in rspec_on_rails - they should all, in theory, now be accessible
552 * Added mock_model method to RSpec on Rails, which stubs common methods. Based on http://metaclass.org/2006/12/22/making-a-mockery-of-activerecord
553 * Fixed [#8165] Partial Mock Errors when respond_to? is true but the method is not in the object
554 * Fixed [#7611] Partial Mocks override Subclass methods
555 * Fixed [#8302] Strange side effect when mocking a class method
556 * Applied [#8316] to_param should return a stringified key in resource generator's controller spec (Patch from Chris Anderson)
557 * Applied [#8216] shortcut for creating object stub
558 * Applied [#8008] Correct generated specs for view when calling resource generator (Patch from Jonathan Tron)
559 * Fixed [#7754] Command-R fails to run spec in TextMate (added instruction from Luke Redpath to the website)
560 * Fixed [#7826] RSpect.tmbundle web page out of date.
561 * RSpec on Rails specs are now running against RoR 1.2.1 and 1.2.2
562 * rspec_scaffold now generates specs for views
563 * In a Rails app, RSpec core is only loaded when RAILS_ENV==test (init.rb)
564 * Added support for target.should arbitrary_expectation_handler and target.should_not arbitrary_expectation_handler
565 * Fixed [#7533] Spec suite fails and the process exits with a code 0
566 * Fixed [#7565] Subsequent stub! calls for method fail to override the first call to method
567 * Applied [#7524] Incorrect Documentation for 'pattern' in Rake task (patch from Stephen Duncan)
568 * Fixed [#7409] default fixtures do not appear to run.
569 * Fixed [#7507] "render..and return" doesn't return
570 * Fixed [#7509] rcov/rspec incorrectly includes boot.rb (Patch from Courtenay)
571 * Fixed [#7506] unnecessary complex output on failure of response.should be_redirect
572 * Applied [#6098] Make scaffold_resource generator. Based on code from Pat Maddox.
573 * The drbspec command is gone. Use spec --drb instead.
574 * The drb option is gone from the Rake task. Pass --drb to spec_opts instead.
575 * New -X/--drb option for running specs against a server like spec/rails' script/rails_spec_server
576 * New -O/--options and -G/--generate flags for file-based options (handy for spec/rails)
577 * Applied [#7339] Turn off caching in HTML reports
578 * Applied [#7419] "c option for colorizing output does not work with rails_spec" (Patch from Shintaro Kakutani)
579 * Applied [#7406] [PATCH] 0.7.5 rspec_on_rails loads fixtures into development database (Patch from Wilson Bilkovich)
580 * Applied [#7387] Allow stubs to return consecutive values (Patch from Pat Maddox)
581 * Applied [#7393] Fix for rake task (Patch from Pat Maddox)
582 * Reinstated support for response.should_render (in addition to controller.should_render)
583
584 == Version 0.7.5.1
585
586 Bug fix release to allow downloads of rspec gem using rubygems 0.9.1.
587
588 == Version 0.7.5
589 This release adds support for Heckle - Seattle'rb's code mutation tool.
590 There are also several bug fixes to the RSpec core and the RSpec on Rails plugin.
591
592 * Removed svn:externals on rails versions and plugins
593 * Applied [#7345] Adding context_setup and context_teardown, with specs and 100% rcov
594 * Applied [#7320] [PATCH] Allow XHR requests in controller specs to render RJS templates
595 * Applied [#7319] Migration code uses drop_column when it should use remove_column (patch from Pat Maddox)
596 * Added support for Heckle
597 * Applied [#7282] dump results even if spec is interrupted (patch from Kouhei Sutou)
598 * Applied [#7277] model.should_have(n).errors_on(:attribute) (patch from Wilson Bilkovich)
599 * Applied [#7270] RSpec render_partial colliding with simply_helpful (patch from David Goodlad)
600 * Added [#7250] stubs should support throwing
601 * Added [#7249] stubs should support yielding
602 * Fixed [#6760] fatal error when accessing nested finders in rspec
603 * Fixed [#7179] script/generate rspec_scaffold generates incorrect helper name
604 * Added preliminary support for assert_select (response.should_have)
605 * Fixed [#6971] and_yield does not work when the arity is -1
606 * Fixed [#6898] Can we separate rspec from the plugins?
607 * Added [#7025] should_change should accept a block
608 * Applied [#6989] partials with locals (patch from Micah Martin)
609 * Applied [#7023] Typo in team.page
610
611 == Version 0.7.4
612
613 This release features a complete redesign of the reports generated with --format html.
614 As usual there are many bug fixes - mostly related to spec/rails.
615
616 * Applied [#7010] Fixes :spacer_template does not work w/ view spec (patch from Shintaro Kakutani)
617 * Applied [#6798] ensure two ':' in the first backtrace line for Emacs's 'next-error' command (patch from Kouhei Sutou)
618 * Added Much nicer reports to generated website
619 * Much nicer reports with --format --html (patch from Luke Redpath)
620 * Applied [#6959] Calls to render and redirect in controllers should return true
621 * Fixed [#6981] helper method is not available in partial template.
622 * Added [#6978] mock should tell you the expected and actual args when receiving the right message with the wrong args
623 * Added the possibility to tweak the output of the HtmlFormatter (by overriding extra_failure_content).
624 * Fixed [#6936] View specs don't include ApplicationHelper by default
625 * Fixed [#6903] Rendering a partial in a view makes the view spec blow up
626 * Added callback library from Brian Takita
627 * Added [#6925] support controller.should_render :action_name
628 * Fixed [#6884] intermittent errors related to method binding
629 * Fixed [#6870] rspec on edge rails spec:controller fixture loading fails
630 * Using obj.inspect for all messages
631 * Improved performance by getting rid of instance_exec (instance_eval is good enough because we never need to pass it args)
632
633 == Version 0.7.3
634
635 Almost normal bug fix/new feature release.
636
637 A couple of things you need to change in your rails specs:
638 # spec_helper.rb is a little different (see http://rspec.rubyforge.org/upgrade.html)
639 # use controller.should_render before OR after the action (controller.should_have_rendered is deprecated)
640
641 * Applied [#6577] messy mock backtrace when frozen to edge rails (patch from Jay Levitt)
642 * Fixed [#6674] rspec_on_rails fails on @session deprecation warning
643 * Fixed [#6780] routing() was failing...fix included - works for 1.1.6 and edge (1.2)
644 * Fixed [#6835] bad message with arbitrary predicate
645 * Added [#6731] Partial templates rendered
646 * Fixed [#6713] helper methods not rendered in view tests?
647 * Fixed [#6707] cannot run controller / helper tests via rails_spec or spec only works with rake
648 * Applied [#6417] lambda {...}.should_change(receiver, :message) (patch from Wilson Bilkovich)
649 * Eliminated dependency on ZenTest
650 * Fixed [#6650] Reserved characters in the TextMate bundle break svn on Win32
651 * Fixed [#6643] script/generate rspec_controller: invalid symbol generation for 'controller_name' for *modularized* controllers
652 * The script/rails_spec command has been moved to bin/drbspec in RSpec core (installed by the gem)
653
654 == Version 0.7.2
655
656 This release introduces a brand new RSpec bundle for TextMate, plus some small bugfixes.
657
658 * Packaged RSpec.tmbundle.tgz as part of the distro
659 * Fixed [#6593] Add moving progress bar to HtmlFormatter using Javascript
660 * Applied [#6265] should_raise should accept an Exception object
661 * Fixed [#6616] Can't run Rails specs with RSpec.tmbundle
662 * Fixed [#6411] Can't run Rails specs with ruby
663 * Added [#6589] New -l --line option. This is useful for IDE/editor runners/extensions.
664 * Fixed [#6615] controller.should_render_rjs should support :partial => 'path/to/template'
665
666 == Version 0.7.1
667
668 Bug fixes and a couple o' new features.
669
670 * Fixed [#6575] Parse error in aliasing the partial mock original method (patch by Brian Takita)
671 * Fixed [#6277] debris left by stubbing (trunk) [submitted by dastels] (fixed by fix to [#6575])
672 * Fixed [#6575] Parse error in aliasing the partial mock original method
673 * Fixed [#6555] should_have_tag does not match documentation
674 * Fixed [#6567] SyntaxError should not stop entire run
675 * Fixed [#6558] integrated views look for template even when redirected
676 * Fixed [#6547] response.should be_redirect broken in 0.7.0
677 * Applied [#6471] Easy way to spec routes
678 * Applied [#6587] Rspec on Rails displays "Spec::Rails::ContextFactory" as context name
679 * Applied [#6514] Document has trivial typos.
680 * Added [#6560] controller.session should be available before the action
681 * Added support for should_have_rjs :visual_effect
682 * Different printing and colours for unmet expectations (red) and other exceptions (magenta)
683 * Simplified method_missing on mock_methods to make it less invasive on partial mocks. 
684
685 == Version 0.7.0
686
687 This is the "Grow up and eat your own dog food release". RSpec is now used on itself and
688 we're no longer using Test::Unit to test it. Although, we are still extending Test::Unit
689 for the rails plugin (indirectly - through ZenTest)
690
691 IMPORTANT NOTE: THIS RELEASE IS NOT 100% BACKWARDS COMPATIBLE TO 0.6.x
692
693 There are a few changes that will require that you change your existing specs.
694
695 RSpec now handles equality exactly like ruby does:
696
697 # actual.should_equal(expected) will pass if actual.equal?(expected) returns true
698 # actual.should eql(expected) will pass if actual.eql?(expected) returns true
699 # actual.should == expected will pass if actual == expected) returns true
700
701 At the high level, eql? implies equivalence, while equal? implies object identity. For more
702 information on how ruby deals w/ equality, you should do this:
703
704 ri equal?
705
706 or look at this:
707
708 http://www.ruby-doc.org/core/classes/Object.html#M001057
709
710 Also, we left in should_be as a synonym for should_equal, so the only specs that should break are the
711 ones using should_equal (which used to use <code>==</code> instead of <code>.equal?</code>).
712
713 Lastly, should_be used to handle true and false differently from any other values. We've removed
714 this special handling, so now actual.should_be true will fail for any value other than true (it
715 used to pass for any non-nil, non-false value), and actual.should_be false will fail for any
716 value other than false (it used to pass for nil or false).
717
718 Here's what you'll need to do to update your specs:
719 # search for "should_equal" and replace with "should_eql"
720 # run specs
721
722 If any specs still fail, they are probably related to should be_true or should_be_false using
723 non-boolean values. Those you'll just have to inspect manually and adjust appropriately (sorry!).
724
725 --------------------------------------------------
726 Specifying multiple return values in mocks now works like this:
727
728 mock.should_receive(:message).and_return(1,2,3)
729
730 It used to work like this:
731
732 mock.should_receive(:message).and_return([1,2,3])
733
734 but we decided that was counter intuitive and otherwise lame.
735
736 Here's what you'll need to do to update your specs:
737 # search for "and_return(["
738 # get rid of the "[" and "]"
739
740 --------------------------------------------------
741 RSpec on Rails now supports the following (thanks to ZenTest upon which it is built):
742
743 # Separate specs for models, views, controllers and helpers
744 # Controller specs are completely decoupled from the views by default (though you can tell them to couple themselves if you prefer)
745 # View specs are completely decoupled from app-specific controllers
746
747 See http://rspec.rubyforge.org/documentation/rails/index.html for more information
748 --------------------------------------------------
749 As usual, there are also other new features and bug fixes:
750
751 * Added lots of documentation on mocks/stubs and the rails plugin.
752 * Added support for assigns[key] syntax for controller specs (to align w/ pre-existing syntax for view specs)
753 * Added support for controller.should_redirect_to
754 * RSpec on Rails automatically checks whether it's compatible with the installed RSpec
755 * Applied [#6393] rspec_on_rails uses deprecated '@response' instead of the accessor
756 * RSpec now has 100% spec coverage(!)
757 * Added support for stubbing and partial mocking
758 * Progress (....F..F.) is now coloured. Tweaked patch from KAKUTANI Shintaro.
759 * Backtrace now excludes the rcov runner (/usr/local/bin/rcov)
760 * Fixed [#5539] predicates do not work w/ rails
761 * Added [#6091] support for Regexp matching messages sent to should_raise
762 * Added [#6333] support for Regexp matching in mock arguments
763 * Applied [#6283] refactoring of diff support to allow selectable formats and custom differs
764 * Fixed [#5564] "ruby spec_file.rb" doesn't work the same way as "spec spec_file.rb"
765 * Fixed [#6056] Multiple output of failing-spec notice
766 * Fixed [#6233] Colours in specdoc
767 * Applied [#6207] Allows --diff option to diff target and expected's #inspect output (Patch by Lachie Cox)
768 * Fixed [#6203] Failure messages are misleading - consider using inspect.
769 * Added [#6334] subject.should_have_xyz will try to call subject.has_xyz? - use this for hash.should_have_key(key)
770 * Fixed [#6017] Rake task should ignore empty or non-existent spec-dirs
771
772 == Version 0.6.4
773
774 In addition to a number of bug fixes and patches, this release begins to formalize the support for
775 RSpec on Rails.
776
777 * Added Christopher Petrilli's TextMate bundle to vendor/textmate/RSpec.tmbundle
778 * Fixed [#5909], once again supporting multi_word_predicates
779 * Applied [#5873] - response.should_have_rjs (initial patch from Jake Howerton, based on ARTS by Kevin Clark)
780 * Added generation of view specs for rspec_on_rails
781 * Applied [#5815] active_record_subclass.should_have(3).records
782 * Added support in "rake stats" for view specs (in spec/views)
783 * Applied [#5801] QuickRef.pdf should say RSpec, not rSpec
784 * Applied [#5728] rails_spec_runner fails on Windows (Patch from Lindsay Evans).
785 * Applied [#5708] RSpec Rails plugin rspec_controller generator makes specs that do not parse.
786 * Cleaned up RSpec on Rails so it doesn't pollute as much during bootstrapping.
787 * Added support for response.should_have_tag and response.should_not_have_tag (works just like assert_tag in rails)
788 * Added new -c, --colour, --color option for colourful (red/green) output. Inspired from Pat Eyler's Redgreen gem.
789 * Added examples for Watir and Selenium under the gem's vendor directory.
790 * Renamed rails_spec_runner to rails_spec_server (as referred to in the docs)
791 * Added support for trying a plural for arbitrary predicates.  E.g. Album.should_exist(:name => "Hey Jude") will call Album.exists?(:name => "Hey Jude")
792 * Added support for should_have to work with methods taking args returning a collection.  E.g. @dave.should_have(3).albums_i_have_that_this_guy_doesnt(@aslak)
793 * Added [#5570] should_not_receive(:msg).with(:specific, "args")
794 * Applied [#5065] to support using define_method rather than method_missing to capture expected messages on mocks. Thanks to Eero Saynatkari for the tip that made it work.
795 * Restructured directories and Modules in order to separate rspec into three distinct Modules: Spec::Expectations, Spec::Runner and Spec::Mocks. This will allow us to more easily integrate other mock frameworks and/or allow test/unit users to take advantage of the expectation API.
796 * Applied [#5620] support any boolean method and arbitrary comparisons (5.should_be < 6) (Patch from Mike Williams)
797  
798 == Version 0.6.3
799
800 This release fixes some minor bugs related to RSpec on Rails
801 Note that if you upgrade a rails app with this version of the rspec_on_rails plugin
802 you should remove your lib/tasks/rspec.rake if it exists.
803
804 * Backtraces from drb (and other standard ruby libraries) are now stripped from backtraces.
805 * Applied [#5557] Put rspec.rake into the task directory of the RSpec on Rails plugin (Patch from Daniel Siemssen)
806 * Applied [#5556] rails_spec_server loads environment.rb twice (Patch from Daniel Siemssen)
807
808 == Version 0.6.2
809 This release fixes a couple of regressions with the rake task that were introduced in the previous version (0.6.1)
810
811 * Fixed [#5518] ruby -w: warnings in 0.6.1
812 * Applied [#5525] fix rake task path to spec tool for gem-installed rspec (patch from Riley Lynch)
813 * Fixed a teensey regression with the rake task - introduced in 0.6.1. The spec command is now quoted so it works on windows.
814
815 == Version 0.6.1
816 This is the "fix the most annoying bugs release" of RSpec. There are 9 bugfixes this time.
817 Things that may break backwards compatibility:
818 1) Spec::Rake::SpecTask no longer has the options attribute. Use ruby_opts, spec_opts and rcov_opts instead.
819
820 * Fixed [#4891] RCOV task failing on windows
821 * Fixed [#4896] Shouldn't modify user's $LOAD_PATH (Tip from Gavin Sinclair)
822 * Fixed [#5369] ruby -w: warnings in RSpec 0.5.16 (Tip from Suraj Kurapati)
823 * Applied [#5141] ExampleMatcher doesn't escape strings before matching (Patch from Nikolai Weibull).
824 * Fixed [#5224] Move 'require diff-lcs' from test_helper.rb to diff_test.rb (Tip from Chris Roos)
825 * Applied [#5449] Rake stats for specs (Patch from Nick Sieger)
826 * Applied [#5468, #5058] Fix spec runner to correctly run controller specs (Patch from Daniel Siemssen)
827 * Applied fixes to rails_spec_server to improve its ability to run several times. (Patch from Daniel Siemssen)
828 * Changed RCov::VerifyTask to fail if the coverage is above the threshold. This is to ensure it gets bumped when coverage improves.
829
830 == Version 0.6.0
831 This release makes an official commitment to underscore_syntax (with no more support for dot.syntax)
832
833 * Fixed bug (5292) that caused mock argument matching to fail
834 * Converted ALL tests to use underscore syntax
835 * Fixed all remaining problems with underscores revealed by converting all the tests to underscores
836 * Enhanced sugar to support combinations of methods (i.e. once.and_return) 
837 * Simplified helper structure taking advantage of dot/underscore combos (i.e. should.be.an_instance_of, which can be expressed as should be_an_instance_of)
838 * Added support for at_most in mocks
839 * Added support for should_not_receive(:msg) (will be removing should_receive(:msg).never some time soon)
840 * Added support for should_have_exactly(5).items_in_collection
841
842 == Version 0.5.16
843 This release improves Rails support and test2spec translation.
844
845 * Fixed underscore problems that occurred when RSpec was used in Rails
846 * Simplified the Rails support by packaging it as a plugin instead of a generator gem.
847 * Fixed [#5063] 'rspec_on_rails' require line in spec_helper.rb
848 * Added pre_commit rake task to reduce risk of regressions. Useful for RSpec developers and patchers.
849 * Added failure_message to RSpec Rake task
850 * test2spec now defines converted helper methods outside of the setup block (bug #5057).
851
852 == Version 0.5.15
853 This release removes a prematurely added feature that shouldn't have been added.
854
855 * Removed support for differences that was added in 0.5.14. The functionality is not aligned with RSpec's vision.
856
857 == Version 0.5.14
858 This release introduces better ways to extend specs, improves some of the core API and
859 a experimental support for faster rails specs.
860
861 * Added proc methods for specifying differences (increments and decrements). See difference_test.rb
862 * Methods can now be defined alongside specs. This obsoletes the need for defining methods in setup. (Patch #5002 from Brian Takita)
863 * Sugar (underscores) now works correctly with should be_a_kind_of and should be_an_instance_of
864 * Added support for include and inherit in contexts. (Patch #4971 from Brian Takita)
865 * Added rails_spec and rails_spec_server for faster specs on rails (still buggy - help needed)
866 * Fixed bug that caused should_render to break if given a :symbol (in Rails)
867 * Added support for comparing exception message in should_raise and should_not_raise
868
869 == Version 0.5.13
870 This release fixes some subtle bugs in the mock API.
871
872 * Use fully-qualified class name of Exceptions in failure message. Easier to debug that way.
873 * Fixed a bug that caused mocks to yield a one-element array (rather than the element) when one yield arg specified.
874 * Mocks not raise AmbiguousReturnError if an explicit return is used at the same time as an expectation block.
875 * Blocks passed to yielding mocks can now raise without causing mock verification to fail.
876
877 == Version 0.5.12
878 This release adds diff support for failure messages, a HTML formatter plus some other
879 minor enhancements.
880
881 * Added HTML formatter.
882 * Added fail_on_error option to spectask.
883 * Added support for diffing, using the diff-lcs Rubygem (#2648).
884 * Remove RSpec on Rails files from backtrace (#4694).
885 * All of RSpec's own tests run successfully after translation with test2spec.
886 * Added --verbose mode for test2spec - useful for debugging when classes fail to translate.
887 * Output of various formatters is now flushed - to get more continuous output.
888
889 == Version 0.5.11
890 This release makes test2spec usable with Rails (with some manual steps). 
891 See http://rspec.rubyforge.org/tools/rails.html for more details
892
893 * test2spec now correctly translates bodies of helper methods (non- test_*, setup and teardown ones).
894 * Added more documentation about how to get test2spec to work with Rails.
895
896 == Version 0.5.10
897 This version features a second rewrite of test2spec - hopefully better than the previous one.
898
899 * Improved test2spec's internals. It now transforms the syntax tree before writing out the code.
900
901 == Version 0.5.9
902 This release improves test2spec by allowing more control over the output
903
904 * Added --template option to test2spec, which allows for custom output driven by ERB
905 * Added --quiet option to test2spec
906 * Removed unnecessary dependency on RubyToC
907
908 == Version 0.5.8
909 This release features a new Test::Unit to RSpec translation tool.
910 Also note that the RubyGem of the previous release (0.5.7) was corrupt.
911 We're close to being able to translate all of RSpec's own Test::Unit
912 tests and have them run successfully!
913
914 * Updated test2spec documentation.
915 * Replaced old test2rspec with a new test2spec, which is based on ParseTree and RubyInline.
916
917 == Version 0.5.7
918 This release changes examples and documentation to recommend underscores rather than dots,
919 and addresses some bugfixes and changes to the spec commandline.
920
921 * spec DIR now works correctly, recursing down and slurping all *.rb files
922 * All documentation and examples are now using '_' instead of '.'
923 * Custom external formatters can now be specified via --require and --format.
924
925 == Version 0.5.6
926 This release fixes a bug in the Rails controller generator
927
928 * The controller generator did not write correct source code (missing 'do'). Fixed.
929
930 == Version 0.5.5
931 This release adds initial support for Ruby on Rails in the rspec_generator gem.
932
933 * [Rails] Reorganised Lachie's original code to be a generator packaged as a gem rather than a plugin.
934 * [Rails] Imported code from http://lachie.info/svn/projects/rails_plugins/rspec_on_rails (Written by Lachie Cox)
935 * Remove stack trace lines from TextMate's Ruby bundle
936 * Better error message from spectask when no spec files are found.
937
938 == Version 0.5.4
939 The "the tutorial is ahead of the gem" release
940
941 * Support for running a single spec with --spec
942 * Exitcode is now 1 unless all specs pass, in which case it's 0.
943 * -v, --version now both mean the same thing
944 * For what was verbose output (-v), use --format specdoc or -f s
945 * --format rdoc always runs in dry-run mode
946 * Removed --doc and added --format and --dry-run
947 * Refactored towards more pluggable formatters
948 * Use webgen's execute tag when generating website (more accurate)
949 * Fixed incorrect quoting of spec_opts in SpecTask
950 * Added patch to enable underscored shoulds like 1.should_equal(1) - patch from Rich Kilmer
951 * Removed most inherited instance method from Mock, making more methods mockable.
952 * Made the RCovVerify task part of the standard toolset.
953 * Documented Rake task and how to use it with Rcov
954 * Implemented <ruby></ruby> tags for website (hooking into ERB, RedCloth and syntax)
955 * RSpec Rake task now takes spec_opts and out params so it can be used for doc generation
956 * RCov integration for RSpec Rake task (#4058)
957 * Group all results instead of printing them several times (#4057)
958 * Mocks can now yield
959 * Various improvements to error reporting (including #4191)
960 * backtrace excludes rspec code - use -b to include it
961 * split examples into examples (passing) and failing_examples
962
963 == Version 0.5.3
964 The "hurry up, CoR is in two days" release.
965
966 * Don't run rcov by default
967 * Make separate task for running tests with RCov
968 * Added Rake task to fail build if coverage drops below a certain threshold
969 * Even more failure output cleanup (simplification)
970 * Added duck_type constraint for mocks
971
972 == Version 0.5.2
973 This release has minor improvements to the commandline and fixes some gem warnings
974
975 * Readded README to avoid RDoc warnings
976 * Added --version switch to commandline
977 * More changes to the mock API
978
979 == Version 0.5.1
980 This release is the first release of RSpec with a new website. It will look better soon.
981
982 * Added initial documentation for API
983 * Added website based on webgen
984 * Modified test task to use rcov
985 * Deleted unused code (thanks, rcov!)
986 * Various changes to the mock API,
987 * Various improvements to failure reporting
988
989 == Version 0.5.0
990 This release introduces a new API and obsolesces previous versions.
991
992 * Moved source code to separate subfolders
993 * Added new DSL runner based on instance_exec
994 * Added spike for testdox/rdoc generation
995 * merge Astels' and Chelimsky's work on ShouldHelper
996 * this would be 0.5.0 if I updated the documentation
997 * it breaks all of your existing specifications.  We're not sorry.
998
999 == Version 0.3.2
1000
1001 The "srbaker is an idiot" release.
1002
1003 * also forgot to update the path to the actual Subversion repository
1004 * this should be it
1005
1006 == Version 0.3.1
1007
1008 This is just 0.3.0, but with the TUTORIAL added to the documentation list.
1009
1010 * forgot to include TUTORIAL in the documentation
1011
1012 == Version 0.3.0
1013
1014 It's been a while since last release, lots of new stuff is available.  For instance:
1015
1016 * improvements to the runners
1017 * addition of should_raise expectation (thanks to Brian Takita)
1018 * some documentation improvements
1019 * RSpec usable as a DSL
1020
1021 == Version 0.2.0
1022
1023 This release provides a tutorial for new users wishing to get started with
1024 RSpec, and many improvements.
1025
1026 * improved reporting in the spec runner output
1027 * update the examples to the new mock api
1028 * added TUTORIAL, a getting started document for new users of RSpec
1029
1030 == Version 0.1.7
1031
1032 This release improves installation and documentation, mock integration and error reporting.
1033
1034 * Comparison errors now print the class name too.
1035 * Mocks now take an optional +options+ parameter to specify behaviour.
1036 * Removed __expects in favour of should_receive
1037 * Added line number reporting in mock error messages for unreceived message expectations.
1038 * Added should_match and should_not_match.
1039 * Added a +mock+ method to Spec::Context which will create mocks that autoverify (no need to call __verify).
1040 * Mocks now require names in the constructor to ensure sensible error messages.
1041 * Made 'spec' executable and updated usage instructions in README accordingly.
1042 * Made more parts of the Spec::Context API private to avoid accidental usage.
1043 * Added more RDoc to Spec::Context.
1044
1045 == Version 0.1.6
1046
1047 More should methods.
1048
1049 * Added should_match and should_not_match.
1050
1051 == Version 0.1.5
1052
1053 Included examples and tests in gem.
1054
1055 == Version 0.1.4
1056
1057 More tests on block based Mock expectations.
1058
1059 == Version 0.1.3
1060
1061 Improved mocking:
1062
1063 * block based Mock expectations.
1064
1065 == Version 0.1.2
1066
1067 This release adds some improvements to the mock API and minor syntax improvements
1068
1069 * Added Mock.should_expect for a more consistent DSL.
1070 * Added MockExpectation.and_returns for a better DSL.
1071 * Made Mock behave as a null object after a call to Mock.ignore_missing
1072 * Internal syntax improvements.
1073 * Improved exception trace by adding exception class name to error message.
1074 * Renamed some tests for better consistency.
1075
1076 == Version 0.1.1
1077
1078 This release adds some shoulds and improves error reporting
1079
1080 * Added should be_same_as and should_not be_same_as.
1081 * Improved error reporting for comparison expectations.
1082
1083 == Version 0.1.0
1084
1085 This is the first preview release of RSpec, a Behaviour-Driven Development library for Ruby 
1086
1087 * Added Rake script with tasks for gems, rdoc etc.
1088 * Added an XForge task to make release go easier.