github_cli 0.3.1 → 0.4.0

data/lib/github_cli/apis/organization.rb

@@ -0,0 +1,28 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Organization < API
+
+    class << self
+
+      def list(user, params, format)
+        output format do
+          github_api.orgs.list user, params
+        end
+      end
+
+      def get(org, params, format)
+        output format do
+          github_api.orgs.get org, params
+        end
+      end
+
+      def edit(org, params, format)
+        output format do
+          github_api.orgs.edit org, params
+        end
+      end
+    end
+
+  end # Organization
+end # GithubCLI

data/lib/github_cli/apis/team.rb

@@ -0,0 +1,89 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Team < API
+
+    class << self
+
+      def all(org, params, format)
+        output format do
+          github_api.orgs.teams.list org, params
+        end
+      end
+
+
+      def get(id, params, format)
+        output format do
+          github_api.orgs.teams.get id, params
+        end
+      end
+
+      def create(org, params, format)
+        output format do
+          github_api.orgs.teams.create org, params
+        end
+      end
+
+      def edit(id, params, format)
+        output format do
+          github_api.orgs.teams.edit id, params
+        end
+      end
+
+      def delete(id, params, format)
+        output format do
+          github_api.orgs.teams.delete id, params
+        end
+      end
+
+      def all_member(id, params, format)
+        output format do
+          github_api.orgs.teams.list_members id, params
+        end
+      end
+
+      def member(id, user, params, format)
+        output format do
+          github_api.orgs.teams.team_member? id, user, params
+        end
+      end
+
+      def add_member(id, user, params, format)
+        output format do
+          github_api.orgs.teams.add_member id, user, params
+        end
+      end
+
+      def remove_member(id, user, params, format)
+        output format do
+          github_api.orgs.teams.remove_member id, user, params
+        end
+      end
+
+      def all_repo(id, params, format)
+        output format do
+          github_api.orgs.teams.list_repos id, params
+        end
+      end
+
+      def repo(id, user, repo, params, format)
+        output format do
+          github_api.orgs.teams.team_repo? id, user, repo, params
+        end
+      end
+
+      def add_repo(id, user, repo, params, format)
+        output format do
+          github_api.orgs.teams.add_member id, user, repo, params
+        end
+      end
+
+      def remove_repo(id, user, repo, params, format)
+        output format do
+          github_api.orgs.teams.remove_repo id, user, repo, params
+        end
+      end
+    end
+
+  end # Team
+end # GithubCLI

data/lib/github_cli/apis/user.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+
+module GithubCLI
+  class User < API
+
+    class << self
+
+      def get(user, params, format)
+        output format do
+          github_api.users.get params.update(:user => user)
+        end
+      end
+
+      def update(params, format)
+        output format do
+          github_api.users.update params
+        end
+      end
+    end
+
+  end # User
+end # GithubCLI

data/lib/github_cli/apis.rb

@@ -15,18 +15,23 @@ end
   commit
   download
   email
+  follower
   fork
   gist
   hook
   issue
   key
   label
+  member
   milestone
+  organization
   pull_request
   reference
   repository
   tag
+  team
   tree
+  user
   watching
 ].each do |api|
   require_api api

data/lib/github_cli/cli.rb

@@ -10,13 +10,13 @@ module GithubCLI
       the_shell = (options["no-color"] ? Thor::Shell::Basic.new : shell)
       GithubCLI.ui = UI.new(the_shell)
       GithubCLi.ui.debug! if options["verbose"]
-      Terminal.print_program_name
+      options["no-pager"] ? Pager.disable : Pager.enable
     end
 
     map "repository" => :repo,
         "reference"  => :ref,
         "is" => :issue,
-        "-v" => :version,
+        "--version" => :version,
         "ls" => :list
 
     class_option :config, :type => :string,
@@ -26,9 +26,16 @@ module GithubCLI
                  :desc => 'Authentication token.',
                  :banner => 'Set authentication token'
     class_option "no-color", :type => :boolean,
-                 :banner => "Disable colorization in output."
+                 :desc => "Disable colorization in output."
+    class_option "no-pager", :type => :boolean,
+                 :desc => "Disable pagination of the output."
+    class_option :pager, :type => :string, :aliases => '-p',
+                 :desc => "Command to be used for paging. Command can have options after it i.e. 'less -r'. Defaults to common pagers i.e. less if detected.",
+                 :banner => "less, more etc..."
     class_option :verbose, :type => :boolean,
-                 :banner => "Enable verbose output mode."
+                 :desc => "Enable verbose output mode."
+    class_option :version, :type => :boolean,
+                 :desc => "Show program version"
 
     desc 'init', 'Generates a configuration file in your home directory'
     long_desc <<-DESC

data/lib/github_cli/command.rb

@@ -10,7 +10,8 @@ module GithubCLI
       issue label milestone
       tag tree blob reference commit
       pull
-      email
+      user email follower
+      org member team
       event
     )
 
@@ -31,44 +32,55 @@ module GithubCLI
         "all" => :list,
         "del" => :delete
 
+    class_option :params, :type => :hash, :default => {}, :aliases => '-p',
+                 :desc => 'Request parameters e.i per_page:100'
+
     class_option :format, :type => :string, :aliases => '-f',
                  :default => 'table',
                  :banner => output_formats.keys.join('|'),
-                 :desc => "Format of the output"
-    class_option :pager, :type => :boolean, :aliases => '-p',
-                 :default => true,
-                 :desc => "Determines if the output is paged."
+                 :desc => "Format of the output. Type table:h to display table horizontally."
 
-    def self.banner(task, namespace=true, subcommand=true)
-      "#{basename} #{task.formatted_usage(self, true, subcommand)}"
-    end
+    class << self
 
+      def banner(task, namespace=true, subcommand=true)
+        "#{basename} #{task.formatted_usage(self, true, subcommand)}"
+      end
 
-    def self.all
-      commands = []
-      Base.subclasses.each do |klass|
-        namespace = extract_namespace(klass)
-        next unless is_api_command?(namespace)
-        namespace = "" if namespace.index API_CLASSES.first
+      def all
+        commands = []
+        Thor::Base.subclasses.each do |klass|
+          namespace = extract_namespace(klass)
+          next unless is_api_command?(namespace)
+          namespace = "" if namespace.index API_CLASSES.first
 
-        klass.tasks.each do |task|
-          next if task.last.name.index HELP_COMMAND
-          commands << Comm.new(namespace,
-                               task.last.name,
-                               task.last.description,
-                               task.last.usage)
+          klass.tasks.each do |task|
+            next if task.last.name.index HELP_COMMAND
+            commands << Comm.new(namespace,
+                                task.last.name,
+                                task.last.description,
+                                task.last.usage)
+          end
         end
+        commands
       end
-      commands
-    end
 
-    def self.is_api_command?(klass)
-      return false unless API_CLASSES.include?(klass.to_s)
-      return true
-    end
+      def is_api_command?(klass)
+        return false unless API_CLASSES.include?(klass.to_s)
+        return true
+      end
+
+      def extract_namespace(klass)
+        klass.namespace.split(':').last
+      end
+
+      def command_to_show(command)
+        command_token = Command.all.find do |cmd|
+          end_index = command.index('<').nil? ? -1 : command.index('<')
+          !cmd.namespace.empty? && command[0..end_index].include?(cmd.namespace)
+        end
+        command_token ? command_token.namespace : '<command>'
+      end
 
-    def self.extract_namespace(klass)
-      klass.namespace.split(':').last
     end
 
   end # Command

data/lib/github_cli/commands/followers.rb

@@ -0,0 +1,50 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Commands::Followers < Command
+
+    namespace :follower
+
+    desc 'list', "Lists an authenticated user's followers"
+    method_option :user, :type => :string, :aliases => ["-u"],
+                  :desc => 'List a <user> followers',
+                  :banner => '<user>'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def list
+      Follower.all options[:user], options[:params], options[:format]
+    end
+
+    desc 'following', 'List who the authenticated user is following'
+    method_option :user, :type => :string, :aliases => ["-u"],
+                  :desc => 'List who a <user> is following',
+                  :banner => '<user>'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def following
+      Follower.following options[:user], options[:params], options[:format]
+    end
+
+    desc 'follower <user>', 'Check if you are following a user'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def follower(user)
+      Follower.following? user, options[:params], options[:format]
+    end
+
+    desc 'follow <user>', 'Follow a user'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def follow(user)
+      Follower.follow user, options[:params], options[:format]
+    end
+
+    desc 'unfollow <user>', 'Unfollow a user'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def unfollow(user)
+      Follower.unfollow user, options[:params], options[:format]
+    end
+
+  end # Followers
+end # GithubCLI

data/lib/github_cli/commands/members.rb

@@ -0,0 +1,70 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Commands::Members < Command
+
+    namespace :member
+
+    desc 'list <org>', "Lists an organization members"
+    long_desc <<-DESC
+      List all users who are members of an organization. A member is a user
+      that belongs to at least 1 team in the organization.
+
+      If the authenticated user is also a member of this organization then
+      both concealed and public members will be returned.
+      Otherwise only public members are returned.
+
+      Members of an organization can choose to have their membership publicized or not.
+    DESC
+    method_option :public, :type => :boolean, :default => false,
+                  :desc => 'List public members'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def list(org)
+      if options[:public]
+        Member.all_public org, options[:params], options[:format]
+      else
+        Member.all org, options[:params], options[:format]
+      end
+    end
+
+    desc 'member <org> <user>', 'Checks if user is a member of an organization'
+    method_option :public, :type => :boolean, :default => false,
+                  :desc => 'Get if a user is a public member of an organization'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def member(org, user)
+      if options[:public]
+        Member.public_member? org, user, options[:params], options[:format]
+      else
+        Member.member? org, user, options[:params], options[:format]
+      end
+    end
+
+    desc 'delete <org> <user>', 'Remove a member from an organization'
+    long_desc <<-DESC
+      Removing a user from this list will remove them from all teams and they
+      will no longer have any access to the organization’s repositories.
+    DESC
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def delete(org, user)
+      Member.delete org, user, options[:params], options[:format]
+    end
+
+    desc 'publicize <org> <user>', "Publicize a user’s membership"
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def publicize(org, user)
+      Member.publicize org, user, options[:params], options[:format]
+    end
+
+    desc 'conceal <org> <user>', "Conceal a user’s membership"
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def conceal(org, user)
+      Member.conceal org, user, options[:params], options[:format]
+    end
+
+  end # Members
+end # GithubCLI

data/lib/github_cli/commands/organizations.rb

@@ -0,0 +1,42 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Commands::Organizations < Command
+
+    namespace :org
+
+    desc 'list', 'List public and private organizations for the authenticated user'
+    method_option :user, :type => :string, :aliases => ["-u"],
+                  :desc => 'List all public organizations for a user',
+                  :banner => '<user>'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def list
+      Organization.list options[:user], options[:params], options[:format]
+    end
+
+    desc 'get <org>', 'Get properties for a single organization'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def get(org)
+      Organization.get org, options[:params], options[:format]
+    end
+
+    desc 'edit <org>', 'Edit organization'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    long_desc <<-DESC
+      Parameters
+
+      billing_email - Optional string - Billing email address. This address is not publicized.\n
+      company - Optional string\n
+      email - Optional string\n
+      location - Optional string\n
+      name - Optional string\n
+    DESC
+    def edit(org)
+      Oraanization.edit org, options[:params], options[:format]
+    end
+
+  end # Organizations
+end # GithubCLI

data/lib/github_cli/commands/teams.rb

@@ -0,0 +1,148 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Commands::Teams < Command
+
+    namespace :team
+
+    desc 'list <org>', "List teams"
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def list(org)
+      Team.all org, options[:params], options[:format]
+    end
+
+    desc 'get <id>', "Get a team"
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def get(id)
+      Team.get id, options[:params], options[:format]
+    end
+
+    desc 'create <org>', "Create a team"
+    long_desc <<-DESC
+      In order to create a team, the authenticated user must be an owner of :org.
+
+      Input
+
+      name - Required string\n
+      repo_names - Optional array of strings\n
+      permission - Optional string\n
+      *  pull - team members can pull, but not push or administor this repositories. Default\n
+      * push - team members can pull and push, but not administor this repositores.\n
+      * admin - team members can pull, push and administor these repositories.\n
+    DESC
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def create(org)
+      Team.create org, options[:params], options[:format]
+    end
+
+    desc 'edit <id>', "Edit team <id>"
+    long_desc <<-DESC
+      In order to edit a team, the authenticated user must be an owner of the org that the team is associated with.
+
+      Input
+
+      name - Required string\n
+      permission - Optional string\n
+      *  pull - team members can pull, but not push or administor this repositories. Default\n
+      * push - team members can pull and push, but not administor this repositores.\n
+      * admin - team members can pull, push and administor these repositories.\n
+    DESC
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def edit(id)
+      Team.edit id, options[:params], options[:format]
+    end
+
+    desc 'delete <id>', 'Delete team'
+    long_desc <<-DESC
+      In order to delete a team, the authenticated user must be an owner of the org that the team is associated with.
+    DESC
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def delete(id)
+      Team.delete id, options[:params], options[:format]
+    end
+
+    desc 'list_member <id>', "List team <id> members"
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def list_member(id)
+      Team.all_member id, options[:params], options[:format]
+    end
+
+    desc 'member <id> <user>', 'Check if <user> is a team member'
+    long_desc <<-DESC
+      In order to get if a user is a member of a team, the authenticated user must be a member of the team.
+    DESC
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def member(id, user)
+      Team.member id, user, options[:params], options[:format]
+    end
+
+    desc 'add_member <id> <user>', 'Add team member'
+    long_desc <<-DESC
+      In order to add a user to a team, the authenticated user must have ‘admin’ permissions to the team or be an owner of the org that the team is associated with.
+    DESC
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def add_member(id, user)
+      Team.add_member id, user, options[:params], options[:format]
+    end
+
+    desc 'remove_member <id> <user>', 'Remove team member'
+    long_desc <<-DESC
+      In order to remove a user from a team, the authenticated user must have
+      ‘admin’ permissions to the team or be an owner of the org that the team
+      is associated with. NOTE: This does not delete the user, it just remove
+      them from the team.
+    DESC
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def remove_member(id, user)
+      Team.remove_member id, user, options[:params], options[:format]
+    end
+
+    desc 'list_repo <id>', "List team <id> repositories"
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def list_repo(id)
+      Team.all_repo id, options[:params], options[:format]
+    end
+
+    desc 'repo <id> <user> <repo>', 'Check if <repo> is managed by <id> team'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def repo(id, user, repo)
+      Team.repo id, user, repo, options[:params], options[:format]
+    end
+
+    desc 'add_repo <id> <user> <repo>', 'Add team <repo>'
+    long_desc <<-DESC
+      In order to add a repo to a team, the authenticated user must be an owner
+      of the org that the team is associated with. Also, the repo must be owned
+      by the organization, or a direct for of a repo owned by the organization.
+    DESC
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def add_repo(id, user, repo)
+      Team.add_repo id, user, repo, options[:params], options[:format]
+    end
+
+    desc 'remove_repo <id> <user> <repo>', 'Remove team <repo>'
+    long_desc <<-DESC
+      In order to remove a repo from a team, the authenticated user must be an
+      owner of the org that the team is associated with. NOTE: This does not
+      delete the repo, it just removes it from the team.
+    DESC
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def remove_repo(id, user, repo)
+      Team.remove_repo id, user, repo, options[:params], options[:format]
+    end
+
+  end # Teams
+end # GithubCLI

data/lib/github_cli/commands/users.rb

@@ -0,0 +1,26 @@
+# encoding: utf-8
+
+module GithubCLI
+  class Commands::Users < Command
+
+    namespace :user
+
+    desc 'get', 'Get the authenticated user'
+    method_option :user, :type => :string, :aliases => ["-u"],
+                  :desc => 'Get a single unauthenticated <user>',
+                  :banner => '<user>'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additional request parameters e.i per_page:100'
+    def get
+      User.get options[:user], options[:params], options[:format]
+    end
+
+    desc 'update', 'Update the authenticated user'
+    method_option :params, :type => :hash, :default => {},
+                  :desc => 'Additonal request parameters e.i per_page:100'
+    def update
+      User.update options[:params], options[:format]
+    end
+
+  end # Users
+end # GithubCLI

data/lib/github_cli/commands.rb

@@ -9,18 +9,23 @@ module GithubCLI
     autoload :Downloads,      'github_cli/commands/downloads'
     autoload :Emails,         'github_cli/commands/emails'
     autoload :Events,         'github_cli/commands/events'
+    autoload :Followers,      'github_cli/commands/followers'
     autoload :Forks,          'github_cli/commands/forks'
     autoload :Gists,          'github_cli/commands/gists'
     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 :Members,        'github_cli/commands/members'
     autoload :Milestones,     'github_cli/commands/milestones'
+    autoload :Organizations,  'github_cli/commands/organizations'
     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 :Teams,          'github_cli/commands/teams'
     autoload :Trees,          'github_cli/commands/trees'
+    autoload :Users,          'github_cli/commands/users'
     autoload :Watching,       'github_cli/commands/watching'
   end # Commands
 end # GithubCLI