Class: Hammer::Command

Inherits:
Object
  • Object
show all
Defined in:
lib/hammer/command.rb

Overview

A single registered command on a Hammer class.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name:, desc: '', handler: nil) ⇒ Command

Returns a new instance of Command.



7
8
9
10
11
12
13
14
15
 
# File 'lib/hammer/command.rb', line 7

def initialize(name:, desc: '', handler: nil)
  @name     = name.to_s
  @desc     = desc.to_s.rstrip
  @handler  = handler
  @options  = []
  @examples = []
  @alts     = []
  @needs    = []
end

Instance Attribute Details

#alts ⇒ Object (readonly)

Returns the value of attribute alts.



4
5
6
 
# File 'lib/hammer/command.rb', line 4

def alts
  @alts
end

#cron ⇒ Object (readonly)

Returns the value of attribute cron.



4
5
6
 
# File 'lib/hammer/command.rb', line 4

def cron
  @cron
end

#desc ⇒ Object (readonly)

Returns the value of attribute desc.



4
5
6
 
# File 'lib/hammer/command.rb', line 4

def desc
  @desc
end

#examples ⇒ Object (readonly)

Returns the value of attribute examples.



4
5
6
 
# File 'lib/hammer/command.rb', line 4

def examples
  @examples
end

#handler ⇒ Object

Returns the value of attribute handler.



5
6
7
 
# File 'lib/hammer/command.rb', line 5

def handler
  @handler
end

#location ⇒ Object

Returns the value of attribute location.



5
6
7
 
# File 'lib/hammer/command.rb', line 5

def location
  @location
end

#name ⇒ Object (readonly)

Returns the value of attribute name.



4
5
6
 
# File 'lib/hammer/command.rb', line 4

def name
  @name
end

#needs ⇒ Object (readonly)

Returns the value of attribute needs.



4
5
6
 
# File 'lib/hammer/command.rb', line 4

def needs
  @needs
end

#options ⇒ Object (readonly)

Returns the value of attribute options.



4
5
6
 
# File 'lib/hammer/command.rb', line 4

def options
  @options
end

#prev_location ⇒ Object

Returns the value of attribute prev_location.



5
6
7
 
# File 'lib/hammer/command.rb', line 5

def prev_location
  @prev_location
end

Instance Method Details

#add_alt(name) ⇒ Object 



30
31
32
 
# File 'lib/hammer/command.rb', line 30

def add_alt(name)
  @alts << name.to_s
end

#add_example(text) ⇒ Object 



26
27
28
 
# File 'lib/hammer/command.rb', line 26

def add_example(text)
  @examples << text.to_s
end

#add_need(name) ⇒ Object 



34
35
36
 
# File 'lib/hammer/command.rb', line 34

def add_need(name)
  @needs << name.to_s
end

#add_option(option) ⇒ Object 



22
23
24
 
# File 'lib/hammer/command.rb', line 22

def add_option(option)
  @options << option
end

#brief ⇒ Object

First line of desc, used in the flat command listing.



18
19
20
 
# File 'lib/hammer/command.rb', line 18

def brief
  @desc.lines.first&.chomp.to_s
end

#cron_schedule ⇒ Object 



47
48
49
 
# File 'lib/hammer/command.rb', line 47

def cron_schedule
  @cron_schedule
end

#finalize! ⇒ Object

Auto-assign a single-letter short alias (first letter of the opt name) to any opt that does not already declare one. Explicit aliases and -h are reserved first, so they always win. On collision the opt simply gets no short form - long flag still works. Idempotent.



61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
 
# File 'lib/hammer/command.rb', line 61

def finalize!
  return if @finalized
  @finalized = true

  claimed = ['-h']
  @options.each do |o|
    o.aliases.each { |a| claimed << a if short_flag?(a) }
  end

  @options.each do |o|
    next if o.aliases.any? { |a| short_flag?(a) }
    short = "-#{o.name.to_s[0]}"
    next if claimed.include?(short)
    o.aliases << short
    claimed << short
  end
end

#matches?(name) ⇒ Boolean

Returns:

  • (Boolean) 


51
52
53
54
 
# File 'lib/hammer/command.rb', line 51

def matches?(name)
  name = name.to_s
  name == @name || @alts.include?(name)
end

#set_cron(expr) ⇒ Object

Store a cron '<expr>' schedule. The raw string is kept for display/export; parsing happens here so an invalid expression raises Hammer::Error at definition time, not when the job server starts. The parsed Hammer::Cron is what the scheduler consumes.



42
43
44
45
 
# File 'lib/hammer/command.rb', line 42

def set_cron(expr)
  @cron_schedule = Hammer::Cron.new(expr)
  @cron = @cron_schedule.source
end

#to_h(path = name) ⇒ Object

Structured form for JSON export (h:json). path is the full colon path supplied by the tree walk - a Command doesn't know its own namespace prefix. hidden follows the help rule: a task with no desc still dispatches but is hidden from listings.



83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
 
# File 'lib/hammer/command.rb', line 83

def to_h(path = name)
  {
    name:      name,
    path:      path,
    desc:      desc,
    brief:     brief,
    hidden:    desc.empty?,
    redefined: !prev_location.nil?,
    location:  location,
    alts:      alts,
    needs:     needs,
    cron:      cron,
    examples:  examples,
    options:   options.map(&:to_h)
  }
end