はじめに
この記事は、タイトルのとおり、「Everyday Rails」を Rails 6 で勉強したいので、
書籍の翻訳者である伊藤さんのブログを参考にして頑張ってみた記録を記したものである。
記事自体が長くなったので、導入編・前編・中編・後編に分割している。
Rails 6 へのアップグレードは非常に時間がかかるので、いきなり挑戦するのではなく、
まず導入編を読んでいただき、本当に挑戦するのか検討することを強く勧めます。
記録を見たい方は、以下を参照すること。
【導入編】「Everyday Rails - RSpecによるRailsテスト入門」を Rails 6 で勉強したいので伊藤さんのブログを参考にして頑張ってみた - Qiita
【前編】「Everyday Rails - RSpecによるRailsテスト入門」を Rails 6 で勉強したいので伊藤さんのブログを参考にして頑張ってみた - Qiita
【中編】「Everyday Rails - RSpecによるRailsテスト入門」を Rails 6 で勉強したいので伊藤さんのブログを参考にして頑張ってみた - Qiita
また、本記事は、伊藤さんのyoutube動画を見ながら作業した内容の実況中継に
近いような形で書き進めているので、以下を必ず併せて視聴してください。
(youtube動画を視聴している前提で書いているので、この記事単体だと意味が通じない)
【前編】永久保存版!?伊藤さん式・Railsアプリのアップグレード手順(youtube動画)
【後編】永久保存版!?伊藤さん式・Railsアプリのアップグレード手順(youtube動画)
振り返り
Railsのバージョンを5.2.7までアップグレードした。
続いて、Railsのバージョンを6.0.0に上げていく。
なお、本人はバージョンを6.0.0に上げているつもりだが、指定しきれていないので、
結果として6.0.3.1にバージョンアップされている。
また、この記事は以下の伊藤さんの記事と連動するような形で章立てしている。
その記事内での5番までの作業は不要になるため、次の章は6番からスタートする。
6. Railsを最新のパッチバージョンに上げる
さて、RailsのGemfile
を開き、Railsのバージョンを6.00に上げる。
現在では、6.0.3.1が最新版だが、怖いので、とりあえず6.00に上げる。
gem 'rails', '~> 6.0.0'
Gemfile
を変更した後、bundle update
を行う。
7. Railsのメジャーバージョン、またはマイナーバージョンを上げる
やらないつもりだったが、しれっとやっているという。。。
8. rails app:updateを実行する
ターミナルでrails app:update
を実行する。
前回と同様に、routes.rbだけ上書きをせず、n
と回答する。
そのほかは、y
と回答する。
必要に応じて上書きされた設定を元に戻す
Yで上書き実行すると、それまで使っていた重要な設定が失わることがあります。
その場合はgitのdiffをチェックしながら、上書きされて消えてしまった設定を自力で戻していきます。
Rails5.2のバージョンアップの時と同様に対応する。
以下のファイルを変更した。
〜 省略 〜
module Projects
class Application < Rails::Application
# Initialize configuration defaults for originally generated Rails version.
config.load_defaults 5.2
# Settings in config/environments/* take precedence over those specified here.
# Application configuration can go into files in config/initializers
# -- all .rb files in that directory are automatically loaded after loading
# the framework and any gems in your application.
# 以下が消えていたので、戻した。
config.generators do |g|
g.test_framework :rspec,
view_specs: false,
helper_specs: false,
routing_specs: false
end
end
end
# 以下のコードを最後に追加する
# Keep files uploaded in tests from polluting the Rails development
# environment's file uploads
Paperclip::Attachment.default_options[:path] = \
"#{Rails.root}/spec/test_uploads/:class/:id_partition/:style.:extension"
9. railsdiff.orgを参考にして、新しく追加されたgem等を確認する
次に以下を開き、差分を更新していく。
アプリのことをよく分かっており、かつ勘所がないと困難なので、
伊藤さんの動画の指示に従っていく。
以下のファイルを変更した。
source 'https://rubygems.org'
git_source(:github) { |repo| "https://github.com/#{repo}.git" }
ruby '2.7.1'
gem 'rails', '~> 6.0.0'
gem 'sqlite3', '~> 1.4' # 更新
gem 'puma', '~> 3.11'
gem 'sass-rails', '~> 5' # 更新
gem 'uglifier', '>= 1.3.0'
gem 'coffee-rails', '~> 4.2'
gem 'turbolinks', '~> 5'
gem 'jbuilder', '~> 2.7' # 更新
gem 'bootsnap', '>= 1.4.2', require: false # 更新
〜 以下省略 〜
module Projects
class Application < Rails::Application
# Initialize configuration defaults for originally generated Rails version.
config.load_defaults 6.0 # ここを6.0に変更
# Settings in config/environments/* take precedence over those specified here.
# Application configuration can go into files in config/initializers
# -- all .rb files in that directory are automatically loaded after loading
# the framework and any gems in your application.
config.generators do |g|
g.test_framework :rspec,
view_specs: false,
helper_specs: false,
routing_specs: false
end
end
end
Gemfile
を反映させるため、bundle update
を実行する。
無事、成功した。
10. 動作確認を行う
rails c
については、成功した。
rails s
については、動画のとおりrails db:migrate
を実行すると、
無事起動することができた。挙動も問題なさそうだった。
bin/rspec
を実行し、テストに失敗がないか確認する。
以下のFailuresが発生した。
Failures:
1) TasksController#show responds with JSON formatted output
Failure/Error: expect(response).to have_content_type :json
Expected "unknown content type (application/json; charset=utf-8)" to be Content Type "application/json" (json)
# ./spec/controllers/tasks_controller_spec.rb:11:in `block (3 levels) in <main>'
# /Users/kentasuedomi/.rbenv/gems/2.7.0/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/core_ext/kernel_require.rb:55:in `load'
# /Users/kentasuedomi/.rbenv/gems/2.7.0/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/core_ext/kernel_require.rb:55:in `load'
# /Users/kentasuedomi/.rbenv/gems/2.7.0/gems/spring-commands-rspec-1.0.4/lib/spring/commands/rspec.rb:18:in `call'
# -e:1:in `<main>'
2) TasksController#create responds with JSON formatted output
Failure/Error: expect(response).to have_content_type :json
Expected "unknown content type (application/json; charset=utf-8)" to be Content Type "application/json" (json)
# ./spec/controllers/tasks_controller_spec.rb:21:in `block (3 levels) in <main>'
# /Users/kentasuedomi/.rbenv/gems/2.7.0/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/core_ext/kernel_require.rb:55:in `load'
# /Users/kentasuedomi/.rbenv/gems/2.7.0/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/core_ext/kernel_require.rb:55:in `load'
# /Users/kentasuedomi/.rbenv/gems/2.7.0/gems/spring-commands-rspec-1.0.4/lib/spring/commands/rspec.rb:18:in `call'
# -e:1:in `<main>'
Finished in 56.81 seconds (files took 2.96 seconds to load)
70 examples, 2 failures
動画によると、RSpecの書き方が変わったらしい。
expect
で始まるコードを修正する。
require 'rails_helper'
RSpec.describe TasksController, type: :controller do
include_context "project setup"
describe "#show" do
it "responds with JSON formatted output" do
sign_in user
get :show, format: :json,
params: { project_id: project.id, id: task.id }
expect(response.content_type).to eq "application/json; charset=utf-8" # ここを修正
end
end
describe "#create" do
it "responds with JSON formatted output" do
new_task = { name: "New test task" }
sign_in user
post :create, format: :json,
params: { project_id: project.id, task: new_task }
expect(response.content_type).to eq "application/json; charset=utf-8" # ここを修正
end
it "adds a new task to the project" do
new_task = { name: "New test task" }
sign_in user
expect {
post :create, format: :json,
params: { project_id: project.id, task: new_task }
}.to change(project.tasks, :count).by(1)
end
it "requires authentication" do
new_task = { name: "New test task" }
# Don't sign in this time ...
expect {
post :create, format: :json,
params: { project_id: project.id, task: new_task }
}.to_not change(project.tasks, :count)
expect(response.content_type).to eq "application/json; charset=utf-8" # ここを修正
end
end
end
bin/rspec
を実行し、テストに失敗がないか確認したところ、無事成功した。
ただし、動画同様に警告が出ているので、対応していく。
DEPRECATION WARNING: update_attributes is deprecated and will be removed from Rails 6.1 (please, use update instead) (called from toggle at /Users/HOGE/Desktop/Github作業フォルダ/RSpecPractice/everydayrails-rspec-2017-master/app/controllers/tasks_controller.rb:67)
update_attributes
をupdate
に修正するとのことだった。
ついては、以下のファイルを修正する。
app/controllers/tasks_controller.rb
app/controllers/projects_controller.rb
spec/controllers/projects_controller.rb
さて、次に以下の警告を対応する。
DEPRECATION WARNING: Single arity template handlers are deprecated. Template handlers must
now accept two parameters, the view object and the source for the view object.
Change:
>> Coffee::Rails::TemplateHandler.call(template)
To:
>> Coffee::Rails::TemplateHandler.call(template, source)
(called from <main> at /Users/kentasuedomi/Desktop/Github作業フォルダ/RSpecPractice/everydayrails-rspec-2017-master/Rakefile:6)
動画で紹介されてないのでどうしたものかと思っていたところ、
以下の記事を発見! ありがたい!!!
結論を読むと、cofee-rails
のバージョンが問題らしい。
Gemfile
を以下のとおり設定し、bundle update
を行う。
gem 'coffee-rails', '~> 5.0.0'
警告が消えた!
ついに終了!!!
最後に
RSpecの勉強がやっと開始できることを嬉しく思います。
伊藤さん、改めてお世話になります!!!
大変でしたが、こんな初学者がRailsのバージョンアップを
ハンズオンで体験できるという意味ではすごい教材です!!!
ただ、RSpecを純粋に勉強したい人は、バージョンアップするべきかよく考えましょう 笑