multipart-post 2.1.1 → 2.3.0

data/lib/parts.rb

@@ -1,126 +1,25 @@
-#--
-# Copyright (c) 2007-2013 Nick Sieger.
-# See the file README.txt included with the distribution for
-# software license details.
-#++
-
-module Parts
-  module Part
-    def self.new(boundary, name, value, headers = {})
-      headers ||= {} # avoid nil values
-      if file?(value)
-        FilePart.new(boundary, name, value, headers)
-      else
-        ParamPart.new(boundary, name, value, headers)
-      end
-    end
-
-    def self.file?(value)
-      value.respond_to?(:content_type) && value.respond_to?(:original_filename)
-    end
-
-    def length
-      @part.length
-    end
-
-    def to_io
-      @io
-    end
-  end
-
-  # Represents a parametric part to be filled with given value.
-  class ParamPart
-    include Part
-
-    # @param boundary [String]
-    # @param name [#to_s]
-    # @param value [String]
-    # @param headers [Hash] Content-Type is used, if present.
-    def initialize(boundary, name, value, headers = {})
-      @part = build_part(boundary, name, value, headers)
-      @io = StringIO.new(@part)
-    end
-
-    def length
-     @part.bytesize
-    end
-
-    # @param boundary [String]
-    # @param name [#to_s]
-    # @param value [String]
-    # @param headers [Hash] Content-Type is used, if present.
-    def build_part(boundary, name, value, headers = {})
-      part = ''
-      part << "--#{boundary}\r\n"
-      part << "Content-Disposition: form-data; name=\"#{name.to_s}\"\r\n"
-      part << "Content-Type: #{headers["Content-Type"]}\r\n" if headers["Content-Type"]
-      part << "\r\n"
-      part << "#{value}\r\n"
-    end
-  end
-
-  # Represents a part to be filled from file IO.
-  class FilePart
-    include Part
-
-    attr_reader :length
-
-    # @param boundary [String]
-    # @param name [#to_s]
-    # @param io [IO]
-    # @param headers [Hash]
-    def initialize(boundary, name, io, headers = {})
-      file_length = io.respond_to?(:length) ?  io.length : File.size(io.local_path)
-      @head = build_head(boundary, name, io.original_filename, io.content_type, file_length,
-                         io.respond_to?(:opts) ? io.opts.merge(headers) : headers)
-      @foot = "\r\n"
-      @length = @head.bytesize + file_length + @foot.length
-      @io = CompositeReadIO.new(StringIO.new(@head), io, StringIO.new(@foot))
-    end
-
-    # @param boundary [String]
-    # @param name [#to_s]
-    # @param filename [String]
-    # @param type [String]
-    # @param content_len [Integer]
-    # @param opts [Hash]
-    def build_head(boundary, name, filename, type, content_len, opts = {})
-      opts = opts.clone
-
-      trans_encoding = opts.delete("Content-Transfer-Encoding") || "binary"
-      content_disposition = opts.delete("Content-Disposition") || "form-data"
-
-      part = ''
-      part << "--#{boundary}\r\n"
-      part << "Content-Disposition: #{content_disposition}; name=\"#{name.to_s}\"; filename=\"#{filename}\"\r\n"
-      part << "Content-Length: #{content_len}\r\n"
-      if content_id = opts.delete("Content-ID")
-        part << "Content-ID: #{content_id}\r\n"
-      end
-
-      if opts["Content-Type"] != nil
-        part <<  "Content-Type: " + opts["Content-Type"] + "\r\n"
-      else
-        part << "Content-Type: #{type}\r\n"
-      end
-
-      part << "Content-Transfer-Encoding: #{trans_encoding}\r\n"
-
-      opts.each do |k, v|
-        part << "#{k}: #{v}\r\n"
-      end
-
-      part << "\r\n"
-    end
-  end
-
-  # Represents the epilogue or closing boundary.
-  class EpiloguePart
-    include Part
-
-    def initialize(boundary)
-      @part = "--#{boundary}--\r\n"
-      @io = StringIO.new(@part)
-    end
-  end
-end
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2008-2009, by McClain Looney.
+# Copyright, 2009-2013, by Nick Sieger.
+# Copyright, 2011, by Johannes Wagener.
+# Copyright, 2011, by Gerrit Riessen.
+# Copyright, 2011, by Jason Moore.
+# Copyright, 2012, by Steven Davidovitz.
+# Copyright, 2012, by hexfet.
+# Copyright, 2013, by Vincent Pellé.
+# Copyright, 2013, by Gustav Ernberg.
+# Copyright, 2013, by Socrates Vicente.
+# Copyright, 2017, by David Moles.
+# Copyright, 2017, by Matt Colyer.
+# Copyright, 2017, by Eric Hutzelman.
+# Copyright, 2019, by Olle Jonsson.
+# Copyright, 2019, by Ethan Turkeltaub.
+# Copyright, 2022, by Samuel Williams.
+
+warn "Top level ::Parts is deprecated, require 'multipart/post' and use `Multipart::Post::Parts` instead!"
+require_relative 'multipart/post'
+
+Parts = Multipart::Post::Parts
+Object.deprecate_constant :Parts

data/license.md

@@ -0,0 +1,57 @@
+# MIT License
+
+Copyright, 2006-2014, by Nick Sieger.  
+Copyright, 2008-2009, by McClain Looney.  
+Copyright, 2010, by Tohru Hashimoto.  
+Copyright, 2011, by Jeff Hodges.  
+Copyright, 2011, by Alex Koppel.  
+Copyright, 2011, by Johannes Wagener.  
+Copyright, 2011, by Christine Yen.  
+Copyright, 2011, by Gerrit Riessen.  
+Copyright, 2011, by Jason Moore.  
+Copyright, 2011, by Luke Redpath.  
+Copyright, 2012, by Steven Davidovitz.  
+Copyright, 2012, by hexfet.  
+Copyright, 2013, by Jordi Massaguer Pla.  
+Copyright, 2013, by Mislav Marohnić.  
+Copyright, 2013, by Vincent Pellé.  
+Copyright, 2013, by Gustav Ernberg.  
+Copyright, 2013, by Socrates Vicente.  
+Copyright, 2013, by Leo Cassarani.  
+Copyright, 2013, by Jagtesh Chadha.  
+Copyright, 2013, by Steffen Grunwald.  
+Copyright, 2013, by Lonre Wang.  
+Copyright, 2017-2023, by Samuel Williams.  
+Copyright, 2017, by Feuda Nan.  
+Copyright, 2017, by David Moles.  
+Copyright, 2017, by Matt Colyer.  
+Copyright, 2017, by Eric Hutzelman.  
+Copyright, 2019, by Lachlan Priest.  
+Copyright, 2019, by Jan Piotrowski.  
+Copyright, 2019-2022, by Olle Jonsson.  
+Copyright, 2019, by Ethan Turkeltaub.  
+Copyright, 2019, by Jan-Joost Spanjers.  
+Copyright, 2019, by Patrick Davey.  
+Copyright, 2021, by Tim Barkley.  
+Copyright, 2021, by Lewis Cowles.  
+Copyright, 2022, by Jason York.  
+Copyright, 2022, by Takuya Noguchi.  
+Copyright, 2023, by Peter Goldstein.  
+
+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,170 @@
+# Multipart::Post
+
+Adds a streamy multipart form post capability to `Net::HTTP`. Also supports other
+methods besides `POST`.
+
+[![Development Status](https://github.com/socketry/multipart-post/workflows/Test/badge.svg)](https://github.com/socketry/multipart-post/actions?workflow=Test)
+
+## Features/Problems
+
+  - Appears to actually work. A good feature to have.
+  - Encapsulates posting of file/binary parts and name/value parameter parts, similar to
+    most browsers' file upload forms.
+  - Provides an `UploadIO` helper class to prepare IO objects for inclusion in the params
+    hash of the multipart post object.
+
+## Installation
+
+``` shell
+bundle add multipart-post
+```
+
+## Usage
+
+``` ruby
+require 'net/http/post/multipart'
+
+url = URI.parse('http://www.example.com/upload')
+File.open("./image.jpg") do |jpg|
+  req = Net::HTTP::Post::Multipart.new url.path,
+    "file" => UploadIO.new(jpg, "image/jpeg", "image.jpg")
+  res = Net::HTTP.start(url.host, url.port) do |http|
+    http.request(req)
+  end
+end
+```
+
+To post multiple files or attachments, simply include multiple parameters with
+`UploadIO` values:
+
+``` ruby
+require 'net/http/post/multipart'
+
+url = URI.parse('http://www.example.com/upload')
+req = Net::HTTP::Post::Multipart.new url.path,
+  "file1" => UploadIO.new(File.new("./image.jpg"), "image/jpeg", "image.jpg"),
+  "file2" => UploadIO.new(File.new("./image2.jpg"), "image/jpeg", "image2.jpg")
+res = Net::HTTP.start(url.host, url.port) do |http|
+  http.request(req)
+end
+```
+
+To post files with other normal, non-file params such as input values, you need to pass hashes to the `Multipart.new` method.
+
+In Rails 4 for example:
+
+``` ruby
+def model_params
+  require_params = params.require(:model).permit(:param_one, :param_two, :param_three, :avatar)
+  require_params[:avatar] = model_params[:avatar].present? ? UploadIO.new(model_params[:avatar].tempfile, model_params[:avatar].content_type, model_params[:avatar].original_filename) : nil
+  require_params
+end
+
+require 'net/http/post/multipart'
+
+url = URI.parse('http://www.example.com/upload')
+Net::HTTP.start(url.host, url.port) do |http|
+  req = Net::HTTP::Post::Multipart.new(url, model_params)
+  key = "authorization_key"
+  req.add_field("Authorization", key) #add to Headers
+  http.use_ssl = (url.scheme == "https")
+  http.request(req)
+end
+```
+
+Or in plain ruby:
+
+``` ruby
+def params(file)
+  params = { "description" => "A nice picture!" }
+  params[:datei] = UploadIO.new(file, "image/jpeg", "image.jpg")
+  params
+end
+
+url = URI.parse('http://www.example.com/upload')
+File.open("./image.jpg") do |file|
+  req = Net::HTTP::Post::Multipart.new(url.path, params(file))
+  res = Net::HTTP.start(url.host, url.port) do |http|
+    return http.request(req).body
+  end
+end
+```
+
+### Parts Headers
+
+By default, all individual parts will include the header `Content-Disposition` as well as `Content-Length`, `Content-Transfer-Encoding` and `Content-Type` for the File Parts.
+
+You may optionally configure the headers `Content-Type` and `Content-ID` for both ParamPart and FilePart by passing in a `parts` header.
+
+For example:
+
+``` ruby
+url = URI.parse('http://www.example.com/upload')
+
+params = {
+  "file_metadata_01" => { "description" => "A nice picture!" },
+  "file_content_01"  => UploadIO.new(file, "image/jpeg", "image.jpg")
+}
+
+headers = {
+  'parts': {
+    'file_metadata_01': {
+      'Content-Type' => "application/json"
+      }
+    }
+  }
+
+req = Net::HTTP::Post::Multipart.new(uri, params, headers)
+```
+
+This would configure the `file_metadata_01` part to include `Content-Type`
+
+    Content-Disposition: form-data; name="file_metadata_01"
+    Content-Type: application/json
+      {
+        "description" => "A nice picture!" 
+      }
+
+#### Custom Parts Headers
+
+*For FileParts only.*
+
+You can include any number of custom parts headers in addition to `Content-Type` and `Content-ID`.
+
+``` ruby
+headers = {
+  'parts': {
+    'file_metadata_01': {
+      'Content-Type' => "application/json",
+      'My-Custom-Header' => "Yo Yo!"
+    }
+  }
+}
+```
+
+### Debugging
+
+You can debug requests and responses (e.g. status codes) for all requests by adding the following code:
+
+``` ruby
+http = Net::HTTP.new(uri.host, uri.port)
+http.set_debug_output($stdout)
+```
+
+## Versioning
+
+This library aims to adhere to [Semantic Versioning 2.0.0](http://semver.org/).
+Violations of this scheme should be reported as bugs. Specifically,
+if a minor or patch version is released that breaks backward
+compatibility, a new version should be immediately released that
+restores compatibility. Breaking changes to the public API will
+only be introduced with new major versions.
+
+As a result of this policy, you can (and should) specify a
+dependency on this gem using the [Pessimistic Version Constraint](http://guides.rubygems.org/patterns/#pessimistic-version-constraint) with two digits of precision.
+
+For example:
+
+``` ruby
+spec.add_dependency 'multipart-post', '~> 2.1'
+```

metadata

@@ -1,15 +1,79 @@
 --- !ruby/object:Gem::Specification
 name: multipart-post
 version: !ruby/object:Gem::Version
-  version: 2.1.1
+  version: 2.3.0
 platform: ruby
 authors:
 - Nick Sieger
 - Samuel Williams
-autorequire: 
+- Olle Jonsson
+- McClain Looney
+- Lewis Cowles
+- Gustav Ernberg
+- Patrick Davey
+- Steven Davidovitz
+- Alex Koppel
+- Ethan Turkeltaub
+- Jagtesh Chadha
+- Jason York
+- Tohru Hashimoto
+- Vincent Pellé
+- hexfet
+- Christine Yen
+- David Moles
+- Eric Hutzelman
+- Feuda Nan
+- Gerrit Riessen
+- Jan Piotrowski
+- Jan-Joost Spanjers
+- Jason Moore
+- Jeff Hodges
+- Johannes Wagener
+- Jordi Massaguer Pla
+- Lachlan Priest
+- Leo Cassarani
+- Lonre Wang
+- Luke Redpath
+- Matt Colyer
+- Mislav Marohnić
+- Peter Goldstein
+- Socrates Vicente
+- Steffen Grunwald
+- Takuya Noguchi
+- Tim Barkley
+autorequire:
 bindir: bin
-cert_chain: []
-date: 2019-05-13 00:00:00.000000000 Z
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIE2DCCA0CgAwIBAgIBATANBgkqhkiG9w0BAQsFADBhMRgwFgYDVQQDDA9zYW11
+  ZWwud2lsbGlhbXMxHTAbBgoJkiaJk/IsZAEZFg1vcmlvbnRyYW5zZmVyMRIwEAYK
+  CZImiZPyLGQBGRYCY28xEjAQBgoJkiaJk/IsZAEZFgJuejAeFw0yMjA4MDYwNDUz
+  MjRaFw0zMjA4MDMwNDUzMjRaMGExGDAWBgNVBAMMD3NhbXVlbC53aWxsaWFtczEd
+  MBsGCgmSJomT8ixkARkWDW9yaW9udHJhbnNmZXIxEjAQBgoJkiaJk/IsZAEZFgJj
+  bzESMBAGCgmSJomT8ixkARkWAm56MIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIB
+  igKCAYEAomvSopQXQ24+9DBB6I6jxRI2auu3VVb4nOjmmHq7XWM4u3HL+pni63X2
+  9qZdoq9xt7H+RPbwL28LDpDNflYQXoOhoVhQ37Pjn9YDjl8/4/9xa9+NUpl9XDIW
+  sGkaOY0eqsQm1pEWkHJr3zn/fxoKPZPfaJOglovdxf7dgsHz67Xgd/ka+Wo1YqoE
+  e5AUKRwUuvaUaumAKgPH+4E4oiLXI4T1Ff5Q7xxv6yXvHuYtlMHhYfgNn8iiW8WN
+  XibYXPNP7NtieSQqwR/xM6IRSoyXKuS+ZNGDPUUGk8RoiV/xvVN4LrVm9upSc0ss
+  RZ6qwOQmXCo/lLcDUxJAgG95cPw//sI00tZan75VgsGzSWAOdjQpFM0l4dxvKwHn
+  tUeT3ZsAgt0JnGqNm2Bkz81kG4A2hSyFZTFA8vZGhp+hz+8Q573tAR89y9YJBdYM
+  zp0FM4zwMNEUwgfRzv1tEVVUEXmoFCyhzonUUw4nE4CFu/sE3ffhjKcXcY//qiSW
+  xm4erY3XAgMBAAGjgZowgZcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0O
+  BBYEFO9t7XWuFf2SKLmuijgqR4sGDlRsMC4GA1UdEQQnMCWBI3NhbXVlbC53aWxs
+  aWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MC4GA1UdEgQnMCWBI3NhbXVlbC53aWxs
+  aWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MA0GCSqGSIb3DQEBCwUAA4IBgQB5sxkE
+  cBsSYwK6fYpM+hA5B5yZY2+L0Z+27jF1pWGgbhPH8/FjjBLVn+VFok3CDpRqwXCl
+  xCO40JEkKdznNy2avOMra6PFiQyOE74kCtv7P+Fdc+FhgqI5lMon6tt9rNeXmnW/
+  c1NaMRdxy999hmRGzUSFjozcCwxpy/LwabxtdXwXgSay4mQ32EDjqR1TixS1+smp
+  8C/NCWgpIfzpHGJsjvmH2wAfKtTTqB9CVKLCWEnCHyCaRVuKkrKjqhYCdmMBqCws
+  JkxfQWC+jBVeG9ZtPhQgZpfhvh+6hMhraUYRQ6XGyvBqEUe+yo6DKIT3MtGE2+CP
+  eX9i9ZWBydWb8/rvmwmX2kkcBbX0hZS1rcR593hGc61JR6lvkGYQ2MYskBveyaxt
+  Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
+  voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
+  -----END CERTIFICATE-----
+date: 2023-01-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -17,20 +81,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.3'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '3'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.3'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '3'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -46,7 +104,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.4'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: covered
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -59,41 +117,31 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 'Use with Net::HTTP to do multipart form postspec. IO values that have
-  #content_type, #original_filename, and #local_path will be posted as a binary file.'
+description:
 email:
-- nick@nicksieger.com
-- samuel.williams@oriontransfer.co.nz
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".travis.yml"
-- ".yardopts"
-- Gemfile
-- History.txt
-- LICENSE
-- Manifest.txt
-- README.md
-- Rakefile
+- changelog.md
 - lib/composite_io.rb
+- lib/multipart/post.rb
+- lib/multipart/post/composite_read_io.rb
+- lib/multipart/post/multipartable.rb
+- lib/multipart/post/parts.rb
+- lib/multipart/post/upload_io.rb
+- lib/multipart/post/version.rb
 - lib/multipart_post.rb
 - lib/multipartable.rb
 - lib/net/http/post/multipart.rb
 - lib/parts.rb
-- multipart-post.gemspec
-- spec/composite_io_spec.rb
-- spec/multibyte.txt
-- spec/net/http/post/multipart_spec.rb
-- spec/parts_spec.rb
-- spec/spec_helper.rb
-homepage: https://github.com/nicksieger/multipart-post
+- license.md
+- readme.md
+homepage: https://github.com/socketry/multipart-post
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -101,20 +149,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.4.1
+signing_key:
 specification_version: 4
 summary: A multipart form post accessory for Net::HTTP.
-test_files:
-- spec/composite_io_spec.rb
-- spec/multibyte.txt
-- spec/net/http/post/multipart_spec.rb
-- spec/parts_spec.rb
-- spec/spec_helper.rb
+test_files: []

data/.gitignore

@@ -1,6 +0,0 @@
-doc
-pkg
-*~
-*.swo
-*.swp
-/Gemfile.lock

data/.rspec

@@ -1,5 +0,0 @@
---color
---format documentation
---backtrace
---require spec_helper
---warnings

data/.travis.yml

@@ -1,20 +0,0 @@
-language: ruby
-cache: bundler
-
-rvm:
-  - 2.0
-  - 2.1
-  - 2.2
-  - 2.3
-  - 2.4
-  - 2.5
-  - 2.6
-  - ruby-head
-  - jruby-head
-  - truffleruby
-
-matrix:
-  allow_failures:
-    - rvm: ruby-head
-    - rvm: jruby-head
-    - rvm: truffleruby

data/.yardopts

@@ -1,6 +0,0 @@
---no-private
-lib/**/*.rb
--
-History.txt
-LICENSE
-README.md

data/Gemfile

@@ -1,6 +0,0 @@
-source 'https://rubygems.org'
-gemspec
-
-group :development, :test do
-  gem 'rake'
-end

data/History.txt

@@ -1,64 +0,0 @@
-<!--
-# @markup rdoc
-# @title CHANGELOG
--->
-
-=== 2.0.0 / 2013-12-21
-
-- Drop Ruby 1.8 compatibility
-- GH #21: Fix FilePart length calculation for Ruby 1.9 when filename contains
-  multibyte characters (hexfet)
-- GH #20: Ensure upload responds to both #content_type and #original_filename
-  (Steven Davidovitz)
-- GH #31: Support setting headers on any part of the request (Socrates Vicente)
-- GH #30: Support array values for params (Gustav Ernberg)
-- GH #32: Fix respond_to? signature (Leo Cassarani)
-- GH #33: Update README to markdown (Jagtesh Chadha)
-- GH #35: Improved handling of array-type parameters (Steffen Grunwald)
-
-=== 1.2.0 / 2013-02-25
-
-- #25: Ruby 2 compatibility (thanks mislav)
-
-=== 1.1.5 / 2012-02-12
-
-- Fix length/bytesize of parts in 1.9 (#7, #14) (Jason Moore)
-- Allow CompositeIO objects to be re-read by rewinding, like other IO
-  objects. (Luke Redpath)
-
-=== 1.1.4 / 2011-11-23
-
-- Non-functional changes in release (switch to Bundler gem tasks)
-
-=== 1.1.3 / 2011-07-25
-
-- More configurable header specification for parts (Gerrit Riessen)
-
-=== 1.1.2 / 2011-05-24
-
-- Fix CRLF file part miscalculation (Johannes Wagener)
-- Fix Epilogue CRLF issue (suggestion by Neil Spring)
-
-=== 1.1.1 / 2011-05-13
-
-- GH# 9: Fixed Ruby 1.9.2 StringIO bug (thanks Alex Koppel)
-
-=== 1.1.0 / 2011-01-11
-
-- API CHANGE: UploadIO.convert! removed in favor of UploadIO.new
-  (Jeff Hodges)
-
-=== 1.0.1 / 2010-04-27
-
-- Doc updates, make gemspec based on more modern Rubygems
-
-=== 1.0 / 2009-02-12
-
-- Many fixes from mlooney, seems to work now. Putting the 0.9 seal of
-  approval on it.
-
-=== 0.1 / 2008-08-12
-
-* 1 major enhancement
-
-  * Birthday!