ghi 0.2.0

data/History.rdoc

@@ -0,0 +1,180 @@
+=== 0.2.0 / 2009-11-03
+
+* Major-minor release!
+
+  * Cleanup! (Better help, warnings and errors.)
+
+
+=== 0.1.7 / 2009-08-26
+
+* 2 bugfixes
+
+  * Allow dots in repo names.
+  * Fix bug preventing invocation from non-GitHub repo directories.
+
+
+=== 0.1.6 / 2009-08-05
+
+* 1 minor enhancement
+
+  * Support for non-"origin" remotes.
+
+
+* 1 bugfix
+
+  * Graceful offline error.
+
+
+=== 0.1.5 / 2009-07-08
+
+* 2 bugfixes
+
+  * Long titles should wrap in show/verbose issue view.
+  * If a non-OptionParser argument fails early, re-parse when valid.
+
+
+=== 0.1.4 / 2009-05-15
+
+* 1 minor enhancement
+
+  * Minor Windows support.
+
+
+=== 0.1.3 / 2009-05-08
+
+* 1 minor enhancement
+
+  * Fix bug where `more' was being passed `less' options.
+  * Fix scoping of commands so `ghi user/repo` can run outside of a repo
+    directory.
+
+
+=== 0.1.2 / 2009-05-07
+
+* 1 major enhancement
+
+  * Better fallbacks. Enter `ghi open`, `ghi list closed`, `ghi search term`,
+    `ghi show 2`, `ghi user/repo`, etc., it will try to work. Fallbacks do not
+    accept options, though.
+
+
+=== 0.1.1 / 2009-05-01
+
+* 3 major enhancements
+
+  * Use `more' (or $GHI_PAGER) to accommodate lengthy output.
+  * Default to "-l" if Dir.pwd is a git repo.
+  * Accept numbered args/flags to shortcut "show" (e.g., "ghi -2", "ghi 2")
+
+
+* 1 minor enhancement
+
+  * Update --url flag to GitHub's new convention.
+
+
+=== 0.1.0 / 2009-04-27
+
+* 2 major enhancements
+
+  * Use tempfiles when we should, the gitdir otherwise.
+  * Now a minor!
+
+
+* 2 minor enhancement
+
+  * Small ANSI tweaks.
+  * Truncation fix.
+
+
+=== 0.0.9 / 2009-04-27
+
+* 1 major enhancement
+
+  * ANSI colors (honors your .gitconfig).
+
+
+* 1 minor enhancement
+
+  * Bugfixes.
+
+
+=== 0.0.8 / 2009-04-26
+
+* 1 major enhancement
+
+  * Flag to return issues URLs.
+
+
+* 1 minor enhancement
+
+  * Preliminary specs for top-level module and API class.
+
+
+=== 0.0.7 / 2009-04-25
+
+* 1 major enhancement
+
+  * Labels! Label and un-label at your whim.
+
+
+* 1 minor enhancement
+
+  * Tail arguments are sometimes parsed. E.g., ghi -om "Issue message parsed".
+
+
+=== 0.0.6 / 2009-04-25
+
+* 2 minor enhancements
+
+  * Accept comments as arguments in more places.
+  * Update error message to accommodate both issues and comments.
+
+
+=== 0.0.5 / 2009-04-25
+
+* 3 major enhancements
+
+  * Flag to claim/label issues with your GitHub username (thanks, Jamie).
+  * Flag for commenting on issues.
+  * Prompt for GitHub login and token if absent from gitconfig.
+
+
+* 1 minor enhancement
+
+  * Opening issues with a title bypasses your $EDITOR.
+
+
+=== 0.0.4 / 2009-04-24
+
+* 1 major enhancement
+
+  * Cache messages created in $EDITOR.
+
+
+* 2 minor enhancements
+
+  * Refactoring and cleanup.
+  * Change editing messages.
+
+
+=== 0.0.3 / 2009-04-23
+
+* 2 minor enhancements
+
+  * Typo corrected.
+  * README updated.
+
+
+=== 0.0.2 / 2009-04-22
+
+* 1 major enhancement
+
+  * Add --search flag.
+  * Add --repo flag.
+
+
+=== 0.0.1 / 2009-04-21
+
+* 1 major enhancement
+
+  * Birthday!

data/Manifest.txt

@@ -0,0 +1,14 @@
+History.rdoc
+Manifest.txt
+MIT-LICENSE
+Rakefile
+README.rdoc
+bin/ghi
+lib/ghi/api.rb
+lib/ghi/cli.rb
+lib/ghi/issue.rb
+lib/ghi.rb
+spec/ghi/api_spec.rb
+spec/ghi/cli_spec.rb
+spec/ghi/issue_spec.rb
+spec/ghi_spec.rb

data/README.rdoc

@@ -0,0 +1,92 @@
+= ghi
+
+http://github.com/stephencelis/ghi
+
+
+GitHub Issues on the command line. Use your <tt>$EDITOR</tt>, not your
+browser.
+
+== HOW?
+
+Get:
+
+  % gem install stephencelis-ghi --source=http://gems.github.com
+
+
+Go:
+
+  Usage: ghi [options]
+      -l, --list [state|term|number]
+          --search, --show
+      -v, --verbose
+      -o, --open [title|number]
+          --reopen
+      -c, --closed, --close [number]
+      -e, --edit [number]
+      -r, --repo, --repository [name]
+      -m, --comment [number|comment]
+      -t, --label [number] [label]
+          --claim [number]
+      -d, --unlabel [number] [label]
+      -u, --url [state|number]
+          --[no-]color
+          --[no-]pager
+      -V, --version
+      -h, --help
+
+
+== EXAMPLE?
+
+ghi works simply from within a repository. Some short examples:
+
+  ghi -l                    # Lists all open issues
+  ghi                       # Shorter shorthand for "ghi -l"
+  ghi -v                    # Lists all open issues, verbosely (includes body)
+  ghi -lc                   # Lists all closed issues
+  ghi -l "doesn't work"     # Searches for open issues matching "doesn't work"
+  ghi -l invalid -c         # Searches for closed issues matching "invalid"
+  ghi -l1                   # Shows issue 1
+  ghi -1                    # Shorter shorthand for "ghi -l1"
+  ghi 1                     # Shorter shorthand still
+  ghi -o                    # Opens a new issue (in your $EDITOR)
+  ghi -o "New issue"        # Opens a new issue with the title "New issue"
+  ghi -o "Title" -m "Body"  # Opens a new issue with specified title and body
+  ghi -e1                   # Edits issue number 1 (in your $EDITOR)
+  ghi -e1 -m "New body"     # Edits issue number 1 with the specified body
+  ghi -c1                   # Closes issue 1
+  ghi -c1 -m                # Closes issue with comment (from your $EDITOR)
+  ghi -c1 -m "Comment"      # Closes issue with specified comment
+  ghi -o1                   # Reopens 1 (accepts comments, too)
+  ghi -m1                   # Comments on issue 1 (in your $EDITOR)
+  ghi -t1 "tag"             # Labels issue 1 with "tag"
+  ghi -d1 "tag"             # Removes the label, "tag"
+  ghi --claim 1             # Tags issue 1 with your GitHub username
+  ghi -u                    # Loads issues in your browser.
+  ghi -u1                   # Loads an issue in your browser.
+
+
+ghi also works anywhere:
+
+  ghi -rghi                 # Your fork of "ghi"
+  ghi -rstephencelis/ghi    # Mine: "stephencelis/ghi"
+  ghi stephencelis/ghi      # Shorthand to merely list open.
+
+
+ghi uses ANSI colors if you use them in git.
+
+ghi looks for a <tt>$GHI_PAGER</tt> variable for paging.
+
+
+== CONTRIBUTORS
+
+* Jamie Macey (http://blog.tracefunc.com)
+* Hiroshi Nakamura (http://github.com/nahi)
+
+
+=== CONTRIBUTE?
+
+ghi is not under currently under the control of any gem packaging system. To
+build, use RubyGems:
+
+  % gem build ghi.gemspec
+  % sudo gem install ghi*.gem

data/bin/ghi

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+$: << File.expand_path(File.join(File.dirname(__FILE__), "..", "lib"))
+require "ghi/cli"
+$stdout.sync = true
+GHI::CLI::Executable.new.parse!(ARGV)

data/lib/ghi.rb

@@ -0,0 +1,55 @@
+require "net/http"
+require "yaml"
+
+module GHI
+  VERSION = "0.2"
+
+  class << self
+    def login
+      return @login if defined? @login
+      @login = `git config --get github.user`.chomp
+      if @login.empty?
+        begin
+          print "Please enter your GitHub username: "
+          @login = gets.chomp
+          valid = user? @login
+          warn "invalid username" unless valid
+        end until valid
+        `git config --global github.user #@login`
+      end
+      @login
+    end
+
+    def token
+      return @token if defined? @token
+      @token = `git config --get github.token`.chomp
+      if @token.empty?
+        begin
+          print "GitHub token (https://github.com/account): "
+          @token = gets.chomp
+          valid = token? @token
+          warn "invalid token for #{login}" unless valid
+        end until valid
+        `git config --global github.token #@token`
+      end
+      @token
+    end
+
+    private
+
+    def user?(username)
+      url = "http://github.com/api/v2/yaml/user/show/#{username}"
+      !YAML.load(Net::HTTP.get(URI.parse(url)))["user"].nil?
+    rescue ArgumentError, URI::InvalidURIError
+      false
+    end
+
+    def token?(token)
+      url  = "http://github.com/api/v2/yaml/user/show/#{login}"
+      url += "?login=#{login}&token=#{token}"
+      !YAML.load(Net::HTTP.get(URI.parse(url)))["user"]["plan"].nil?
+    rescue ArgumentError, NoMethodError, URI::InvalidURIError
+      false
+    end
+  end
+end

data/lib/ghi/api.rb

@@ -0,0 +1,106 @@
+require "net/http"
+require "yaml"
+
+class GHI::API
+  class InvalidRequest < StandardError
+  end
+
+  class InvalidConnection < StandardError
+  end
+
+  class ResponseError < StandardError
+  end
+
+  API_URL = "http://github.com/api/v2/yaml/issues/:action/:user/:repo"
+
+  attr_reader :user, :repo
+
+  def initialize(user, repo)
+    raise InvalidConnection if user.nil? || repo.nil?
+    @user, @repo = user, repo
+  end
+
+  def search(term, state = :open)
+    get(:search, state, term)["issues"].map { |attrs| GHI::Issue.new(attrs) }
+  end
+
+  def list(state = :open)
+    get(:list, state)["issues"].map { |attrs| GHI::Issue.new(attrs) }
+  end
+
+  def show(number)
+    GHI::Issue.new get(:show, number)["issue"]
+  end
+
+  def open(title, body)
+    GHI::Issue.new post(:open, :title => title, :body => body)["issue"]
+  end
+
+  def edit(number, title, body)
+    res = post :edit, number, :title => title, :body => body
+    GHI::Issue.new res["issue"]
+  end
+
+  def close(number)
+    GHI::Issue.new post(:close, number)["issue"]
+  end
+
+  def reopen(number)
+    GHI::Issue.new post(:reopen, number)["issue"]
+  end
+
+  def add_label(label, number)
+    post("label/add", label, number)["labels"]
+  end
+
+  def remove_label(label, number)
+    post("label/remove", label, number)["labels"]
+  end
+
+  def comment(number, comment)
+    post(:comment, number, :comment => comment)["comment"]
+  end
+
+  private
+
+  def get(*args)
+    res = YAML.load Net::HTTP.get(URI.parse(url(*args) + auth(true)))
+    raise ResponseError, errors(res) if res["error"]
+    res
+  rescue ArgumentError, URI::InvalidURIError
+    raise ResponseError, "GitHub hiccuped on your request"
+  rescue SocketError
+    raise ResponseError, "couldn't find the internet"
+  end
+
+  def post(*args)
+    params = args.last.is_a?(Hash) ? args.pop : {}
+    params.update auth
+    res = YAML.load Net::HTTP.post_form(URI.parse(url(*args)), params).body
+    raise ResponseError, errors(res) if res["error"]
+    res
+  rescue ArgumentError, URI::InvalidURIError
+    raise ResponseError, "GitHub hiccuped on your request"
+  rescue SocketError
+    raise ResponseError, "couldn't find the internet"
+  end
+
+  def errors(response)
+    [*response["error"]].map { |e| e["error"] } * ", "
+  end
+
+  def auth(query = false)
+    if query
+      "?login=#{GHI.login}&token=#{GHI.token}"
+    else
+      { :login => GHI.login, :token => GHI.token }
+    end
+  end
+
+  def url(action, *args)
+    @url ||= API_URL.sub(":user", user).sub(":repo", repo)
+    uri  = @url.sub ":action", action.to_s
+    uri += "/#{args.join("/")}" unless args.empty?
+    uri
+  end
+end