開発

2017.11.16

Ruby: Dry-rb gemシリーズのラインナップと概要

hachi8833

シェア
ツイート
ブックマーク
LINE

こんにちは、hachi8833です。

先ごろRubyWorld ConferenceでRuby Prize 2017を受賞された@solnicことPiotr Solnicaさんが近年力を入れているのがdry-rbシリーズです。

@solnicさんはあのVirtusの作者でもあるのですが、現在VirtusのREADMEには、Virtusの機能を分割改良してdry-rbにしたとあります。

Virtusを作ったことで、Rubyにおけるデータの扱い、中でもcoercion/型安全/バリデーションについて多くのことを学べました。このプロジェクトは成功を収めて多くの人々が役立ててくれましたが、私はさらによいものを作ることを決心しました。その結果、dry-types、dry-struct、dry-validationが誕生しました。これらのプロジェクトはVirtusの後継者と考えるべきであり、考慮点やより優れた機能がさらにうまく分割されています。Virtusが解決しようとした同種の現代的な問題について関心がおありの方は、ぜひdryシリーズのプロジェクトもチェックしてみてください。

@solnic
https://github.com/solnic/virtus より抄訳

Virtusは長く使われていて枯れているせいか、何年も更新されていません。
また、Virtusの動作が確認されているのはRuby 1.9.3/2.0.0/2.1.2/jrubyであるとのことなので、今後はdry-rbを使うのがよさそうです。そこで、とりあえずどんなgemがあるのかというレベルで少し調べてみました。

なお、dry-rbにはDiscourseで作られたフォーラムがあり、質問にはこちらを使って欲しいそうです。

dry-rbシリーズのラインナップ

dry-rb.orgより

dry-rbシリーズのgem同士の依存関係だけ、とりあえず.gemspecファイルを元にがんばって図にしてみました（draw.ioで作成）。ざっと見た限りでは、dry-validationとdry-structを使えばVirtusとだいたい同じことができそうです。これらをインストールすると、dry-coreやdry-typeなどの依存gemもインストールされます。

以下はhttp://dry-rb.org/gems/の記載順です。多くのgemは互いに依存関係にあります。11月7日時点のものなので、今後変わる可能性があります。gem名直後のかっこ内はバージョン番号です。

dry-validation（0.11.1）

述語論理に基づいたバリデーションを行うgemです。ドキュメントには、ActiveRecord/ActiveModel::Validationとstrong_parametersより数倍速いとあります（使うかどうかはまた別の問題です）。以下のようなユースケースを含む多くの使いみちがあります。

Form params
“GET” params
JSON/YAMLドキュメント
アプリの設定（ENVに保存されているなど）
ActiveRecord/ActiveModel::Validationsの置き換え
strong-parametersの置き換え

# dry-rb.orgより
schema = Dry::Validation.Form do
  required(:name).filled
  required(:age).filled(:int?, gt?: 18)
end

schema.("name" => "Jane", "age" => "30").to_h
# => {name: "Jane", age: 30}

schema.("name" => "Jane", "age" => "17").messages
# => {:age=>["must be greater than 18"]}

依存gem

'concurrent-ruby', '~> 1.0'
'dry-configurable', '~> 0.1', '>= 0.1.3'
'dry-equalizer', '~> 0.2'
'dry-logic', '~> 0.4', '>= 0.4.0'
'dry-types', '~> 0.12.0'
'dry-core', '~> 0.2', '>= 0.2.1'

dry-types（0.12.2）

さまざまなビルトイン型を用いて柔軟な型システムを提供します。利用できる型リストにはTypes::Form::TimeやTypes::Maybe::Strict::IntやTypes::Maybe::Coercible::Arrayといった膨大な種類の型が含まれています。

# dry-rb.orgより
require 'dry-types'
require 'dry-struct'

module Types
  include Dry::Types.module
end

class User < Dry::Struct
  attribute :name, Types::String
  attribute :age,  Types::Int
end

User.new(name: 'Bob', age: 35)
# => #<User name="Bob" age=35>

依存gem

'concurrent-ruby', '~> 1.0'
'dry-core', '~> 0.2', '>= 0.2.1'
'dry-container', '~> 0.3'
'dry-equalizer', '~> 0.2'
'dry-configurable', '~> 0.1'
'dry-logic', '~> 0.4', '>= 0.4.2'
'inflecto', '~> 0.0.0', '>= 0.0.2'

dry-struct（0.4.0）

structに似たオブジェクトを扱える属性DSLです。constructor_typeで以下を指定することでさまざまな挙動のstructを定義できます。

:permissive: デフォルト
:schema
:strict
:strict_with_defaults
:weakと:symbolized

機能が絞り込まれており、属性のwriterは提供されていません（データオブジェクトとしての利用）。そうした目的にはdry-typesが向いているそうです。

# dry-rb.orgより
require 'dry-struct'

module Types
  include Dry::Types.module
end

class User < Dry::Struct
  attribute :name, Types::String.optional
  attribute :age, Types::Coercible::Int
end

user = User.new(name: nil, age: '21')

user.name # nil
user.age # 21

依存gem

'dry-equalizer', '~> 0.2'
'dry-types', '~> 0.12', '>= 0.12.2'
'dry-core', '~> 0.4', '>= 0.4.1'
'ice_nine', '~> 0.11'

dry-transaction（0.10.2）

ビジネストランザクションを記述するDSLを提供します。トランザクションをモジュール化して再利用したり、トランザクションに引数でステップを追加したりできます。

# dry-rb.orgより
class CreateUser
  include Dry::Transaction(container: Container)

  step :process, with: "operations.process"
  step :validate, with: "operations.validate"
  step :persist, with: "operations.persist"
end

依存gem

"dry-container", ">= 0.2.8"
"dry-matcher", ">= 0.5.0"
"dry-monads", ">= 0.0.1"
"wisper", ">= 1.6.0"

dry-container（0.6.0）

dry-auto_inject gemと組み合わせることで依存関係逆転の法則を利用できる、シンプルでスレッドセーフなIoC（制御の反転）コンテナです。ソフトウェアの密結合を避けるのに使います。

# dry-rb.orgより
container = Dry::Container.new
container.register(:parrot) { |a| puts a }

parrot = container.resolve(:parrot)
parrot.call("Hello World")
# Hello World
# => nil

依存gem

'concurrent-ruby', '~> 1.0'
'dry-configurable', '~> 0.1', '>= 0.1.3'

dry-equalizer（0.0.11）

等しいかどうかをチェックする各種メソッドを追加します。依存しているgemはありません。コアファイルはequalizer.rb 1つだけと、dry-rbシリーズの中では最もシンプルなgemのようです。RubyのModule Builderパターン #2で紹介されているように、equalizer.rbではModule Builderパターンが使われています。

# dry-rbより
class GeoLocation
  include Dry::Equalizer(:latitude, :longitude)

  attr_reader :latitude, :longitude

  def initialize(latitude, longitude)
    @latitude, @longitude = latitude, longitude
  end
end

point_a = GeoLocation.new(1, 2)
point_b = GeoLocation.new(1, 2)
point_c = GeoLocation.new(2, 2)

point_a.inspect    # => "#<GeoLocation latitude=1 longitude=2>"

point_a == point_b           # => true
point_a.hash == point_b.hash # => true
point_a.eql?(point_b)        # => true
point_a.equal?(point_b)      # => false

point_a == point_c           # => false
point_a.hash == point_c.hash # => false
point_a.eql?(point_c)        # => false
point_a.equal?(point_c)      # => false

dry-system（0.8.1）

システム設定の自動読み込みや依存関係の自動解決などを行います。以下のコードを見てもdry-containerやdry-auto_injectが使われているらしいことがわかります。
このライブラリはdry-webにも使われています。

# dry-rb.orgより
require 'dry/system/container'

class Application < Dry::System::Container
  configure do |config|
    config.root = Pathname('./my/app')
  end
end

# now you can register a logger
require 'logger'
Application.register('utils.logger', Logger.new($stdout))

# and access it
Application['utils.logger']

依存gem

'inflecto', '>= 0.0.2'
'concurrent-ruby', '~> 1.0'
'dry-core', '>= 0.3.1'
'dry-equalizer', '~> 0.2'
'dry-container', '~> 0.6'
'dry-auto_inject', '>= 0.4.0'
'dry-configurable', '~> 0.7', '>= 0.7.0'
'dry-struct', '~> 0.3'

dry-initializer（2.3.0）

パラメータやオプションの初期化を定義するDSLです。Rails向けのdry-initializer-railsもあります。依存gemはなく、これも非常にシンプルなソースです（initializer.rb）。

# dry-rb.orgより
require 'dry-initializer-rails'

class CreateOrder
  extend Dry::Initializer
  extend Dry::Initializer::Rails

  # Params and options
  param  :customer, model: 'Customer' # use either a name
  option :product,  model: Product    # or a class

  def call
    Order.create customer: customer, product: product
  end
end

customer = Customer.find(1)
product  = Product.find(2)

order = CreateOrder.new(customer, product: product).call
order.customer # => <Customer @id=1 ...>
order.product  # => <Product @id=2 ...>

dry-logic（0.4.2）

組み立て可能な述語論理機能を提供します。dry-typeやdry-validationでも使われています。

# dry-rb.orgより
require 'dry/logic'
require 'dry/logic/predicates'

include Dry::Logic

# Rule::Predicate will only apply its predicate to its input, that’s all

user_present = Rule::Predicate.new(Predicates[:key?]).curry(:user)
# here curry simply curries arguments, so we can prepare
# predicates with args without the input
# translating this into words: check the if input has the key `:user`

min_18 = Rule::Predicate.new(Predicates[:gt?]).curry(18)
# check the value is greater than 18

has_min_age = Operations::Key.new(min_18, name: [:user, :age])
# in this example the name options is been use for accessing
# the value of the input

user_rule = user_present & has_min_age

user_rule.(user: { age: 19 }).success?
# true

user_rule.(user: { age: 18 }).success?
# false

user_rule.(user: { age: 'seventeen' })
# ArgumentError: comparison of String with 18 failed

user_rule.(user: { })
# NoMethodError: undefined method `>' for nil:NilClass

user_rule.({}).success?
# false

依存gem

'dry-core', '~> 0.2'
'dry-container', '~> 0.2', '>= 0.2.6'
'dry-equalizer', '~> 0.2'

dry-matcher（0.6.0）

柔軟で高い表現力を持つパターンマッチャーを提供します。依存gemはありません。
dry-monads gemと組み合わせるとEitherMatcherというものも使えるようになります。

# dry-rb.orgより
require "dry-monads"
require "dry/matcher/either_matcher"

value = Dry::Monads::Either::Right.new("success!")

result = Dry::Matcher::EitherMatcher.(value) do |m|
  m.success do |v|
    "Yay: #{v}"
  end

  m.failure do |v|
    "Boo: #{v}"
  end
end

result # => "Yay: success!"

dry-monads（0.3.1）

Rubyの例外ハンドリングとは別のエラーハンドリングをモナド（monad）で提供します。
モナドはHaskellで中心となる概念だそうです。

参考: エラー処理の地学史、もしくはあなたがMaybeモナドを使うべき理由。

# dry-rb.orgより
require 'dry-monads'

M = Dry::Monads

maybe_user = M.Maybe(user).bind do |u|
  M.Maybe(u.address).bind do |a|
    M.Maybe(a.street)
  end
end

# If user with address exists
# => Some("Street Address")
# If user or address is nil
# => None()

# You also can pass a proc to #bind

add_two = -> (x) { M.Maybe(x + 2) }

M.Maybe(5).bind(add_two).bind(add_two) # => Some(9)
M.Maybe(nil).bind(add_two).bind(add_two) # => None()

依存gem

'dry-equalizer'
'dry-core', '~> 0.3', '>= 0.3.3'

dry-view（0.4.0）

Webのビューをビューコントローラ/レイアウト/テンプレートの3つの構成で記述できます。

ビューコントローラ

# dry-rb.orgより
require "dry-view"

class HelloView < Dry::View::Controller
  configure do |config|
    config.paths = [File.join(__dir__, "templates")]
    config.layout = "app"
    config.template = "hello"
  end

  expose :greeting
end

レイアウト (templates/layouts/app.html.erb)

<html>
  <body>
    <%= yield %>
  </body>
</html>

テンプレート (templates/hello.html.erb):

<h1>Hello!</h1>
<p><%= greeting %></p>

これで、レンダリングするビューコントローラを#callします。

view = HelloView.new
view.(greeting: "Greetings from dry-rb")
# => "<html><body><h1>Hello!</h1><p>Greetings from dry-rb!</p></body></html>

依存gem

"tilt", "~> 2.0"
"dry-core", "~> 0.2"
"dry-configurable", "~> 0.1"
"dry-equalizer", "~> 0.2"

dry-core（0.4.1）

dry-rbシリーズやROM（rom-rb: Ruby Object Mapper）共通のサポート用モジュールです。

キャッシュ
クラス属性（下サンプルコード）
クラスビルダー
特殊定数（EMPTY_ARRAYやUndefinedなど）
機能の非推奨化サポート
指定したタイミングでの拡張の読み込み

# dry-rb
require 'dry/core/class_attributes'

class MyClass
  extend Dry::Core::ClassAttributes

  defines :one, :two

  one 1
  two 2
end

class OtherClass < MyClass
  two 'two'
end

MyClass.one # => 1
MyClass.two # => 2

OtherClass.one # => 1
OtherClass.two # => 'two'

依存gem

'concurrent-ruby', '~> 1.0'

dry-web-roda（0.9.1）

dry-rbとrom-rb（データベース永続化用）をルーティングツリーキットのRoda gemと連携させたシンプルなWebスタックです。

本筋ではありませんが、ちょっとだけ動かしてみました。
以下を実行すると、Railsっぽくプロジェクトが生成されます（構成はだいぶ違いますが）。

gem install dry-web-roda
dry-web-roda new my_app

bundle install --path vendor/bundleしてからshotgun -p 3001 -o 0.0.0.0 config.ruするとhttp://0.0.0.0:3001/でアプリが開きました。shotgunって何だろうと思ったら、Rackを自動でリロードするgemでした。

依存gem

"dry-configurable", "~> 0.2"
"inflecto", "~> 0.0"
"roda", "~> 2.14"
"roda-flow", "~> 0.3"
"thor", "~> 0.19"

Railsコードを改善する7つの素敵なGem（翻訳）

Rails: Form ObjectとVirtusを使って属性をサニタイズする（翻訳）

RubyのModule Builderパターン #2 Module Builderパターンとは何か（翻訳）

シェア
ツイート
ブックマーク
LINE

Twitter: @hachi8833、GitHub: @hachi8833 コボラー、ITコンサル、ローカライズ業界、Rails開発を経てTechRachoの編集・記事作成を担当。これまでにRuby on Rails チュートリアル第2版のコンテンツ監修、Railsガイドのコンテンツ作成を担当。かと思うと、正規表現の粋を尽くした日本語エラーチェックサービス enno.jpを運営。実は最近Go言語が好きで、Goで書かれたRubyライクなGoby言語のメンテナーでもある。仕事に関係ないすっとこブログ「あけてくれ」は2000年頃から多少の中断をはさんで継続、現在はnote.comに移転。Amazonウィッシュリスト: https://bit.ly/32aAmiI

Ruby: Dry-rb gemシリーズのラインナップと概要

dry-rbシリーズのラインナップ

dry-validation（0.11.1）

依存gem

dry-types（0.12.2）

依存gem

dry-struct（0.4.0）

依存gem

dry-transaction（0.10.2）

依存gem

dry-container（0.6.0）

依存gem

dry-auto_inject（0.4.4）

依存gem

dry-equalizer（0.0.11）

dry-system（0.8.1）

依存gem

dry-configurable（0.7.0）

依存gem

dry-initializer（2.3.0）

dry-logic（0.4.2）

依存gem

dry-matcher（0.6.0）

dry-monads（0.3.1）

依存gem

dry-view（0.4.0）

依存gem

dry-core（0.4.1）

依存gem

dry-web-roda（0.9.1）

依存gem

関連記事

週刊Railsウォッチ（20191202前編）Rails 6のimplicit_order_columnはカスタマイズ可能、rubocop-rails 2.4.0リリース、Capistrano記事ほか

Kotlinの拡張機能で冗長な〇〇Utilsから脱却する

Rails: ビューでstrftimeを直書きするのはたぶんよくない（翻訳）

週刊Railsウォッチ（20191119後編）メソッド参照演算子が廃止、GitHub新機能続々、平成Ruby会議、GitHub OAuthバイパスほか

Rails 6の新しいデフォルト設定と安全な移行方法を詳しく解説（翻訳）

Rails 6の新しいデフォルト設定と安全な移行方法を詳しく解説（翻訳）

Rubyスタイルガイドを読む: 文法（5）ブロック、proc

RailsとPHP各フレームワークの「複数形」変換処理を比較してみる

eclipseが起動しなくなった

bootstrap のボタンドロップダウンの出現位置を固定する方法

Ruby 3.4に導入される次世代の帯域外ガベージコレクション（翻訳）

Safari 17.5で多数のリダイレクト画像にloading="lazy"を指定すると読み込まれない問題（翻訳）

Tailwind: メディアクエリに垂直方向のスクリーンサイズを追加する（翻訳）

複雑なファイル処理をサーバーレスでシンプルにする方法（翻訳）

Rails 8.0 Changelog（全項目リンク付き）

関連記事

週刊Railsウォッチ（20190115）Rubyの<=でクラス同士を比較、Rubyの記号の読み方いろいろ、Ruby C API解説サイトほか

Rails: dry-rbでForm Objectを作る（翻訳）

週刊Railsウォッチ（20171110）dry-rbでFormObjectを作る、RailsのSQLインジェクション手法サイト、年に1度だけ起きるバグほか

CONTACT