Module: OmniAuth::Strategy::ClassMethods

Defined in:
lib/omniauth/strategy.rb

Instance Method Summary collapse

Instance Method Details

#args(args = nil) ⇒ Object

Sets (and retrieves) option key names for initializer arguments to be recorded as. This takes care of 90% of the use cases for overriding the initializer in OmniAuth Strategies.



81
82
83
84
85
 
# File 'lib/omniauth/strategy.rb', line 81

def args(args = nil)
  @args = Array(args) and return if args
  existing = superclass.respond_to?(:args) ? superclass.args : []
  return @args || existing
end

#compile_stack(ancestors, method, context) ⇒ Object 



100
101
102
103
104
105
106
 
# File 'lib/omniauth/strategy.rb', line 100

def compile_stack(ancestors, method, context)
  stack = ancestors.inject([]) do |a, ancestor|
    a << context.instance_eval(&ancestor.send(method)) if ancestor.respond_to?(method) && ancestor.send(method)
    a
  end
  stack.reverse!
end

#configure(options = nil) {|Options| ... } ⇒ Object

This allows for more declarative subclassing of strategies by allowing default options to be set using a simple configure call.

Examples:

Using a yield to configure the default options.


class MyStrategy
  include OmniAuth::Strategy

  configure do |c|
    c.foo = 'bar'
  end
end

Using a hash to configure the default options.


class MyStrategy
  include OmniAuth::Strategy
  configure foo: 'bar'
end

Parameters:

  • options (Hash) (defaults to: nil) —

    If supplied, these will be the default options (deep-merged into the superclass's default options).

Yields:

  • (Options) —

    The options Mash that allows you to set your defaults as you'd like.



54
55
56
57
 
# File 'lib/omniauth/strategy.rb', line 54

def configure(options = nil)
  yield default_options and return unless options
  default_options.deep_merge!(options)
end

#default_options ⇒ Object

Returns an inherited set of default options set at the class-level for each strategy.



26
27
28
29
30
 
# File 'lib/omniauth/strategy.rb', line 26

def default_options
  return @default_options if @default_options
  existing = superclass.respond_to?(:default_options) ? superclass.default_options : {}
  @default_options = OmniAuth::Strategy::Options.new(existing)
end

#option(name, value = nil) ⇒ Object

Directly declare a default option for your class. This is a useful from a documentation perspective as it provides a simple line-by-line analysis of the kinds of options your strategy provides by default.

Examples:


class MyStrategy
  include OmniAuth::Strategy

  option :foo, 'bar'
  option 
end

Parameters:

  • name (Symbol) —

    The key of the default option in your configuration hash.

  • value (Object) (defaults to: nil) —

    The value your object defaults to. Nil if not provided.



74
75
76
 
# File 'lib/omniauth/strategy.rb', line 74

def option(name, value = nil)
  default_options[name] = value
end