active って名前で誤魔化すな / DON'T JUST CALL IT "ACTIVE"

Transcript

1. activ Gotanda.rb#69 ‧ 2026/08/26 activeって名前で誤魔化すな active って名前が使われすぎていたので分析したら、様々な意味で使われていたので整理しよう @hatsu_38 ‧
2. 02 · SELF INTRODUCTION ⾃⼰紹介 2019.4 フリーランス 2024.6 SHE.inc 2024.10 Kaigi on Rails で CIの話をした 2026.09 KoR落ちたので RailsTokyo#6で話します @hatsu_38 02 / 11
3. ３ · NAME IS IMPORTANT 名前重要 私の設計上の座右の銘は「名前重要」です。あらゆる機能をデザインす る時に、私はその名前にもっともこだわります。プログラマとしてのキャ リアの中で、適切な名前をつけることができた機能は成功し、そうでな い機能については後で後悔することが多かったように思うからです。 参考: プログラマが知るべき97のこと ‒ まつもとゆきひろ Gotanda.rb activeって名前で誤魔化さない 03 / 11
4. 04 · KEY NUMBERS active って名前多すぎない？ 280個 37個 13% ActiveRecord を継承した Model数 Enum の active 17個 + scope: :active 20個 active の scope が存在する率 2026/08/26 時点の話 ActiveRecord とかの話ではなく、Enum とか カラムとかの話です active を含むscope全体: 52 active を含む明⽰的なメソッド全体: 63 Gotanda.rb activeって名前で誤魔化すな 04 / 11
5. 05 · ACTIVE MEAN active の意味はなんでしょう？ active? の実例です event.active? coupon.active? イベントが予約可能？ クーポンが利⽤可能？ イベントが公開されている？ クーポンの期限が切れていない？ イベントが開催期間中である？ クーポンがアーカイブされていない？ イベントがキャンセルされていない？ Gotanda.rb activeって名前で誤魔化さない 05/ 11
6. 06 · ACTIVE MEAN active の意味はなんでしょう？ active? の実例です event.active? coupon.active? イベントが予約可能？ クーポンが利⽤可能？ イベントが公開されている？ クーポンの期限が切れていない？ イベントが開催期間中である？ クーポンがアーカイブされていない？ イベントがキャンセルされていない？ Gotanda.rb activeって名前で誤魔化さない 06 / 11
7. むずいって！！！ event.active? と coupon.active? は、同じ英単語なのに問いがまったく違う。 event.active? → ⼀般公開されている coupon.active? → 期限を過ぎていない order.active? → 注⽂がキャンセルされていない lesson.active? → 予約が可能 active だけを読んでも、公開‧時間‧利⽤可否‧ライフサイクルのどれを表すのか分からない。 Gotanda.rb activeって名前で誤魔化さない 07 / 11
8. 08 · WHAT DOES "ACTIVE" MEAN? そもそも active の意味は？ 活動的な、活発な、敏活な、積極的な、意欲的な、活気のあ る、盛んな、現に活動中の、有効な、効⼒のある 参考: active — Weblio英和‧和英辞典 active 活動中 有効な 効⼒のある 盛んな 活発な Gotanda.rb activeって名前で誤魔化さない 07 / 19
9. 09 · WHAT DOES "ACTIVE" MEAN? そもそも active の意味は？ 活動的な、活発な、敏活な、積極的な、意欲的な、活気のあ る、盛んな、現に活動中の、有効な、効⼒のある 参考: active — Weblio英和‧和英辞典 active 活動中 Model 説明 Coupon 有効期間中のクーポン(利⽤可能とは⾔ってない) Lesson 予約可能なレッスン(公開中かつ満員じゃない) Event 公開されているイベント(予約できるとは⾔ってない) Order キャンセルになっていない注⽂ Membership 契約が⼊会中(⼊会前でもなく、退会もしていない) BankAccount 有効な⼝座(審査が完了して、利⽤可能な唯⼀の⼝座) 有効な 効⼒のある 盛んな 活発な active でも間違ってはいないが、より相応しい⾔葉がある！ reservable や publish や ongoing や joined など Gotanda.rb activeって名前で誤魔化さない 09 / 11
10. 10 · WHAT DOES "ACTIVE" MEAN? 利用されている active を⼤別する 01: 積極的‧意欲的 02: 現に活動中の 03: 有効な、効⼒のある 性格や性質を表した active ライフサイクルの中にある active 「使えるか」の判断を返す active まだ終わっていない 予約できる? 性格 : おだやか / 積極的 / etc. 待機中・処理中・休会中などを まとめて active と呼ぶ 公開中？ 期間内？ 空きあり？ 対象者？ 動いている最中 pending → active → archived の 真ん中の状態 Gotanda.rb activeって名前で誤魔化さない 10 / 11
11. 11 · WHY USE "ACTIVE" MEAN? active が使われる理由 実例は「公開」「期間中」「利⽤可能」「存続中」などがあった が、 active はより抽象的な概念でこれらを包括している active 活動中 「やばい」と⾔っておけば、⽐較的多くの場⾯に当てはまる かのように active を使っておけば間違った表現ではない 有効な 効⼒のある 盛んな 抽象的な名前であれば、メソッド名を変えずに中⾝だけ変え ることが容易になる 活発な 「やばい」 と同じように active も⾔語化をサボりやすい「楽」な⾔葉として使ってしまっている Gotanda.rb activeって名前で誤魔化さない 11 / 11
12. 12 · USE "ACTIVE" RESPONSIBLY active のご利用は計画的に • 抽象的な⾔葉は便利なのであらゆるところで出現する • 広く使われると、本来の意味が希釈されて誤った⽤法でも使われる • 誤った⽤法で使われてしまうと、正しい⽤法の箇所も疑ってしまう • うちのリポジトリを⾒ていても気になったし、あるあるだと思う Gotanda.rb activeって名前で誤魔化さない 11 / 11