プラグインの使用

プラグインはRigorにフレームワーク、gem、またはアプリケーションDSLについて教えます——Railsのルートヘルパー、RSpecのletバインディング、dry-rbのstruct属性など、通常の推論では見えないものです。このページはプラグインの有効化について説明します。プラグインの作成はexamples/とrigor-plugin-authorスキルでカバーされています。

プラグインを有効化する

設定ファイルのplugins:キーの下にプラグインを列挙します:

plugins:
  - rigor-activerecord
  - rigor-rspec
  - rigor-rails-routes

各名前はrigortype gem内にバンドル済みのプラグインです——追加のインストールは不要です。plugins:の下に列挙するだけで有効化できます。設定が必要なプラグインはオブジェクト形式を使います:

plugins:
  - gem: rigor-activerecord
    config:
      schema: db/schema.rb

利用可能なプラグイン

Rigorはplugins/配下にプロダクションプラグインのカタログを同梱しています。リリース間でセットは増えます——現在のリストと各プラグインのオプションはそのディレクトリを参照してください——現在のファミリーは以下のとおりです:

• Rails — rigor-activerecord、rigor-actionpack、rigor-rails-routes、rigor-rails-i18n、rigor-actionmailer、rigor-activejob、rigor-activestorage、rigor-actioncable。rigor-railsメタgemはGemfileの利便性のためにRailsセットをバンドルしています。plugins:の下に使いたい個別プラグインは引き続き列挙する必要があります。
• Testing — rigor-rspec、rigor-rspec-rails、rigor-minitest、rigor-shoulda-matchers、rigor-factorybot。
• dry-rb — rigor-dry-types、rigor-dry-schema、rigor-dry-struct、rigor-dry-validation。
• その他のエコシステム — rigor-sinatra、rigor-hanami、rigor-devise、rigor-pundit、rigor-sidekiq、rigor-graphql、rigor-statesman、rigor-sorbet、rigor-typescript-utility-types、rigor-activesupport-core-ext。

plugins/ vs examples/

plugins/は実際のgemとフレームワーク向けのプロダクションプラグイン——有効化するもの——を保持しています。examples/ツリーは意図的に単純化されたDSL上のチュートリアルプラグインを保持しています。プラグイン作者向けの読み物であり、実際のプロジェクトで有効化するためのものではありません。

サンドボックス

プラグインはファイル（スキーマダンプ）を読み込んだりネットワークに接続したりしたい場合があります。それらはplugins_io:設定キーでゲートされています——ネットワークはデフォルトでdisabledで、プラグインはリストしたパスのみ読み込めます。設定を参照してください。