Module: Usable

Defined in:
lib/usable.rb,
lib/usable/config.rb,
lib/usable/struct.rb,
lib/usable/version.rb,
lib/usable/eager_load.rb,
lib/usable/config_multi.rb,
lib/usable/mod_extender.rb,
lib/usable/config_register.rb

Defined Under Namespace

Modules: ConfigMulti, ConfigRegister, EagerLoad Classes: Config, ModExtender, Railtie

Constant Summary collapse

VERSION = 
"3.7.0".freeze

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#usables ⇒ Object 



90
91
92
 
# File 'lib/usable.rb', line 90

def usables
  @usables ||= Config.new
end

Class Method Details

.copy_usables(context, recipient) ⇒ Object 



66
67
68
69
70
71
 
# File 'lib/usable.rb', line 66

def self.copy_usables(context, recipient)
  unless Usable.frozen?
    recipient.usables += context.usables
    Usable.extended_constants << recipient
  end
end

.extended(base) ⇒ Object 



38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
 
# File 'lib/usable.rb', line 38

def self.extended(base)
  if base.is_a? Class
    # Define an instance level version of +usables+
    base.class_eval do
      def usables
        self.class.usables
      end

      def usable_method(method_name)
        self.class.usable_method(self, method_name)
      end
    end
  end

  unless base.respond_to?(:config)
    base.instance_eval do
      def config(&block)
        if block
          usables.instance_eval &block
        else
          usables
        end
      end
    end
  end
  extended_constants << base unless Usable.frozen?
end

.extended_constants ⇒ Object

Keep track of extended classes and modules so we can freeze all usables on boot in production environments



24
25
26
 
# File 'lib/usable.rb', line 24

def self.extended_constants
  @extended_constants ||= Set.new
end

.freeze ⇒ Object 



28
29
30
31
32
33
34
35
36
 
# File 'lib/usable.rb', line 28

def self.freeze
  logger.debug { "freezing! #{extended_constants.to_a}" }
  extended_constants
  super
  # This may eager load classes, which is why we freeze ourselves first,
  # so the +extended+ hook doesn't try to modify @extended_constants while we're iterating over it
  extended_constants.each { |const| const.usables.freeze }
  self
end

.logger ⇒ Object 



9
10
11
12
13
14
15
16
17
 
# File 'lib/usable.rb', line 9

def self.logger
  @logger ||= begin
    require 'logger'
    Logger.new(STDOUT).tap do |config|
      config.formatter = proc { |*args| "[#{name}] #{args[0]}: #{args[-1]}\n" }
      config.level = Logger::ERROR
    end
  end
end

.logger=(obj) ⇒ Object 



19
20
21
 
# File 'lib/usable.rb', line 19

def self.logger=(obj)
  @logger = obj
end

.Struct(attributes = {}) ⇒ Object 



2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
 
# File 'lib/usable/struct.rb', line 2

def self.Struct(attributes = {})
  Class.new do
    extend Usable

    self.usables = Usable::Config.new(attributes)

    attributes.keys.each do |key|
      define_method(key) { @attrs[key] }
      define_method("#{key}=") { |new_val| @attrs[key] = new_val }
    end

    attr_accessor :attrs

    def initialize(attrs = {})
      @attrs = usables.merge(attrs)
    end
  end
end

Instance Method Details

#extended(base) ⇒ Object 



78
79
80
81
82
 
# File 'lib/usable.rb', line 78

def extended(base)
  base.extend(Usable) unless base.respond_to?(:usables)
  Usable.copy_usables(self, base)
  super
end

#included(base) ⇒ Object 



84
85
86
87
88
 
# File 'lib/usable.rb', line 84

def included(base)
  base.extend(Usable) unless base.respond_to?(:usables)
  Usable.copy_usables(self, base)
  super
end

#inherited(base) ⇒ Object 



73
74
75
76
 
# File 'lib/usable.rb', line 73

def inherited(base)
  Usable.copy_usables(self, base)
  super
end

#usable(*args, &block) ⇒ Object

Note:

Hides methods

Returns self.

Examples:


class Example
  extend Usable
  usable Mixin, only: [:foo, :bar] do
    baz "Available as `Example.usables.baz` or `Example.usables.mixin.baz`"
  end
end

Parameters:

  • mod (Module)
  • options (Hash) —

    Customize the extension of the module as well as define config settings on the target

  • [Array,Symbol] (Hash) —

    a customizable set of options

  • [String,Symbol] (Hash) —

    a customizable set of options

Returns:

  • self



113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
 
# File 'lib/usable.rb', line 113

def usable(*args, &block)
  options = args.last.is_a?(Hash) ? args.pop : {}
  args.each do |mod|
    ModExtender.new(mod, only: options.delete(:only), method: options.delete(:method)).call self
    # Define settings on @usables and on the scoped @usables
    scope = Config.new
    if mod.name
      scope_name = mod.name.split('::').last.gsub(/\B([A-Z])([a-z_0-9])/, '_\1\2').downcase
      usables[scope_name] = scope
    end
    if mod.respond_to? :usables
      scope += mod.usables
      self.usables += mod.usables
    end
    # any left over -options- are considered "config" settings
    if options
      [scope, usables].each { |x| options.each { |k, v| x[k] = v } }
    end
    if block_given?
      [scope, usables].each { |x| x.instance_eval &block }
    end
    if mod.const_defined?(:InstanceMethods, false)
      send :include, mod.const_get(:InstanceMethods, false)
    end
    if mod.const_defined?(:ClassMethods, false)
      send :extend, mod.const_get(:ClassMethods, false)
    end
  end
  self
end

#usable_method(context, method_name) ⇒ Method

Returns bound to the given -context-.

Returns:

  • (Method) —

    bound to the given -context-



145
146
147
 
# File 'lib/usable.rb', line 145

def usable_method(context, method_name)
  usables.available_methods[method_name].bind(context)
end