twurl 0.9.1 → 0.9.6

data/.gitignore

@@ -1,38 +0,0 @@
-*.gem
-*.rbc
-*.sw[a-p]
-*.tmproj
-*.tmproject
-*.un~
-*~
-.Spotlight-V100
-.Trashes
-._*
-.bundle
-.config
-.directory
-.elc
-.emacs.desktop
-.emacs.desktop.lock
-.redcar
-.yardoc
-Desktop.ini
-Gemfile.lock
-Icon?
-InstalledFiles
-Session.vim
-\#*\#
-_yardoc
-auto-save-list
-coverage
-doc
-lib/bundler/man
-pkg
-pkg/*
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
-tmtags
-tramp

data/.travis.yml

@@ -1,16 +0,0 @@
-bundler_args: --without development
-language: ruby
-rvm:
-  - 1.8.7
-  - 1.9.2
-  - 1.9.3
-  - 2.0.0
-  - jruby-head
-  - rbx
-  - ruby-head
-matrix:
-  allow_failures:
-    - rvm: jruby-head
-    - rvm: rbx
-    - rvm: ruby-head
-  fast_finish: true

data/COPYING

@@ -1,18 +0,0 @@
-# Copyright (c) 2009 Marcel Molina <marcel@twitter.com>, Twitter, Inc.
-#
-# 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/Gemfile

@@ -1,20 +0,0 @@
-source 'https://rubygems.org'
-
-gem 'jruby-openssl', :platforms => :jruby
-gem 'rake'
-
-group :test do
-  gem 'coveralls', :require => false
-  gem 'mime-types', '~> 1.25', :platforms => :ruby_18
-  gem 'minitest', '>= 5'
-  gem 'rr', '>= 1.1'
-  gem 'simplecov', :require => false
-end
-
-platforms :rbx do
-  gem 'rubinius-coverage', '~> 2.0'
-  gem 'rubysl-base64', '~> 2.0'
-  gem 'rubysl-net-http', '~> 2.0'
-end
-
-gemspec

data/INSTALL

@@ -1,18 +0,0 @@
-+-----------------------+
-| Install with RubyGems |
-+-----------------------+
-
-  sudo gem i twurl --source http://rubygems.org
-
-+---------------------+
-| Install from source |
-+---------------------+
-
-  rake dist:gem
-  sudo gem i pkg/twurl*gem
-
-+--------------+
-| Dependencies |
-+--------------+
-
-  sudo gem i oauth

data/README

@@ -1,119 +0,0 @@
-+-------+
-| Twurl |
-+-------+
-
-Twurl is like curl, but tailored specifically for the Twitter API.
-It knows how to grant an access token to a client application for
-a specified user and then sign all requests with that access token.
-
-It also provides other development and debugging conveniences such
-as defining aliases for common requests, as well as support for
-multiple access tokens to easily switch between different client
-applications and Twitter accounts.
-
-+-----------------+
-| Getting Started |
-+-----------------+
-
-The first thing you have to do is register an OAuth application
-to get a consumer key and secret.
-
-  http://dev.twitter.com/apps/new
-
-When you have your consumer key and its secret you authorize
-your Twitter account to make API requests with your consumer key
-and secret.
-
-  % twurl authorize --consumer-key key       \
-                    --consumer-secret secret
-
-This will return an URL that you should open up in your browser.
-Authenticate to Twitter, and then enter the returned PIN back into
-the terminal.  Assuming all that works well, you will beauthorized
-to make requests with the API. Twurl will tell you as much.
-
-If your consumer application has xAuth enabled, then you can use
-a variant of the above
-
-  % twurl authorize -u username -p password  \
-                    --consumer-key key       \
-                    --consumer-secret secret
-
-And, again assuming your username, password, key and secret is
-correct, will authorize you in one step.
-
-+-----------------+
-| Making Requests |
-+-----------------+
-
-The simplest request just requires that you specify the path you
-want to request.
-
-  % twurl /1.1/statuses/home_timeline.json
-
-Similar to curl, a GET request is performed by default.
-
-You can implicitly perform a POST request by passing the -d option,
-which specifies POST parameters.
-
-  % twurl -d 'status=Testing twurl' /1.1/statuses/update.json
-
-You can explicitly specify what request method to perform with
-the -X (or --request-method) option.
-
-  % twurl -X POST /1.1/statuses/destroy/1234567890.json
-
-+------------------+
-| Creating aliases |
-+------------------+
-
-  % twurl alias h /1.1/statuses/home_timeline.json
-
-You can then use "h" in place of the full path.
-
-  % twurl h
-
-Paths that require additional options such as request parameters for example can
-be used with aliases the same as with full explicit paths, just as you might
-expect.
-
-  % twurl alias tweet /1.1/statuses/update.json
-  % twurl tweet -d "status=Aliases in twurl are convenient"
-
-+-------------------------------+
-| Changing your default profile |
-+-------------------------------+
-
-The first time you authorize a client application to make requests on behalf of your account, twurl stores your access token information in its .twurlrc file. Subsequent requests will use this profile as the default profile. You can use the 'accounts' subcommand to see what client applications have been authorized for what user names:
-
-  % twurl accounts
-  noradio
-    HQsAGcBm5MQT4n6j7qVJw
-    hhC7Koy2zRsTZvQh1hVlSA (default)
-  testiverse
-    guT9RsJbNQgVe6AwoY9BA
-
-Notice that one of those consumer keys is marked as the default. To change the default use the 'set' subcommand, passing then either just the username, if it's unambiguous, or the username and consumer key pair if it isn't unambiguous:
-
-  % twurl set default testiverse
-  % twurl accounts
-  noradio
-    HQsAGcBm5MQT4n6j7qVJw
-    hhC7Koy2zRsTZvQh1hVlSA
-  testiverse
-    guT9RsJbNQgVe6AwoY9BA (default)
-
-  % twurl set default noradio HQsAGcBm5MQT4n6j7qVJw
-  % twurl accounts
-  noradio
-    HQsAGcBm5MQT4n6j7qVJw (default)
-    hhC7Koy2zRsTZvQh1hVlSA
-  testiverse
-    guT9RsJbNQgVe6AwoY9BA
-
-+--------------+
-| Contributors |
-+--------------+
-
-Marcel Molina <marcel@twitter.com> / @noradio
-Erik Michaels-Ober / @sferik

data/Rakefile

@@ -1,12 +0,0 @@
-require 'rake/testtask'
-require 'rubygems/package_task'
-require 'bundler'
-
-task :default => :test
-
-Rake::TestTask.new do |test|
-  test.pattern = 'test/*_test.rb'
-  test.verbose = true
-end
-
-Bundler::GemHelper.install_tasks

data/test/account_information_controller_test.rb

@@ -1,61 +0,0 @@
-require File.dirname(__FILE__) + '/test_helper'
-
-class Twurl::AccountInformationController::DispatchWithNoAuthorizedAccountsTest < Minitest::Test
-  attr_reader :options, :client, :controller
-  def setup
-    @options    = Twurl::Options.new
-    @client     = Twurl::OAuthClient.load_new_client_from_options(options)
-    @controller = Twurl::AccountInformationController.new(client, options)
-    mock(Twurl::OAuthClient.rcfile).empty? { true }
-  end
-
-  def test_message_indicates_when_no_accounts_are_authorized
-    mock(Twurl::CLI).puts(Twurl::AccountInformationController::NO_AUTHORIZED_ACCOUNTS_MESSAGE).times(1)
-
-    controller.dispatch
-  end
-end
-
-class Twurl::AccountInformationController::DispatchWithOneAuthorizedAccountTest < Minitest::Test
-  attr_reader :options, :client, :controller
-  def setup
-    @options    = Twurl::Options.test_exemplar
-    @client     = Twurl::OAuthClient.load_new_client_from_options(options)
-    mock(Twurl::OAuthClient.rcfile).save.times(1)
-    Twurl::OAuthClient.rcfile << client
-    @controller = Twurl::AccountInformationController.new(client, options)
-  end
-
-  def test_authorized_account_is_displayed_and_marked_as_the_default
-    mock(Twurl::CLI).puts(client.username).times(1).ordered
-    mock(Twurl::CLI).puts("  #{client.consumer_key} (default)").times(1).ordered
-
-    controller.dispatch
-  end
-end
-
-class Twurl::AccountInformationController::DispatchWithOneUsernameThatHasAuthorizedMultipleAccountsTest < Minitest::Test
-  attr_reader :default_client_options, :default_client, :other_client_options, :other_client, :controller
-  def setup
-    @default_client_options = Twurl::Options.test_exemplar
-    @default_client         = Twurl::OAuthClient.load_new_client_from_options(default_client_options)
-
-    @other_client_options             = Twurl::Options.test_exemplar
-    other_client_options.consumer_key = default_client_options.consumer_key.reverse
-    @other_client                     = Twurl::OAuthClient.load_new_client_from_options(other_client_options)
-    mock(Twurl::OAuthClient.rcfile).save.times(2)
-
-    Twurl::OAuthClient.rcfile << default_client
-    Twurl::OAuthClient.rcfile << other_client
-
-    @controller = Twurl::AccountInformationController.new(other_client, other_client_options)
-  end
-
-  def test_authorized_account_is_displayed_and_marked_as_the_default
-    mock(Twurl::CLI).puts(default_client.username).times(1)
-    mock(Twurl::CLI).puts("  #{default_client.consumer_key} (default)").times(1)
-    mock(Twurl::CLI).puts("  #{other_client.consumer_key}").times(1)
-
-    controller.dispatch
-  end
-end

data/test/alias_controller_test.rb

@@ -1,53 +0,0 @@
-require File.dirname(__FILE__) + '/test_helper'
-
-class Twurl::AliasesController::DispatchTest < Minitest::Test
-  attr_reader :options, :client
-  def setup
-    @options = Twurl::Options.test_exemplar
-    @client  = Twurl::OAuthClient.test_exemplar
-
-    # Clean slate
-    if Twurl::OAuthClient.rcfile.aliases
-      Twurl::OAuthClient.rcfile.aliases.clear
-    end
-
-    stub(Twurl::OAuthClient.rcfile).save
-  end
-
-  def test_when_no_subcommands_are_provided_and_no_aliases_exist_nothing_is_displayed
-    assert options.subcommands.empty?
-    mock(Twurl::CLI).puts(Twurl::AliasesController::NO_ALIASES_MESSAGE).times(1)
-
-    controller = Twurl::AliasesController.new(client, options)
-    controller.dispatch
-  end
-
-  def test_when_no_subcommands_are_provided_and_aliases_exist_they_are_displayed
-    assert options.subcommands.empty?
-
-    Twurl::OAuthClient.rcfile.alias('h', '/1.1/statuses/home_timeline.json')
-    mock(Twurl::CLI).puts("h: /1.1/statuses/home_timeline.json").times(1)
-
-    controller = Twurl::AliasesController.new(client, options)
-    controller.dispatch
-  end
-
-  def test_when_alias_and_value_are_provided_they_are_added
-    options.subcommands = ['h']
-    options.path        = '/1.1/statuses/home_timeline.json'
-    mock(Twurl::OAuthClient.rcfile).alias('h', '/1.1/statuses/home_timeline.json').times(1)
-
-    controller = Twurl::AliasesController.new(client, options)
-    controller.dispatch
-  end
-
-  def test_when_no_path_is_provided_nothing_happens
-    options.subcommands = ['a']
-    assert_nil options.path
-
-    mock(Twurl::CLI).puts(Twurl::AliasesController::NO_PATH_PROVIDED_MESSAGE).times(1)
-
-    controller = Twurl::AliasesController.new(client, options)
-    controller.dispatch
-  end
-end

data/test/authorization_controller_test.rb

@@ -1,30 +0,0 @@
-require File.dirname(__FILE__) + '/test_helper'
-
-class Twurl::AuthorizationController::DispatchTest < Minitest::Test
-  attr_reader :options, :client, :controller
-  def setup
-    @options    = Twurl::Options.new
-    @client     = Twurl::OAuthClient.load_new_client_from_options(options)
-    @controller = Twurl::AuthorizationController.new(client, options)
-  end
-
-  def test_successful_authentication_saves_retrieved_access_token
-    mock(client).exchange_credentials_for_access_token.times(1)
-    mock(client).save.times(1)
-    mock(controller).raise(Twurl::Exception, Twurl::AuthorizationController::AUTHORIZATION_FAILED_MESSAGE).never
-    mock(Twurl::CLI).puts(Twurl::AuthorizationController::AUTHORIZATION_SUCCEEDED_MESSAGE).times(1)
-
-    controller.dispatch
-  end
-
-  module ErrorCases
-    def test_failed_authorization_does_not_save_client
-      mock(client).exchange_credentials_for_access_token { raise OAuth::Unauthorized }
-      mock(client).save.never
-      mock(controller).raise(Twurl::Exception, Twurl::AuthorizationController::AUTHORIZATION_FAILED_MESSAGE).times(1)
-
-      controller.dispatch
-    end
-  end
-  include ErrorCases
-end

data/test/cli_options_test.rb

@@ -1,23 +0,0 @@
-require File.dirname(__FILE__) + '/test_helper'
-
-class Twurl::Options::Test < Minitest::Test
-  attr_reader :options
-  def setup
-    @options = Twurl::Options.new
-  end
-
-  def test_base_url_is_built_from_protocol_and_host
-    options.protocol = 'http'
-    options.host     = 'api.twitter.com'
-
-    assert_equal 'http://api.twitter.com', options.base_url
-  end
-
-  def test_ssl_is_enabled_if_the_protocol_is_https
-    options.protocol = 'http'
-    assert !options.ssl?
-
-    options.protocol = 'https'
-    assert options.ssl?
-  end
-end

data/test/cli_test.rb

@@ -1,192 +0,0 @@
-require File.dirname(__FILE__) + '/test_helper'
-
-class Twurl::CLI::OptionParsingTest < Minitest::Test
-  TEST_PATH = '/1.1/url/does/not/matter.json'
-
-  module CommandParsingTests
-    def test_no_command_specified_falls_to_default_command
-      options = Twurl::CLI.parse_options([TEST_PATH])
-      assert_equal Twurl::CLI::DEFAULT_COMMAND, options.command
-    end
-
-    def test_supported_command_specified_extracts_the_command
-      expected_command = Twurl::CLI::SUPPORTED_COMMANDS.first
-      options = Twurl::CLI.parse_options([expected_command])
-      assert_equal expected_command, options.command
-    end
-
-    def test_unsupported_command_specified_sets_default_command
-      unsupported_command = 'unsupported'
-      options = Twurl::CLI.parse_options([TEST_PATH, unsupported_command])
-      assert_equal Twurl::CLI::DEFAULT_COMMAND, options.command
-    end
-  end
-  include CommandParsingTests
-
-  module PathParsingTests
-    def test_missing_path_throws_no_path_found
-      stub(Twurl::CLI).puts
-      assert_raises Twurl::CLI::NoPathFound do
-        Twurl::CLI.parse_options([])
-      end
-    end
-
-    def test_uri_params_are_encoded
-      options = Twurl::CLI.parse_options(["/1.1/url?baz=bamf:rofl"])
-      assert_equal options.path, "/1.1/url?baz=bamf%3Arofl"
-    end
-  end
-  include PathParsingTests
-
-  module RequestMethodParsingTests
-    def test_request_method_is_default_if_unspecified
-      options = Twurl::CLI.parse_options([TEST_PATH])
-      assert_equal Twurl::Options::DEFAULT_REQUEST_METHOD, options.request_method
-    end
-
-    def test_specifying_a_request_method_extracts_and_normalizes_request_method
-      variations = [%w[-X put], %w[-X PUT], %w[--request-method PUT], %w[--request-method put]]
-      variations.each do |option_variation|
-        order_variant_1 = [option_variation, TEST_PATH].flatten
-        order_variant_2 = [TEST_PATH, option_variation].flatten
-        [order_variant_1, order_variant_2].each do |args|
-          options = Twurl::CLI.parse_options(args)
-          assert_equal 'put', options.request_method
-        end
-      end
-    end
-
-    def test_specifying_unsupported_request_method_returns_an_error
-      Twurl::CLI.parse_options([TEST_PATH, '-X', 'UNSUPPORTED'])
-    end
-  end
-  include RequestMethodParsingTests
-
-  module OAuthClientOptionParsingTests
-    def test_extracting_the_consumer_key
-      mock(Twurl::CLI).prompt_for('Consumer key').never
-
-      options = Twurl::CLI.parse_options([TEST_PATH, '-c', 'the-key'])
-      assert_equal 'the-key', options.consumer_key
-    end
-
-    def test_consumer_key_option_with_no_value_prompts_user_for_value
-      mock(Twurl::CLI).prompt_for('Consumer key').times(1) { 'inputted-key'}
-      options = Twurl::CLI.parse_options([TEST_PATH, '-c'])
-      assert_equal 'inputted-key', options.consumer_key
-    end
-  end
-  include OAuthClientOptionParsingTests
-
-  module DataParsingTests
-    def test_extracting_a_single_key_value_pair
-      options = Twurl::CLI.parse_options([TEST_PATH, '-d', 'key=value'])
-      assert_equal({'key' => 'value'}, options.data)
-
-      options = Twurl::CLI.parse_options([TEST_PATH, '--data', 'key=value'])
-      assert_equal({'key' => 'value'}, options.data)
-    end
-
-    def test_passing_data_and_no_explicit_request_method_defaults_request_method_to_post
-      options = Twurl::CLI.parse_options([TEST_PATH, '-d', 'key=value'])
-      assert_equal 'post', options.request_method
-    end
-
-    def test_passing_data_and_an_explicit_request_method_uses_the_specified_method
-      options = Twurl::CLI.parse_options([TEST_PATH, '-d', 'key=value', '-X', 'DELETE'])
-      assert_equal({'key' => 'value'}, options.data)
-      assert_equal 'delete', options.request_method
-    end
-
-    def test_multiple_pairs_when_option_is_specified_multiple_times_on_command_line_collects_all
-      options = Twurl::CLI.parse_options([TEST_PATH, '-d', 'key=value', '-d', 'another=pair'])
-      assert_equal({'key' => 'value', 'another' => 'pair'}, options.data)
-    end
-
-    def test_multiple_pairs_separated_by_ampersand_are_all_captured
-      options = Twurl::CLI.parse_options([TEST_PATH, '-d', 'key=value&another=pair'])
-      assert_equal({'key' => 'value', 'another' => 'pair'}, options.data)
-    end
-
-    def test_extracting_an_empty_key_value_pair
-      options = Twurl::CLI.parse_options([TEST_PATH, '-d', 'key='])
-      assert_equal({'key' => ''}, options.data)
-
-      options = Twurl::CLI.parse_options([TEST_PATH, '--data', 'key='])
-      assert_equal({'key' => ''}, options.data)
-    end
-  end
-  include DataParsingTests
-
-  module HeaderParsingTests
-    def test_extracting_a_single_header
-      options = Twurl::CLI.parse_options([TEST_PATH, '-A', 'Key: Value'])
-      assert_equal({'Key' => 'Value'}, options.headers)
-
-      options = Twurl::CLI.parse_options([TEST_PATH, '--header', 'Key: Value'])
-      assert_equal({'Key' => 'Value'}, options.headers)
-    end
-
-    def test_multiple_headers_when_option_is_specified_multiple_times_on_command_line_collects_all
-      options = Twurl::CLI.parse_options([TEST_PATH, '-A', 'Key: Value', '-A', 'Another: Pair'])
-      assert_equal({'Key' => 'Value', 'Another' => 'Pair'}, options.headers)
-    end
-  end
-  include HeaderParsingTests
-
-  module SSLDisablingTests
-    def test_ssl_is_on_by_default
-      options = Twurl::CLI.parse_options([TEST_PATH])
-      assert options.ssl?
-    end
-
-    def test_passing_no_ssl_option_disables_ssl
-      ['-U', '--no-ssl'].each do |switch|
-        options = Twurl::CLI.parse_options([TEST_PATH, switch])
-        assert !options.ssl?
-      end
-    end
-  end
-  include SSLDisablingTests
-
-  module HostOptionTests
-    def test_not_specifying_host_sets_it_to_the_default
-      options = Twurl::CLI.parse_options([TEST_PATH])
-      assert_equal Twurl::Options::DEFAULT_HOST, options.host
-    end
-
-    def test_setting_host_updates_to_requested_value
-      custom_host = 'localhost:3000'
-      assert Twurl::Options::DEFAULT_HOST != custom_host
-
-      [[TEST_PATH, '-H', custom_host], [TEST_PATH, '--host', custom_host]].each do |option_combination|
-        options = Twurl::CLI.parse_options(option_combination)
-        assert_equal custom_host, options.host
-      end
-    end
-
-    def test_protocol_is_stripped_from_host
-      custom_host = 'localhost:3000'
-      options = Twurl::CLI.parse_options([TEST_PATH, '-H', "https://"+custom_host])
-      assert_equal custom_host, options.host
-    end
-  end
-  include HostOptionTests
-
-  module ProxyOptionTests
-    def test_not_specifying_proxy_sets_it_to_nil
-      options = Twurl::CLI.parse_options([TEST_PATH])
-      assert_equal nil, options.proxy
-    end
-
-    def test_setting_proxy_updates_to_requested_value
-      custom_proxy = 'localhost:80'
-
-      [[TEST_PATH, '-P', custom_proxy], [TEST_PATH, '--proxy', custom_proxy]].each do |option_combination|
-        options = Twurl::CLI.parse_options(option_combination)
-        assert_equal custom_proxy, options.proxy
-      end
-    end
-  end
-  include ProxyOptionTests
-end