Class: EacRubyUtils::Console::DocoptRunner

Inherits:
Object
  • Object
show all
Includes:
EacRubyUtils::Contextualizable
Defined in:
lib/eac_ruby_utils/console/docopt_runner.rb,
lib/eac_ruby_utils/console/docopt_runner/_doc.rb,
lib/eac_ruby_utils/console/docopt_runner/_settings.rb,
lib/eac_ruby_utils/console/docopt_runner/_subcommands.rb,
lib/eac_ruby_utils/console/docopt_runner/_class_methods.rb

Defined Under Namespace

Modules: SubcommandsSupport

Constant Summary collapse

PROGRAM_MACRO = 
'__PROGRAM__'
SUBCOMMAND_ARG = 
'<subcommand>'
SUBCOMMAND_ARGS_ARG = 
'<subcommand-args>'
SUBCOMMANDS_MACRO = 
'__SUBCOMMANDS__'
DOCOPT_ERROR_EXIT_CODE = 
0x22220000

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from EacRubyUtils::Contextualizable

#context

Constructor Details

#initialize(settings = {}) ⇒ DocoptRunner

Returns a new instance of DocoptRunner.



19
20
21
22
 
# File 'lib/eac_ruby_utils/console/docopt_runner.rb', line 19

def initialize(settings = {})
  @settings = settings.with_indifferent_access.freeze
  check_subcommands
end

Instance Attribute Details

#settings ⇒ Object (readonly)

Returns the value of attribute settings.



17
18
19
 
# File 'lib/eac_ruby_utils/console/docopt_runner.rb', line 17

def settings
  @settings
end

Class Method Details

.run(options = {}) ⇒ Object 



9
10
11
12
13
14
 
# File 'lib/eac_ruby_utils/console/docopt_runner/_class_methods.rb', line 9

def run(options = {})
  new(options).send(:run)
rescue Docopt::Exit => e
  STDERR.write(e.message + "\n")
  ::Kernel.exit(DOCOPT_ERROR_EXIT_CODE)
end

Instance Method Details

#check_subcommands ⇒ Object 



17
18
19
20
21
22
23
 
# File 'lib/eac_ruby_utils/console/docopt_runner/_subcommands.rb', line 17

def check_subcommands
  return unless subcommands?
  singleton_class.include(SubcommandsSupport)
  check_subcommands_arg
  return if singleton_class.method_defined?(:run)
  singleton_class.send(:alias_method, :run, :run_with_subcommand)
end

#options ⇒ Object 



24
25
26
 
# File 'lib/eac_ruby_utils/console/docopt_runner.rb', line 24

def options
  @options ||= Docopt.docopt(target_doc, docopt_options)
end

#parent ⇒ Object 



28
29
30
 
# File 'lib/eac_ruby_utils/console/docopt_runner.rb', line 28

def parent
  settings[:parent]
end

#program_name ⇒ Object 



16
17
18
 
# File 'lib/eac_ruby_utils/console/docopt_runner/_doc.rb', line 16

def program_name
  [setting_value(:program_name, false), ENV['PROGRAM_NAME'], $PROGRAM_NAME].find(&:present?)
end

#source_doc ⇒ Object 



8
9
10
 
# File 'lib/eac_ruby_utils/console/docopt_runner/_doc.rb', line 8

def source_doc
  setting_value(:doc)
end

#subcommands? ⇒ Boolean

Returns:

  • (Boolean) 


13
14
15
 
# File 'lib/eac_ruby_utils/console/docopt_runner/_subcommands.rb', line 13

def subcommands?
  source_doc.include?(SUBCOMMANDS_MACRO)
end

#target_doc ⇒ Object 



12
13
14
 
# File 'lib/eac_ruby_utils/console/docopt_runner/_doc.rb', line 12

def target_doc
  source_doc.gsub(PROGRAM_MACRO, program_name).strip + "\n"
end