<h3>Active Supportとは</h3> <p>Active Supportは<a class="keyword" href="http://d.hatena.ne.jp/keyword/Ruby%20on%20Rails">Ruby on Rails</a>の<a class="keyword" href="http://d.hatena.ne.jp/keyword/%A5%B3%A5%F3%A5%DD%A1%BC%A5%CD%A5%F3%A5%C8">コンポーネント</a>であり、<a class="keyword" href="http://d.hatena.ne.jp/keyword/Ruby">Ruby</a>言語の拡張、ユーティリティ、その他横断的な作業を担っています。</p> <p>Active Supportは言語レベルで基本部分を底上げして豊かなものにし、<a class="keyword" href="http://d.hatena.ne.jp/keyword/Rails">Rails</a>アプリケーションの開発と<a class="keyword" href="http://d.hatena.ne.jp/keyword/Ruby%20on%20Rails">Ruby on Rails</a>それ自体の開発に役立てるべく作られています。 （引用：Active Support コア<a class="keyword" href="http://d.hatena.ne.jp/keyword/%B3%C8%C4%A5%B5%A1%C7%BD">拡張機能</a>） <a href="https://railsguides.jp/active_support_core_extensions.html">https://railsguides.jp/active_support_core_extensions.html</a></p> <p>StringやInteger、Date、Datetimeなどのコアなクラスのメソッドを拡張してくれるもの</p> <hr /> <h3>拡張対象</h3> <p>Active Supportが拡張する対象を ざっと挙げてみました（全部ではないです）</p> <ul> <li>Object</li> <li>Module</li> <li>Class</li> <li>String</li> <li>Numeric <ul> <li><a class="keyword" href="http://d.hatena.ne.jp/keyword/BigDecimal">BigDecimal</a></li> <li>Integer</li> </ul> </li> <li>Enumerable</li> <li>Array</li> <li>Hash</li> <li>Range</li> <li>Date</li> <li>Time</li> <li>File</li> <li>NameError</li> <li>LoadError</li> </ul> <p>...</p> <hr /> <h3>全てのオブジェクトで使える拡張</h3> <ul> <li>Object#blank?</li> <li>Object#present?</li> </ul> <p><a class="keyword" href="http://d.hatena.ne.jp/keyword/ruby">ruby</a>にあるのは<code>nil?</code>と<code>empty?</code>のみ</p> <pre class="code" data-lang="" data-unlink>nil.nil? =&gt; true [].empty? =&gt; true &#39;&#39;.empty? =&gt; true</pre> <hr /> <ul> <li>Object#blank?</li> </ul> <p><code>nil?</code>と<code>empty?</code>の合わせ技</p> <pre class="code" data-lang="" data-unlink>nil.blank? =&gt; true [].blank? =&gt; true &#39;&#39;.blank? =&gt; true nil.blank? =&gt; true</pre> <ul> <li>Object#present?</li> </ul> <p><code>!blank?</code>と同じ意味</p> <pre class="code" data-lang="" data-unlink>nil.present? =&gt; false [].present? =&gt; false [1,2,3].present? =&gt; true</pre> <p>blank?とpresent?の定義は下のURL先 <a href="https://github.com/rails/rails/blob/master/activesupport/lib/active_support/core_ext/object/blank.rb">https://github.com/rails/rails/blob/master/activesupport/lib/active_support/core_ext/object/blank.rb</a></p> <hr /> <ul> <li>Object#try</li> </ul> <p>おなじみtryメソッド。 レシーバが<a class="keyword" href="http://d.hatena.ne.jp/keyword/nil">nil</a>、もしくはメソッドが定義されていない時には<a class="keyword" href="http://d.hatena.ne.jp/keyword/nil">nil</a>を返す。<a class="keyword" href="http://d.hatena.ne.jp/keyword/nil">nil</a>でないなら引数で渡されたメソッドを実行。</p> <pre class="code" data-lang="" data-unlink>&#34;test&#34;.try(:name) =&gt; nil &#34;test&#34;.try(:size) =&gt; 4</pre> <ul> <li>Object#try!</li> </ul> <p><code>try</code>と違う点は、レシーバが<a class="keyword" href="http://d.hatena.ne.jp/keyword/nil">nil</a>なら<code>nil</code>でなく例外を返すところ。</p> <pre class="code" data-lang="" data-unlink>&#34;test&#34;.try!(:name) NoMethodError: undefined method `name&#39; for &#34;test&#34;:String # NoMethodErrorクラスの例外が発生</pre> <hr /> <ul> <li>Object#with_options</li> </ul> <p>オプションを一つにまとめられる。 <code>validates</code>メソッドのオプションを一つにまとめたりとかもできると思うよ。</p> <pre class="code" data-lang="" data-unlink>class Company &lt; ApplicationRecord ... has_many :contracts, dependent: :destroy has_one :billing_address, dependent: :destroy has_many :billings, dependent: :destroy ... end ↓ class Company &lt; ApplicationRecord ... with_options dependent: :destroy to |comp| comp.has_many :contracts comp.has_one :billing_address comp.has_many :billings ... end </pre> <hr /> <ul> <li>tapの補足</li> </ul> <p>ブロックを渡した場合には、<a class="keyword" href="http://d.hatena.ne.jp/keyword/nil">nil</a>でない場合のみブロックの評価を行い、tryの返り値はブロックの評価結果となる。</p> <pre class="code" data-lang="" data-unlink>array =&gt; [[&#34;test1&#34;, 1], [&#34;test2&#34;, 2]] array.try do |a| a.to_h end =&gt; {&#34;test1&#34;=&gt;1, &#34;test2&#34;=&gt;2} array.try do |a| a.to_h end.values =&gt; [1, 2] # Object#yield_selfも同様の挙動 array.yield_self do |a| a.to_h end.values =&gt; [1, 2]</pre> <hr /> <h3>Classの拡張</h3> <h4>class_attribute</h4> <p>継承可能なクラス属性を定義する。 以下のようなことができるようになる。</p> <ul> <li>子クラスで上書きが可能</li> <li>アクセサメソッドを自動で定義</li> <li>子クラスで定義されていなければ親クラスの値を参照</li> </ul> <p>親クラスの定数を汚染する恐れがない。<a class="keyword" href="http://d.hatena.ne.jp/keyword/%A5%A4%A5%F3%A5%B9%A5%BF%A5%F3%A5%B9">インスタンス</a>メソッド内からでもアクセスできる。</p> <pre class="code" data-lang="" data-unlink>class A class_attribute :x end class B &lt; A; end class C &lt; B; end A.x = :a B.x # =&gt; :a C.x # =&gt; :a B.x = :b A.x # =&gt; :a C.x # =&gt; :b C.x = :c A.x # =&gt; :a B.x # =&gt; :b # インスタンスからもアクセス・書き換え可能 # インスタンスからクラスのclass_attributeを書き換えることはない test = B.new test.x = :t test.x # =&gt; :t B.x = :b </pre> <hr /> <h3>Stringの拡張</h3> <ul> <li>活用系</li> </ul> <p>レシーバに対して何かしら操作を行う系</p> <pre class="code" data-lang="" data-unlink>&#34;tomato&#34;.pluralize =&gt; &#34;tomatoes&#34; &#34;katsui&#34;.pluralize =&gt; &#34;katsuis&#34;</pre> <hr /> <p>活用系の続き</p> <pre class="code" data-lang="" data-unlink>&#34;admin_user&#34;.camelize =&gt; &#34;AdminUser&#34; &#34;admin_user&#34;.camelize(:lower) =&gt; &#34;adminUser&#34; &#34;account/financial_account&#34;.camelize =&gt; &#34;Account::FinancialAccount&#34; # camelizeと反対の操作を行うのがunderscore &#34;Backoffice::UsersController&#34;.demodulize =&gt; &#34;UsersController&#34; &#34;::UsersController&#34;.demodulize =&gt; &#34;UsersController&#34;</pre> <hr /> <h3>Numericの拡張</h3> <ul> <li>バイト</li> </ul> <p>全ての数値が以下のメソッドに対応している。</p> <pre class="code" data-lang="" data-unlink>bytes kilobytes megabytes gigabytes terabytes petabytes exabytes</pre> <pre class="code" data-lang="" data-unlink>2.bytes =&gt; 2 2.kilobytes =&gt; 2048 2.megabytes =&gt; 2097152</pre> <hr /> <ul> <li>書式設定</li> </ul> <p>指定した形式で数値をフォーマットできる</p> <pre class="code" data-lang="" data-unlink># 電話番号 1234567.to_s(:phone) =&gt; &#34;123-4567&#34; 1234567891.to_s(:phone) =&gt; &#34;123-456-7891&#34; 1234567891.to_s(:phone, area_code: true) =&gt; &#34;(123) 456-7891&#34; // 桁区切り 12345678.to_s(:delimited) =&gt; &#34;12,345,678&#34; pry(main)&gt; 12345678.to_s(:delimited, delimiter: &#34;.&#34;) =&gt; &#34;12.345.678&#34; // 丸める 111.2345.to_s(:rounded) =&gt; &#34;111.235&#34; 111.2345.to_s(:rounded, precision: 2) =&gt; &#34;111.23&#34; 1112903.to_s(:rounded, precision: 3) =&gt; &#34;1112903.000&#34;</pre> <hr /> <h3>Enumerableの拡張</h3> <pre class="code" data-lang="" data-unlink># sum # 要素の合計値を返す # 数値でない場合は+を使ってsumを計算する [2,3,4].sum =&gt; 9 (1..10).sum =&gt; 55 %w(rb yml haml).sum =&gt; &#34;rbymlhaml&#34; # many? # collection.size &gt; 1　の短縮系 [1,2,3,4].many? =&gt; true # many?ではブロックの評価も行える # ブロックの場合、評価結果のcollection &gt; 1かどうか判定する [1,2,3,4].many? { |a| a % 2 == 0 } =&gt; true [1,2,3,4].many? { |a| a % 3 == 0 } =&gt; false # pluck # 指定したkeyに基づく配列を返す [ { id: 1 }, { id: 2 }, { id: 3 } ].pluck(:id) =&gt; [1, 2, 3]</pre> <hr /> <h3>Hashの拡張</h3> <pre class="code" data-lang="" data-unlink># deep_merge # レシーバと引数に同じkeyが存在し、かつ値がHashの時に下位のHashをmergeする {a: {b: 1}}.deep_merge({a: {c: 2}}) =&gt; {:a=&gt;{:b=&gt;1, :c=&gt;2}} # exceptとexcept! # 引数で指定したkeyがあればレシーバのHashから取り除く {a: 1, b: 2}.except(:a) =&gt; {:b=&gt;2} # stringify_keysとsymbolize_keys # レシーバのHashのkeyをシンボル→文字列に変換（stringify_keys） # レシーバのHashのkeyを文字列→シンボルに変換（symbolize_keys） {nil =&gt; nil, 1 =&gt; 1, a: :a}.stringify_keys =&gt; {&#34;&#34;=&gt;nil, &#34;1&#34;=&gt;1, &#34;a&#34;=&gt;:a} {nil =&gt; nil, 1 =&gt; 1, &#34;a&#34; =&gt; &#34;a&#34;}.symbolize_keys =&gt; {nil=&gt;nil, 1=&gt;1, :a=&gt;&#34;a&#34;} </pre> <hr /> <h3>まとめ</h3> <ul> <li><p>あなたが実装しようとしているメソッドは、既にActive Supportが提供しているかもしれないので、一旦落ち着いて探しましょう</p></li> <li><p>比較的Active Supportのドキュメントは読みやすく、発見も色々とあるので読んでみるといいよ！</p></li> </ul>