github_cli 0.1.3 → 0.2.0

data/.rvmrc

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-environment_id="ruby-1.9.3-p0@github_cli"
+environment_id="ruby-1.9.2-p290@github_cli"
 
 #
 # First we attempt to load the desired environment directly from the environment

data/.travis.yml

@@ -5,6 +5,5 @@ branches:
 notifications:
   email:false
 rvm:
-  - 1.8.7
   - 1.9.2
   - 1.9.3

data/Gemfile.lock

@@ -1,8 +1,8 @@
 PATH
   remote: .
   specs:
-    github_cli (0.1.3)
-      github_api (~> 0.4.8)
+    github_cli (0.2.0)
+      github_api (~> 0.5.0)
       thor
 
 GEM
@@ -31,15 +31,17 @@ GEM
     ffi (1.0.11)
     gherkin (2.9.0)
       json (>= 1.4.6)
-    github_api (0.4.8)
+    github_api (0.5.0)
       faraday (~> 0.7.6)
       hashie (~> 1.2.0)
-      multi_json (~> 1.1.0)
+      multi_json (~> 1.3)
+      nokogiri (~> 1.5.2)
       oauth2 (~> 0.5.2)
     hashie (1.2.0)
     json (1.6.5)
-    multi_json (1.1.0)
+    multi_json (1.3.2)
     multipart-post (1.1.5)
+    nokogiri (1.5.2)
     oauth2 (0.5.2)
       faraday (~> 0.7)
       multi_json (~> 1.0)

data/README.md

@@ -39,7 +39,8 @@ $ ghc init
 ```
 
 This will setup a `.githubrc` configuration file in your home directory with
-all the global settings.
+all the global settings. During the install process you will be prompted for your
+`authentication token`.
 
 ### Getting a list of commands
 
@@ -49,6 +50,12 @@ You can list all GitHub APIs comamnds:
 $ ghc list
 ```
 
+to limit returned results pass `pattern`
+
+```shell
+$ ghc list re*   # Returns all commands matching the pattern
+```
+
 ### API
 
 Interact with git data:
@@ -74,7 +81,23 @@ Interact with repositories:
 $ ghc repo
 $ ghc download
 $ ghc fork
-$ ghc keys
+$ ghc hook
+$ ghc key
+$ ghc watching
+```
+
+### Examples
+
+You can create repository by supplying required parameters
+
+```shell
+ghc repo create --params=name:'octocat' description:'Test repo for kitty.'
+```
+
+To find out which options are required type
+
+```shell
+ghc repo help create
 ```
 
 ## Contributing

data/features/executable.feature

@@ -23,12 +23,14 @@ Feature: The GHC Executable
     And the output should contain "ghc <command>"
 
     Examples:
-      | command |
-      | repo    |
-      | issue   |
-      | blob    |
-      | tree    |
-      | ref     |
-      | pull    |
-      | fork    |
-      | commit  |
+      | command  |
+      | repo     |
+      | issue    |
+      | blob     |
+      | tree     |
+      | ref      |
+      | pull     |
+      | fork     |
+      | commit   |
+      | download |
+      | key      |

data/fixtures/.githubrc

@@ -0,0 +1,9 @@
+---
+oauth_token: ad7f9asdf97as98df7as9fd7
+basic_auth: 'login:password'
+host:
+user:
+repo:
+commands:
+  issue-list: { inputs: 'ticket' }
+  issue-get: {}

data/fixtures/simple_config

@@ -1,5 +1,6 @@
 ---
 oauth_token: ad7f9asdf97as98df7as9fd7
+basic_auth: 'login:password'
 host:
 user:
 repo:

data/github_cli.gemspec

@@ -15,7 +15,7 @@ Gem::Specification.new do |gem|
   gem.require_paths = ["lib"]
   gem.version       = GithubCLI::VERSION
 
-  gem.add_dependency 'github_api', '~> 0.4.8'
+  gem.add_dependency 'github_api', '~> 0.5.0'
   gem.add_dependency 'thor'
 
   gem.add_development_dependency 'rspec'

data/lib/github_cli/api.rb

@@ -21,5 +21,11 @@ module GithubCLI
     def self.configure_api
     end
 
+    class All
+      def initialize
+        github_api
+      end
+    end
+
   end # API
 end # GithubCLI

data/lib/github_cli/apis.rb

@@ -11,12 +11,16 @@ end
 %w[
   blob
   commit
+  download
   fork
+  key
+  label
   pull_request
   reference
   repository
   tag
   tree
+  watching
 ].each do |api|
   require_api api
 end

data/lib/github_cli/apis/blob.rb

@@ -6,11 +6,11 @@ module GithubCLI
     class << self
 
       def get(user, repo, sha, params)
-        github_api.repos.get_blob user, repo, params
+        github_api.git_data.blobs.get user, repo, params
       end
 
       def create(user, repo, params)
-        github_api.repos.create_blob user, repo, params
+        github_api.git_data.blobs.create user, repo, params
       end
     end
 

data/lib/github_cli/apis/commit.rb

@@ -6,11 +6,11 @@ module GithubCLI
     class << self
 
       def get(user, repo, sha, params)
-        github_api.git_data.commit user, repo, params
+        github_api.git_data.commits.get user, repo, params
       end
 
       def create(user, repo, params)
-        github_api.repos.create_commit user, repo, params
+        github_api.git_data.commits.create user, repo, params
       end
     end
 

data/lib/github_cli/apis/download.rb

@@ -0,0 +1,30 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Download < API
+
+    class << self
+
+      def all(user, repo, params)
+        github_api.repos.downloads.list user, repo, params
+      end
+
+      def get(user, repo, id, params)
+        github_api.repos.downloads.get user, repo, id, params
+      end
+
+      def create(user, repo, params)
+        github_api.repos.downloads.create user, repo, params
+      end
+
+      def upload(resource, filename)
+        github_api.repos.downloads.upload resource, filename
+      end
+
+      def delete(user, repo, id, params)
+        github_api.repos.downloads.delete user, repo, id, params
+      end
+    end
+
+  end # Download
+end # GithubCLI

data/lib/github_cli/apis/fork.rb

@@ -6,11 +6,11 @@ module GithubCLI
     class << self
 
       def all(user, repo, params)
-        github_api.repos.forks user, repo, params
+        github_api.repos.forks.list user, repo, params
       end
 
       def create(user, repo, params)
-        github_api.repos.create_fork user, repo, params
+        github_api.repos.forks.create user, repo, params
       end
     end
 

data/lib/github_cli/apis/hook.rb

@@ -0,0 +1,34 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Hook < API
+
+    class << self
+
+      def all(user, repo, params)
+        github_api.repos.hooks.list user, repo, params
+      end
+
+      def get(user, repo, id, params)
+        github_api.repos.hooks.get user, repo, id, params
+      end
+
+      def create(user, repo, params)
+        github_api.repos.hooks.create user, repo, params
+      end
+
+      def edit(user, repo, id, params)
+        github_api.repos.hooks.edit user, repo, id, params
+      end
+
+      def test(user, repo, id, params)
+        github_api.repos.hooks.test user, repo, id, params
+      end
+
+      def delete(user, repo, id, params)
+        github_api.repos.hooks.delete user, repo, id, params
+      end
+    end
+
+  end # Hook
+end # GithubCLI

data/lib/github_cli/apis/key.rb

@@ -0,0 +1,30 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Key < API
+
+    class << self
+
+      def all(user, repo, params)
+        github_api.repos.keys.list user, repo, params
+      end
+
+      def get(user, repo, id, params)
+        github_api.repos.keys.get user, repo, id, params
+      end
+
+      def create(user, repo, params)
+        github_api.repos.keys.create user, repo, params
+      end
+
+      def edit(user, repo, id, params)
+        github_api.repos.keys.edit user, repo, id, params
+      end
+
+      def delete(user, repo, id, params)
+        github_api.repos.keys.delete user, repo, id, params
+      end
+    end
+
+  end # Key
+end # GithubCLI

data/lib/github_cli/apis/label.rb

@@ -34,7 +34,7 @@ module GithubCLI
       end
 
       def remove(user, repo, number, name=nil, params)
-        github_api,issues.remove_label user, repo, number, name, params
+        github_api.issues.remove_label user, repo, number, name, params
       end
 
       def replace(user, repo, number, *args)

data/lib/github_cli/apis/reference.rb

@@ -5,24 +5,24 @@ module GithubCLI
 
     class << self
 
-      def get(user, repo, ref, params)
-        github_api.git_data.reference user, repo, ref, params
+      def list(user, repo, ref, params)
+        github_api.git_data.references.list user, repo, ref, params
       end
 
-      def list(user, repo, ref, params)
-        github_api.git_data.references user, repo, ref, params
+      def get(user, repo, ref, params)
+        github_api.git_data.references.get user, repo, ref, params
       end
 
       def create(user, repo, params)
-        github_api.git_data.create_reference user, repo, params
+        github_api.git_data.references.create user, repo, params
       end
 
       def update(user, repo, ref, params)
-        github_api.git_data.update_reference user, repo, ref, params
+        github_api.git_data.references.update user, repo, ref, params
       end
 
       def delete(user, repo, ref, params)
-        github_api.git_data.delete_reference user, repo, ref, params
+        github_api.git_data.references.delete user, repo, ref, params
       end
     end
 

data/lib/github_cli/apis/repository.rb

@@ -6,19 +6,19 @@ module GithubCLI
     class << self
 
       def all(params)
-        github_api.repos.repos(params)
+        github_api.repos.list params
       end
 
       def get(user, repo, params)
-        github_api.repos.get_repo user, repo, params
+        github_api.repos.get user, repo, params
       end
 
-      def create(user, repo, params)
-        github_api.repos.create_repo user, repo, params
+      def create(params)
+        github_api.repos.create params
       end
 
-      def edit
-        github_api.repos.edit_repo user, repo, params
+      def edit(user, repo, params)
+        github_api.repos.edit user, repo, params
       end
 
       def branches(user, repo, params)

data/lib/github_cli/apis/tag.rb

@@ -6,11 +6,11 @@ module GithubCLI
     class << self
 
       def get(user, repo, sha, params)
-        github_api.repos.get_tag user, repo, params
+        github_api.git_data.tags.get user, repo, params
       end
 
       def create(user, repo, params)
-        github_api.repos.create_tag user, repo, params
+        github_api.git_data.tags.create user, repo, params
       end
     end
 

data/lib/github_cli/apis/tree.rb

@@ -6,11 +6,11 @@ module GithubCLI
     class << self
 
       def get(user, repo, sha, params)
-        github_api.repos.get_tree user, repo, params
+        github_api.git_data.trees.get user, repo, sha, params
       end
 
       def create(user, repo, params)
-        github_api.repos.create_tree user, repo, params
+        github_api.git_data.trees.create user, repo, params
       end
     end
 

data/lib/github_cli/apis/watching.rb

@@ -0,0 +1,30 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Watching < API
+
+    class << self
+
+      def watchers(user, repo, params)
+        github_api.repos.watching.watchers user, repo, params
+      end
+
+      def watched(params)
+        github_api.repos.watching.watched user, repo, id, params
+      end
+
+      def watching?(user, repo, params)
+        github_api.repos.watching.watching? user, repo, params
+      end
+
+      def start_watching(user, repo, params)
+        github_api.repos.watching.start_watching user, repo, params
+      end
+
+      def stop_watching(user, repo, params)
+        github_api.repos.watching.stop_watching user, repo, params
+      end
+    end
+
+  end # Watching
+end # GithubCLI

data/lib/github_cli/cli.rb

@@ -1,8 +1,9 @@
 # encoding: utf-8
 
 module GithubCLI
-  class CLI < ::Thor
+  class CLI < Thor
     include Thor::Actions
+    require 'github_cli/subcommands'
 
     def initialize(*args)
       super
@@ -63,36 +64,6 @@ module GithubCLI
       Terminal.print_commands pattern
     end
 
-    desc "blob <command>", "Leverage Blobs API"
-    subcommand "blob", GithubCLI::Commands::Blobs
-
-    desc "commit <command>", "Leverage Commits API"
-    subcommand "commit", GithubCLI::Commands::Commits
-
-    desc "fork <command>", "Leverage Forks API"
-    subcommand "fork", GithubCLI::Commands::Forks
-
-    desc "issue <command>", "Leverage Issues API"
-    subcommand "issue", GithubCLI::Commands::Issues
-
-    desc "label <command>", "Leverage Labels API"
-    subcommand "label", GithubCLI::Commands::Labels
-
-    desc "pull <command>", "Leverage Pull Requests API"
-    subcommand "pull", GithubCLI::Commands::PullRequests
-
-    desc "ref <command>", "Leverage References API"
-    subcommand "ref", GithubCLI::Commands::References
-
-    desc "repo <command>", "Leverage Repositories API"
-    subcommand "repo", GithubCLI::Commands::Repositories
-
-    desc "tag <command>", "Leverage Tags API"
-    subcommand "tag", GithubCLI::Commands::Tags
-
-    desc "tree <command>", "Leverage Trees API"
-    subcommand "tree", GithubCLI::Commands::Trees
-
     desc 'version', 'Display Github CLI version.'
     def version
       say "Github CLI #{GithubCLI::VERSION}"

data/lib/github_cli/command.rb

@@ -3,7 +3,13 @@
 module GithubCLI
   class Command < Thor
 
-    API_CLASSES = %w( c_l_i repo issue label tree blob reference pull commit fork )
+    API_CLASSES = %w(
+      c_l_i
+      repo download key fork
+      issue label
+      tag tree blob reference commit
+      pull
+    )
 
     HELP_COMMAND = 'help'
 

data/lib/github_cli/commands.rb

@@ -4,13 +4,17 @@ module GithubCLI
   module Commands
     autoload :Blobs,        'github_cli/commands/blobs'
     autoload :Commits,      'github_cli/commands/commits'
+    autoload :Downloads,    'github_cli/commands/downloads'
     autoload :Forks,        'github_cli/commands/forks'
+    autoload :Hooks,        'github_cli/commands/hooks'
     autoload :Issues,       'github_cli/commands/issues'
+    autoload :Keys,         'github_cli/commands/keys'
     autoload :Labels,       'github_cli/commands/labels'
     autoload :PullRequests, 'github_cli/commands/pull_requests'
     autoload :References,   'github_cli/commands/references'
     autoload :Repositories, 'github_cli/commands/repositories'
     autoload :Tags,         'github_cli/commands/tags'
     autoload :Trees,        'github_cli/commands/trees'
+    autoload :Watching,     'github_cli/commands/watching'
   end # Commands
 end # GithubCLI

data/lib/github_cli/commands/blobs.rb

@@ -13,6 +13,12 @@ module GithubCLI
     end
 
     desc 'create <user> <repo>', 'Create a new Blob'
+    long_desc <<-DESC
+      Inputs
+
+        content - String of content \n
+        encoding - String containing encoding utf-8 or base64
+    DESC
     method_option :params, :type => :hash, :default => {},
                   :desc => 'Additonal request parameters e.i per_page:100'
     def create(user, repo)

data/lib/github_cli/commands/commits.rb

@@ -13,6 +13,24 @@ module GithubCLI
     end
 
     desc 'create <user> <repo>', 'Create a Commit'
+    long_desc <<-DESC
+      Parameters
+
+      message - String of the commit message \n
+      tree - String of the SHA of the tree object this commit points to \n
+      parents - Array of the SHAs of the commits that were the parents of this commit. If omitted or empty, the commit will be written as a root commit. For a single parent, an array of one SHA should be provided, for a merge commit, an array of more than one should be provided. \n
+
+        Optional Parameters
+
+        The committer section is optional and will be filled with the author data if omitted. If the author section is omitted, it will be filled in with the authenticated users information and the current date.
+
+        author.name - String of the name of the author of the commit \n
+        author.email - String of the email of the author of the commit \n
+        author.date - Timestamp of when this commit was authored \n
+        committer.name - String of the name of the committer of the commit \n
+        committer.email - String of the email of the committer of the commit \n
+        committer.date:: Timestamp of when this commit was committed
+    DESC
     method_option :params, :type => :hash, :default => {},
                   :desc => 'Additonal request parameters e.i per_page:100'
     def create(user, repo)

data/lib/github_cli/commands/downloads.rb

@@ -0,0 +1,67 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Commands::Downloads < Command
+
+    namespace :download
+
+    desc 'list <user> <repo>', 'Lists downloads'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def list(user, repo)
+      Download.all user, repo, options[:params]
+    end
+
+    desc 'get <user> <repo> <id>', 'Get a download'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def get(user, repo, id)
+      Download.get user, repo, id, options[:params]
+    end
+
+    desc 'create <user> <repo>', 'Create a new download resource'
+    long_desc <<-DESC
+      Creating a new download is a two step process.
+
+      You must first create a new download resource using this method.
+      Response from this method is to be used in #upload method.
+
+      Inputs
+
+        name - Required string - name of the file that is being created. \n
+        size - Required number - size of file in bytes. \n
+        description - Optional string \n
+        content_type - Optional string \n
+    DESC
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    def create(user, repo)
+      Download.create user, repo, options[:params]
+    end
+
+    desc 'upload <resource> <filename>', 'Upload resource to s3'
+    long_desc <<-DESC
+      Upload a file to Amazon, using the reponse instance from
+      Github::Repos::Downloads#create_download. 
+
+      This can be done by passing the response object
+      as an argument to upload method.
+
+      Parameters
+
+        resource - Required resource of the create_download call. \n
+        filename - Required filename, a path to a file location. \n
+    DESC
+    def upload(resource, filename)
+      Download.upload resource, filename
+    end
+
+    desc 'delete <user> <repo> <id>', 'Delete a download'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    def delete(user, repo, id)
+      Download.delete user, repo, id, options[:params]
+    end
+
+  end # Downloads
+end # GithubCLI

data/lib/github_cli/commands/forks.rb

@@ -8,8 +8,10 @@ module GithubCLI
     desc 'list <user> <repo>', 'Lists forks'
     long_desc <<-DESC
       List repository forks
+
       Parameters
-        sort - newest, oldest, watchers, default: newest
+
+      sort - newest, oldest, watchers, default: newest
     DESC
     method_option :sort, :type => :string, :aliases => ["-s"],
                   :desc => 'Sort by newest, oldest or watchers',
@@ -23,7 +25,7 @@ module GithubCLI
       Fork.all user, repo, options[:params]
     end
 
-    desc 'create <user> <repo>', 'Create a new Blob'
+    desc 'create <user> <repo>', 'Create a new fork'
     method_option :org, :type => :string,
                   :desc => ' Organization login. The repository will be forked into this organization.'
     method_option :params, :type => :hash, :default => {},

data/lib/github_cli/commands/hooks.rb

@@ -0,0 +1,67 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Commands::Hooks < Command
+
+    namespace :hook
+
+    desc 'list <user> <repo>', 'Lists hooks'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def list(user, repo)
+      Hook.all user, repo, options[:params]
+    end
+
+    desc 'get <user> <repo> <id>', 'Get a hook'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def get(user, repo, id)
+      Hook.get user, repo, id, options[:params]
+    end
+
+    desc 'create <user> <repo>', 'Create a hook'
+    long_desc <<-DESC
+      Inputs
+
+      name - Required string - the name of the service that is being called.\n
+      config - Required hash - A Hash containing key/value pairs to provide settings for this hook. \n
+      events - Optional array - Determines what events the hook is triggered for. Default: ["push"] \n
+      active - Optional boolean - Determines whether the hook is actually triggered on pushes.
+    DESC
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    def create(user, repo)
+      Hook.create user, repo, options[:params]
+    end
+
+    desc 'edit <user> <repo> <id>', 'Edit a hook'
+    long_desc <<-DESC
+      Inputs
+
+      name - Required string - the name of the service that is being called. \n
+      config - Required hash - A Hash containing key/value pairs to provide settings for this hook. \n
+      events - Optional array - Determines what events the hook is triggered for. This replaces the entire array of events. Default: ["push"]. \n
+      add_events - Optional array - Determines a list of events to be added to the list of events that the Hook triggers for. \n
+      remove_events - Optional array - Determines a list of events to be removed from the list of events that the Hook triggers for. \n
+      active - Optional boolean - Determines whether the hook is actually triggered on pushes. \n
+    DESC
+    def edit(user, repo, id)
+      Hook.edit user, repo, id, options[:params]
+    end
+
+    desc 'test <user> <repo> <id>', 'Test a hook'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    def test(user, repo, id)
+      Hook.test user, repo, id, options[:params]
+    end
+
+    desc 'delete <user> <repo> <id>', 'Delete a hook'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    def delete(user, repo, id)
+      Hook.delete user, repo, id, options[:params]
+    end
+
+  end # Hooks
+end # GithubCLI

data/lib/github_cli/commands/keys.rb

@@ -0,0 +1,56 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Commands::Keys < Command
+
+    namespace :key
+
+    desc 'list <user> <repo>', 'Lists keys'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def list(user, repo)
+      Key.all user, repo, options[:params]
+    end
+
+    desc 'get <user> <repo> <id>', 'Get a key'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def get(user, repo, id)
+      Key.get user, repo, id, options[:params]
+    end
+
+    desc 'create <user> <repo>', 'Create a new key'
+    long_desc <<-DESC
+      Inputs
+
+      title - Required string. \n
+      key - Required string.
+    DESC
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    def create(user, repo)
+      Key.create user, repo, options[:params]
+    end
+
+    desc 'edit <user> <repo> <id>', 'Edit a key'
+    long_desc <<-DESC
+      Inputs
+
+      title - Required string. \n
+      key - Required string.
+    DESC
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    def edit(user, repo, id)
+      Key.edit user, repo, id, options[:params]
+    end
+
+    desc 'delete <user> <repo> <id>', 'Delete a key'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    def delete(user, repo, id)
+      Key.delete user, repo, id, options[:params]
+    end
+
+  end # Keys
+end # GithubCLI

data/lib/github_cli/commands/references.rb

@@ -5,13 +5,6 @@ module GithubCLI
 
     namespace :ref
 
-    desc 'get <user> <repo> <ref>', 'Get a Reference'
-    method_option :params, :type => :hash, :default => {},
-                  :desc => 'Additonal request parameters e.i per_page:100'
-    def get(user, repo, ref)
-      Reference.get user, repo, ref, options[:params]
-    end
-
     desc 'list <user> <repo> <ref>', 'List all References'
     method_option :ref, :type => :string, :banner => 'branch reference'
     method_option :params, :type => :hash, :default => {},
@@ -21,7 +14,20 @@ module GithubCLI
       Reference.list user, repo, ref, options[:params]
     end
 
+    desc 'get <user> <repo> <ref>', 'Get a Reference'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    def get(user, repo, ref)
+      Reference.get user, repo, ref, options[:params]
+    end
+
     desc 'create <user> <repo>', 'Create a new Reference'
+    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
+    DESC
     method_option :params, :type => :hash, :default => {},
                   :desc => 'Additonal request parameters e.i per_page:100'
     def create(user, repo)
@@ -29,6 +35,12 @@ module GithubCLI
     end
 
     desc 'update <user> <repo> <ref>', 'Update a Reference'
+    long_desc <<-DESC
+      Inputs
+
+      sha - String of the SHA1 value to set this reference to\n
+      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
     method_option :params, :type => :hash, :default => {},
                   :desc => 'Additonal request parameters e.i per_page:100'
     def update(user, repo, ref)

data/lib/github_cli/commands/repositories.rb

@@ -31,6 +31,21 @@ module GithubCLI
     end
 
     desc 'create', 'Create a new repository for the authenticated user.'
+    long_desc <<-DESC
+      Create a new repository for the autheticated user.
+
+      Parameters
+
+        name - Required string \n
+        description - Optional string \n
+        homepage - Optional string \n
+        private - Optional boolean - true to create a private repository, false to create a public one \n
+        has_issues - Optional boolean - true to enable issues for this repository, false to disable them \n
+        has_wiki - Optional boolean - true to enable the wiki for this repository, false to disable it. Default is true \n
+        has_downloads Optional boolean - true to enable downloads for this repository \n
+        org Optional string - The organisation in which this repository will be created \n
+        team_id - Optional number - The id of the team that will be granted access to this repository. This is only valid when creating a repo in an organization \n
+    DESC
     method_option :org, :type => :string, :aliases => ["-o"],
                   :desc => 'Create repository in <organization>',
                   :banner => '<organization>'
@@ -40,10 +55,23 @@ module GithubCLI
       if options[:org]
         options[:params]['org'] = options[:org]
       end
-      Repository.create user, repo, options[:params]
+      Repository.create options[:params]
     end
 
     desc 'edit <user> <repo>', 'Edit <repo> for an <user>.'
+    long_desc <<-DESC
+      Create a new repository for the autheticated user.
+
+      Parameters
+
+        name - Required string \n
+        description - Optional string \n
+        homepage - Optional string \n
+        private - Optional boolean - true to create a private repository, false to create a public one \n
+        has_issues - Optional boolean - true to enable issues for this repository, false to disable them \n
+        has_wiki - Optional boolean - true to enable the wiki for this repository, false to disable it. Default is true \n
+        has_downloads Optional boolean - true to enable downloads for this repository \n
+    DESC
     method_option :params, :type => :hash, :default => {},
                   :desc => 'Additonal request parameters e.i per_page:100'
     def edit(user, repo)

data/lib/github_cli/commands/tags.rb

@@ -15,6 +15,23 @@ module GithubCLI
     end
 
     desc 'create <user> <repo>', 'Create a Tag Object'
+    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,
+      you have to do this call to create the tag object, and then create
+      the refs/tags/[tag] reference. If you want to create a lightweight tag,
+      you simply have to create the reference - this call would be unnecessary.
+
+      Parameters
+
+      tag - String of the tag \n
+      message - String of the tag message \n
+      object - String of the SHA of the git object this is tagging \n
+      type - String of the type of the object we're tagging. Normally this is a commit but it can also be a tree or a blob \n
+      tagger.name - String of the name of the author of the tag \n
+      tagger.email - String of the email of the author of the tag \n
+      tagger.date - Timestamp of when this object was tagged \n
+    DESC
     method_option :params, :type => :hash, :default => {},
                   :desc => 'Additonal request parameters e.i per_page:100'
     def create(user, repo)

data/lib/github_cli/commands/trees.rb

@@ -18,6 +18,22 @@ module GithubCLI
     end
 
     desc 'create <user> <repo>', 'Create a new Tree'
+    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,
+      it will overwrite the contents of that tree with the new path contents
+       and write a new tree out.
+
+      Parameters
+
+      base_tree - optional string of the SHA1 of the tree you want to update with new data \n
+      tree - array of hash objects(of :path, :mode, :type and sha) \n
+      tree.path - String of the file referenced in the tree \n
+      tree.mode - String of the file mode - one of 100644 for file(blob), 100755 for executable (blob), 040000 for subdirectory (tree), 160000 for submodule (commit) or 120000 for a blob that specifies the path of a symlink \n
+      tree.type - String of blob, tree, commit \n
+      tree.sha - String of SHA1 checksum ID of the object in the tree
+      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
     method_option :params, :type => :hash, :default => {},
                   :desc => 'Additonal request parameters e.i per_page:100'
     def create(user, repo)

data/lib/github_cli/commands/watching.rb

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Commands::Watching < Command
+
+    namespace :watch
+
+    desc 'watchers <user> <repo>', 'Lists repo watchers'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def watchers(user, repo)
+      Watching.watchers user, repo, options[:params]
+    end
+
+    desc 'watched', 'Lists repos being watched by a user'
+    method_option :user, :type => :string, :aliases => ["-u"],
+                  :desc => 'Watch repositories for <user>'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def watched(user, repo, id)
+      if options[:user]
+        options[:params]['user'] = options[:user]
+      end
+      Watching.watched options[:params]
+    end
+
+    desc 'watching <user> <repo>', 'Check if you are watching a repository'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    def watching(user, repo)
+      Watching.watching? user, repo, options[:params]
+    end
+
+    desc 'start <user> <repo>', 'Watch a repository'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    def start(user, repo)
+      Watching.start_watching user, repo, options[:params]
+    end
+
+    desc 'stop <user> <repo>', 'Stop watching a repository'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    def stop(user, repo)
+      Watching.stop_watching user, repo, options[:params]
+    end
+
+  end # Watching
+end # GithubCLI

data/lib/github_cli/config.rb

@@ -17,7 +17,7 @@ module GithubCLI
     end
 
     def [](key)
-      data[key] #|| data[COMMAND_KEY][key]
+      data[key] #|| (data.nil? ? nil : data[COMMAND_KEY][key])
     end
 
     def fetch(key, default=nil)

data/lib/github_cli/subcommands.rb

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+module GithubCLI
+  class CLI
+
+    desc "blob <command>", "Leverage Blobs API"
+    subcommand "blob", GithubCLI::Commands::Blobs
+
+    desc "commit <command>", "Leverage Commits API"
+    subcommand "commit", GithubCLI::Commands::Commits
+
+    desc "download <command>", "Leverage Downloads API"
+    subcommand "download", GithubCLI::Commands::Downloads
+
+    desc "fork <command>", "Leverage Forks API"
+    subcommand "fork", GithubCLI::Commands::Forks
+
+    desc "hook <command>", "Leverage Hooks API"
+    subcommand "hook", GithubCLI::Commands::Hooks
+
+    desc "issue <command>", "Leverage Issues API"
+    subcommand "issue", GithubCLI::Commands::Issues
+
+    desc "key <command>", "Leverage Keys API"
+    subcommand "key", GithubCLI::Commands::Keys
+
+    desc "label <command>", "Leverage Labels API"
+    subcommand "label", GithubCLI::Commands::Labels
+
+    desc "pull <command>", "Leverage Pull Requests API"
+    subcommand "pull", GithubCLI::Commands::PullRequests
+
+    desc "ref <command>", "Leverage References API"
+    subcommand "ref", GithubCLI::Commands::References
+
+    desc "repo <command>", "Leverage Repositories API"
+    subcommand "repo", GithubCLI::Commands::Repositories
+
+    desc "tag <command>", "Leverage Tags API"
+    subcommand "tag", GithubCLI::Commands::Tags
+
+    desc "tree <command>", "Leverage Trees API"
+    subcommand "tree", GithubCLI::Commands::Trees
+
+    desc "watch <command>", "Leverage Watching API"
+    subcommand "watch", GithubCLI::Commands::Watching
+
+  end # CLI
+end # GithubCLI

data/lib/github_cli/version.rb

@@ -1,3 +1,3 @@
 module GithubCLI
-  VERSION = "0.1.3"
+  VERSION = "0.2.0"
 end

data/spec/github_cli/config_spec.rb

@@ -5,8 +5,14 @@ describe GithubCLI::Config do
   let(:config_name) { 'simple_config' }
   let(:path) { "/users/#{filename}" }
 
+  before :all do
+    unless File.exists?(fixture_path('.githubrc'))
+      File.symlink(fixture_path(config_name), fixture_path('.githubrc'))
+    end
+  end
+
   context 'global' do
-    let(:config) { GithubCLI::Config.new fixture_path(config_name) }
+    let(:config) { GithubCLI::Config.new fixture_path }
 
     before do
       File.stub(:open) { YAML.load fixture('simple_config') }

data/spec/spec_helper.rb

@@ -14,6 +14,6 @@ def fixture(name)
   File.read File.expand_path File.join(File.dirname(__FILE__), '..', 'fixtures', name)
 end
 
-def fixture_path(name)
+def fixture_path(name='')
   File.expand_path File.join(File.dirname(__FILE__), '..', 'fixtures', name)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: github_cli
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,22 +9,22 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-22 00:00:00.000000000 Z
+date: 2012-04-29 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: github_api
-  requirement: &2151931480 !ruby/object:Gem::Requirement
+  requirement: &2160315660 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.4.8
+        version: 0.5.0
   type: :runtime
   prerelease: false
-  version_requirements: *2151931480
+  version_requirements: *2160315660
 - !ruby/object:Gem::Dependency
   name: thor
-  requirement: &2151930740 !ruby/object:Gem::Requirement
+  requirement: &2160315120 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2151930740
+  version_requirements: *2160315120
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &2151929860 !ruby/object:Gem::Requirement
+  requirement: &2160314500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2151929860
+  version_requirements: *2160314500
 - !ruby/object:Gem::Dependency
   name: aruba
-  requirement: &2151929040 !ruby/object:Gem::Requirement
+  requirement: &2160314000 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2151929040
+  version_requirements: *2160314000
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &2151942440 !ruby/object:Gem::Requirement
+  requirement: &2160313480 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,7 +65,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2151942440
+  version_requirements: *2160313480
 description: CLI-based access to GitHub API v3
 email:
 - pmurach@gmail.com
@@ -89,6 +89,7 @@ files:
 - features/settings.feature
 - features/support/env.rb
 - features/support/hooks.rb
+- fixtures/.githubrc
 - fixtures/simple_config
 - github_cli.gemspec
 - lib/github_cli.rb
@@ -96,30 +97,39 @@ files:
 - lib/github_cli/apis.rb
 - lib/github_cli/apis/blob.rb
 - lib/github_cli/apis/commit.rb
+- lib/github_cli/apis/download.rb
 - lib/github_cli/apis/fork.rb
+- lib/github_cli/apis/hook.rb
+- lib/github_cli/apis/key.rb
 - lib/github_cli/apis/label.rb
 - lib/github_cli/apis/pull_request.rb
 - lib/github_cli/apis/reference.rb
 - lib/github_cli/apis/repository.rb
 - lib/github_cli/apis/tag.rb
 - lib/github_cli/apis/tree.rb
+- lib/github_cli/apis/watching.rb
 - lib/github_cli/cli.rb
 - lib/github_cli/command.rb
 - lib/github_cli/commands.rb
 - lib/github_cli/commands/blobs.rb
 - lib/github_cli/commands/commits.rb
+- lib/github_cli/commands/downloads.rb
 - lib/github_cli/commands/forks.rb
+- lib/github_cli/commands/hooks.rb
 - lib/github_cli/commands/issues.rb
+- lib/github_cli/commands/keys.rb
 - lib/github_cli/commands/labels.rb
 - lib/github_cli/commands/pull_requests.rb
 - lib/github_cli/commands/references.rb
 - lib/github_cli/commands/repositories.rb
 - lib/github_cli/commands/tags.rb
 - lib/github_cli/commands/trees.rb
+- lib/github_cli/commands/watching.rb
 - lib/github_cli/config.rb
 - lib/github_cli/dsl.rb
 - lib/github_cli/errors.rb
 - lib/github_cli/helpers.rb
+- lib/github_cli/subcommands.rb
 - lib/github_cli/terminal.rb
 - lib/github_cli/ui.rb
 - lib/github_cli/version.rb