rest-man 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2274a801fef783f90e351212a49c396e9206f39b6216a29c1cdc0b6995b0a8fc
-  data.tar.gz: 5007d4e83636368725a1e4a3d69d7a844a05d0d5407bd2853d200b15ca4e4105
+  metadata.gz: d2a2ed4e6c9eb8299cb2b261f08ee19f8a8a6cb9716e3a92dd35f976f406f6a6
+  data.tar.gz: 959ea55211158eb81adde856be6144a62b5f9bd6e9bf0b3d294cb8ee41ab9cd3
 SHA512:
-  metadata.gz: 674b7bd8deef3107f3a3bd41412de34e67116902e946842951487833e47ed772856df64a56b46e2082c04735cdc3a0b79f14236bb6ef501d26f6faf1fb072999
-  data.tar.gz: 8d299a22870e2010f56e4ddb3c04b42d3e2959651438edb2f03ec22cc3af09e63b894d287e513e6e99bdceb5f535dbd443527858b7a67d53e9b0ab2f1329ccd2
+  metadata.gz: 4d92a3aa41d3447a1559466579314515950bb424a1a598310999841e77732d2ae604bb4b7ab5e868045aed1ea19d48fee0ba6ff4027828d9a221184a59a3bc73
+  data.tar.gz: 824b1be24cc6b19544d529a13f0aa18201cde6a9112ad331e6a1b35e56bc925e8ae7c2ca328b8b5c513dd5995716dc9079874e7ee4f4736f28afc6b02dad64fe

data/.github/workflows/{multi-matrix-test.yml → ci.yml}

@@ -1,4 +1,4 @@
-name: Run tests against all matrix
+name: CI
 
 on:
   push:
@@ -18,6 +18,7 @@ jobs:
     strategy:
       matrix:
         ruby:
+          - 2.6
           - 2.7
           - 3.0
           - 3.1
@@ -32,4 +33,12 @@ jobs:
         ruby-version: ${{ matrix.ruby }}
         bundler-cache: true
     - name: Run all tests with RSpec 
+      env:
+        UPLOAD_COVERAGE_TO_CODACY: true
       run: bundle exec rspec
+    - name: Run codacy-coverage-reporter
+      if: matrix.ruby == '3.1'
+      uses: codacy/codacy-coverage-reporter-action@v1
+      with:
+        project-token: ${{ secrets.CODACY_PROJECT_TOKEN }}
+        coverage-reports: coverage/coverage.xml

data/.github/workflows/single-matrix-test.yml

@@ -7,6 +7,7 @@ on:
         required: true
         type: choice
         options:
+        - ruby-2.6
         - ruby-2.7
         - ruby-3.0
         - ruby-3.1

data/.gitignore

@@ -11,3 +11,5 @@
 .ruby-version
 .matrixeval/docker-compose
 .matrixeval/gemfile_locks
+coverage
+.DS_Store

data/.rubocop-disables.yml

@@ -8,7 +8,7 @@
 # TODO
 # Offense count: 1
 # Cop supports --auto-correct.
-Lint/StringConversionInInterpolation:
+Lint/RedundantStringCoercion:
   Enabled: false
 
 # Tests only
@@ -17,18 +17,10 @@ Lint/StringConversionInInterpolation:
 Lint/UnusedBlockArgument:
   Enabled: false
 
-Security/Eval:
-  Exclude:
-  - rest-man.windows.gemspec
-
-Lint/HandleExceptions:
+Lint/SuppressedException:
   Exclude:
   - lib/restman/utils.rb
 
-Lint/UselessAccessModifier:
-  Exclude:
-  - lib/restman/windows/root_certs.rb
-
 # Offense count: 4
 # Cop supports --auto-correct.
 Style/Alias:
@@ -46,17 +38,6 @@ Style/AndOr:
 Style/BlockDelimiters:
   Enabled: false
 
-# Offense count: 48
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyle, SupportedStyles.
-Style/BracesAroundHashParameters:
-  Enabled: false
-
-# Offense count: 1
-Naming/ClassAndModuleCamelCase:
-  Exclude:
-    - lib/restman/windows/root_certs.rb
-
 # Offense count: 2
 # Configuration parameters: EnforcedStyle, SupportedStyles.
 Style/ClassAndModuleChildren:
@@ -184,7 +165,7 @@ Style/HashSyntax:
 Style/IfUnlessModifier:
   Enabled: false
 
-Layout/IndentFirstHashElement:
+Layout/FirstHashElementIndentation:
   Exclude:
     - 'spec/**/*.rb'
 
@@ -364,7 +345,7 @@ Style/UnlessElse:
 # TODO?
 # Offense count: 6
 # Cop supports --auto-correct.
-Style/UnneededPercentQ:
+Style/RedundantPercentQ:
   Enabled: false
 
 # Offense count: 5
@@ -378,9 +359,3 @@ Style/WordArray:
 # Configuration parameters: EnforcedStyle, SupportedStyles.
 Style/BarePercentLiterals:
   Enabled: false
-
-
-Style/RescueStandardError:
-  Exclude:
-    - 'exe/restman'
-    - 'lib/restman/windows/root_certs.rb'

data/AUTHORS

@@ -20,7 +20,6 @@ Coda Hale
 Crawford
 Cyril Rohr
 Dan Mayer
-Dario Hamidi
 Darren Coxall
 David Backeus
 David Perkowski
@@ -37,6 +36,7 @@ Giovanni Cappellotto
 Greg Borenstein
 Harm Aarts
 Hiro Asari
+Hopper Gee
 Hugh McGowan
 Ian Warshak
 Igor Zubkov
@@ -77,12 +77,14 @@ Michael Klett
 Michael Rykov
 Michael Westbom
 Mike Fletcher
+Nathan Perry
 Nelson Elhage
 Nicholas Wieland
 Nick Hammond
 Nick Plante
 Niko Dittmann
 Nikolay Shebanov
+Olle Jonsson
 Oscar Del Ben
 Pablo Astigarraga
 Paul Dlug
@@ -95,11 +97,13 @@ Richard Schneeman
 Rick Olson
 Robert Eanes
 Rodrigo Panachi
+Ryan Guest
 Sam Norbury
 Samuel Cochran
 Syl Turner
 T. Watanabe
 Tekin
+The Gitter Badger
 W. Andrew Loe III
 Waynn Lue
 Xavier Shay

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+# v1.1.0
+
+- Drop support for Ruby < 2.6
+- Support Ruby 3.1, 3.2, JRuby-9.4
+- Remove support for windows platform
+- Support `write_timeout`, `ssl_timeout`, `keep_alive_timeout` option
+- Support `max_retries` option
+- Support `ssl_min_version` and `ssl_max_version` option
+- Support `close_on_empty_response` option
+- Support `local_host`, `local_port` option
+- Add `AbstractRequest#sucess?`
+- Move doc to seperate files
+- Refactor most code with `ActiveMethod`
+
 # 1.0.0
 
 - Fork from rest-client and rename to rest-man

data/Gemfile

@@ -8,4 +8,7 @@ group :development, :test do
   gem 'rake'
   gem 'byebug' unless RUBY_PLATFORM == 'java'
   gem 'ruby-debug' if RUBY_PLATFORM == 'java'
+  gem 'simplecov'
+  gem 'simplecov-cobertura'
+  gem 'rubycritic'
 end

data/README.md

@@ -1,5 +1,9 @@
 # REST Man -- simple DSL for accessing HTTP and REST resources
 
+[![CI](https://github.com/rest-man/rest-man/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/rest-man/rest-man/actions/workflows/ci.yml)
+[![Codacy Badge](https://app.codacy.com/project/badge/Grade/f68e8752d2c740129b82394f973de025)](https://www.codacy.com/gh/rest-man/rest-man/dashboard?utm_source=github.com&utm_medium=referral&utm_content=rest-man/rest-man&utm_campaign=Badge_Grade)
+[![Codacy Badge](https://app.codacy.com/project/badge/Coverage/f68e8752d2c740129b82394f973de025)](https://www.codacy.com/gh/rest-man/rest-man/dashboard?utm_source=github.com&utm_medium=referral&utm_content=rest-man/rest-man&utm_campaign=Badge_Coverage)
+
 A simple HTTP and REST client for Ruby, inspired by the Sinatra's microframework style
 of specifying actions: get, put, post, delete.
 
@@ -7,23 +11,17 @@ This is a fork version of [rest-client](https://github.com/rest-client/rest-clie
 
 ## Requirements
 
-MRI Ruby 2.0 and newer are supported. Alternative interpreters compatible with
-2.0+ should work as well.
-
-Earlier Ruby versions such as 1.8.7, 1.9.2, and 1.9.3 are no longer supported. These
-versions no longer have any official support, and do not receive security
-updates.
+Supported Ruby versions
 
-The rest-man gem depends on these other gems for usage at runtime:
+| 2.6 | 2.7 | 3.0 | 3.1 | 3.2 | 3.3-Preview |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
 
-* [mime-types](http://rubygems.org/gems/mime-types)
-* [netrc](http://rubygems.org/gems/netrc)
-* [http-accept](https://rubygems.org/gems/http-accept)
-* [http-cookie](https://rubygems.org/gems/http-cookie)
+Supported JRuby versions
 
-There are also several development dependencies. It's recommended to use
-[bundler](http://bundler.io/) to manage these dependencies for hacking on
-rest-man.
+| 9.3 | 9.4 |
+| ---- | ---- |
+| ✅ | ✅ |
 
 ## Usage: Raw URL
 
@@ -202,7 +200,7 @@ Other `OpenSSL::SSL::SSLError` errors are raised as is.
 
 By default, rest-man will follow HTTP 30x redirection requests.
 
-__New in 2.0:__ `RestMan::Response` exposes a `#history` method that returns
+`RestMan::Response` exposes a `#history` method that returns
 a list of each response received in a redirection chain.
 
 ```ruby
@@ -224,12 +222,6 @@ a list of each response received in a redirection chain.
 
 To disable automatic redirection, set `:max_redirects => 0`.
 
-__New in 2.0:__ Prior versions of rest-man would raise
-`RestMan::MaxRedirectsReached`, with no easy way to access the server's
-response. In 2.0, rest-man raises the normal
-`RestMan::ExceptionWithResponse` as it would with any other non-HTTP-20x
-response.
-
 ```ruby
 >> RestMan::Request.execute(method: :get, url: 'http://httpbin.org/redirect/1')
 => RestMan::Response 200 "{\n  "args":..."
@@ -258,6 +250,14 @@ RestMan::Found: 302 Found
 => RestMan::Response 200 "{\n  "args":..."
 ```
 
+#### Manually set max retries
+
+The default max_retries is 1. You can change it to any number you like.
+
+```ruby
+RestMan::Request.execute(method: :get, url: 'http://httpbin.org', max_retires: 0)
+```
+
 ## Result handling
 
 The result of a `RestMan::Request` is a `RestMan::Response` object.
@@ -271,9 +271,9 @@ Response objects have several useful methods. (See the class rdoc for more detai
 - `Response#headers`: A hash of HTTP response headers
 - `Response#raw_headers`: A hash of HTTP response headers as unprocessed arrays
 - `Response#cookies`: A hash of HTTP cookies set by the server
-- `Response#cookie_jar`: <em>New in 1.8</em> An HTTP::CookieJar of cookies
+- `Response#cookie_jar`: An HTTP::CookieJar of cookies
 - `Response#request`: The RestMan::Request object used to make the request
-- `Response#history`: <em>New in 2.0</em> If redirection was followed, a list of prior Response objects
+- `Response#history`: If redirection was followed, a list of prior Response objects
 
 ```ruby
 RestMan.get('http://example.com')
@@ -602,7 +602,7 @@ use whatever proxy the system is configured to use:
   RestMan.proxy = ENV['http_proxy']
 ```
 
-__New in 2.0:__ Specify a per-request proxy by passing the :proxy option to
+Specify a per-request proxy by passing the :proxy option to
 RestMan::Request. This will override any proxies set by environment variable
 or by the global `RestMan.proxy` value.
 
@@ -702,7 +702,7 @@ GET:
   {"outer"=>{"foo"=>"123", "bar"=>"456"}}
 ```
 
-__New in 2.0:__ The new `RestMan::ParamsArray` class allows callers to
+The `RestMan::ParamsArray` class allows callers to
 provide ordering even to structured parameters. This is useful for unusual
 cases where the server treats the order of parameters as significant or you
 want to pass a particular key multiple times.
@@ -741,18 +741,18 @@ RestMan.delete 'http://example.com/resource', {:Authorization => 'Bearer cT0febF
 
 By default the timeout for a request is 60 seconds. Timeouts for your request can
 be adjusted by setting the `timeout:` to the number of seconds that you would like
-the request to wait. Setting `timeout:` will override both `read_timeout:` and `open_timeout:`.
+the request to wait. Setting `timeout:` will override `read_timeout:`, `open_timeout:` and `write_timeout`.
 
 ```ruby
 RestMan::Request.execute(method: :get, url: 'http://example.com/resource',
                             timeout: 120)
 ```
 
-Additionally, you can set `read_timeout:` and `open_timeout:` separately.
+Additionally, you can set `read_timeout:`, `open_timeout:` and `write_timeout` separately.
 
 ```ruby
 RestMan::Request.execute(method: :get, url: 'http://example.com/resource',
-                            read_timeout: 120, open_timeout: 240)
+                            read_timeout: 120, open_timeout: 240, write_timeout: 120)
 ```
 
 ## Cookies
@@ -772,13 +772,9 @@ response2 = RestMan.post(
 )
 # ...response body
 ```
-### Full cookie jar support (new in 1.8)
+### Full cookie jar support
 
-The original cookie implementation was very naive and ignored most of the
-cookie RFC standards.
-__New in 1.8__:  An HTTP::CookieJar of cookies
-
-Response objects now carry a cookie_jar method that exposes an HTTP::CookieJar
+Response objects carry a cookie_jar method that exposes an HTTP::CookieJar
 of cookies, which supports full standards compliant behavior.
 
 ## SSL/TLS support
@@ -838,6 +834,3 @@ Released under the MIT License: https://opensource.org/licenses/MIT
 
 Photo of the International Space Station was produced by NASA and is in the
 public domain.
-
-Code for reading Windows root certificate store derived from work by Puppet;
-used under terms of the Apache License, Version 2.0.

data/Rakefile

@@ -50,7 +50,7 @@ the following kind souls:
 end
 
 task :default do
-  sh 'rake -T'
+  sh 'rake test'
 end
 
 def alias_task(alias_task, original)
@@ -61,64 +61,6 @@ alias_task(:test, :spec)
 
 ############################
 
-WindowsPlatforms = %w{x86-mingw32 x64-mingw32 x86-mswin32}
-
-namespace :all do
-
-  desc "Build rest-man #{RestMan::VERSION} for all platforms"
-  task :build => ['ruby:build'] + \
-    WindowsPlatforms.map {|p| "windows:#{p}:build"}
-
-  desc "Create tag v#{RestMan::VERSION} and for all platforms build and " \
-    "push rest-man #{RestMan::VERSION} to Rubygems"
-  task :release => ['build', 'ruby:release'] + \
-    WindowsPlatforms.map {|p| "windows:#{p}:push"}
-
-end
-
-namespace :windows do
-  spec_path = File.join(File.dirname(__FILE__), 'rest-man.windows.gemspec')
-
-  WindowsPlatforms.each do |platform|
-    namespace platform do
-      gem_filename = "rest-man-#{RestMan::VERSION}-#{platform}.gem"
-      base = File.dirname(__FILE__)
-      pkg_dir = File.join(base, 'pkg')
-      gem_file_path = File.join(pkg_dir, gem_filename)
-
-      desc "Build #{gem_filename} into the pkg directory"
-      task 'build' do
-        orig_platform = ENV['BUILD_PLATFORM']
-        begin
-          ENV['BUILD_PLATFORM'] = platform
-
-          sh("gem build -V #{spec_path}") do |ok, res|
-            if ok
-              FileUtils.mkdir_p(pkg_dir)
-              FileUtils.mv(File.join(base, gem_filename), pkg_dir)
-              Bundler.ui.confirm("rest-man #{RestMan::VERSION} " \
-                                 "built to pkg/#{gem_filename}")
-            else
-              abort "Command `gem build` failed: #{res}"
-            end
-          end
-
-        ensure
-          ENV['BUILD_PLATFORM'] = orig_platform
-        end
-      end
-
-      desc "Push #{gem_filename} to Rubygems"
-      task 'push' do
-        sh("gem push #{gem_file_path}")
-      end
-    end
-  end
-
-end
-
-############################
-
 require 'rdoc/task'
 
 Rake::RDocTask.new do |t|

data/_doc/lib/restman/abstract_response/_follow_redirection.rdoc

@@ -0,0 +1,7 @@
+Follow a redirection
+
+[Parameters:]
+
+  - *new_args* (Hash) -- Start with this hash of arguments for the
+    redirection request. The hash will be mutated, so be sure to dup any
+    existing hash that should not be modified.

data/_doc/lib/restman/abstract_response/beautify_headers.rdoc

@@ -0,0 +1,24 @@
+:call-seq:
+  beautify_headers(headers) -> hash
+ 
+Convert headers hash into canonical form.
+
+Header names will be converted to lowercase symbols with underscores
+instead of hyphens.
+
+Headers specified multiple times will be joined by comma and space,
+except for Set-Cookie, which will always be an array.
+
+Per RFC 2616, if a server sends multiple headers with the same key, they
+MUST be able to be joined into a single header by a comma. However,
+Set-Cookie (RFC 6265) cannot because commas are valid within cookie
+definitions. The newer RFC 7230 notes (3.2.2) that Set-Cookie should be
+handled as a special case.
+
+http://tools.ietf.org/html/rfc2616#section-4.2
+http://tools.ietf.org/html/rfc7230#section-3.2.2
+http://tools.ietf.org/html/rfc6265
+
+[Parameters:]
+
+  - *headers* (Hash)

data/_doc/lib/restman/abstract_response/cookie_jar.rdoc

@@ -0,0 +1,4 @@
+:call-seq:
+  cookie_jar -> HTTP::CookieJar
+
+Cookie jar extracted from response headers.

data/_doc/lib/restman/abstract_response/cookies.rdoc

@@ -0,0 +1,12 @@
+:call-seq:
+  cookies -> hash
+
+Hash of cookies extracted from response headers.
+
+NB: This will return only cookies whose domain matches this request, and
+may not even return all of those cookies if there are duplicate names.
+Use the full cookie_jar for more nuanced access.
+
+[See Also:]
+
+  - #cookie_jar

data/_doc/lib/restman/abstract_response/follow_get_redirection.rdoc

@@ -0,0 +1,2 @@
+Follow a redirection response, but change the HTTP method to GET and drop
+the payload from the original request.

data/_doc/lib/restman/abstract_response/follow_redirection.rdoc

@@ -0,0 +1,2 @@
+Follow a redirection response by making a new HTTP request to the
+redirection target.

data/_doc/lib/restman/abstract_response/headers.rdoc

@@ -0,0 +1,2 @@
+A hash of the headers, beautified with symbols and underscores.
+e.g. "Content-type" will become :content_type.

data/_doc/lib/restman/abstract_response/response_set_vars.rdoc

@@ -0,0 +1,5 @@
+[Parameters:]
+
+  - net_http_res (Net::HTTPResponse)
+  - request (RestMan::Request)
+  - start_time (Time)

data/_doc/lib/restman/abstract_response/return.rdoc

@@ -0,0 +1,9 @@
+Return the default behavior corresponding to the response code:
+
+For 20x status codes: return the response itself
+
+For 30x status codes:
+  301, 302, 307: redirect GET / HEAD if there is a Location header
+  303: redirect, changing method to GET, if there is a Location header
+
+For all other responses, raise a response exception

data/_doc/lib/restman/add_before_execution_proc.rdoc

@@ -0,0 +1,2 @@
+Add a Proc to be called before each request in executed.
+The proc parameters will be the http request and the request params.

data/_doc/lib/restman/create_log.rdoc

@@ -0,0 +1,2 @@
+Create a log that respond to << like a logger
+param can be 'stdout', 'stderr', a string (then we will log to that file) or a logger (then we return it)

data/_doc/lib/restman/exception.rdoc

@@ -0,0 +1,6 @@
+This is the base RestMan exception class. Rescue it if you want to
+catch any exception that your request might raise
+You can get the status code by e.http_code, or see anything about the
+response via e.response.
+For example, the entire result body (which is
+probably an HTML error page) is e.response.

data/_doc/lib/restman/exceptions/timeout.rdoc

@@ -0,0 +1,4 @@
+Base class for request timeouts.
+
+NB: Previous releases of rest-man would raise RequestTimeout both for
+HTTP 408 responses and for actual connection timeouts.

data/_doc/lib/restman/exceptions.rdoc

@@ -0,0 +1,4 @@
+RestMan exception classes. TODO: move all exceptions into this module.
+
+We will a create an exception for each status code, see
+http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html

data/_doc/lib/restman/log=.rdoc

@@ -0,0 +1,3 @@
+Setup the log for RestMan calls.
+Value should be a logger but can can be stdout, stderr, or a filename.
+You can also configure logging by the environment variable RESTCLIENT_LOG.

data/_doc/lib/restman/params_array/new.rdoc

@@ -0,0 +1,20 @@
+[Parameters:]
+
+  - array (Array) An array of parameter key,value pairs. These
+    pairs may be 2 element arrays [key, value] or single element hashes
+    {key => value}. They may also be single element arrays to represent a
+    key with no value.
+
+
+
+*Examples*:
+
+  ParamsArray.new([[:foo, 123], [:foo, 456], [:bar, 789]])
+
+This will be encoded as "foo=123&foo=456&bar=789"
+
+  ParamsArray.new({foo: 123, bar: 456})
+
+This is valid, but there's no reason not to just use the Hash directly
+instead of a ParamsArray.
+

data/_doc/lib/restman/params_array/process_pair.rdoc

@@ -0,0 +1,4 @@
+A pair may be:
+- A single element hash, e.g. {foo: 'bar'}
+- A two element array, e.g. ['foo', 'bar']
+- A one element array, e.g. ['foo']

data/_doc/lib/restman/params_array.rdoc

@@ -0,0 +1,11 @@
+The ParamsArray class is used to represent an ordered list of [key, value]
+pairs. Use this when you need to include a key multiple times or want
+explicit control over parameter ordering.
+
+Most of the request payload & parameter functions normally accept a Hash of
+keys => values, which does not allow for duplicated keys.
+
+[See Also:]
+
+  - RestMan::Utils.encode_query_string
+  - RestMan::Utils.flatten_params

data/_doc/lib/restman/platform/jruby?.rdoc

@@ -0,0 +1,4 @@
+:call-seq:
+  jruby? -> boolean
+
+Return true if we are running on jruby.

data/_doc/lib/restman/platform/mac_mri?.rdoc

@@ -0,0 +1,5 @@
+:call-seq:
+  mac_mri? -> boolean
+
+# Return true if we are running on a darwin-based Ruby platform. This will
+# be false for jruby even on OS X.

data/_doc/lib/restman/proxy.rdoc

@@ -0,0 +1,2 @@
+A global proxy URL to use for all requests. This can be overridden on a
+per-request basis by passing `:proxy` to RestMan::Request.

data/_doc/lib/restman/proxy_set?.rdoc

@@ -0,0 +1,5 @@
+:call-seq:
+  proxy_set? -> boolean
+
+Return whether RestMan.proxy was set explicitly. We use this to
+differentiate between no value being set and a value explicitly set to nil.

data/_doc/lib/restman/raw_response/new.rdoc

@@ -0,0 +1,6 @@
+[Parameters:]
+
+  - tempfile (Tempfile) -- The temporary file containing the body
+  - net_http_res (Net::HTTPResponse)
+  - request (RestMan::Request)
+  - start_time (Time)

data/_doc/lib/restman/raw_response.rdoc

@@ -0,0 +1,10 @@
+The response from RestMan on a raw request looks like a string, but is
+actually one of these.  99% of the time you're making a rest call all you
+care about is the body, but on the occasion you want to fetch the
+headers you can:
+
+  RestMan.get('http://example.com').headers[:content_type]
+
+In addition, if you do not use the response as a string, you can access
+a Tempfile object at res.file, which contains the path to the raw
+downloaded request body.

data/_doc/lib/restman/request/cookie_jar.rdoc

@@ -0,0 +1,3 @@
+:call-seq:
+  cookie_jar() -> HTTP::CookieJar
+ 

data/_doc/lib/restman/request/cookies.rdoc

@@ -0,0 +1,11 @@
+:call-seq:
+  cookies -> hash
+ 
+Render a hash of key => value pairs for cookies in the Request#cookie_jar
+that are valid for the Request#uri. This will not necessarily include all
+cookies if there are duplicate keys. It's safer to use the cookie_jar
+directly if that's a concern.
+
+[See Also:]
+
+  - Request#cookie_jar

data/_doc/lib/restman/request/default_headers.rdoc

@@ -0,0 +1,5 @@
+:call-seq:
+  default_headers -> Hash<Symbol, String>
+
+Default headers set by RestMan. In addition to these headers, servers
+will receive headers set by Net::HTTP, such as Accept-Encoding and Host.

data/_doc/lib/restman/request/default_ssl_cert_store.rdoc

@@ -0,0 +1,8 @@
+:call-seq:
+  .default_ssl_cert_store -> OpenSSL::X509::Store
+
+Return a certificate store that can be used to validate certificates with
+the system certificate authorities. This will probably not do anything on
+OS X, which monkey patches OpenSSL in terrible ways to insert its own
+validation. On most *nix platforms, this will add the system certifcates
+using OpenSSL::X509::Store#set_default_paths.