httparty-responsibly 0.17.1

data/Gemfile

@@ -0,0 +1,24 @@
+source 'https://rubygems.org'
+gemspec
+
+gem 'rake'
+gem 'mongrel',  '1.2.0.pre2'
+
+group :development do
+  gem 'guard'
+  gem 'guard-rspec'
+  gem 'guard-bundler'
+end
+
+group :test do
+  gem 'rspec',    '~> 3.4'
+  gem 'simplecov', require: false
+  gem 'aruba'
+  gem 'cucumber', '~> 2.3'
+  gem 'webmock'
+  gem 'addressable'
+end
+
+group :development, :test do
+  gem 'pry'
+end

data/Guardfile

@@ -0,0 +1,16 @@
+rspec_options = {
+  version:        1,
+  all_after_pass: false,
+  all_on_start:   false
+}
+
+guard 'rspec', rspec_options do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+
+guard 'bundler' do
+  watch('Gemfile')
+  watch(/^.+\.gemspec/)
+end

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 John Nunemaker
+
+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,78 @@
+# httparty
+
+An up-to-date fork of httparty, without the post-install nonsense.
+
+## Install
+
+```
+gem install httparty
+```
+
+## Requirements
+
+* Ruby 2.0.0 or higher
+* multi_xml
+
+## Examples
+
+```ruby
+# Use the class methods to get down to business quickly
+response = HTTParty.get('http://api.stackexchange.com/2.2/questions?site=stackoverflow')
+
+puts response.body, response.code, response.message, response.headers.inspect
+
+# Or wrap things up in your own class
+class StackExchange
+  include HTTParty
+  base_uri 'api.stackexchange.com'
+
+  def initialize(service, page)
+    @options = { query: { site: service, page: page } }
+  end
+
+  def questions
+    self.class.get("/2.2/questions", @options)
+  end
+
+  def users
+    self.class.get("/2.2/users", @options)
+  end
+end
+
+stack_exchange = StackExchange.new("stackoverflow", 1)
+puts stack_exchange.questions
+puts stack_exchange.users
+```
+
+See the [examples directory](http://github.com/jnunemaker/httparty/tree/master/examples) for even more goodies.
+
+## Command Line Interface
+
+httparty also includes the executable `httparty` which can be
+used to query web services and examine the resulting output. By default
+it will output the response as a pretty-printed Ruby object (useful for
+grokking the structure of output). This can also be overridden to output
+formatted XML or JSON. Execute `httparty --help` for all the
+options. Below is an example of how easy it is.
+
+```
+httparty "https://api.stackexchange.com/2.2/questions?site=stackoverflow"
+```
+
+## Help and Docs
+
+* [Docs](https://github.com/jnunemaker/httparty/tree/master/docs)
+* https://groups.google.com/forum/#!forum/httparty-gem
+* https://www.rubydoc.info/github/jnunemaker/httparty
+* http://stackoverflow.com/questions/tagged/httparty
+
+## Contributing
+
+* Fork the project.
+* Run `bundle`
+* Run `bundle exec rake`
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Run `bundle exec rake` (No, REALLY :))
+* Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself in another branch so I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.

data/Rakefile

@@ -0,0 +1,10 @@
+begin
+  require 'rspec/core/rake_task'
+  RSpec::Core::RakeTask.new(:spec)
+rescue LoadError
+end
+
+require 'cucumber/rake/task'
+Cucumber::Rake::Task.new(:features)
+
+task default: [:spec, :features]

data/bin/httparty

@@ -0,0 +1,123 @@
+#!/usr/bin/env ruby
+
+require "optparse"
+require "pp"
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), "/../lib"))
+require "httparty"
+
+opts = {
+  action: :get,
+  headers: {},
+  verbose: false
+}
+
+OptionParser.new do |o|
+  o.banner = "USAGE: #{$PROGRAM_NAME} [options] [url]"
+
+  o.on("-f",
+       "--format [FORMAT]",
+       "Output format to use instead of pretty-print ruby: " \
+       "plain, csv, json or xml") do |f|
+    opts[:output_format] = f.downcase.to_sym
+  end
+
+  o.on("-a",
+       "--action [ACTION]",
+       "HTTP action: get (default), post, put, delete, head, or options") do |a|
+    opts[:action] = a.downcase.to_sym
+  end
+
+  o.on("-d",
+       "--data [BODY]",
+       "Data to put in request body (prefix with '@' for file)") do |d|
+    if d =~ /^@/
+      opts[:body] = open(d[1..-1]).read
+    else
+      opts[:body] = d
+    end
+  end
+
+  o.on("-H", "--header [NAME:VALUE]", "Additional HTTP headers in NAME:VALUE form") do |h|
+    abort "Invalid header specification, should be Name:Value" unless h =~ /.+:.+/
+    name, value = h.split(':')
+    opts[:headers][name.strip] = value.strip
+  end
+
+  o.on("-v", "--verbose", "If set, print verbose output") do |v|
+    opts[:verbose] = true
+  end
+
+  o.on("-u", "--user [CREDS]", "Use basic authentication. Value should be user:password") do |u|
+    abort "Invalid credentials format. Must be user:password" unless u =~ /.*:.+/
+    user, password = u.split(':')
+    opts[:basic_auth] = { username: user, password: password }
+  end
+
+  o.on("-r", "--response-code", "Command fails if response code >= 400") do
+    opts[:response_code] = true
+  end
+
+  o.on("-h", "--help", "Show help documentation") do |h|
+    puts o
+    exit
+  end
+
+  o.on("--version", "Show HTTParty version") do |ver|
+    puts "Version: #{HTTParty::VERSION}"
+    exit
+  end
+end.parse!
+
+if ARGV.empty?
+  STDERR.puts "You need to provide a URL"
+  STDERR.puts "USAGE: #{$PROGRAM_NAME} [options] [url]"
+end
+
+def dump_headers(response)
+  resp_type = Net::HTTPResponse::CODE_TO_OBJ[response.code.to_s]
+  puts "#{response.code} #{resp_type.to_s.sub(/^Net::HTTP/, '')}"
+  response.headers.each do |n, v|
+    puts "#{n}: #{v}"
+  end
+  puts
+end
+
+if opts[:verbose]
+  puts "#{opts[:action].to_s.upcase} #{ARGV.first}"
+  opts[:headers].each do |n, v|
+    puts "#{n}: #{v}"
+  end
+  puts
+end
+
+response = HTTParty.send(opts[:action], ARGV.first, opts)
+if opts[:output_format].nil?
+  dump_headers(response) if opts[:verbose]
+  pp response
+else
+  print_format = opts[:output_format]
+  dump_headers(response) if opts[:verbose]
+
+  case opts[:output_format]
+    when :json
+      begin
+        require 'json'
+        puts JSON.pretty_generate(response.parsed_response)
+      rescue LoadError
+        puts YAML.dump(response)
+      rescue JSON::JSONError
+        puts response.inspect
+      end
+    when :xml
+      require 'rexml/document'
+      REXML::Document.new(response.body).write(STDOUT, 2)
+      puts
+    when :csv
+      require 'csv'
+      puts CSV.parse(response.body).map(&:to_s)
+    else
+      puts response
+  end
+end
+exit false if opts[:response_code] && response.code >= 400

data/cucumber.yml

@@ -0,0 +1 @@
+default: features --format progress

data/docs/README.md

@@ -0,0 +1,106 @@
+# httparty
+
+Makes http fun again!
+
+## Table of contents
+- [Parsing JSON](#parsing-json)
+- [Working with SSL](#working-with-ssl)
+
+## Parsing JSON
+If the response Content Type is `application/json`, HTTParty will parse the response and return Ruby objects such as a hash or array. The default behavior for parsing JSON will return keys as strings. This can be supressed with the `format` option. To get hash keys as symbols:
+
+```ruby
+response = HTTParty.get('http://example.com', format: :plain)
+JSON.parse response, symbolize_names: true
+```
+
+## Working with SSL
+
+You can use this guide to work with SSL certificates.
+
+#### Using `pem` option
+
+```ruby
+# Use this example if you are using a pem file
+
+class Client
+  include HTTParty
+
+  base_uri "https://example.com"
+  pem File.read("#{File.expand_path('.')}/path/to/certs/cert.pem"), "123456"
+end
+```
+
+#### Using `pkcs12` option
+
+```ruby
+# Use this example if you are using a pkcs12 file
+
+class Client
+  include HTTParty
+
+  base_uri "https://example.com"
+  pkcs12 File.read("#{File.expand_path('.')}/path/to/certs/cert.p12"), "123456"
+end
+```
+
+#### Using `ssl_ca_file` option
+
+```ruby
+# Use this example if you are using a pkcs12 file
+
+class Client
+  include HTTParty
+
+  base_uri "https://example.com"
+  ssl_ca_file "#{File.expand_path('.')}/path/to/certs/cert.pem"
+end
+```
+
+#### Using `ssl_ca_path` option
+
+```ruby
+# Use this example if you are using a pkcs12 file
+
+class Client
+  include HTTParty
+
+  base_uri "https://example.com"
+  ssl_ca_path '/path/to/certs'
+end
+```
+
+You can also include this options with the call:
+
+```ruby
+class Client
+  include HTTParty
+
+  base_uri "https://example.com"
+
+  def self.fetch
+    get("/resources", pem: (File.read("#{File.expand_path('.')}/path/to/certs/cert.pem"), "123456")
+  end
+end
+```
+
+### Avoid SSL verification
+
+In some cases you may want to skip SSL verification, because the entity that issue the certificate is not a valid one, but you still want to work with it. You can achieve this through:
+
+```ruby
+# Skips SSL certificate verification
+
+class Client
+  include HTTParty
+
+  base_uri "https://example.com"
+  pem File.read("#{File.expand_path('.')}/path/to/certs/cert.pem"), "123456"
+
+  def self.fetch
+    get("/resources", verify: false)
+    # You can also use something like:
+    # get("resources", verify_peer: false)
+  end
+end
+```

data/examples/README.md

@@ -0,0 +1,86 @@
+## Examples
+
+* [Amazon Book Search](aaws.rb)
+    * Httparty included into poro class
+    * Uses `get` requests
+    * Transforms query params to uppercased params
+
+* [Google Search](google.rb)
+  * Httparty included into poro class
+  * Uses `get` requests
+
+* [Crack Custom Parser](crack.rb)
+    * Creates a custom parser for XML using crack gem
+    * Uses `get` request
+
+* [Create HTML Nokogiri parser](nokogiri_html_parser.rb)
+    * Adds Html as a format
+    * passed the body of request to Nokogiri
+
+* [More Custom Parsers](custom_parsers.rb)
+  * Create an additional parser for atom or make it the ONLY parser
+
+* [Basic Auth, Delicious](delicious.rb)
+  * Basic Auth, shows how to merge those into options
+  * Uses `get` requests
+
+* [Passing Headers, User Agent](headers_and_user_agents.rb)
+  * Use the class method of Httparty
+  * Pass the User-Agent in the headers
+  * Uses `get` requests
+
+* [Basic Post Request](basic.rb)
+    * Httparty included into poro class
+    * Uses `post` requests
+
+* [Access Rubyurl Shortener](rubyurl.rb)
+  * Httparty included into poro class
+  * Uses `post` requests
+
+* [Add a custom log file](logging.rb)
+  * create a log file and have httparty log requests
+
+* [Accessing StackExchange](stackexchange.rb)
+  * Httparty included into poro class
+  * Creates methods for different endpoints
+  * Uses `get` requests
+
+* [Accessing Tripit](tripit_sign_in.rb)
+  * Httparty included into poro class
+  * Example of using `debug_output` to see headers/urls passed
+  * Getting and using Cookies
+  * Uses `get` requests
+
+* [Accessing Twitter](twitter.rb)
+  * Httparty included into poro class
+  * Basic Auth
+  * Loads settings from a config file
+  * Uses `get` requests
+  * Uses `post` requests
+
+* [Accessing WhoIsMyRep](whoismyrep.rb)
+  * Httparty included into poro class
+  * Uses `get` requests
+  * Two ways to pass params to get, inline on the url or in query hash
+
+* [Rescue Json Error](rescue_json.rb)
+  * Rescue errors due to parsing response
+
+* [Download file using stream mode](stream_download.rb)
+  * Uses `get` requests
+  * Uses `stream_body` mode
+  * Download file without using the memory
+
+* [Microsoft graph](microsoft_graph.rb)
+  * Basic Auth
+  * Uses `post` requests
+  * Uses multipart
+
+* [Multipart](multipart.rb)
+  * Multipart data upload _(with and without file)_
+
+* [Uploading File](body_stream.rb)
+  * Uses `body_stream` to upload file
+
+* [Accessing x509 Peer Certificate](peer_cert.rb)
+  * Provides access to the server's TLS certificate