You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[RSpec Rails new versioning strategy]: https://github.com/rspec/rspec-rails/blob/main/rfcs/versioning-strategy.md
30
32
31
33
## Installation
32
34
33
35
**IMPORTANT** This README / branch refers to the current development build.
34
-
See the [`6-1-maintenance` branch on Github](https://github.com/rspec/rspec-rails/tree/6-1-maintenance) if you want or require the latest stable release.
36
+
See the [`7-0-maintenance` branch on Github](https://github.com/rspec/rspec-rails/tree/7-0-maintenance) if you want or require the latest stable release.
35
37
36
38
1. Add `rspec-rails` to **both** the `:development` and `:test` groups
37
39
of your app’s `Gemfile`:
38
40
39
41
```ruby
40
42
# Run against this stable release
41
43
group :development, :testdo
42
-
gem 'rspec-rails', '~> 6.1.0'
44
+
gem 'rspec-rails', '~> 7.0.0'
43
45
end
44
46
45
47
# Or, run against the main branch
@@ -86,7 +88,7 @@ read the [`rspec-rails` upgrade notes][] to find out what to watch out for.
86
88
87
89
Be sure to check the general [RSpec upgrade notes][] as well.
Copy file name to clipboardexpand all lines: features/upgrade/README.md
+26-5
Original file line number
Diff line number
Diff line change
@@ -1,18 +1,39 @@
1
-
# Upgrading from rspec-rails 5.x to version 6
1
+
# Upgrading
2
+
3
+
RSpec Rails versions follow semantic versioning of x.y.z where:
4
+
5
+
-`x` is a major release containing breaking changes and support changes for Rails.
6
+
-`y` is a minor release which will contain only feature additions and bug fixes.
7
+
-`z` is a patch release which will contain only bug fixes for the minor levels currently supported version of Rails.
8
+
9
+
On new Rails minor releases we will usually release our own new minor version to support that version, occasionally
10
+
we will release a new major version instead to allow us to remove support for now unsupported versions of Rails
11
+
as defined by the Rails team themselves.
12
+
13
+
The RSpec team will only maintain the current major / minor version, although it is common for the `main` branch
14
+
to contain changes for the next upcoming version of Rails and usage of this branch directly is also supported.
2
15
3
-
RSpec Rails 6 is a major version under semantic versioning, it also follows our new versioning strategy for RSpec-Rails, which is to keep in step with Rails supported versions. Thus it supports 6.1 and 7.0. There are no changes required to upgrade to RSpec Rails 6 if you are using a supported version of Rails.
16
+
# Upgrading from rspec-rails 6.x to version 7
17
+
18
+
RSpec Rails 7 supports Rails versions 7.0, 7.1 and 7.2. There are no changes required to upgrade from 6.x to 7 for these versions of Rails,
19
+
but we encourage those doing multiple step upgrades to upgrade to Rails 7.1 and RSpec Rails 6.1.x before upgrading to Rails 7.2 and RSpec Rails 7.0.
20
+
21
+
If you are on Rails 6.1 you will need to keep using RSpec Rails 6.1.
22
+
23
+
# Upgrading from rspec-rails 5.x to version 6
4
24
5
-
If you are using an older version of Rails, you can use 5.x which hard supports 5.2 and 6.x.
25
+
RSpec Rails 6 supports Rails versions 6.1, 7.0 and 7.1. There are no changes required to upgrade from 5.x to 6 for these versions of Rails.
6
26
7
27
# Upgrading from rspec-rails 4.x to version 5
8
28
9
-
RSpec Rails 5 is a major version under semantic versioning, it also follows our new versioning strategy for RSpec-Rails, which is to keep in step with Rails supported versions. Thus it supports 5.2, 6.0 and 6.1. There are no changes required to upgrade to RSpec Rails 5 if you are using a supported version of Rails.
29
+
RSpec Rails 5 supports 5.2, 6.0 and 6.1. There are no changes required to upgrade from 4.x to 5 for these versions of Rails.
10
30
11
31
If you are using an older version of Rails, you can use 4.x which hard supports 5.0 and 5.1, and soft supports 4.2 (which is unmaintained).
12
32
13
33
# Upgrading from rspec-rails 3.x to version 4
14
34
15
-
RSpec Rails 4 is a major version under semantic versioning, it allowed us to change the supported Rails versions to 5 and 6 only. There are no changes required to upgrade to RSpec Rails 4 if you are using Rails 5 or 6.
35
+
RSpec Rails 4 was the first version to be released out of step with rspec, as a major version under semantic versioning, it allowed us to change the supported Rails versions to 5 and 6 only.
36
+
There are no changes required to upgrade to RSpec Rails 4 from 3.x if you are using Rails 5 or 6.
16
37
17
38
If you are using Rails 4.2 you can use RSpec Rails 4, but note that support for it is not maintained, we consider this a breaking change hence the version change, and you must be on Ruby 2.2 as a minimum.
0 commit comments