Initial commit of Gitlab CLI shell. Tab completion for Gitlab.actions.

README.md

@@ -96,6 +96,24 @@ gitlab user --only=id,username
 gitlab user --except=email,bio
 ```
 
+## CLI Shell
+
+Usage:
+
+```sh
+[user@host ~]$ gitlab shell
+# set endpoint for session
+gitlab> endpoint= http://192.168.1.20/api/v3
+"http://192.168.1.20/api/v3"
+# set private token for session
+gitlab> private_token= Z78CpekqasoWahskVcVr
+"Z78CpekqasoWahskVcVr"
+# list groups
+gitlab> groups
+# protect a branch
+gitlab> protect_branch 1 master
+```
+
 For more information, refer to [website](http://narkoz.github.io/gitlab).
 
 ## License

lib/gitlab/cli.rb

@@ -1,6 +1,7 @@
 require 'gitlab'
 require 'terminal-table/import'
 require_relative 'cli_helpers'
+require_relative 'shell'
 
 class Gitlab::CLI
   extend Helpers
@@ -23,6 +24,8 @@ def self.run(cmd, args=[])
       puts "Gitlab Ruby Gem #{Gitlab::VERSION}"
     when '-v', '--version'
       puts "Gitlab Ruby Gem #{Gitlab::VERSION}"
+    when 'shell'
+      Gitlab::Shell.start
     else
       unless Gitlab.actions.include?(cmd.to_sym)
         puts "Unknown command. Run `gitlab help` for a list of available commands."
@@ -37,21 +40,8 @@ def self.run(cmd, args=[])
 
       confirm_command(cmd)
 
-      begin
-        data = args.any? ? Gitlab.send(cmd, *command_args) : Gitlab.send(cmd)
-      rescue => e
-        puts e.message
-        exit(1)
-      end
-
-      case data
-      when Gitlab::ObjectifiedHash
-        puts single_record_table(data, cmd, args)
-      when Array
-        puts multiple_record_table(data, cmd, args)
-      else
-        puts data.inspect
-      end
+      data = gitlab_helper(cmd,command_args) { exit(1) }
+      output_table(data)
     end
   end
 end

lib/gitlab/cli_helpers.rb

@@ -77,6 +77,22 @@ def actions_table
       end
     end
 
+    # Decides which table to use.
+    #
+    # @return [String]
+
+    def output_table(cmd, args, data)
+      case data
+      when Gitlab::ObjectifiedHash
+        puts single_record_table(data, cmd, args)
+      when Array
+        puts multiple_record_table(data, cmd, args)
+      else
+        puts data.inspect
+      end
+
+    end
+
     # Table for a single record.
     #
     # @return [String]
@@ -137,5 +153,16 @@ def multiple_record_table(data, cmd, args)
         end
       end
     end
+
+    # Helper function to call Gitlab commands, w/ args
+    def gitlab_helper(cmd,args=[])
+      begin
+        data = args.any? ? Gitlab.send(cmd, *args) : Gitlab.send(cmd)
+      rescue => e
+        puts e.message
+        yield if block_given?
+      end
+      data
+    end
   end
 end

lib/gitlab/shell.rb

@@ -0,0 +1,29 @@
+require 'gitlab'
+require "readline"
+require_relative 'cli_helpers'
+
+class Gitlab::Shell
+  extend Gitlab::CLI::Helpers
+
+  def self.start
+    actions = Gitlab.actions.map(&:to_s)
+    actions << 'endpoint=' << 'private_token='
+
+    comp = proc { |s| actions.grep(/^#{Regexp.escape(s)}/) }
+
+    Readline.completion_append_character = " "
+    Readline.completion_proc = comp
+
+    while buf = Readline.readline("gitlab> ", true)
+      next if buf.nil? || buf.empty?
+      buf = buf.split.map(&:chomp)
+      cmd = buf.shift
+      args = buf.count > 0 ? buf : [] 
+      confirm_command(cmd)
+
+      data = gitlab_helper(cmd,args)
+
+      output_table(cmd, args, data)
+    end
+  end
+end