Sha256: 34de37be9818f5f4fcfc6ac5bc03622a208f29eeca9b14234c316caa91adba39

Contents?: true

Size: 1.27 KB

Versions: 38

Compression:

Stored size: 1.27 KB

Contents

# frozen_string_literal: true

module ActiveSupport
  # = Actionable Errors
  #
  # Actionable errors lets you define actions to resolve an error.
  #
  # To make an error actionable, include the +ActiveSupport::ActionableError+
  # module and invoke the +action+ class macro to define the action. An action
  # needs a name and a block to execute.
  module ActionableError
    extend Concern

    class NonActionable < StandardError; end

    included do
      class_attribute :_actions, default: {}
    end

    def self.actions(error) # :nodoc:
      case error
      when ActionableError, -> it { Class === it && it < ActionableError }
        error._actions
      else
        {}
      end
    end

    def self.dispatch(error, name) # :nodoc:
      actions(error).fetch(name).call
    rescue KeyError
      raise NonActionable, "Cannot find action \"#{name}\""
    end

    module ClassMethods
      # Defines an action that can resolve the error.
      #
      #   class PendingMigrationError < MigrationError
      #     include ActiveSupport::ActionableError
      #
      #     action "Run pending migrations" do
      #       ActiveRecord::Tasks::DatabaseTasks.migrate
      #     end
      #   end
      def action(name, &block)
        _actions[name] = block
      end
    end
  end
end

Version data entries

38 entries across 38 versions & 6 rubygems

Version Path
activesupport-8.0.0 lib/active_support/actionable_error.rb
activesupport-7.2.2 lib/active_support/actionable_error.rb
activesupport-7.1.5 lib/active_support/actionable_error.rb
activesupport-8.0.0.rc2 lib/active_support/actionable_error.rb
activesupport-7.2.1.2 lib/active_support/actionable_error.rb
activesupport-7.1.4.2 lib/active_support/actionable_error.rb
activesupport-8.0.0.rc1 lib/active_support/actionable_error.rb
activesupport-7.2.1.1 lib/active_support/actionable_error.rb
activesupport-7.1.4.1 lib/active_support/actionable_error.rb
activesupport-8.0.0.beta1 lib/active_support/actionable_error.rb
omg-activesupport-8.0.0.alpha9 lib/active_support/actionable_error.rb
omg-activesupport-8.0.0.alpha8 lib/active_support/actionable_error.rb
omg-activesupport-8.0.0.alpha7 lib/active_support/actionable_error.rb
omg-activesupport-8.0.0.alpha4 lib/active_support/actionable_error.rb
omg-activesupport-8.0.0.alpha3 lib/active_support/actionable_error.rb
omg-activesupport-8.0.0.alpha2 lib/active_support/actionable_error.rb
omg-activesupport-8.0.0.alpha1 lib/active_support/actionable_error.rb
activesupport-7.1.4 lib/active_support/actionable_error.rb
activesupport-7.2.1 lib/active_support/actionable_error.rb
activesupport-7.2.0 lib/active_support/actionable_error.rb