Class: CTioga2::Commands::Documentation::Doc

Inherits:
Object
  • Object
show all
Defined in:
lib/ctioga2/commands/doc/doc.rb

Overview

The base class for all documentation.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Doc

Create a Doc object caring about the current state of registered commands and such.



52
53
54
55
56
57
58
59
60
61
 
# File 'lib/ctioga2/commands/doc/doc.rb', line 52

def initialize
  @commands = Interpreter::commands
  @groups = Interpreter::groups
  @types = Interpreter::types
  @backends = Data::Backends::Backend::list_backends
  @functions = Function::functions

  @ignore_blacklisted = ! (ENV.key?("CT2_DEV") && 
                           ! ENV["CT2_DEV"].empty?)
end

Instance Attribute Details

#backends ⇒ Object

The hash containing all the backends, as returned by Data::Backends::Backend::list_backends



42
43
44
 
# File 'lib/ctioga2/commands/doc/doc.rb', line 42

def backends
  @backends
end

#commands ⇒ Object

The hash containing all the commands, as returned by Interpreter::commands.



30
31
32
 
# File 'lib/ctioga2/commands/doc/doc.rb', line 30

def commands
  @commands
end

#functions ⇒ Object

The functions



48
49
50
 
# File 'lib/ctioga2/commands/doc/doc.rb', line 48

def functions
  @functions
end

#groups ⇒ Object

The hash containing all the groups, as returned by Interpreter::commands.



34
35
36
 
# File 'lib/ctioga2/commands/doc/doc.rb', line 34

def groups
  @groups
end

#ignore_blacklisted ⇒ Object

Wether or not to ignore blacklisted commands



45
46
47
 
# File 'lib/ctioga2/commands/doc/doc.rb', line 45

def ignore_blacklisted
  @ignore_blacklisted
end

#types ⇒ Object

The hash containing all the types, as returned by Interpreter::commands.



38
39
40
 
# File 'lib/ctioga2/commands/doc/doc.rb', line 38

def types
  @types
end

Instance Method Details

#display_command_line_help(options) ⇒ Object

Display command-line help.



88
89
90
91
 
# File 'lib/ctioga2/commands/doc/doc.rb', line 88

def display_command_line_help(options)
  CommandLineHelp.new(options).
    print_commandline_options(*self.documented_commands)
end

#documented_commands ⇒ Object

Returns a [ cmds, groups ] hash containing the list of commands, and the groups to be documented.



65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
 
# File 'lib/ctioga2/commands/doc/doc.rb', line 65

def documented_commands
  cmds = group_commands

  groups = cmds.keys.sort do |a,b|
    if ! a
      1
    elsif ! b
      -1
    else
      if a.priority == b.priority
        a.name <=> b.name
      else
        a.priority <=> b.priority
      end
    end
  end
  if @ignore_blacklisted
    groups.delete_if {|g| g && g.blacklisted }
  end
  return [cmds, groups]
end