github_cli 0.5.3 → 0.5.4

data/lib/github_cli/commands/milestones.rb

@@ -6,6 +6,12 @@ module GithubCLI
     namespace :milestone
 
     desc 'list <user> <repo>', 'List milestones for a repository'
+    option :state, :type => :string, :default => "open",
+      :desc => "open, closed, default: open"
+    option :sort, :type => :string, :default => "due_date",
+      :desc => "due_date, completeness, default: due_date"
+    option :direction, :type => :string, :default => "desc",
+      :desc => "asc, desc, default: desc"
     long_desc <<-DESC
       Parameters
 
@@ -14,15 +20,24 @@ module GithubCLI
         direction - asc, desc, default: desc\n
     DESC
     def list(user, repo)
-      Milestone.all user, repo, options[:params], options[:format]
+      params = options[:params].dup
+      params['state'] = options[:state] || 'open'
+      params['sort']  = options[:sort] || 'due_date'
+      params['direction'] = options[:direction] || 'desc'
+      Milestone.all user, repo, params, options[:format]
     end
 
-    desc 'get <user> <repo> <milestone-id>', 'Get a single milestone'
-    def get(user, repo, id)
-      Milestone.get user, repo, id, options[:params], options[:format]
+    desc 'get <user> <repo> <number>', 'Get a single milestone'
+    def get(user, repo, number)
+      Milestone.get user, repo, number, options[:params], options[:format]
     end
 
     desc 'create <user> <repo>', 'Create a milestone'
+    option :title, :type => :string, :required => true
+    option :state, :type => :string, :default => "open",
+      :desc => "open, closed, default: open"
+    option :desc, :type => :string
+    option :due_on, :type => :string, :desc => "Optional string - ISO 8601 time"
     long_desc <<-DESC
       Parameters
 
@@ -33,13 +48,23 @@ module GithubCLI
 
       Example
 
-      ghc milestone create wycats thor --params=title:new
+      ghc milestone create wycats thor --title=new
     DESC
     def create(user, repo)
-      Milestone.create user, repo, options[:params], options[:format]
+      params = options[:params].dup
+      params['title'] = options[:title]
+      params['state'] = options[:state] if options[:state]
+      params['description'] = options[:desc] if options[:desc]
+      params['due_on'] = options[:due_on] if options[:due_on]
+      Milestone.create user, repo, params, options[:format]
     end
 
-    desc 'update <user> <repo> <milestone-id>', 'Update a milestone'
+    desc 'update <user> <repo> <number>', 'Update a milestone'
+    option :title, :type => :string
+    option :state, :type => :string, :default => "open",
+      :desc => "open, closed, default: open"
+    option :desc, :type => :string
+    option :due_on, :type => :string, :desc => "Optional string - ISO 8601 time"
     long_desc <<-DESC
       Parameters
 
@@ -50,15 +75,20 @@ module GithubCLI
 
       Example
 
-      ghc milestone update wycats thor 1 --params=title:new
+      ghc milestone update wycats thor 1 --title=new
     DESC
-    def update(user, repo, milestone_id)
-      Milestone.update user, repo, milestone_id, options[:params], options[:format]
+    def update(user, repo, number)
+      params = options[:params].dup
+      params['title'] = options[:title] if options[:title]
+      params['state'] = options[:state] if options[:state]
+      params['description'] = options[:desc] if options[:desc]
+      params['due_on'] = options[:due_on] if options[:due_on]
+      Milestone.update user, repo, number, params, options[:format]
     end
 
-    desc 'delete <user> <repo> <milestone-id>', 'Delete a milestone'
-    def delete(user, repo, id)
-      Milestone.delete user, repo, id, options[:params], options[:format]
+    desc 'delete <user> <repo> <number>', 'Delete a milestone'
+    def delete(user, repo, number)
+      Milestone.delete user, repo, number, options[:params], options[:format]
     end
 
   end # Milestones

data/lib/github_cli/commands/references.rb

@@ -6,12 +6,13 @@ module GithubCLI
     namespace :ref
 
     desc 'list <user> <repo>', 'List all References'
-    method_option :ref, :type => :string, :banner => 'branch reference'
+    option :ref, :type => :string, :banner => 'branch reference'
     def list(user, repo)
+      params = options[:params].dup
       if options[:ref]
-        options[:params]['ref'] = options[:ref]
+        params['ref'] = options[:ref]
       end
-      Reference.list user, repo, options[:params], options[:format]
+      Reference.list user, repo, params, options[:format]
     end
 
     desc 'get <user> <repo> <ref>', 'Get a Reference'
@@ -20,17 +21,28 @@ module GithubCLI
     end
 
     desc 'create <user> <repo>', 'Create a new Reference'
+    option :ref, :type => :string, :required => true, :banner => "<ref>",
+      :desc => "String of the name of the fully qualified reference (ie: refs/heads/master). If it doesn’t start with ‘refs’ and have at least two slashes, it will be rejected."
+    option :sha, :type => :string, :required => true,
+      :desc => "String of the SHA1 value to set this reference to."
     long_desc <<-DESC
       Inputs
 
       ref - String of the name of the fully qualified reference (ie: refs/heads/master). If it doesn’t start with ‘refs’ and have at least two slashes, it will be rejected.\n
-      sha - String of the SHA1 value to set this reference to
+      sha - String of the SHA1 value to set this reference to.
     DESC
     def create(user, repo)
-      Reference.create user, repo, options[:params], options[:format]
+      params = options[:params].dup
+      params['ref'] = options[:ref] if options[:ref]
+      params['sha'] = options[:sha] if options[:sha]
+      Reference.create user, repo, params, options[:format]
     end
 
     desc 'update <user> <repo> <ref>', 'Update a Reference'
+    option :sha, :type => :string, :required => true,
+      :desc => "String of the SHA1 value to set this reference to."
+    option :force => false, :default => 'false', :aliases => ["-f"],
+      :desc => "Boolean indicating whether to force the update or to make sure the update is a fast-forward update."
     long_desc <<-DESC
       Inputs
 
@@ -38,7 +50,10 @@ module GithubCLI
       force - Boolean indicating whether to force the update or to make sure the update is a fast-forward update. The default is <tt>false</tt>, so leaving this out or setting it to false will make sure you’re not overwriting work.
     DESC
     def update(user, repo, ref)
-      Reference.update user, repo, ref, options[:params], options[:format]
+      params = options[:params].dup
+      params['sha']   = options[:sha] if options[:sha]
+      params['force'] = options[:force] || false
+      Reference.update user, repo, ref, params, options[:format]
     end
 
     desc 'delete <user> <repo> <ref>', 'Delete a Reference'

data/lib/github_cli/commands/starring.rb

@@ -14,10 +14,11 @@ module GithubCLI
     method_option :user, :type => :string, :aliases => ["-u"],
                   :desc => 'Starred repositories for <user>'
     def starred
+      params = options[:params].dup
       if options[:user]
-        options[:params]['user'] = options[:user]
+        params['user'] = options[:user]
       end
-      Starring.starred options[:params], options[:format]
+      Starring.starred params, options[:format]
     end
 
     desc 'starring <user> <repo>', 'Check if you are starring a repository'

data/lib/github_cli/commands/tags.rb

@@ -13,6 +13,14 @@ module GithubCLI
     end
 
     desc 'create <user> <repo>', 'Create a Tag Object'
+    option :tag, :type => :string, :desc => "String of the tag"
+    option :message, :type => :string, :aliases => ["-m"],
+      :desc => "String of the tag message"
+    option :object, :type => :string, :banner => "<SHA>",
+      :desc => "String of the SHA of the git object this is tagging"
+    option :type, :type => :string, :banner => "commit/tree/blob",
+      :desc => "String of the type of the object we're tagging."
+    option :tagger, :type => :hash, :desc => "Tag author information"
     long_desc <<-DESC
       Note that creating a tag object does not create the reference that
       makes a tag in Git. If you want to create an annotated tag in Git,
@@ -31,7 +39,14 @@ module GithubCLI
       tagger.date - Timestamp of when this object was tagged \n
     DESC
     def create(user, repo)
-      Tag.create user, repo, options[:params], options[:format]
+      params = options[:params].dup
+      params['tag']     = options[:tag] if options[:tag]
+      params['message'] = options[:message] if options[:message]
+      params['object']  = options[:object] if options[:object]
+      params['type']    = optiosn[:type] if options[:type]
+      params['tagger']  = options[:tagger] if options[:tagger]
+
+      Tag.create user, repo, params, options[:format]
     end
 
   end # Tag

data/lib/github_cli/commands/trees.rb

@@ -9,13 +9,16 @@ module GithubCLI
     method_option :recursive, :type => :boolean, :aliases => ["-r"],
                   :desc => 'get a tree recursively'
     def get(user, repo, sha)
-      if options[:recursive]
-        options[:params]['recursive'] = true
-      end
-      Tree.get user, repo, sha, options[:params], options[:format]
+      params = options[:params].dup
+      params['recursive'] = options[:recursive] if options[:recursive]
+      Tree.get user, repo, sha, params, options[:format]
     end
 
     desc 'create <user> <repo>', 'Create a new Tree'
+    option :base_tree, :type => :string, :banner => "<SHA>",
+      :desc => "optional string of the SHA1 of the tree you want to update with new data"
+    option :tree, :type => :array,
+      :desc => "array of hash objects(of :path, :mode, :type and sha)"
     long_desc <<-DESC
       The tree creation API will take nested entries as well.
       If both a tree and a nested path modifying that tree are specified,
@@ -33,7 +36,10 @@ module GithubCLI
       tree.content - String of content you want this file to have - GitHub will write this blob out and use the SHA for this entry. Use either this or tree.sha
     DESC
     def create(user, repo)
-      Tree.create user, repo, options[:params], options[:format]
+      params = options[:params].dup
+      params['base_tree'] = options[:base_tree] if options[:base_tree]
+      params['tree']      = options[:tree] if options[:tree]
+      Tree.create user, repo, params, options[:format]
     end
 
   end # Blobs

data/lib/github_cli/commands/watching.rb

@@ -14,10 +14,11 @@ module GithubCLI
     method_option :user, :type => :string, :aliases => ["-u"],
                   :desc => 'Watch repositories for <user>'
     def watched
+      params = options[:params].dup
       if options[:user]
-        options[:params]['user'] = options[:user]
+        params['user'] = options[:user]
       end
-      Watching.watched options[:params], options[:format]
+      Watching.watched params, options[:format]
     end
 
     desc 'watching <user> <repo>', 'Check if you are watching a repository'

data/lib/github_cli/config.rb

@@ -3,9 +3,11 @@
 module GithubCLI
   class Config
 
-    COMMAND_KEY  = 'commands'
+    COMMAND_KEY  = 'commands'.freeze
 
-    COMMAND_HELP = 'help'
+    COMMAND_HELP = 'help'.freeze
+
+    DEFAULT_NAME = '.githubrc'.freeze
 
     # Contains information of where the command is run from.
     attr_reader :root
@@ -13,8 +15,15 @@ module GithubCLI
     # Location scope of currently used configuration file.
     attr_reader :location
 
+    # Name for the confiugration file
+    attr_accessor :filename
+
+    # Initialize a Config
+    #
+    # @api public
     def initialize(root, options={})
-      @root = root
+      @root          = root
+      @filename      = options.fetch(:filename) { DEFAULT_NAME }
       @local_config  = local_options_file
       @global_config = global_options_file
     end
@@ -64,7 +73,7 @@ module GithubCLI
         composite_key = "#{COMMAND_KEY}.#{cmd.namespace}.#{cmd.name}"
         if !cmd.namespace.empty? && cmd.name != COMMAND_HELP &&
            !config.has_key?(composite_key)
-          config[composite_key]= {}
+          config[composite_key]= nil
         end
       end
       File.open(path, 'w', 0600) do |file|
@@ -93,12 +102,12 @@ module GithubCLI
   private
 
     def local_options_file
-      Pathname.new "#{root}/.githubrc"
+      Pathname.new "#{root}/#{filename}"
     end
 
     def global_options_file
       begin
-        Pathname.new File.join(Thor::Util.user_home, ".githubrc")
+        Pathname.new File.join(Thor::Util.user_home, filename)
       rescue ArgumentError
         GithubCLI.ui.warn "Unable to find ~/.githubrc because the HOME environment variable is not set"
         exit 1

data/lib/github_cli/dsl.rb

@@ -28,5 +28,5 @@ module GithubCLI
     def configure(&block)
     end
 
-  end
-end
+  end # DSL
+end # GithubCLI

data/lib/github_cli/formatter.rb

@@ -21,9 +21,8 @@ module GithubCLI
     def determine_output_formatter
       case format.to_s
       when 'table', /table:v.*/, /table:h.*/
-        formatter = Formatters::Table.new(response,
-                      :transform => format.to_s.split(':').last
-                    )
+        formatter = Formatters::Table.new(response.body,
+                      :transform => format.to_s.split(':').last)
         formatter.format
       when 'csv'
         formatter = Formatters::CSV.new(response)

data/lib/github_cli/formatters/csv.rb

@@ -4,34 +4,49 @@ module GithubCLI
   module Formatters
     class CSV
 
+      attr_reader :response
+
       def initialize(response)
         @response = response
       end
 
       def format
-        case @response
-        when Array
-          render_headers @response.first
-          @response.each_with_index do |item, indx|
-            render_line indx, item
+        if response.respond_to?(:to_ary)
+          render_headers(response.first)
+          response.each_with_index do |item, indx|
+            render_line(indx, item)
             Terminal.newline
           end
-        when Hash
-          render_headers @response
-          render_line 1, @response
+        elsif response.respond_to?(:keys)
+          render_headers(response)
+          render_line(1, response)
         else
-          Terminal.line "#{@response}\n"
+          Terminal.line "#{response}\n"
         end
       end
 
-      def render_headers(response)
-        output = GithubCLI::Util.flatten_hash(response.to_hash)
-        Terminal.line "Index,#{output.keys.join(',')}\n"
+      def render_headers(header)
+        output = header
+        if header.respond_to?(:to_hash)
+          output = GithubCLI::Util.flatten_hash(header.to_hash)
+          output = "Index,#{output.keys.join(',')}\n"
+        elsif header.respond_to?(:to_ary)
+          output = "Index,#{header.join(',')}\n"
+        end
+
+        Terminal.line output
       end
 
       def render_line(index, item)
-        output = GithubCLI::Util.flatten_hash(item.to_hash)
-        $stdout.printf "%d,%s", index, output.values.join(',')
+        output = item
+        if item.respond_to?(:to_hash)
+          output = GithubCLI::Util.flatten_hash(item.to_hash)
+          output = output.values.join(',')
+        elsif item.respond_to?(:to_ary)
+          output = item.join(',')
+        end
+
+        $stdout.printf "%d,%s", index, output
       end
 
     end # CSV

data/lib/github_cli/formatters/table.rb

@@ -70,8 +70,7 @@ module GithubCLI
       # Builds output array from response hash
       #
       def build_output
-        case response
-        when Array
+        if response.respond_to?(:to_ary)
           case transform
           when :horizontal
             array = [flatten_hash(response[0].to_hash).keys]
@@ -88,7 +87,7 @@ module GithubCLI
               array
             end
           end
-        when Hash
+        elsif response.respond_to?(:to_hash)
           output = flatten_hash(response)
           case transform
           when :horizontal

data/lib/github_cli/man/gcli-config.1

@@ -1,19 +1,19 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "GCLI\-CONFIG" "1" "July 2012" "" ""
+.TH "GCLI\-CONFIG" "1" "March 2013" "" ""
 .
 .SH "NAME"
 \fBgcli\-config\fR \- Get or set global or local configuration options
 .
 .SH "SYNOPSIS"
-\fBgcli config\fR \-\-global|\-\-local name [value]
+\fBgcli config\fR [\-\-local] name [value]
 .
 .br
-\fBgcli config\fR \-\-global|\-\-local \fB\-l | \-list\fR [name_regex]
+\fBgcli config\fR [\-\-local] \fB\-l | \-list\fR [name_regex]
 .
 .br
-\fBgcli config\fR \-\-global|\-\-local \fB\-e | \-\-edit\fR
+\fBgcli config\fR [\-\-local] \fB\-e | \-\-edit\fR
 .
 .SH "DESCRIPTION"
 You can query/set options with this command\. The name is actually a hash key string that is a composite one, nested with dots\. If only name is provided, a value will be retrieved\. If two parameters are given then value will be set or updated depending whether it already exists or not\.\en
@@ -32,10 +32,6 @@ The config file is invalid\.
 .SH "OPTIONS"
 .
 .TP
-\fB\-\-global\fR
-Writes configuration settings to global ~/\.githubrc file inside user home directory\.
-.
-.TP
 \fB\-\-local\fR
 Writes cofinguration settings inside the current directory to the \.githubrc file\.
 .
@@ -59,12 +55,20 @@ The configuration file is written in \fByaml\fR\. Therfore all formatting rules
 .SS "VARIABLES"
 .
 .TP
-\fBauth\.token\fR
+\fBuser\.token\fR
 Authentication token\.
 .
 .TP
-\fBauth\.basic\fR
-Basic credentials in the form \fBlogin:password\fR\.
+\fBuser\.login\fR
+Basic login credentials\.
+.
+.TP
+\fBuser\.password\fR
+Basic password credentials\.
+.
+.TP
+\fBcore\.adapter\fR
+Sets http adapter used to perform requests to GitHub API v3\.
 .
 .TP
 \fBcore\.endpoint\fR
@@ -80,7 +84,7 @@ The command that will be used to paginate output\. Can be overridden with PAGER
 .
 .TP
 \fBcore\.no\-pager\fR
-false
+Switched off results paging\.
 .
 .TP
 \fBcore\.no\-color\fR
@@ -91,7 +95,7 @@ If set to true disables color output\. By default is set to false\.
 Determines output formatting\. Defaults to table output\.
 .
 .TP
-\fBcore\.auto\fR
+\fBcore\.auto_pagination\fR
 Automatic pagination of requests to GitHub\.
 .
 .TP

data/lib/github_cli/man/gcli-config.1.txt

@@ -6,9 +6,9 @@ NAME
        gcli-config - Get or set global or local configuration options
 
 SYNOPSIS
-       gcli config --global|--local name [value]
-       gcli config --global|--local -l | -list [name_regex]
-       gcli config --global|--local -e | --edit
+       gcli config [--local] name [value]
+       gcli config [--local] -l | -list [name_regex]
+       gcli config [--local] -e | --edit
 
 DESCRIPTION
        You  can  query/set  options  with this command. The name is actually a
@@ -27,12 +27,8 @@ DESCRIPTION
 
 
 OPTIONS
-       --global
-	      Writes configuration settings to global ~/.githubrc file	inside
-	      user home directory.
-
        --local
-	      Writes  cofinguration  settings  inside the current directory to
+	      Writes cofinguration settings inside the	current  directory  to
 	      the .githubrc file.
 
        -l, --list
@@ -41,48 +37,54 @@ OPTIONS
        -e, --edit
 	      Opens an editor to modify the specified config file.
 
-	      Defaults to vi editor if non specified. It  first  looks	inside
+	      Defaults	to  vi	editor if non specified. It first looks inside
 	      --global or --local config, then searches environement variables
 	      EDITOR and VISUAL before assuming default.
 
 CONFIGURATION FILE
-       The gcli configuration file contains a number of variables that	affect
+       The  gcli configuration file contains a number of variables that affect
        the way the GitHub API is quried.
 
    SYNTAX
-       The  configuration  file  is  written  in yaml. Therfore all formatting
+       The configuration file is written  in  yaml.  Therfore  all  formatting
        rules are derived from yaml specification.
 
    VARIABLES
-       auth.token
+       user.token
 	      Authentication token.
 
-       auth.basic
-	      Basic credentials in the form login:password.
+       user.login
+	      Basic login credentials.
+
+       user.password
+	      Basic password credentials.
+
+       core.adapter
+	      Sets http adapter used to perform requests to GitHub API v3.
 
        core.endpoint
-	      Sets host path used as the base for all requests to  GitHub  API
+	      Sets  host  path used as the base for all requests to GitHub API
 	      v3.
 
        core.editor
-	      Sets  the editor to be used when opening files. By default vi is
+	      Sets the editor to be used when opening files. By default vi  is
 	      specified.
 
        core.pager
-	      The command that will be used to paginate output. Can  be  over-
+	      The  command  that will be used to paginate output. Can be over-
 	      ridden with PAGER environment variable. less
 
        core.no-pager
-	      false
+	      Switched off results paging.
 
        core.no-color
-	      If  set  to  true  disables  color  output. By default is set to
+	      If set to true disables color  output.  By  default  is  set  to
 	      false.
 
        core.format
 	      Determines output formatting. Defaults to table output.
 
-       core.auto
+       core.auto_pagination
 	      Automatic pagination of requests to GitHub.
 
        core.aliases
@@ -93,4 +95,4 @@ AUTHOR
 
 
 
-				   July 2012			GCLI-CONFIG(1)
+				  March 2013			GCLI-CONFIG(1)

data/lib/github_cli/vendor/thor/actions/create_link.rb

@@ -52,6 +52,9 @@ class Thor
         given_destination
       end
 
+      def exists?
+        super || File.symlink?(destination)
+      end
     end
   end
 end

data/lib/github_cli/vendor/thor/actions/directory.rb

@@ -38,6 +38,7 @@ class Thor
     # destination<String>:: the relative path to the destination root.
     # config<Hash>:: give :verbose => false to not log the status.
     #                If :recursive => false, does not look for paths recursively.
+    #                If :mode => :preserve, preserve the file mode from the source.
     #
     # ==== Examples
     #
@@ -73,26 +74,44 @@ class Thor
         def execute!
           lookup = Util.escape_globs(source)
           lookup = config[:recursive] ? File.join(lookup, '**') : lookup
-          lookup = File.join(lookup, '{*,.[a-z]*}')
+          lookup = file_level_lookup(lookup)
 
-          Dir[lookup].sort.each do |file_source|
+          files(lookup).sort.each do |file_source|
             next if File.directory?(file_source)
             file_destination = File.join(given_destination, file_source.gsub(source, '.'))
             file_destination.gsub!('/./', '/')
 
             case file_source
-              when /\.empty_directory$/
-                dirname = File.dirname(file_destination).gsub(/\/\.$/, '')
-                next if dirname == given_destination
-                base.empty_directory(dirname, config)
-              when /\.tt$/
-                destination = base.template(file_source, file_destination[0..-4], config, &@block)
-              else
-                destination = base.copy_file(file_source, file_destination, config, &@block)
+            when /\.empty_directory$/
+              dirname = File.dirname(file_destination).gsub(/\/\.$/, '')
+              next if dirname == given_destination
+              base.empty_directory(dirname, config)
+            when /\.tt$/
+              destination = base.template(file_source, file_destination[0..-4], config, &@block)
+            else
+              destination = base.copy_file(file_source, file_destination, config, &@block)
             end
           end
         end
 
+        if RUBY_VERSION < '2.0'
+          def file_level_lookup(previous_lookup)
+            File.join(previous_lookup, '{*,.[a-z]*}')
+          end
+
+          def files(lookup)
+            Dir[lookup]
+          end
+        else
+          def file_level_lookup(previous_lookup)
+            File.join(previous_lookup, '*')
+          end
+
+          def files(lookup)
+            Dir.glob(lookup, File::FNM_DOTMATCH)
+          end
+        end
+
     end
   end
 end