Module: Shell::Extensions::ObjectCoreExtensions
- Defined in:
- lib/chef/shell/ext.rb
Overview
Extensions to be included in every ‘main’ object in chef-shell. These objects are extended with this module.
Instance Method Summary collapse
- #all_help_descriptions ⇒ Object
- #desc(help_text) ⇒ Object
- #ensure_session_select_defined ⇒ Object
- #explain(explain_text) ⇒ Object
- #explain_command(method_name) ⇒ Object
- #find_or_create_session_for(context_obj) ⇒ Object
- #help_banner ⇒ Object
- #help_descriptions ⇒ Object
-
#off ⇒ Object
returns
:off
so you can just do ‘tracing off’. -
#on ⇒ Object
helpfully returns
:on
so we can have sugary syntax like ‘tracing on’. - #singleton_method_added(mname) ⇒ Object
- #subcommands(subcommand_help = {}) ⇒ Object
Instance Method Details
#all_help_descriptions ⇒ Object
117 118 119 |
# File 'lib/chef/shell/ext.rb', line 117 def all_help_descriptions help_descriptions end |
#desc(help_text) ⇒ Object
121 122 123 |
# File 'lib/chef/shell/ext.rb', line 121 def desc(help_text) @desc = help_text end |
#ensure_session_select_defined ⇒ Object
39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 |
# File 'lib/chef/shell/ext.rb', line 39 def ensure_session_select_defined # irb breaks if you prematurely define IRB::JobManager # so these methods need to be defined at the latest possible time. unless jobs.respond_to?(:select_session_by_context) def jobs.select_session_by_context(&block) # rubocop:disable Lint/NestedMethodDefinition @jobs.select { |job| block.call(job[1].context.main) } end end unless jobs.respond_to?(:session_select) def jobs.select_shell_session(target_context) # rubocop:disable Lint/NestedMethodDefinition session = if target_context.is_a?(Class) select_session_by_context { |main| main.is_a?(target_context) } else select_session_by_context { |main| main.equal?(target_context) } end Array(session.first)[1] end end end |
#explain(explain_text) ⇒ Object
125 126 127 |
# File 'lib/chef/shell/ext.rb', line 125 def explain(explain_text) @explain = explain_text end |
#explain_command(method_name) ⇒ Object
87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 |
# File 'lib/chef/shell/ext.rb', line 87 def explain_command(method_name) help = all_help_descriptions.find { |h| h.cmd.to_s == method_name.to_s } if help puts "" puts "Command: #{method_name}" puts "".ljust(80, "=") puts help.explanation || help.desc puts "".ljust(80, "=") puts "" else puts "" puts "command #{method_name} not found or no help available" puts "" end end |
#find_or_create_session_for(context_obj) ⇒ Object
60 61 62 63 64 65 66 67 |
# File 'lib/chef/shell/ext.rb', line 60 def find_or_create_session_for(context_obj) ensure_session_select_defined if subsession = jobs.select_shell_session(context_obj) jobs.switch(subsession) else irb(context_obj) # rubocop: disable Lint/Debugger end end |
#help_banner ⇒ Object
69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 |
# File 'lib/chef/shell/ext.rb', line 69 def = [] << "" << "#{ChefUtils::Dist::Infra::SHELL} Help" << "".ljust(80, "=") << "| " + "Command".ljust(25) + "| " + "Description" << "".ljust(80, "=") all_help_descriptions.each do |help_text| << "| " + help_text.cmd.ljust(25) + "| " + help_text.desc end << "".ljust(80, "=") << "\n" << "Use help(:command) to get detailed help with individual commands" << "\n" .join("\n") end |
#help_descriptions ⇒ Object
113 114 115 |
# File 'lib/chef/shell/ext.rb', line 113 def help_descriptions @help_descriptions ||= [] end |
#off ⇒ Object
returns :off
so you can just do ‘tracing off’
109 110 111 |
# File 'lib/chef/shell/ext.rb', line 109 def off :off end |
#on ⇒ Object
helpfully returns :on
so we can have sugary syntax like ‘tracing on’
104 105 106 |
# File 'lib/chef/shell/ext.rb', line 104 def on :on end |
#singleton_method_added(mname) ⇒ Object
133 134 135 136 137 138 139 140 141 142 143 144 |
# File 'lib/chef/shell/ext.rb', line 133 def singleton_method_added(mname) if @desc help_descriptions << Help.new(mname.to_s, @desc.to_s, @explain) @desc, @explain = nil, nil end if @subcommand_help @subcommand_help.each do |subcommand, text| help_descriptions << Help.new("#{mname}.#{subcommand}", text.to_s, nil) end end @subcommand_help = {} end |
#subcommands(subcommand_help = {}) ⇒ Object
129 130 131 |
# File 'lib/chef/shell/ext.rb', line 129 def subcommands(subcommand_help = {}) @subcommand_help = subcommand_help end |