Class: RailsOmnibar

Inherits:
Object
  • Object
show all
Defined in:
lib/rails_omnibar.rb,
lib/rails_omnibar/items.rb,
lib/rails_omnibar/config.rb,
lib/rails_omnibar/engine.rb,
lib/rails_omnibar/version.rb,
lib/rails_omnibar/commands.rb,
lib/rails_omnibar/item/base.rb,
lib/rails_omnibar/item/help.rb,
lib/rails_omnibar/rendering.rb,
lib/rails_omnibar/command/base.rb,
lib/rails_omnibar/command/search.rb

Defined Under Namespace

Modules: Command, Item Classes: BaseController, Engine, HtmlController, JsController, QueriesController

Constant Summary collapse

VERSION = 
'1.4.0'

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#calculator=(value) ⇒ Object (writeonly)

Sets the attribute calculator

Parameters:

  • value —

    the value to set the attribute calculator to.



27
28
29
 
# File 'lib/rails_omnibar/config.rb', line 27

def calculator=(value)
  @calculator = value
end

#modal=(value) ⇒ Object (writeonly)

Sets the attribute modal

Parameters:

  • value —

    the value to set the attribute modal to.



22
23
24
 
# File 'lib/rails_omnibar/config.rb', line 22

def modal=(value)
  @modal = value
end

#placeholder ⇒ Object 



41
42
43
44
45
46
 
# File 'lib/rails_omnibar/config.rb', line 41

def placeholder
  return @placeholder.presence unless @placeholder.nil?

  help_item = items.find { |i| i.type == :help }
  help_item && "Hint: Type `#{help_item.title}` for help"
end

Class Method Details

.cast_to_command(arg) ⇒ Object 



17
18
19
20
21
22
23
 
# File 'lib/rails_omnibar/commands.rb', line 17

def self.cast_to_command(arg)
  case arg
  when Command::Base then arg
  when Hash          then Command::Base.new(**arg)
  else raise(ArgumentError, "expected command, got #{arg.class}")
  end
end

.cast_to_item(arg) ⇒ Object 



13
14
15
16
17
18
19
 
# File 'lib/rails_omnibar/items.rb', line 13

def self.cast_to_item(arg)
  case arg
  when Item::Base then arg
  when Hash       then Item::Base.new(**arg)
  else raise(ArgumentError, "expected Item, got #{arg.class}")
  end
end

.cast_to_proc(arg) ⇒ Object 



25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
 
# File 'lib/rails_omnibar/commands.rb', line 25

def self.cast_to_proc(arg)
  arg = arg.method(:call).to_proc if arg.respond_to?(:call) && !arg.is_a?(Proc)
  arg.is_a?(Proc) && arg.parameters.count { |type, _| type == :req } == 1 ||
    raise(ArgumentError, "must be a proc that takes one positional argument")

  if arg.arity == 1
    # normalize for easier calling
    return ->(v, controller:, omnibar:) { arg.call(v) }
  end

  unsupported = arg.parameters.reject do |type, name|
    type == :req || type == :keyreq && name.in?(%i[controller omnibar])
  end
  unsupported.empty? ||
    raise(ArgumentError, "unsupported proc params: #{unsupported}")

  arg
end

.like ⇒ Object 



69
70
71
 
# File 'lib/rails_omnibar/command/search.rb', line 69

def self.like
  @like ||= ActiveRecord::Base.connection.adapter_name =~ /^post|pg/i ? 'ILIKE' : 'LIKE'
end

Instance Method Details

#add_command(command) ⇒ Object 



11
12
13
14
15
 
# File 'lib/rails_omnibar/commands.rb', line 11

def add_command(command)
  check_const_and_clear_cache
  commands << RailsOmnibar.cast_to_command(command)
  self
end

#add_help(**kwargs) ⇒ Object 



2
3
4
 
# File 'lib/rails_omnibar/item/help.rb', line 2

def add_help(**kwargs)
  add_item Item::Help.new(for_commands: commands, **kwargs)
end

#add_item(item) ⇒ Object 



2
3
4
5
6
 
# File 'lib/rails_omnibar/items.rb', line 2

def add_item(item)
  check_const_and_clear_cache
  items << RailsOmnibar.cast_to_item(item)
  self
end

#add_items(*args) ⇒ Object 



8
9
10
11
 
# File 'lib/rails_omnibar/items.rb', line 8

def add_items(*args)
  args.each { |arg| add_item(arg) }
  self
end

#add_record_search(**kwargs) ⇒ Object 



6
7
8
 
# File 'lib/rails_omnibar/command/search.rb', line 6

def add_record_search(**kwargs)
  add_command Command::RecordSearch.new(**kwargs)
end

#add_search(**kwargs) ⇒ Object 



2
3
4
 
# File 'lib/rails_omnibar/command/search.rb', line 2

def add_search(**kwargs)
  add_command Command::Search.new(**kwargs)
end

#as_json ⇒ Object 



17
18
19
20
21
22
23
24
25
26
27
28
 
# File 'lib/rails_omnibar/rendering.rb', line 17

def as_json(*)
  {
    calculator:     calculator?,
    commandPattern: JsRegex.new!(command_pattern, target: 'ES2018'),
    hotkey:         hotkey,
    items:          items,
    maxResults:     max_results,
    modal:          modal?,
    placeholder:    placeholder,
    queryPath:      urls.query_path(omnibar_class: omnibar_class),
  }
end

#auth=(arg) ⇒ Object 



7
8
9
 
# File 'lib/rails_omnibar/config.rb', line 7

def auth=(arg)
  @auth = RailsOmnibar.cast_to_proc(arg)
end

#authorize(controller) ⇒ Object 



10
11
12
 
# File 'lib/rails_omnibar/config.rb', line 10

def authorize(controller)
  @auth ? @auth.call(controller, controller: controller, omnibar: self) : true
end

#calculator? ⇒ Boolean

Returns:

  • (Boolean) 


28
29
30
 
# File 'lib/rails_omnibar/config.rb', line 28

def calculator?
  instance_variable_defined?(:@calculator) ? !!@calculator : true
end

#command_pattern ⇒ Object 



7
8
9
 
# File 'lib/rails_omnibar/commands.rb', line 7

def command_pattern
  commands.any? ? Regexp.union(commands.map(&:pattern)) : /$NO_COMMANDS/
end

#configure(&block) ⇒ Object 



2
3
4
5
 
# File 'lib/rails_omnibar/config.rb', line 2

def configure(&block)
  check_const_and_clear_cache
  tap(&block)
end

#handle(input, controller) ⇒ Object 



2
3
4
5
 
# File 'lib/rails_omnibar/commands.rb', line 2

def handle(input, controller)
  handler = commands.find { |h| h.pattern.match?(input) }
  handler&.call(input, controller: controller, omnibar: self) || []
end

#hotkey ⇒ Object 



32
33
34
 
# File 'lib/rails_omnibar/config.rb', line 32

def hotkey
  @hotkey || 'k'
end

#hotkey=(arg) ⇒ Object 



35
36
37
38
 
# File 'lib/rails_omnibar/config.rb', line 35

def hotkey=(arg)
  arg.to_s.size == 1 || raise(ArgumentError, 'hotkey must have length 1')
  @hotkey = arg.to_s.downcase
end

#html_url ⇒ Object 



11
12
13
 
# File 'lib/rails_omnibar/rendering.rb', line 11

def html_url
  urls.html_path(omnibar_class: omnibar_class)
end

#max_results ⇒ Object 



18
19
20
 
# File 'lib/rails_omnibar/config.rb', line 18

def max_results
  @max_results || 10
end

#max_results=(arg) ⇒ Object 



14
15
16
17
 
# File 'lib/rails_omnibar/config.rb', line 14

def max_results=(arg)
  arg.is_a?(Integer) && arg > 0 || raise(ArgumentError, 'max_results must be > 0')
  @max_results = arg
end

#modal? ⇒ Boolean

Returns:

  • (Boolean) 


23
24
25
 
# File 'lib/rails_omnibar/config.rb', line 23

def modal?
  instance_variable_defined?(:@modal) ? !!@modal : false
end

#render ⇒ Object 



2
3
4
5
6
7
8
9
 
# File 'lib/rails_omnibar/rendering.rb', line 2

def render
  @cached_html ||= <<~HTML.html_safe
    <script src='#{urls.js_path}?v=#{RailsOmnibar::VERSION}' type='text/javascript'></script>
    <div id='mount-rails-omnibar'>
      <script type="application/json">#{to_json}</script>
    </div>
  HTML
end

#urls ⇒ Object 



30
31
32
 
# File 'lib/rails_omnibar/rendering.rb', line 30

def urls
  @urls ||= RailsOmnibar::Engine.routes.url_helpers
end