jist 0.9.2 → 1.5.0

data/.gitignore

@@ -0,0 +1,8 @@
+.rvmrc
+Gemfile.lock
+
+# OS X
+.DS_Store
+.yardoc
+doc
+*.gem

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format progress
+-r ./spec/spec_helper.rb

data/Gemfile

@@ -0,0 +1,3 @@
+source :rubygems
+
+gemspec

data/LICENSE.MIT

@@ -0,0 +1,7 @@
+Copyright (c) 2012 Conrad Irwin <conrad.irwin@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,189 @@
+Jist is a gem that allows you to publish a [gist](https://gist.github.com) from Ruby.
+
+# Installation
+
+As with all ruby gems, you can install Jist (assuming you have ruby and rubygems) with:
+
+```shell
+$ gem install jist
+```
+
+If you want to use the library in your application, and you're using Bundler. Add the
+following to your Gemfile.
+
+```ruby
+source :rubygems
+gem 'jist'
+```
+
+# Command
+
+The jist gem provides a `jist` command that you can use from your terminal to
+upload content to https://gist.github.com/.
+
+It's easy to use. To upload the contents of `a.rb` just:
+
+```shell
+$ jist a.rb
+https://gist.github.com/0d07bc98c139810a4075
+```
+
+Upload multiple files : 
+```shell
+$ jist a b c
+$ jist *.rb
+```
+
+By default it reads from STDIN, and you can set a filename with `-f`.
+
+```shell
+$ jist -f test.rb <a.rb
+https://gist.github.com/7db51bb5f4f35c480fc8
+```
+
+Alternatively, you can just paste from the clipboard:
+
+```shell
+$ jist -P
+https://gist.github.com/6a330a11a0db8e52a6ee
+```
+
+Use `-p` to make the gist public and `-d` to add a description.
+```shell
+$ jist -p -d "Random rbx bug" a.rb
+https://gist.github.com/2977722
+```
+
+You can update existing gists with `-u`:
+
+```shell
+$ jist lib/jist.rb bin/jist -u 42f2c239d2eb57299408
+https://gist.github.com/42f2c239d2eb57299408
+```
+
+If you'd like to copy the resulting URL to your clipboard, use `-c`.
+
+```shell
+$ jist -c <a.rb
+https://gist.github.com/7db51bb5f4f35c480fc8
+```
+
+If you'd like to copy the resulting embeddable URL to your clipboard, use `--copy-js`.
+
+```shell
+$ jist --copy-js <a.rb
+<script src="https://gist.github.com/7db51bb5f4f35c480fc8"></script>
+```
+And you can just ask jist to open a browser window directly with `-o`.
+
+```shell
+$ jist -o <a.rb
+https://gist.github.com/7db51bb5f4f35c480fc8
+```
+
+See `jist --help` for more detail.
+
+## Login
+
+If you want to associate your gists with your github account, you need to login
+with jist. It doesn't store your username and password, it just uses them to get
+an OAuth2 token (with the "gist" permission).
+
+```shell
+jist --login
+Obtaining OAuth2 access_token from github.
+Github username: ConradIrwin
+Github password:
+Success! https://github.com/settings/applications
+```
+
+This token is stored in `~/.jist` and used for all future gisting. If you need to
+you can revoke it from https://github.com/settings/applications, or just delete the
+file.
+
+After you've done this, you can still upload gists anonymously with `-a`.
+
+```shell
+jist -a a.rb
+https://gist.github.com/6bf7ec379fc9119b1f15
+```
+
+# Library
+
+You can also use Jist as a library from inside your ruby code:
+
+```ruby
+Jist.gist("Look.at(:my => 'awesome').code")
+```
+
+If you need more advanced features you can also pass:
+
+* `:access_token` to authenticate using OAuth2 (default is `File.read("~/.jist")).
+* `:filename` to change the syntax highlighting (default is `a.rb`).
+* `:public` if you want your gist to have a guessable url.
+* `:description` to add a description to your gist.
+* `:update` to update an existing gist (can be a URL or an id).
+* `:anonymous` to submit an anonymous gist (default is false).
+* `:copy` to copy the resulting URL to the clipboard (default is false).
+* `:open` to open the resulting URL in a browser (default is false).
+
+NOTE: The access_token must have the "gist" scope.
+
+If you want to upload multiple files in the same gist, you can:
+
+```ruby
+Jist.multi_gist("a.rb" => "Foo.bar", "a.py" => "Foo.bar")
+```
+
+If you'd rather use jist's builtin access_token, then you can force the user to
+obtain one by calling:
+
+```ruby
+Jist.login!
+```
+
+This will take them through the process of obtaining an OAuth2 token, and storing it
+in `~/.jist`, where it can later be read by `Jist.gist`
+
+GitHub enterprise
+==================
+
+If you'd like `jist` to use your locally installed [Github Enterprise](https://enterprise.github.com/),
+you need to export the `GITHUB_URL` environment variable in your `~/.bashrc`.
+
+```bash
+export GITHUB_URL=http://github.internal.example.com/
+```
+
+Once you've done this and restarted your terminal (or run `source ~/.bashrc`), jist will
+automatically use github enterprise instead of the public github.com
+
+Configuration
+=============
+
+If you'd like `-o` or `-c` to be the default when you use the jist executable, add an
+alias to your `~/.bashrc` (or equivalent). For example:
+
+```ruby
+alias jist='jist -c'
+```
+
+If you'd prefer jist to open a different browser, then you can export the BROWSER
+environment variable:
+
+```ruby
+export BROWSER=google-chrome
+```
+
+If clipboard or browser integration don't work on your platform, please file a bug or
+(more ideally) a pull request.
+
+If you need to use an HTTP proxy to access the internet, export the `HTTP_PROXY` or
+`http_proxy` environment variable and jist will use it.
+
+Meta-fu
+=======
+
+I wrote this because the `gist` gem is out of action, and has been for many months.
+
+It's licensed under the MIT license, and bug-reports, and pull requests are welcome.

data/Rakefile

@@ -0,0 +1,10 @@
+task :default => :test
+
+desc 'run the tests' # that's non-DRY
+task :test do
+  sh 'rspec spec'
+end
+
+task :clipfailtest do
+  sh 'PATH=/ /usr/bin/ruby -Ilib -S bin/jist -ac < lib/jist.rb'
+end

data/bin/jist

@@ -1,8 +1,7 @@
 #!/usr/bin/env ruby
 
 require 'optparse'
-
-require 'jist'
+require File.expand_path('../../lib/jist', __FILE__)
 
 # For the holdings of options.
 options = {}
@@ -13,9 +12,6 @@ opts = OptionParser.new do |opts|
   opts.banner = <<-EOS
 Jist (v#{Jist::VERSION}) lets you upload to https://gist.github.com/
 
-Usage: #{executable_name} [-p] [-d DESC] [-t TOKEN|-a] [-u URL] [-f NAME]* [FILE]*
-       #{executable_name} --login
-
 The content to be uploaded can be passed as a list of files, if none are
 specified STDIN will be read. The default filename for STDIN is "a.rb", and all
 filenames can be overridden by repeating the "-f" flag. The most useful reason
@@ -32,10 +28,21 @@ Anonymous gists are not associated with your GitHub account, they can be created
 with "-a" even after you have used "jist --login". If you already have an access
 token with the "gist" scope, you can pass that with "-t".
 
+If you would like to shorten the resulting gist URL, use the -s flag. This will
+use GitHub's URL shortener, git.io.
+
+To copy the resulting URL to your clipboard you can use the -c option, or to just
+open it directly in your browser, use -o. Using the -e option will copy the embeddable
+URL to the clipboard. You can add `alias jist='jist -c'` to your shell's rc file to configure this
+behaviour by default.
+
 Instead of creating a new jist, you can update an existing one by passing its ID
 or URL with "-u". For this to work, you must be logged in, and have created the
 original gist with the same GitHub account.
 
+Usage: #{executable_name} [-o|-c|-e] [-p] [-s] [-d DESC] [-t TOKEN|-a] [-u URL] [-P] [-f NAME]* FILE*
+       #{executable_name} --login
+
   EOS
 
   opts.on("--login", "Authenticate jist on this computer.") do
@@ -56,6 +63,10 @@ original gist with the same GitHub account.
     options[:description] = description
   end
 
+  opts.on("-s", "--shorten", "Shorten the gist URL using git.io.") do |shorten|
+    options[:shorten] = shorten
+  end
+
   opts.on("-u", "--update [ URL | ID ]", "Update an existing gist.") do |update|
     options[:update] = update
   end
@@ -68,6 +79,22 @@ original gist with the same GitHub account.
     options[:access_token] = token
   end
 
+  opts.on("-c", "--copy", "Copy the resulting URL to the clipboard") do
+    options[:copy] = true
+  end
+  opts.on("-e", "--embed", "Copy the embed code for the gist to the clipboard") do
+    options[:embed] = true
+    options[:copy] = true
+  end
+
+  opts.on("-o", "--open", "Open the resulting URL in a browser") do
+    options[:open] = true
+  end
+
+  opts.on("-P", "--paste", "Paste from the clipboard to jist") do
+    options[:paste] = true
+  end
+
   opts.on_tail("-h","--help", "Show this message.") do
     puts opts
     exit
@@ -82,9 +109,21 @@ end
 opts.parse!
 
 begin
-  if ARGV.size == 0
+  options[:output] = if options[:embed] && options[:shorten]
+                       raise Jist::Error, "--embed does not make sense with --shorten"
+                     elsif options[:embed]
+                       :javascript
+                     elsif options[:shorten]
+                       :short_url
+                     else
+                       :html_url
+                     end
+
+  if options[:paste]
+    puts Jist.gist(Jist.paste, options)
+  elsif ARGV.size == 0
     $stderr.puts "(type a gist. <ctrl-c> to cancel, <ctrl-d> when done)" if $stdin.tty?
-    puts Jist.gist(ARGF.read, options)['html_url']
+    puts Jist.gist(ARGF.read, options)
   else
     files = {}
     ARGV.zip(filenames).each do |(file, name)|
@@ -95,7 +134,7 @@ begin
       end
     end
 
-    puts Jist.multi_gist(files, options)['html_url']
+    puts Jist.multi_gist(files, options)
   end
 rescue Jist::Error => e
   puts "Error: #{e.message}"

data/jist.gemspec

@@ -0,0 +1,20 @@
+require './lib/jist'
+Gem::Specification.new do |s|
+  s.name          = 'jist'
+  s.version       = Jist::VERSION
+  s.summary       = 'Just allows you to upload gists'
+  s.description   = 'Provides a single function (Jist.gist) that uploads a gist.'
+  s.homepage      = 'https://github.com/ConradIrwin/jist'
+  s.email         = 'conrad.irwin@gmail.com'
+  s.authors       = ['Conrad Irwin']
+  s.license       = 'MIT'
+  s.files         = `git ls-files`.split("\n")
+  s.require_paths = ["lib"]
+
+  s.executables << 'jist'
+
+  s.add_dependency 'json'
+  %w(rake rspec webmock).each do |gem|
+    s.add_development_dependency gem
+  end
+end

data/lib/jist.rb

@@ -1,30 +1,43 @@
 require 'net/https'
 require 'cgi'
 require 'json'
+require 'uri'
 
 # It just gists.
 module Jist
+  extend self
 
-  VERSION = '0.9.2'
+  VERSION = '1.5.0'
+
+  # A list of clipboard commands with copy and paste support.
+  CLIPBOARD_COMMANDS = {
+    'xclip'   => 'xclip -o',
+    'xsel'    => 'xsel -o',
+    'pbcopy'  => 'pbpaste',
+    'putclip' => 'getclip'
+  }
+
+  GITHUB_API_URL   = URI("https://api.github.com/")
+  GIT_IO_URL       = URI("http://git.io")
+
+  GITHUB_BASE_PATH = ""
+  GHE_BASE_PATH    = "/api/v3"
+
+  URL_ENV_NAME     = "GITHUB_URL"
 
   # Exception tag for errors raised while gisting.
-  module Error; end
+  module Error;
+    def self.exception(*args)
+      RuntimeError.new(*args).extend(self)
+    end
+  end
+  class ClipboardError < RuntimeError; include Error end
 
-  module_function
   # Upload a gist to https://gist.github.com
   #
   # @param [String] content  the code you'd like to gist
-  # @param [Hash] options  more detailed options
-  #
-  # @option options [String] :description  the description
-  # @option options [String] :filename  ('a.rb') the filename
-  # @option options [Boolean] :public  (false) is this gist public
-  # @option options [Boolean] :anonymous  (false) is this gist anonymous
-  # @option options [String] :access_token  (`File.read("~/.jist")`) The OAuth2 access token.
-  # @option options [String] :update  the URL or id of a gist to update
-  #
-  # @return [Hash]  the decoded JSON response from the server
-  # @raise [Jist::Error]  if something went wrong
+  # @param [Hash] options  more detailed options, see
+  #   the documentation for {multi_gist}
   #
   # @see http://developer.github.com/v3/gists/
   def gist(content, options = {})
@@ -42,8 +55,15 @@ module Jist
   # @option options [Boolean] :anonymous  (false) is this gist anonymous
   # @option options [String] :access_token  (`File.read("~/.jist")`) The OAuth2 access token.
   # @option options [String] :update  the URL or id of a gist to update
+  # @option options [Boolean] :copy  (false) Copy resulting URL to clipboard, if successful.
+  # @option options [Boolean] :open  (false) Open the resulting URL in a browser.
+  # @option options [Symbol] :output (:all) The type of return value you'd like:
+  #   :html_url gives a String containing the url to the gist in a browser
+  #   :short_url gives a String contianing a  git.io url that redirects to html_url
+  #   :javascript gives a String containing a script tag suitable for embedding the gist
+  #   :all gives a Hash containing the parsed json response from the server
   #
-  # @return [Hash]  the decoded JSON response from the server
+  # @return [String, Hash]  the return value as configured by options[:output]
   # @raise [Jist::Error]  if something went wrong
   #
   # @see http://developer.github.com/v3/gists/
@@ -63,10 +83,10 @@ module Jist
     if options[:anonymous]
       access_token = nil
     else
-      access_token = (options[:access_token] || File.read(File.expand_path("~/.jist")) rescue nil)
+      access_token = (options[:access_token] || File.read(auth_token_file) rescue nil)
     end
 
-    url = "/gists"
+    url = "#{base_path}/gists"
     url << "/" << CGI.escape(existing_gist) if existing_gist.to_s != ''
     url << "?access_token=" << CGI.escape(access_token) if access_token.to_s != ''
 
@@ -77,9 +97,9 @@ module Jist
     retried = false
 
     begin
-      response = http(request)
+      response = http(api_url, request)
       if Net::HTTPSuccess === response
-        JSON.parse(response.body)
+        on_success(response.body, options)
       else
         raise "Got #{response.class} from gist: #{response.body}"
       end
@@ -93,6 +113,22 @@ module Jist
     raise e.extend Error
   end
 
+  # Convert long github urls into short git.io ones
+  #
+  # @param [String] url
+  # @return [String] shortened url, or long url if shortening fails
+  def shorten(url)
+    request = Net::HTTP::Post.new("/")
+    request.set_form_data(:url => url)
+    response = http(GIT_IO_URL, request)
+    case response.code
+    when "201"
+      response['Location']
+    else
+      url
+    end
+  end
+
   # Log the user into jist.
   #
   # This method asks the user for a username and password, and tries to obtain
@@ -113,7 +149,7 @@ module Jist
     end
     puts ""
 
-    request = Net::HTTP::Post.new("/authorizations")
+    request = Net::HTTP::Post.new("#{base_path}/authorizations")
     request.body = JSON.dump({
       :scopes => [:gist],
       :note => "The jist gem",
@@ -122,13 +158,13 @@ module Jist
     request.content_type = 'application/json'
     request.basic_auth(username, password)
 
-    response = http(request)
+    response = http(api_url, request)
 
     if Net::HTTPCreated === response
-      File.open(File.expand_path("~/.jist"), 'w') do |f|
+      File.open(auth_token_file, 'w') do |f|
         f.write JSON.parse(response.body)['token']
       end
-      puts "Success! https://github.com/settings/applications"
+      puts "Success! #{ENV[URL_ENV_NAME] || "https://github.com/"}settings/applications"
     else
       raise "Got #{response.class} from gist: #{response.body}"
     end
@@ -136,20 +172,171 @@ module Jist
     raise e.extend Error
   end
 
-  # Run an HTTP operation against api.github.com
+  # Return HTTP connection
   #
-  # @param [Net::HTTPRequest] request
-  # @return [Net::HTTPResponse]
-  def http(request)
-    connection = Net::HTTP.new("api.github.com", 443)
-    connection.use_ssl = true
-    connection.verify_mode = OpenSSL::SSL::VERIFY_NONE
+  # @param [URI::HTTP] The URI to which to connect
+  # @return [Net::HTTP]
+  def http_connection(uri)
+    env = ENV['http_proxy'] || ENV['HTTP_PROXY']
+    connection = if env
+                   proxy = URI(env)
+                   Net::HTTP::Proxy(proxy.host, proxy.port).new(uri.host, uri.port)
+                 else
+                   Net::HTTP.new(uri.host, uri.port)
+                 end
+    if uri.scheme == "https"
+      connection.use_ssl = true
+      connection.verify_mode = OpenSSL::SSL::VERIFY_NONE
+    end
     connection.open_timeout = 10
     connection.read_timeout = 10
-    connection.start do |http|
+    connection
+  end
+
+  # Run an HTTP operation
+  #
+  # @param [URI::HTTP] The URI to which to connect
+  # @param [Net::HTTPRequest] The request to make
+  # @return [Net::HTTPResponse]
+  def http(url, request)
+    http_connection(url).start do |http|
       http.request request
     end
   rescue Timeout::Error
-    raise "Could not connect to https://api.github.com/"
+    raise "Could not connect to #{api_url}"
+  end
+
+  # Called after an HTTP response to gist to perform post-processing.
+  #
+  # @param [String] body  the text body from the github api
+  # @param [Hash] options  more detailed options, see
+  #   the documentation for {multi_gist}
+  def on_success(body, options={})
+    json = JSON.parse(body)
+
+    output = case options[:output]
+             when :javascript
+               %Q{<script src="#{json['html_url']}.js"></script>}
+             when :html_url
+               json['html_url']
+             when :short_url
+               shorten(json['html_url'])
+             else
+               json
+             end
+
+    Jist.copy(output.to_s) if options[:copy]
+    Jist.open(json['html_url']) if options[:open]
+
+    output
+  end
+
+  # Copy a string to the clipboard.
+  #
+  # @param [String] content
+  # @raise [Jist::Error] if no clipboard integration could be found
+  #
+  def copy(content)
+    IO.popen(clipboard_command(:copy), 'r+') { |clip| clip.print content }
+
+    unless paste == content
+      message = 'Copying to clipboard failed.'
+
+      if ENV["TMUX"] && clipboard_command(:copy) == 'pbcopy'
+        message << "\nIf you're running tmux on a mac, try http://robots.thoughtbot.com/post/19398560514/how-to-copy-and-paste-with-tmux-on-mac-os-x"
+      end
+
+      raise Error, message
+    end
+  rescue Error => e
+    raise ClipboardError, e.message + "\nAttempted to copy: #{content}"
+  end
+
+  # Get a string from the clipboard.
+  #
+  # @param [String] content
+  # @raise [Jist::Error] if no clipboard integration could be found
+  def paste
+    `#{clipboard_command(:paste)}`
+  end
+
+  # Find command from PATH environment.
+  #
+  # @param [String] cmd  command name to find
+  # @param [String] options  PATH environment variable
+  # @return [String]  the command found
+  def which(cmd, path=ENV['PATH'])
+    if RUBY_PLATFORM.downcase =~ /mswin(?!ce)|mingw|bccwin|cygwin/
+      path.split(File::PATH_SEPARATOR).each {|dir|
+        f = File.join(dir, cmd+".exe")
+        return f if File.executable?(f) && !File.directory?(f)
+      }
+      nil
+    else
+      return system("which #{cmd} > /dev/null 2>&1")
+    end
+  end
+
+  # Get the command to use for the clipboard action.
+  #
+  # @param [Symbol] action  either :copy or :paste
+  # @return [String]  the command to run
+  # @raise [Jist::ClipboardError] if no clipboard integration could be found
+  def clipboard_command(action)
+    command = CLIPBOARD_COMMANDS.keys.detect do |cmd|
+      which cmd
+    end
+    raise ClipboardError, <<-EOT unless command
+Could not find copy command, tried:
+    #{CLIPBOARD_COMMANDS.values.join(' || ')}
+    EOT
+    action == :copy ? command : CLIPBOARD_COMMANDS[command]
+  end
+
+  # Open a URL in a browser.
+  #
+  # @param [String] url
+  # @raise [RuntimeError] if no browser integration could be found
+  #
+  # This method was heavily inspired by defunkt's Gist#open,
+  # @see https://github.com/defunkt/gist/blob/bca9b29/lib/gist.rb#L157
+  def open(url)
+    command = if ENV['BROWSER']
+                ENV['BROWSER']
+              elsif RUBY_PLATFORM =~ /darwin/
+                'open'
+              elsif RUBY_PLATFORM =~ /linux/
+                %w(
+                  sensible-browser
+                  firefox
+                  firefox-bin
+                ).detect do |cmd|
+                  which cmd
+                end
+              elsif ENV['OS'] == 'Windows_NT' || RUBY_PLATFORM =~ /djgpp|(cyg|ms|bcc)win|mingw|wince/i
+                'start ""'
+              else
+                raise "Could not work out how to use a browser."
+              end
+
+    `#{command} #{url}`
+  end
+
+  # Get the API base path
+  def base_path
+    ENV.key?(URL_ENV_NAME) ? GHE_BASE_PATH : GITHUB_BASE_PATH
+  end
+
+  # Get the API URL
+  def api_url
+    ENV.key?(URL_ENV_NAME) ? URI(ENV[URL_ENV_NAME]) : GITHUB_API_URL
+  end
+
+  def auth_token_file
+    if ENV.key?(URL_ENV_NAME)
+      File.expand_path "~/.jist.#{ENV[URL_ENV_NAME].gsub(/[^a-z.]/, '')}"
+    else
+      File.expand_path "~/.jist"
+    end
   end
 end

data/spec/clipboard_spec.rb

@@ -0,0 +1,40 @@
+describe '...' do
+  before do
+    @saved_path = ENV['PATH']
+    @bobo_url = 'http://example.com'
+  end
+
+  after do
+    ENV['PATH'] = @saved_path
+  end
+
+  def ask_for_copy
+    Jist.on_success({'html_url' => @bobo_url}.to_json, :copy => true, :output => :html_url)
+  end
+  def jist_but_dont_ask_for_copy
+    Jist.on_success({'html_url' => 'http://example.com/'}.to_json, :output => :html_url)
+  end
+
+  it 'should try to copy the url when the clipboard option is passed' do
+    Jist.should_receive(:copy).with(@bobo_url)
+    ask_for_copy
+  end
+
+  it 'should try to copy the embed url when the clipboard-js option is passed' do
+    js_link = %Q{<script src="#{@bobo_url}.js"></script>}
+    Jist.should_receive(:copy).with(js_link)
+    Jist.on_success({'html_url' => @bobo_url}.to_json, :copy => true, :output => :javascript)
+  end
+
+  it "should not copy when not asked to" do
+    Jist.should_not_receive(:copy).with(@bobo_url)
+    jist_but_dont_ask_for_copy
+  end
+
+  it "should raise an error if no copying mechanisms are available" do
+    ENV['PATH'] = ''
+    lambda{
+      ask_for_copy
+    }.should raise_error(/Could not find copy command.*http/m)
+  end
+end

data/spec/ghe_spec.rb

@@ -0,0 +1,80 @@
+describe '...' do
+
+  MOCK_GHE_HOST     = 'ghe.example.com'
+  MOCK_GHE_PROTOCOL = 'http'
+  MOCK_USER         = 'foo'
+  MOCK_PASSWORD     = 'bar'
+
+  MOCK_AUTHZ_GHE_URL    = "#{MOCK_GHE_PROTOCOL}://#{MOCK_USER}:#{MOCK_PASSWORD}@#{MOCK_GHE_HOST}/api/v3/"
+  MOCK_GHE_URL          = "#{MOCK_GHE_PROTOCOL}://#{MOCK_GHE_HOST}/api/v3/"
+  MOCK_AUTHZ_GITHUB_URL = "https://#{MOCK_USER}:#{MOCK_PASSWORD}@api.github.com/"
+  MOCK_GITHUB_URL       = "https://api.github.com/"
+
+  before do
+    @saved_env = ENV[Jist::URL_ENV_NAME]
+
+    # stub requests for /gists
+    stub_request(:post, /#{MOCK_GHE_URL}gists/).to_return(:body => %[{"html_url": "http://#{MOCK_GHE_HOST}"}])
+    stub_request(:post, /#{MOCK_GITHUB_URL}gists/).to_return(:body => '{"html_url": "http://github.com/"}')
+
+    # stub requests for /authorizations
+    stub_request(:post, /#{MOCK_AUTHZ_GHE_URL}authorizations/).
+      to_return(:status => 201, :body => '{"token": "asdf"}')
+    stub_request(:post, /#{MOCK_AUTHZ_GITHUB_URL}authorizations/).
+      to_return(:status => 201, :body => '{"token": "asdf"}')
+  end
+
+  after do
+    ENV[Jist::URL_ENV_NAME] = @saved_env
+  end
+
+  describe :login! do
+    before do
+      @saved_stdin = $stdin
+
+      # stdin emulation
+      $stdin = StringIO.new "#{MOCK_USER}\n#{MOCK_PASSWORD}\n"
+
+      # intercept for updating ~/.jist
+      File.stub(:open)
+    end
+
+    after do
+      $stdin = @saved_stdin
+    end
+
+    it "should access to api.github.com when $#{Jist::URL_ENV_NAME} wasn't set" do
+      ENV.delete Jist::URL_ENV_NAME
+
+      Jist.login!
+
+      assert_requested(:post, /#{MOCK_AUTHZ_GITHUB_URL}authorizations/)
+    end
+
+    it "should access to #{MOCK_GHE_HOST} when $#{Jist::URL_ENV_NAME} was set" do
+      ENV[Jist::URL_ENV_NAME] = MOCK_GHE_URL
+
+      Jist.login!
+
+      assert_requested(:post, /#{MOCK_AUTHZ_GHE_URL}authorizations/)
+    end
+  end
+
+  describe :gist do
+    it "should access to api.github.com when $#{Jist::URL_ENV_NAME} wasn't set" do
+      ENV.delete Jist::URL_ENV_NAME
+
+      Jist.gist "test gist"
+
+      assert_requested(:post, /#{MOCK_GITHUB_URL}gists/)
+    end
+
+    it "should access to #{MOCK_GHE_HOST} when $#{Jist::URL_ENV_NAME} was set" do
+      ENV[Jist::URL_ENV_NAME] = MOCK_GHE_URL
+
+      Jist.gist "test gist"
+
+      assert_requested(:post, /#{MOCK_GHE_URL}gists/)
+    end
+  end
+end

data/spec/proxy_spec.rb

@@ -0,0 +1,21 @@
+describe '...' do
+  before do
+    @saved_env = ENV['HTTP_PROXY']
+  end
+
+  after do
+    ENV['HTTP_PROXY'] = @saved_env
+  end
+
+  FOO_URL = URI('http://ddg.gg/')
+
+  it "should be Net::HTTP when $HTTP_PROXY wasn't set" do
+    ENV['HTTP_PROXY'] = ''
+    Jist.http_connection(FOO_URL).should be_an_instance_of(Net::HTTP)
+  end
+
+  it "should be Net::HTTP::Proxy when $HTTP_PROXY was set" do
+    ENV['HTTP_PROXY'] = 'http://proxy.example.com:8080'
+    Jist.http_connection(FOO_URL).should_not be_an_instance_of(Net::HTTP)
+  end
+end

data/spec/shorten_spec.rb

@@ -0,0 +1,11 @@
+describe '...' do
+  before do
+    stub_request(:post, /api\.github.com\/gists\?access_token=.*/).to_return(:body => '{"html_url": "http://github.com/"}')
+    stub_request(:post, "http://git.io/").to_return(:status => 201, :headers => { 'Location' => 'http://git.io/XXXXXX' })
+  end
+
+  it "should return a shortened version of the URL" do
+    Jist.gist("Test gist", :output => :short_url).should == "http://git.io/XXXXXX"
+  end
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper.rb"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+end
+
+require 'webmock/rspec'
+require_relative '../lib/jist'
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jist
 version: !ruby/object:Gem::Version
-  version: 0.9.2
+  version: 1.5.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,24 +9,72 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-24 00:00:00.000000000 Z
+date: 2013-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
+  type: :runtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
+  prerelease: false
   name: json
+- !ruby/object:Gem::Dependency
+  type: :development
   requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
     none: false
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+    none: false
   prerelease: false
+  name: rake
+- !ruby/object:Gem::Dependency
+  type: :development
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
   version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
     none: false
+  prerelease: false
+  name: rspec
+- !ruby/object:Gem::Dependency
+  type: :development
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+    none: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
+  prerelease: false
+  name: webmock
 description: Provides a single function (Jist.gist) that uploads a gist.
 email: conrad.irwin@gmail.com
 executables:
@@ -34,29 +82,42 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/jist.rb
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.MIT
+- README.md
+- Rakefile
 - bin/jist
+- jist.gemspec
+- lib/jist.rb
+- spec/clipboard_spec.rb
+- spec/ghe_spec.rb
+- spec/proxy_spec.rb
+- spec/shorten_spec.rb
+- spec/spec_helper.rb
 homepage: https://github.com/ConradIrwin/jist
-licenses: []
+licenses:
+- MIT
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+  none: false
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 1.8.25
 signing_key: 
 specification_version: 3
 summary: Just allows you to upload gists