find_byの使い方がよくわかっていないので復習がてらここに記載していきたいと思います。
find_byを使うと指定したデータを受け取ることができる。
たとえば、
モデル名.find_by(カラム名: 値）
とすることでその値を持ったデータベースからデータを受け取ることができる。
find_byを使うと指定したデータを受け取ることができることを覚えておきたい。
paramsの使い方は２通りあって
① 「:○○」を使ったルーティングのURLから値を取得できる。
① get "posts/:○○ => ...
② 「name="○○"」が付いたフォームの入力内容を取得できる。
②
rails db:migrate時のエラー「Cannot add a NOT NULL column」について
初めに
某ガイドの学習中にエラーが発生したため、その解決方法を記事にします。
初めての投稿ですので、至らぬ点などあればご指摘いただけますと幸いです。
エラーが発生した状況
UserテーブルとTaskテーブルがあります。
User : Taskの間で1 : 多の関係となるように、マイグレーションファイルを作成し、マイグレーションを行ったタイミングで下記エラーが発生しました。
発生したエラー
terminal
rails aborted!
StandardError: An error has occurred, this and all later migrations canceled:
SQLite3::SQLException: Cannot add a NOT NULL column with default value NULL: ALTER TABLE "tasks" ADD "user_id" integer NOT NULL
エラー内容を見てみると「Cannot add a NOT NULL column with default value」と記載があるとおり、columnにNOT NULLを与えることができないとなっています。
エラーが発生した際のマイグレーションファイルは以下のとおりです。
xxxxxxxxxxxxxx_AddUserIdTasks.rb
class AddUserIdToTasks < ActiveRecord::Migration[5.2]
def up
execute "DELETE FROM tasks;"
add_reference :tasks, :user, null: false, index: true
end
end
execute "DELETE FROM tasks;"はSQLによって、ここまでに作成したタスクを削除しています。
add_reference :tasks, :user, null: false, index: trueでは、tasksにuserと関連付けたuser_idカラムを追加し、制約としてnull: false, index: trueオプションをつけようとしています。
このadd_reference行についてエラーが発生しました。
解決した方法
先にも記載したとおり「Cannot add a NOT NULL column with default value」ということでしたので、null: falseを削除したら無事マイグレーションできました。
xxxxxxxxxxxxxx_AddUserIdTasks.rb
class AddUserIdToTasks < ActiveRecord::Migration[5.2]
def up
execute "DELETE FROM tasks;"
add_reference :tasks, :user, index: true
end
end
原因について詳しく特定できていませんが、某ガイドの指定しているデータベースとは別のデータベースを用いているのが理由なのかなと考えています。試していないので断言はできませんが。。。
なお、下記を行うことでNOT NULL制約を与えることができました。
xxxxxxxxxxxxxx_ChangeUserIdToTasks
class ChangeUserIdToTasks < ActiveRecord::Migration[5.2]
def change
change_column :tasks, :user_id, :integer, null: false
end
end
参考にさせて頂いた記事
[Qiita]マイグレショーンファイルを作成する際のnull: false
今回はRSpecの中トロ部分、system specでコントローラーのテストを実行していきます。
コントローラーのテストでは、実際に操作するような感覚でテストコードを書いていきます。
開発環境
ruby 2.6.3
Rails 5.2.6
前提
FactoryBot使用
Faker使用
capybara使用
devise使用
RSpecの準備、FactoryBotでのテストデータの定義等は、下記記事にまとめてますので、まだの方は先にこちらをどうぞ。
[Rails]RSpecでテストを行う準備(FactoryBot使用)
ファイルの作成
まずは、spec配下にsystemフォルダを作って、その中に各コントローラーのファイルを作っていきます。
今回は、
posts_spec.rb
を例にコードを記述していきます。
作成した各モデルのファイルで、rails_helperの設定を読み込んでいきます。
rails_helperはRSpecの設定が記述してあるファイルです。
コードを１行書くだけで、読み込めるので先に記述しておきます。
最初にまとめて書いておくことで、書き忘れを防げます！
コントローラーファイル
require 'rails_helper'
deviseのヘルパーを使えるようにする
controllerのテストを実行していく中で、sign_inなどのdeviseのヘルパーを使う機会が出てきます。
なぜRSpecのコードを書いていくときに、deviseのヘルパーが必要かというと、アクセス権限でログインしてないユーザーを許可していない場合があるからです。
ユーザーの編集ページはログインしてないときは、アクセスできないなど
spec/rails_helper.rbにdeviseのヘルパーを使えるようにコードを追加します。
spec/rails_helper.rb
:
# deviseのヘルパーメソッドをsystemで使用できるように設定
config.include Devise::Test::IntegrationHelpers, type: :system
end
これでdeviseのヘルパーをsystemで使用できるようになりました。
capybaraの設定
systemでCapybaraを使ってテストできるように、spec_helperに設定を追加します。
spec/spec_helper.rb
:
RSpec.configure do |config|
# 以下３行を追加
config.before(:each, type: :system) do
driven_by :rack_test
end
:
これでsystemでcapybaraが使えるようになりました。
テストコードを書いていく
posts_specでは投稿のテストと削除のテストを行います。
テスト項目の洗い出し
まずはテスト項目の洗い出しを行っていきます。
投稿のテストでは、成功したときと失敗したときのテストを書いていきます。
spec/system/posts_spec.rb
require 'rails_helper'
describe '投稿に関するテスト' do
describe "投稿のテスト" do
context "投稿が成功したとき" do
it "投稿成功後の遷移先が正しいか" do
# この中にテストの処理を書いていく
end
it "投稿成功後の表示の確認" do
# この中にテストの処理を書いていく
end
end
context "投稿が失敗したとき" do
it "投稿失敗後の遷移先が正しいか" do
# この中にテストの処理を書いていく
end
it "投稿失敗後の表示の確認" do
# この中にテストの処理を書いていく
end
end
end
describe "削除のテスト" do
it "削除リンクが表示されているか" do
# この中にテストの処理を書いていく
end
it "削除されるか" do
# この中にテストの処理を書いていく
end
end
end
RSpecの記述の基本形がわからない方はこちらの記事参照
最低限覚えておきたいRSpecの基本構成
テストデータをつくる
FactoryBotで作っておいたデータをつ使います。
わからない方は、こちらの記事で確認してください。
[Rails]RSpecでテストを行う準備(FactoryBot使用)
spec/system/posts_spec.rb
:
describe '投稿に関するテスト' do
# FactoryBotのテストデータを使う
let!(:user) { create(:user) }
let!(:post) { create(:post, user_id: user.id) }
describe "投稿のテスト" do
:
beforeを記述
投稿のテストも削除のテストもサインインしてから使う機能なので、サインインしてからテストを実行したいので、beforeでサインインしたあとに各ページに移動しておきます。
spec/system/posts_spec.rb
:
describe "投稿のテスト" do
# userでログインしてから新規投稿画面へ遷移
before do
sign_in user
visit new_post_path
end
:
describe "削除のテスト" do
# userでログインしてから投稿一覧へ遷移
before do
sign_in user
visit posts_path
end
:
テストの中身を記述
これで、準備ができたので、itの中でテストを実行していきます。
コード内に解説を入れています。
spec/system/posts_spec.rb
require 'rails_helper'
describe '投稿に関するテスト' do
# FactoryBotのテストデータを使う
let!(:user) { create(:user) }
let!(:post) { create(:post, user_id: user.id) }
describe "投稿のテスト" do
before do
sign_in user
visit new_post_path
end
context "投稿が成功したとき" do
it "投稿成功後の遷移先が正しいか" do
# contentのフォームにFakerでランダムな５文字の文字列を入れる
fill_in 'post[content]', with: Faker::Lorem.characters(number: 5)
# 投稿ボタンをクリック
click_button "投稿"
# 投稿成功後の遷移先が期待したパスになっているか
expect(page).to have_current_path posts_path
end
it "投稿成功後の表示の確認" do
# contentのフォームにFakerでランダムな５文字の文字列を入れる
fill_in 'post[content]', with: Faker::Lorem.characters(number: 5)
# 投稿ボタンをクリック
click_button "投稿"
# 投稿が成功して"投稿が成功しました"の文字があるか
expect(page).to have_content "投稿に成功しました"
end
end
context "投稿が失敗したとき" do
it "投稿失敗後の遷移先が正しいか" do
# contentのフォームを空にする
fill_in 'post[content]', with: nil
# 投稿ボタンをクリック
click_button "投稿"
# エラーが起きて選先が期待したパスになっているか
expect(page).to have_current_path posts_path
end
it "投稿失敗後の表示の確認" do
# contentのフォームを空にする
fill_in 'post[content]', with: nil
# 投稿ボタンをクリック
click_button "投稿"
# エラーが出てエラーメッセージが表示されているか
expect(page).to have_content "入力してください"
end
end
end
describe "削除のテスト" do
before do
sign_in user
visit posts_path
end
it "削除リンクが表示されているか" do
# 削除のパスへのリンクがあるか
expect(page).to have_link "", href: post_path(post)
end
it "削除されるか" do
# 削除された時データベースから削除されているか
expect { post.destroy }.to change(Post, :count).by(-1)
end
end
end
マッチャーについてわからない方はこちらの記事参照
[Rails]RSpecでよく使うマッチャー10選
まとめ
system specでコントローラーのテストを実施する手順は４つです。
system specファイルの作成
deviseのヘルパーを使えるようにする
capybaraの設定
テストコードを書いていく
今回はかんたんな投稿と削除機能のみでしたが、今後も色んなテストコードを投稿していきたいと思います。
