Ruby on Railsチュートリアルに書いてないけど大切なこと

Ruby on Railsチュートリアルを一通りやってみて、とても難しいなと感じています。

原因は、覚えなくてはいけないことがあまりに多いこと。Convention over Configurationというコンセプトはいいのですが、構成ファイルより規約をということは、規約を覚えなければソースコードを読むこともできないということです。

チュートリアルでは、丁寧に説明されていますが、それでもわからないと感じたことがあるので調べてみました。

ここでは、わからないことのなかから大切だと思う2つを取り上げます。

ルーティング

RESTfulなインターフェースを一言でいうと、あるアドレスにアクセスするとあら不思議、入力したデータを保存したり変更、削除ができてしまうということです。普段インターネットを見ているには、表示することしかやっていないです。それを拡張したと思えばよいでしょう。

そのようなアドレスと処理するメソッドを結びつけるのがルーティングです。どこにアクセスしたら何をするかを表しています。チュートリアルで勉強してみて、一番大切ではないかと思っています。

Railsがどのようなルーティングを設定しているかを表示するのがrails routesというコマンドです。

rails routes

このコマンドで、次のような表が得られます。

                 Prefix Verb   URI Pattern                             Controller#Action        
    password_resets_new GET    /password_resets/new(.:format)          password_resets#new      
   password_resets_edit GET    /password_resets/edit(.:format)         password_resets#edit     
                   root GET    /                                       static_pages#home        
                   help GET    /help(.:format)                         static_pages#help        
                  about GET    /about(.:format)                        static_pages#about       
                contact GET    /contact(.:format)                      static_pages#contact     
                 signup GET    /signup(.:format)                       users#new                
                        POST   /signup(.:format)                       users#create             
                  login GET    /login(.:format)                        sessions#new             
                        POST   /login(.:format)                        sessions#create          
                 logout DELETE /logout(.:format)                       sessions#destroy         
                  users GET    /users(.:format)                        users#index              
                        POST   /users(.:format)                        users#create             
               new_user GET    /users/new(.:format)                    users#new                
              edit_user GET    /users/:id/edit(.:format)               users#edit               
                   user GET    /users/:id(.:format)                    users#show               
                        PATCH  /users/:id(.:format)                    users#update             
                        PUT    /users/:id(.:format)                    users#update             
                        DELETE /users/:id(.:format)                    users#destroy            
edit_account_activation GET    /account_activations/:id/edit(.:format) account_activations#edit 
        password_resets POST   /password_resets(.:format)              password_resets#create   
     new_password_reset GET    /password_resets/new(.:format)          password_resets#new      
    edit_password_reset GET    /password_resets/:id/edit(.:format)     password_resets#edit     
         password_reset PATCH  /password_resets/:id(.:format)          password_resets#update   
                        PUT    /password_resets/:id(.:format)          password_resets#update   
             microposts POST   /microposts(.:format)                   microposts#create        
              micropost DELETE /microposts/:id(.:format)               microposts#destroy       

どこにアクセスしたら(URI Pattern)、何を呼び出すか(Controller#Action)がわかります。

例えば、/usersにアクセスしたらusers#indexを呼び出します。つまり、users_controller.rbにあるUsersControllerというクラスのindexアクションメソッドを呼び出します。

実はそれだけでなく、プログラムの中でどのようなメソッドや変数が使えるかもここから読み取れます。

Prefixと書いてあるものに、_urlや_pathをつけるとアドレスを表すことができます。上の例では、password_resets_newに_urlをつけて、password_reset_new_urlでhttp://www.example.com/password_resets/newという絶対アドレスになります。_pathをつけて、password_reset_new_pathだと、ホスト名を除いた/password_resets/newという相対アドレスになります。

また、edit_userのところのように:idというアドレスがつくものは、そこに数字が入ることを意味します。たとえば、/users/1というアドレスにアクセスしたら、プログラム上では、params[:id]=1として扱うことができます。

:idに数字が入るということは、アドレスにどのユーザーにアクセスしたいのか指定しなければなりません。そこで、プログラム上でedit_user_pathだけでは不十分で、edit_user_path(@user)というようにユーザーを指定して使うことになります。

VerbのGETやPOSTは、methodの種類です。同じアドレスにアクセスしてもmethodを指定することで違うことができると思えばいいでしょう。

Webアプリケーションは、あるアドレスにアクセスすることですべての動作が始まりますので、ルーティングはとても大切です。この表の読み方だけでも十分理解できると、後の理解の助けになると思います。

変数やアクションメソッドのスコープ

Ruby on Railsチュートリアルをやっていると、いろいろなファイルが出てきて、結局どのファイルでどんな変数やメソッドが使えるのか理解に苦しみました。

簡単にまとめると、ビュー内ではヘルパーすべてが使えます。コントローラー内のメソッドは使えません。

コントローラー内では、application_controller.rbでモジュールをincludeすることでそのコントローラーに関連する以外のヘルパーが使えるようになります。

モデルで定義したクラスは、コントローラー内で使えます。

もう少し詳しく説明します。

まず、app/viewsフォルダの中では、app/helpersの中で定義されたメソッドがすべて使えます。

app/controllers内ではshowやdestroyなどのRESTfulなアクションメソッドを書いて、app/helpers内のヘルパーにそれを補助するメソッドを書くのがいいです。

また、app/controllers内だけで使って他で使わないものは、そのファイルの中でprivate宣言の後に書くといいです。

次に、app/cotrollers内ではapp/controllers/sessions_controller.rbとapp/helpers/sessions_helper.rbのように関連するヘルパーのメソッドは使えます。しかし、関連しないusers_controller.rbからsessions_helper.rbはそのままでは使えません。そのため、app/controllers/application_controller.rb内でinclude SessionsHelperと指定することでcontroller内でsessionに関するメソッドが使えるようになります。

このとき、ファイル名はsessions_helper.rbですが、その中で定義されたモジュール名はSessionsHelperと表記方法が変わっていることに注意してください。

その他には、app/controllers内で@userのようにインスタンス変数を設定すると、それがapp/views内で使えます。app/viewsは通常のRubyのファイルではなく、controllerから呼び出されて使われるものというイメージです。

まとめ

Ruby on Railsチュートリアルをやってみて、あまり説明されていない2つを調べました。ルーティングと変数のスコープを把握しているとプログラム全体の構成がわかりやすくなります。

Railsは、規約が多いのでそれを覚えるだけで大変ですね。でも、重要度にいろいろとあると思うので、大切なものから理解していきたいものです。

Ruby on Railsチュートリアルでクッキーの削除を確認

Ruby on Railsチュートリアルの8.3演習2のクッキーの削除を確認しました。

最初、どうやって確認したらよいのかわかりませんでした。

同じように困った人がいて、次のような疑問が出ています。

railsログアウト時のCookiesの状態

まず、Chromeの設定、詳細設定、コンテンツの設定、Cookieというところで、クッキーの値を変化をログアウト前後で見てみたのですが、変化はありませんでした。

結局、Chromeのデベロッパーツールを開き、ApplicationのCookiesというところでクッキーの値を調べると、ログアウト前後で値が変わっていました。

チュートリアルでは、session.delete(:user_id)で:user_idの項目だけ削除しています。そのため、クッキー自体がなくなるわけではなく、その暗号化された値が変わるのを確認することで、削除されたことがわかります。

Chromeの設定画面では、その変化を表示できないようです。

なお、クッキー自体はChromeを閉じると消えてしまいます。

Ruby on Railsチュートリアルでbcryptのエラー

Ruby on Railsチュートリアルでbcryptのエラーが出ました。環境はWindows上のMSYS2+Ruby 2.4です。

C:/Ruby24-x64/lib/ruby/gems/2.4.0/gems/bcrypt-3.1.11-x64-mingw32/lib/bcrypt.rb:16:in `require': cannot load such file -- bcrypt_ext (LoadError)

こちらのようにしたら動きました。最後の'bcrypt-ruby'を設定する方法です。

gem 'bcrypt' で起動時Error&ページアクセス時にもError

bcrypt 3.1.11でWindowsの修正が入ったという情報がありますが、なぜか動ないんですよね。

Ruby on RailsチュートリアルでUserのデータベースマイグレーション

Ruby on Railsチュートリアルで第6章のユーザーのモデルを作成しているとき、rails db:migrateしてもrails testすると、

Migrations are pending. To resolve this issue, run:

        bin/rails db:migrate RAILS_ENV=test

というエラーになります。素直に、RAILS_ENVをつけてテストをすると、テストはパスします。

その後、validationでuniquenessをつけてまたmigrateしようとするとこんどは、migrateできないというエラーになります。

SQLite3::ConstraintException: UNIQUE constraint failed: users.email: CREATE UNIQUE INDEX "index_users_on_email" ON "users" ("email")

このときは、一度db:rollbackして、db:migrateするとうまくいきます。

test/fixtures/users.ymlを空にしてから、

rails db:rollback RAILS_ENV=test
rails db:migrate RAILS_ENV=test

チュートリアルでは、development環境で実行されているようですが、テストはtest環境で実行されているようで異なっています。

development環境とともにtest環境のデータベースも用意しないといけないようです。

Ruby on Railsチュートリアルでguardを使ったときのエラー

Ruby on Railsチュートリアルをやって、第3章の3.6.2 Guardによるテストの自動化をやったときのこと。

チュートリアル通りやっても、

No such file or directory - bin/rails test test/controllers/static_pages_controller_test.rb test/test_helper.rb

このようにファイルがないというエラーになります。調べたところ、こちらのようにGuardfileからspring: "bin/rails test"を消したら動くようになりました。

Guardfile

guard :minitest, all_on_start: false do # ここ
  watch(%r{^test/(.*)/?(.*)_test\.rb$})
  watch('test/test_helper.rb') { 'test' }
  ....
end

MSYS2+Ruby on RailsでPumaが終了できないときの対処法

MSYS2とRuby 2.4.0をこちらの情報をもとにインストールしました。

Ruby on Rails 5.1.1もインストールできました。

でも、rails serverコマンドでPumaを起動した後、Ctrl-Cで終了しようとしてもできません。プロンプトは返ってくるのですが、Pumaにシグナルが送られていなくてプロセスは起動したままになっています。こうなるとタスクマネージャーでRuby Interpreterを探してタスクを終了するしかなくなります。

対処方法として、MinttyをあきらめてWindows Consoleを使う方法と、winptyを使う方法、ConEmuを使う方法の3つがあります。

Windows Consoleを使う方法だと、lsで出力に色がついたときに、赤色と青色が暗くて読めなくなります。

winptyを使う方法だと、いちいちwinptyをつけてコマンドを実行しなくてはならず面倒です。

そこで、ConEmuを使ってみることにしました。

ConEmuは、こちらからダウンロードしてインストールします。

PATHに追加してconemu64で起動できるようにします。

次に、スタートメニューのMinGW 64-bitやMSYS2の項目を右クリックしてファイルの場所を開くでショートカットを表示します。

ショートカットのプロパティーで、-conemuを付け加えます。

C:\msys64\msys2_shell.cmd -mingw64 -conemu

これで、ConEmuが使えるようになります。

右上の三本のアイコンでsettingsを選ぶと、フォントの大きさも変えられます。また、マウスで選択することでコピーペーストもできるのでとりあえずいいかなと思っています。

ただ、irbやrails consoleで日本語が文字化けします。どうするか考え中です。

Ruby on Railsはバージョン管理が大変

Ruby on Railsチュートリアルをやり始めました。開発環境は、Ruby 2.4.0p0[x64-mingw32] + MSYS2です。

ちなみに、これまでRuby 2.4.0ではRailsがインストールできませんでした。nokogiri 1.7.2がRuby 2.3系しか対応していなかったためです。

2017/6/5になってnokogiri 1.8.0がリリースされてようやくインストールできるようになりました。

チュートリアルをやり始めてすぐエラーが出ました。

key must be 32 bytes

ということで、こちらの情報をもとにRailsを5.0.1に変更しました。

でも、これでHerokuにデプロイしてみるとH20(App boot timeout)というエラーになります。起動に時間がかかりすぎているというエラーです。

そこで、Railsのバージョンを5.0.3にしました。すると、普通に起動するようになりました。

Gemfile

gem 'Rails', '5.0.3'

また、rails testでエラーになります。こちらの情報をもとにminitestを5.10.1に指定しました。

minitestの5.10.2でtestが動作しないときに試すこと

これで、とりあえず動いています。

なんだか、少しバージョンが違っただけで動いたり動かなかったりするんですね。

このほかにも、win32consoleを入れた方がいいというメッセージが出て入れてみたりしました。rails testの時に色がつくそうです。

Herokuにデプロイしてみると、Windowsで作られたGemfile.lockは使えませんということで、作り直してくれているようです。RubyをWindowsで使うのはなかなか難しいなと思います。

Django Girls Tutorialをやり終えて

Django Girls Tutorialをやり終えました。

このTutorialの良いところは、Webアプリケーションを作る過程を一通りできることです。

作ったアプリケーションをHerokuで公開するところまで含まれていますので、簡単そうでしたが結構骨が折れました。

実際にやってみないとわからないことが多くありました。

Djangoを触ってみて一番驚いたのは、データの削除をするとき関連するデータまで削除してくれることです。

Tutorialの中で、ブログの記事とコメントを作るのですが、記事を削除すると関連する複数あったコメントまで同時に削除してくれます。データベースを見て確認しました。

自分で関連するコメントを選別して削除する必要はありませんでした。

データベースをきれいに保つには欠かせないと思います。

困った点は、Django Girls Tutorialの日本語版はバージョンが古いらしく、英語版のDjango Girls Tutorial:extensionsをやろうとすると、修正が必要だったことです。ただ、その原因を突きとめる過程で学ぶことが多くありました。

PythonでWebアプリケーションを作りたいとなったときに、Djangoを最初に学ぶには良いTutorialではないかと思います。