Class: Gitlab::CLI

Inherits:
Object
  • Object
show all
Extended by:
Helpers
Defined in:
lib/gitlab/cli.rb,
lib/gitlab/cli_helpers.rb

Defined Under Namespace

Modules: Helpers

Class Method Summary collapse

Methods included from Helpers

actions, client, confirm_command, excluded_fields, gitlab_helper, help, method_owners, output_table, record_table, required_fields, symbolize_keys, valid_command?, yaml_load_arguments!

Class Method Details

.run(cmd, args = []) ⇒ nil

Processes a CLI command and outputs a result to the stream (stdout).

Examples:

Gitlab::CLI.run('help')
Gitlab::CLI.run('help', ['issues'])

Parameters:

  • cmd (String) —

    The name of a command.

  • args (Array) (defaults to: []) —

    The optional arguments for a command.

Returns:

  • (nil) 


30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
 
# File 'lib/gitlab/cli.rb', line 30

def self.run(cmd, args=[])
  case cmd
  when 'help'
    puts help(args.shift) { |out| out.gsub!(/Gitlab\./, 'gitlab ') }
  when 'info'
    endpoint = Gitlab.endpoint ? Gitlab.endpoint : 'not set'
    private_token = Gitlab.private_token ? Gitlab.private_token : 'not set'
    puts "Gitlab endpoint is #{endpoint}"
    puts "Gitlab private token is #{private_token}"
    puts "Ruby Version is #{RUBY_VERSION}"
    puts "Gitlab Ruby Gem #{Gitlab::VERSION}"
  when '-v', '--version'
    puts "Gitlab Ruby Gem #{Gitlab::VERSION}"
  when 'shell'
    Gitlab::Shell.start
  else
    unless valid_command?(cmd)
      puts "Unknown command. Run `gitlab help` for a list of available commands."
      exit(1)
    end

    if args.any? && (args.last.start_with?('--only=') || args.last.start_with?('--except='))
      command_args = args[0..-2]
    else
      command_args = args
    end

    begin
      yaml_load_arguments! command_args
      command_args.map! {|arg| symbolize_keys arg }
    rescue => e
      puts e.message
      exit 1
    end

    confirm_command(cmd)

    data = gitlab_helper(cmd, command_args) { exit(1) }
    output_table(cmd, args, data)
  end
end

.start(args) ⇒ Object

Starts a new CLI session.

Examples:

Gitlab::CLI.start(['help'])
Gitlab::CLI.start(['help', 'issues'])

Parameters:

  • args (Array) —

    The command and it’s optional arguments.



16
17
18
19
 
# File 'lib/gitlab/cli.rb', line 16

def self.start(args)
  command = args.shift.strip rescue 'help'
  run(command, args)
end