multipart-post 2.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e64b8bb7510028e6d5c5ca9626ff5448a12ee4e393938a69edd9eddfedf04e70
+  data.tar.gz: dddcaa65fa823b59d0d3a025c8ad1e88eae0e2fe976469c9b69931a0bc66af6a
+SHA512:
+  metadata.gz: a046600778502bf34933ca1f4b2abd7ce0c7e8b4911ab9abc2bc74316cd42ce2f9167c6a40254ffb290ede586de81500a03500c09bfcb15ed96c0495bed19964
+  data.tar.gz: 422aa7086f923b29e545cba81cd1caca270ed4e86f0d29a50a8c61bc111ad30d546b353ef3db5eb52f63f697d03a5671e759f3119c8c200807184c9cfe3c1f58

data/.gitignore

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

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,20 @@
+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

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

data/Gemfile

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

data/History.txt

@@ -0,0 +1,64 @@
+<!--
+# @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!

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2007-2013 Nick Sieger nick@nicksieger.com
+Copyright, 2017, by Samuel G. D. Williams.
+
+MIT license.
+
+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/Manifest.txt

@@ -0,0 +1,9 @@
+lib/composite_io.rb
+lib/multipartable.rb
+lib/parts.rb
+lib/net/http/post/multipart.rb
+Manifest.txt
+Rakefile
+README.txt
+test/test_composite_io.rb
+test/net/http/post/test_multipart.rb

data/README.md

@@ -0,0 +1,127 @@
+# Multipart::Post
+
+Adds a streamy multipart form post capability to `Net::HTTP`. Also supports other
+methods besides `POST`.
+
+[![Build Status](https://secure.travis-ci.org/socketry/multipart-post.svg)](http://travis-ci.org/socketry/multipart-post)
+
+## 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
+
+    gem install multipart-post
+
+or in your Gemfile
+
+    gem '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
+```
+
+### 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)
+```
+
+## License
+
+Released under the MIT license.
+
+Copyright (c) 2007-2013 Nick Sieger <nick@nicksieger.com>  
+Copyright, 2017, by [Samuel G. D. Williams](http://www.codeotaku.com/samuel-williams).
+
+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/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:test)
+
+task :default => :test

data/lib/composite_io.rb

@@ -0,0 +1,108 @@
+#--
+# Copyright (c) 2007-2012 Nick Sieger.
+# See the file README.txt included with the distribution for
+# software license details.
+#++
+
+# Concatenate together multiple IO objects into a single, composite IO object
+# for purposes of reading as a single stream.
+#
+# @example
+#     crio = CompositeReadIO.new(StringIO.new('one'),
+#                                StringIO.new('two'),
+#                                StringIO.new('three'))
+#     puts crio.read # => "onetwothree"
+class CompositeReadIO
+  # Create a new composite-read IO from the arguments, all of which should
+  # respond to #read in a manner consistent with IO.
+  def initialize(*ios)
+    @ios = ios.flatten
+    @index = 0
+  end
+
+  # Read from IOs in order until `length` bytes have been received.
+  def read(length = nil, outbuf = nil)
+    got_result = false
+    outbuf = outbuf ? outbuf.replace("") : ""
+
+    while io = current_io
+      if result = io.read(length)
+        got_result ||= !result.nil?
+        result.force_encoding("BINARY") if result.respond_to?(:force_encoding)
+        outbuf << result
+        length -= result.length if length
+        break if length == 0
+      end
+      advance_io
+    end
+    (!got_result && length) ? nil : outbuf
+  end
+
+  def rewind
+    @ios.each { |io| io.rewind }
+    @index = 0
+  end
+
+  private
+
+  def current_io
+    @ios[@index]
+  end
+
+  def advance_io
+    @index += 1
+  end
+end
+
+# Convenience methods for dealing with files and IO that are to be uploaded.
+class UploadIO
+  attr_reader :content_type, :original_filename, :local_path, :io, :opts
+
+  # Create an upload IO suitable for including in the params hash of a
+  # Net::HTTP::Post::Multipart.
+  #
+  # Can take two forms. The first accepts a filename and content type, and
+  # opens the file for reading (to be closed by finalizer).
+  #
+  # The second accepts an already-open IO, but also requires a third argument,
+  # the filename from which it was opened (particularly useful/recommended if
+  # uploading directly from a form in a framework, which often save the file to
+  # an arbitrarily named RackMultipart file in /tmp).
+  #
+  # @example
+  #     UploadIO.new("file.txt", "text/plain")
+  #     UploadIO.new(file_io, "text/plain", "file.txt")
+  def initialize(filename_or_io, content_type, filename = nil, opts = {})
+    io = filename_or_io
+    local_path = ""
+    if io.respond_to? :read
+      # in Ruby 1.9.2, StringIOs no longer respond to path
+      # (since they respond to :length, so we don't need their local path, see parts.rb:41)
+      local_path = filename_or_io.respond_to?(:path) ? filename_or_io.path : "local.path"
+    else
+      io = File.open(filename_or_io)
+      local_path = filename_or_io
+    end
+    filename ||= local_path
+
+    @content_type = content_type
+    @original_filename = File.basename(filename)
+    @local_path = local_path
+    @io = io
+    @opts = opts
+  end
+
+  def self.convert!(io, content_type, original_filename, local_path)
+    raise ArgumentError, "convert! has been removed. You must now wrap IOs " \
+                         "using:\nUploadIO.new(filename_or_io, content_type, " \
+                         "filename=nil)\nPlease update your code."
+  end
+
+  def method_missing(*args)
+    @io.send(*args)
+  end
+
+  def respond_to?(meth, include_all = false)
+    @io.respond_to?(meth, include_all) || super(meth, include_all)
+  end
+end

data/lib/multipart_post.rb

@@ -0,0 +1,9 @@
+#--
+# Copyright (c) 2007-2013 Nick Sieger.
+# See the file README.txt included with the distribution for
+# software license details.
+#++
+
+module MultipartPost
+  VERSION = "2.1.1"
+end

data/lib/multipartable.rb

@@ -0,0 +1,48 @@
+#--
+# Copyright (c) 2007-2013 Nick Sieger.
+# See the file README.txt included with the distribution for
+# software license details.
+#++
+
+require 'parts'
+require 'securerandom'
+
+module Multipartable
+  def self.secure_boundary
+    # https://tools.ietf.org/html/rfc7230
+    #      tchar          = "!" / "#" / "$" / "%" / "&" / "'" / "*"
+    #                     / "+" / "-" / "." / "^" / "_" / "`" / "|" / "~"
+    #                     / DIGIT / ALPHA
+    
+    # https://tools.ietf.org/html/rfc2046
+    #      bcharsnospace := DIGIT / ALPHA / "'" / "(" / ")" /
+    #                       "+" / "_" / "," / "-" / "." /
+    #                       "/" / ":" / "=" / "?"
+    
+    "--#{SecureRandom.uuid}"
+  end
+  
+  def initialize(path, params, headers={}, boundary = Multipartable.secure_boundary)
+    headers = headers.clone # don't want to modify the original variable
+    parts_headers = headers.delete(:parts) || {}
+    super(path, headers)
+    parts = params.map do |k,v|
+      case v
+      when Array
+        v.map {|item| Parts::Part.new(boundary, k, item, parts_headers[k]) }
+      else
+        Parts::Part.new(boundary, k, v, parts_headers[k])
+      end
+    end.flatten
+    parts << Parts::EpiloguePart.new(boundary)
+    ios = parts.map {|p| p.to_io }
+    self.set_content_type(headers["Content-Type"] || "multipart/form-data",
+                          { "boundary" => boundary })
+    self.content_length = parts.inject(0) {|sum,i| sum + i.length }
+    self.body_stream = CompositeReadIO.new(*ios)
+    
+    @boundary = boundary
+  end
+  
+  attr :boundary
+end

data/lib/net/http/post/multipart.rb

@@ -0,0 +1,28 @@
+#--
+# Copyright (c) 2007-2012 Nick Sieger.
+# See the file README.txt included with the distribution for
+# software license details.
+#++
+
+require 'net/http'
+require 'stringio'
+require 'cgi'
+require 'composite_io'
+require 'multipartable'
+require 'parts'
+
+module Net
+  class HTTP
+    class Put
+      class Multipart < Put
+        include Multipartable
+      end
+    end
+
+    class Post
+      class Multipart < Post
+        include Multipartable
+      end
+    end
+  end
+end

data/lib/parts.rb

@@ -0,0 +1,126 @@
+#--
+# 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

data/multipart-post.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "multipart_post"
+
+Gem::Specification.new do |spec|
+  spec.name        = "multipart-post"
+  spec.version     = MultipartPost::VERSION
+  spec.authors     = ["Nick Sieger", "Samuel Williams"]
+  spec.email       = ["nick@nicksieger.com", "samuel.williams@oriontransfer.co.nz"]
+  spec.homepage    = "https://github.com/nicksieger/multipart-post"
+  spec.summary     = %q{A multipart form post accessory for Net::HTTP.}
+  spec.license     = "MIT"
+  spec.description = %q{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.}
+  
+  spec.files         = `git ls-files`.split("\n")
+  spec.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  spec.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+  
+  spec.add_development_dependency 'bundler', ['>= 1.3', '< 3']
+  spec.add_development_dependency 'rspec', '~> 3.4'
+  spec.add_development_dependency 'rake'
+end

data/spec/composite_io_spec.rb

@@ -0,0 +1,138 @@
+# Copyright, 2012, by Nick Sieger.
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.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.
+
+require 'composite_io'
+require 'stringio'
+require 'timeout'
+
+RSpec.shared_context "composite io" do
+  it "test_full_read_from_several_ios" do
+    expect(subject.read).to be == 'the quick brown fox'
+  end
+  
+  it "test_partial_read" do
+    expect(subject.read(9)).to be == 'the quick'
+  end
+
+  it "test_partial_read_to_boundary" do
+    expect(subject.read(10)).to be == 'the quick '
+  end
+
+  it "test_read_with_size_larger_than_available" do
+    expect(subject.read(32)).to be == 'the quick brown fox'
+  end
+  
+  it "test_read_into_buffer" do
+    buf = ''
+    subject.read(nil, buf)
+    expect(buf).to be == 'the quick brown fox'
+  end
+
+  it "test_multiple_reads" do
+    expect(subject.read(4)).to be == 'the '
+    expect(subject.read(4)).to be == 'quic'
+    expect(subject.read(4)).to be == 'k br'
+    expect(subject.read(4)).to be == 'own '
+    expect(subject.read(4)).to be == 'fox'
+  end
+
+  it "test_read_after_end" do
+    subject.read
+    expect(subject.read).to be == ""
+  end
+
+  it "test_read_after_end_with_amount" do
+    subject.read(32)
+    expect(subject.read(32)).to be_nil
+  end
+  
+  it "test_second_full_read_after_rewinding" do
+    subject.read
+    subject.rewind
+    expect(subject.read).to be == 'the quick brown fox'
+  end
+  
+  # Was apparently broken on JRuby due to http://jira.codehaus.org/browse/JRUBY-7109
+  it "test_compatible_with_copy_stream" do
+    target_io = StringIO.new
+    Timeout.timeout(1) do # Not sure why we need this in the spec?
+      IO.copy_stream(subject, target_io)
+    end
+    expect(target_io.string).to be == "the quick brown fox"
+  end
+end
+
+RSpec.describe CompositeReadIO do
+  describe "generic io" do
+    subject {StringIO.new('the quick brown fox')}
+  
+    include_context "composite io"
+  end
+  
+  describe "composite io" do
+    subject {CompositeReadIO.new(StringIO.new('the '), StringIO.new('quick '), StringIO.new('brown '), StringIO.new('fox'))}
+  
+    include_context "composite io"
+  end
+  
+  describe "nested composite io" do
+    subject {CompositeReadIO.new(CompositeReadIO.new(StringIO.new('the '), StringIO.new('quick ')), StringIO.new('brown '), StringIO.new('fox'))}
+  
+    include_context "composite io"
+  end
+  
+  describe "unicode composite io" do
+    let(:utf8_io) {File.open(File.dirname(__FILE__)+'/multibyte.txt')}
+    let(:binary_io) {StringIO.new("\x86")}
+    
+    subject {CompositeReadIO.new(binary_io, utf8_io)}
+    
+    it "test_read_from_multibyte" do
+      expect(subject.read).to be == "\x86\xE3\x83\x95\xE3\x82\xA1\xE3\x82\xA4\xE3\x83\xAB\n".b
+    end
+  end
+  
+  it "test_convert_error" do
+    expect do
+      UploadIO.convert!('tmp.txt', 'text/plain', 'tmp.txt', 'tmp.txt')
+    end.to raise_error(ArgumentError, /convert! has been removed/)
+  end
+  
+  it "test_empty" do
+    expect(subject.read).to be == ""
+  end
+
+  it "test_empty_limited" do
+    expect(subject.read(1)).to be_nil
+  end
+
+  it "test_empty_parts" do
+    io = CompositeReadIO.new(StringIO.new, StringIO.new('the '), StringIO.new, StringIO.new('quick'))
+    expect(io.read(3)).to be == "the"
+    expect(io.read(3)).to be == " qu"
+    expect(io.read(3)).to be == "ick"
+  end
+
+  it "test_all_empty_parts" do
+    io = CompositeReadIO.new(StringIO.new, StringIO.new)
+    expect(io.read(1)).to be_nil
+  end
+end

data/spec/multibyte.txt

@@ -0,0 +1 @@
+ファイル

data/spec/net/http/post/multipart_spec.rb

@@ -0,0 +1,123 @@
+#--
+# Copyright (c) 2007-2013 Nick Sieger.
+# See the file README.txt included with the distribution for
+# software license details.
+#++
+
+require 'net/http/post/multipart'
+
+RSpec.shared_context "net http multipart" do
+  let(:temp_file) {"temp.txt"}
+  let(:http_post) do
+    Struct.new("HTTPPost", :content_length, :body_stream, :content_type) do
+      def set_content_type(type, params = {})
+        self.content_type = type + params.map{|k,v|"; #{k}=#{v}"}.join('')
+      end
+    end
+  end
+  
+  after(:each) do
+    File.delete(temp_file) rescue nil
+  end
+  
+  def assert_results(post)
+    expect(post.content_length).to be > 0
+    expect(post.body_stream).to_not be_nil
+    
+    expect(post['content-type']).to be == "multipart/form-data; boundary=#{post.boundary}"
+    
+    body = post.body_stream.read
+    boundary_regex = Regexp.quote(post.boundary)
+    
+    expect(body).to be =~ /1234567890/
+    
+    # ensure there is at least one boundary
+    expect(body).to be =~ /^--#{boundary_regex}\r\n/
+    
+    # ensure there is an epilogue
+    expect(body).to be =~ /^--#{boundary_regex}--\r\n/
+    expect(body).to be =~ /text\/plain/
+    
+    if (body =~ /multivalueParam/)
+      expect(body.scan(/^.*multivalueParam.*$/).size).to be == 2
+    end
+  end
+
+  def assert_additional_headers_added(post, parts_headers)
+    post.body_stream.rewind
+    body = post.body_stream.read
+    parts_headers.each do |part, headers|
+      headers.each do |k,v|
+        expect(body).to be =~ /#{k}: #{v}/
+      end
+    end
+  end
+end
+
+RSpec.describe Net::HTTP::Post::Multipart do
+  include_context "net http multipart"
+  
+  it "test_form_multipart_body" do
+    File.open(TEMP_FILE, "w") {|f| f << "1234567890"}
+    @io = File.open(TEMP_FILE)
+    @io = UploadIO.new @io, "text/plain", TEMP_FILE
+    assert_results Net::HTTP::Post::Multipart.new("/foo/bar", :foo => 'bar', :file => @io)
+  end
+
+  it "test_form_multipart_body_with_stringio" do
+    @io = StringIO.new("1234567890")
+    @io = UploadIO.new @io, "text/plain", TEMP_FILE
+    assert_results Net::HTTP::Post::Multipart.new("/foo/bar", :foo => 'bar', :file => @io)
+  end
+
+  it "test_form_multiparty_body_with_parts_headers" do
+    @io = StringIO.new("1234567890")
+    @io = UploadIO.new @io, "text/plain", TEMP_FILE
+    parts = { :text => 'bar', :file => @io }
+    headers = {
+      :parts => {
+        :text => { "Content-Type" => "part/type" },
+        :file => { "Content-Transfer-Encoding" => "part-encoding" }
+      }
+    }
+
+    request = Net::HTTP::Post::Multipart.new("/foo/bar", parts, headers)
+    assert_results request
+    assert_additional_headers_added(request, headers[:parts])
+  end
+
+  it "test_form_multipart_body_with_array_value" do
+    File.open(TEMP_FILE, "w") {|f| f << "1234567890"}
+    @io = File.open(TEMP_FILE)
+    @io = UploadIO.new @io, "text/plain", TEMP_FILE
+    params = {:foo => ['bar', 'quux'], :file => @io}
+    headers = { :parts => {
+        :foo => { "Content-Type" => "application/json; charset=UTF-8" } } }
+    post = Net::HTTP::Post::Multipart.new("/foo/bar", params, headers)
+    
+    expect(post.content_length).to be > 0
+    expect(post.body_stream).to_not be_nil
+
+    body = post.body_stream.read
+    expect(body.lines.grep(/name="foo"/).length).to be == 2
+    expect(body).to be =~ /Content-Type: application\/json; charset=UTF-8/
+  end
+
+  it "test_form_multipart_body_with_arrayparam" do
+    File.open(TEMP_FILE, "w") {|f| f << "1234567890"}
+    @io = File.open(TEMP_FILE)
+    @io = UploadIO.new @io, "text/plain", TEMP_FILE
+    assert_results Net::HTTP::Post::Multipart.new("/foo/bar", :multivalueParam => ['bar','bah'], :file => @io)
+  end
+end
+
+RSpec.describe Net::HTTP::Put::Multipart do
+  include_context "net http multipart"
+  
+  it "test_form_multipart_body_put" do
+    File.open(TEMP_FILE, "w") {|f| f << "1234567890"}
+    @io = File.open(TEMP_FILE)
+    @io = UploadIO.new @io, "text/plain", TEMP_FILE
+    assert_results Net::HTTP::Put::Multipart.new("/foo/bar", :foo => 'bar', :file => @io)
+  end
+end

data/spec/parts_spec.rb

@@ -0,0 +1,102 @@
+# Copyright, 2012, by Nick Sieger.
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.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.
+
+require 'parts'
+require 'stringio'
+require 'composite_io'
+require 'tempfile'
+
+MULTIBYTE = File.dirname(__FILE__)+'/multibyte.txt'
+TEMP_FILE = "temp.txt"
+
+module AssertPartLength
+  def assert_part_length(part)
+    bytes = part.to_io.read
+    bytesize = bytes.respond_to?(:bytesize) ? bytes.bytesize : bytes.length
+    expect(bytesize).to be == part.length
+  end
+end
+
+RSpec.describe Parts do
+  let(:string_with_content_type) do
+    Class.new(String) do
+      def content_type; 'application/data'; end
+    end
+  end
+
+  it "test_file_with_upload_io" do
+    expect(Parts::Part.file?(UploadIO.new(__FILE__, "text/plain"))).to be true
+  end
+
+  it "test_file_with_modified_string" do
+    expect(Parts::Part.file?(string_with_content_type.new("Hello"))).to be false
+  end
+
+  it "test_new_with_modified_string" do
+    expect(Parts::Part.new("boundary", "multibyte", string_with_content_type.new("Hello"))).to be_kind_of(Parts::ParamPart)
+  end
+end
+
+RSpec.describe Parts::FilePart do
+  include AssertPartLength
+
+  before(:each) do
+    File.open(TEMP_FILE, "w") {|f| f << "1234567890"}
+    io =  UploadIO.new(TEMP_FILE, "text/plain")
+    @part = Parts::FilePart.new("boundary", "afile", io)
+  end
+
+  after(:each) do
+    File.delete(TEMP_FILE) rescue nil
+  end
+
+  it "test_correct_length" do
+    assert_part_length @part
+  end
+
+  it "test_multibyte_file_length" do
+    assert_part_length Parts::FilePart.new("boundary", "multibyte", UploadIO.new(MULTIBYTE, "text/plain"))
+  end
+
+  it "test_multibyte_filename" do
+    name = File.read(MULTIBYTE, 300)
+    file = Tempfile.new(name.respond_to?(:force_encoding) ? name.force_encoding("UTF-8") : name)
+    assert_part_length Parts::FilePart.new("boundary", "multibyte", UploadIO.new(file, "text/plain"))
+    file.close
+  end
+
+   it "test_force_content_type_header" do
+    part = Parts::FilePart.new("boundary", "afile", UploadIO.new(TEMP_FILE, "text/plain"), { "Content-Type" => "application/pdf" })
+    expect(part.to_io.read).to match(/Content-Type: application\/pdf/)
+  end
+end
+
+RSpec.describe Parts::ParamPart do
+  include AssertPartLength
+
+  before(:each) do
+    @part = Parts::ParamPart.new("boundary", "multibyte", File.read(MULTIBYTE))
+  end
+
+  it "test_correct_length" do
+    assert_part_length @part
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,29 @@
+
+if ENV['COVERAGE']
+	begin
+		require 'simplecov'
+		
+		SimpleCov.start do
+			add_filter "/spec/"
+		end
+		
+		if ENV['TRAVIS']
+			require 'coveralls'
+			Coveralls.wear!
+		end
+	rescue LoadError
+		warn "Could not load simplecov: #{$!}"
+	end
+end
+
+require "bundler/setup"
+require "multipart_post"
+
+RSpec.configure do |config|
+	# Enable flags like --only-failures and --next-failure
+	config.example_status_persistence_file_path = ".rspec_status"
+
+	config.expect_with :rspec do |c|
+		c.syntax = :expect
+	end
+end

metadata

@@ -0,0 +1,120 @@
+--- !ruby/object:Gem::Specification
+name: multipart-post
+version: !ruby/object:Gem::Version
+  version: 2.1.1
+platform: ruby
+authors:
+- Nick Sieger
+- Samuel Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-05-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.3'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.3'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !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.'
+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
+- lib/composite_io.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
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+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