multipart-post 2.2.3 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a490fccc98196854246d34c31cfb5a02027e6de137056244c64243861c4300d4
-  data.tar.gz: f30b2512b74ff3000ca0f8d6fcc2a0fe323532049a2710870a95b3a719fe8391
+  metadata.gz: f1ecac652cc8dcabe4e9cd2c7f83da1a08170324f114ba8422a414ca22e44bfb
+  data.tar.gz: c486ff96370ec89f3a92fdf24780f84228a5f50e227d7e1badb7f020b8b0c8f7
 SHA512:
-  metadata.gz: 020ed9e1c057b7a71278c7fa3b3449084d96d3088165e8e1954175b5df28a73528fda7740a8598ed16de3ed111dd5b693d0363dced16f66d2fe48edbcdd624d0
-  data.tar.gz: dad4720dca5d10ff7b5806931a4ce91c2858217e4212b5d4c9355383945b4750b17e19d7290d521287f402b23108ddfb2d351215332f96579bec13156f219d71
+  metadata.gz: bd062538fab61cd651ba6624c4b78be77d9c5c072843cb104b4b3538d9d5acbb17501716ec61dc1e6095c86098a76f2f6021304c8142638166993a2162882eaf
+  data.tar.gz: fdb4e0833f1ee4b28e0d7d2322e1ca515ae8d8a598dfe3f6ae6986789520f593ae564174e969755be16f47e630bd44b80b95b2a145351dfdf9b89b109dd8be98

data/changelog.md

@@ -0,0 +1,14 @@
+# CHANGELOG
+
+## Unreleased
+
+### Added
+
+- Add the ability to set Content-ID header for ParamPart [#62](https://github.com/socketry/multipart-post/pull/62)
+- Allow mixed key types for parts headers [#79](https://github.com/socketry/multipart-post/pull/79)
+
+### Changed
+
+- Refactor `Parts` into a `Multipart::Post` namespace  [#65](https://github.com/socketry/multipart-post/pull/65)
+- Use mutable strings where needed [#70](https://github.com/socketry/multipart-post/pull/70)
+- Use `frozen_string_literal` everywhere [#78](https://github.com/socketry/multipart-post/pull/78)

data/lib/composite_io.rb

@@ -1,2 +1,17 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2006-2013, by Nick Sieger.
+# Copyright, 2010, by Tohru Hashimoto.
+# Copyright, 2011, by Jeff Hodges.
+# Copyright, 2011, by Alex Koppel.
+# Copyright, 2011, by Christine Yen.
+# Copyright, 2011, by Gerrit Riessen.
+# Copyright, 2011, by Luke Redpath.
+# Copyright, 2013, by Mislav Marohnić.
+# Copyright, 2013, by Leo Cassarani.
+# Copyright, 2019, by Olle Jonsson.
+# Copyright, 2022-2024, by Samuel Williams.
+
 warn "Top level ::CompositeIO is deprecated, require 'multipart/post' and use `Multipart::Post::CompositeReadIO` instead!"
 require_relative 'multipart/post'

data/lib/multipart/post/composite_read_io.rb

@@ -1,24 +1,19 @@
 # frozen_string_literal: true
 
-# Copyright, 2007-2013, by Nick Sieger.
-# 
-# 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.
+# Released under the MIT License.
+# Copyright, 2006-2013, by Nick Sieger.
+# Copyright, 2010, by Tohru Hashimoto.
+# Copyright, 2011, by Jeff Hodges.
+# Copyright, 2011, by Alex Koppel.
+# Copyright, 2011, by Christine Yen.
+# Copyright, 2011, by Gerrit Riessen.
+# Copyright, 2011, by Luke Redpath.
+# Copyright, 2013, by Mislav Marohnić.
+# Copyright, 2013, by Leo Cassarani.
+# Copyright, 2019, by Olle Jonsson.
+# Copyright, 2019, by Patrick Davey.
+# Copyright, 2021, by Lewis Cowles.
+# Copyright, 2021-2024, by Samuel Williams.
 
 module Multipart
   module Post
@@ -38,8 +33,26 @@ module Multipart
         @index = 0
       end
 
+      # Close all the underyling IOs.
+      def close
+        @ios.each do |io|
+          io.close if io.respond_to?(:close)
+        end
+
+        @ios = nil
+        @index = 0
+      end
+
+      def closed?
+        @ios.nil?
+      end
+
       # Read from IOs in order until `length` bytes have been received.
       def read(length = nil, outbuf = nil)
+        if @ios.nil?
+          raise IOError, "CompositeReadIO is closed!"
+        end
+
         got_result = false
         outbuf = outbuf ? outbuf.replace("") : String.new
 

data/lib/multipart/post/multipartable.rb

@@ -1,24 +1,17 @@
 # frozen_string_literal: true
 
-# Copyright, 2007-2013, by Nick Sieger.
-# 
-# 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.
+# Released under the MIT License.
+# Copyright, 2008, by McClain Looney.
+# Copyright, 2008-2013, by Nick Sieger.
+# Copyright, 2011, by Gerrit Riessen.
+# Copyright, 2013, by Vincent Pellé.
+# Copyright, 2013, by Gustav Ernberg.
+# Copyright, 2013, by Socrates Vicente.
+# Copyright, 2013, by Steffen Grunwald.
+# Copyright, 2019, by Olle Jonsson.
+# Copyright, 2019-2024, by Samuel Williams.
+# Copyright, 2019, by Patrick Davey.
+# Copyright, 2022, by Jason York.
 
 require_relative 'parts'
 require_relative 'composite_read_io'
@@ -69,18 +62,9 @@ module Multipart
 
       private
 
-      if RUBY_VERSION >= "2.5.0"
-        def symbolize_keys(hash)
-          hash.transform_keys(&:to_sym)
-        end
-      else
-        def symbolize_keys(hash)
-          hash.map{|key,value| [key.to_sym, value]}.to_h
-        end
+      def symbolize_keys(hash)
+        hash.transform_keys(&:to_sym)
       end
     end
   end
 end
-
-Multipartable = Multipart::Post::Multipartable
-Object.deprecate_constant :Multipartable

data/lib/multipart/post/parts.rb

@@ -1,24 +1,23 @@
 # frozen_string_literal: true
 
-# Copyright, 2007-2013, by Nick Sieger.
-# 
-# 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.
+# 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-2021, by Olle Jonsson.
+# Copyright, 2019, by Ethan Turkeltaub.
+# Copyright, 2019, by Patrick Davey.
+# Copyright, 2021-2024, by Samuel Williams.
 
 require 'stringio'
 
@@ -147,6 +146,3 @@ module Multipart
     end
   end
 end
-
-Parts = Multipart::Post::Parts
-Object.deprecate_constant :Parts

data/lib/multipart/post/upload_io.rb

@@ -1,24 +1,7 @@
 # frozen_string_literal: true
 
-# Copyright, 2007-2013, by Nick Sieger.
-# 
-# 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.
+# Released under the MIT License.
+# Copyright, 2022-2024, by Samuel Williams.
 
 module Multipart
   module Post

data/lib/multipart/post/version.rb

@@ -1,27 +1,11 @@
 # frozen_string_literal: true
 
-# Copyright, 2007-2013, by Nick Sieger.
-# 
-# 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.
+# Released under the MIT License.
+# Copyright, 2019, by Patrick Davey.
+# Copyright, 2021-2023, by Samuel Williams.
 
 module Multipart
   module Post
-    VERSION = "2.2.3"
+    VERSION = "2.4.0"
   end
 end

data/lib/multipart/post.rb

@@ -1,24 +1,8 @@
 # frozen_string_literal: true
 
-# Copyright, 2007-2013, by Nick Sieger.
-# 
-# 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.
+# Released under the MIT License.
+# Copyright, 2019, by Patrick Davey.
+# Copyright, 2021-2024, by Samuel Williams.
 
 require_relative 'post/multipartable'
 require_relative 'post/upload_io'

data/lib/multipart_post.rb

@@ -1,3 +1,11 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2009-2013, by Nick Sieger.
+# Copyright, 2019-2024, by Samuel Williams.
+
 warn "Top level ::MultipartPost is deprecated, require 'multipart/post' and use `Multipart::Post` instead!"
 require_relative 'multipart/post'
+
 MultipartPost = Multipart::Post
+Object.deprecate_constant :MultipartPost

data/lib/multipartable.rb

@@ -1,2 +1,19 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2008, by McClain Looney.
+# Copyright, 2008-2013, by Nick Sieger.
+# Copyright, 2011, by Gerrit Riessen.
+# Copyright, 2013, by Vincent Pellé.
+# Copyright, 2013, by Gustav Ernberg.
+# Copyright, 2013, by Socrates Vicente.
+# Copyright, 2013, by Steffen Grunwald.
+# Copyright, 2019, by Olle Jonsson.
+# Copyright, 2019-2024, by Samuel Williams.
+# Copyright, 2019, by Patrick Davey.
+
 warn "Top level ::Multipartable is deprecated, require 'multipart/post' and use `Multipart::Post::Multipartable` instead!"
 require_relative 'multipart/post'
+
+Multipartable = Multipart::Post::Multipartable
+Object.deprecate_constant :Multipartable

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

@@ -1,24 +1,11 @@
 # frozen_string_literal: true
 
-# Copyright, 2007-2013, by Nick Sieger.
-# 
-# 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.
+# Released under the MIT License.
+# Copyright, 2006-2012, by Nick Sieger.
+# Copyright, 2008, by McClain Looney.
+# Copyright, 2019, by Olle Jonsson.
+# Copyright, 2019, by Patrick Davey.
+# Copyright, 2021-2024, by Samuel Williams.
 
 require 'net/http'
 

data/lib/parts.rb

@@ -1,2 +1,25 @@
+# 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-2024, 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,58 @@
+# 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-2024, 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.  
+Copyright, 2024, by Masato Nakamura.  
+
+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,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: multipart-post
 version: !ruby/object:Gem::Version
-  version: 2.2.3
+  version: 2.4.0
 platform: ruby
 authors:
 - Nick Sieger
@@ -16,9 +16,8 @@ authors:
 - Ethan Turkeltaub
 - Jagtesh Chadha
 - Jason York
-- Nick
-- VincWebwag
-- hasimo
+- Tohru Hashimoto
+- Vincent Pellé
 - hexfet
 - Christine Yen
 - David Moles
@@ -35,78 +34,55 @@ authors:
 - Leo Cassarani
 - Lonre Wang
 - Luke Redpath
+- Masato Nakamura
 - Matt Colyer
 - Mislav Marohnić
+- Peter Goldstein
 - Socrates Vicente
 - Steffen Grunwald
+- Takuya Noguchi
 - Tim Barkley
 autorequire:
 bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
-  MIIEhDCCAuygAwIBAgIBATANBgkqhkiG9w0BAQsFADA3MTUwMwYDVQQDDCxzYW11
-  ZWwud2lsbGlhbXMvREM9b3Jpb250cmFuc2Zlci9EQz1jby9EQz1uejAeFw0yMTA4
-  MTYwNjMzNDRaFw0yMjA4MTYwNjMzNDRaMDcxNTAzBgNVBAMMLHNhbXVlbC53aWxs
-  aWFtcy9EQz1vcmlvbnRyYW5zZmVyL0RDPWNvL0RDPW56MIIBojANBgkqhkiG9w0B
-  AQEFAAOCAY8AMIIBigKCAYEAyXLSS/cw+fXJ5e7hi+U/TeChPWeYdwJojDsFY1xr
-  xvtqbTTL8gbLHz5LW3QD2nfwCv3qTlw0qI3Ie7a9VMJMbSvgVEGEfQirqIgJXWMj
-  eNMDgKsMJtC7u/43abRKx7TCURW3iWyR19NRngsJJmaR51yGGGm2Kfsr+JtKKLtL
-  L188Wm3f13KAx7QJU8qyuBnj1/gWem076hzdA7xi1DbrZrch9GCRz62xymJlrJHn
-  9iZEZ7AxrS7vokhMlzSr/XMUihx/8aFKtk+tMLClqxZSmBWIErWdicCGTULXCBNb
-  E/mljo4zEVKhlTWpJklMIhr55ZRrSarKFuW7en0+tpJrfsYiAmXMJNi4XAYJH7uL
-  rgJuJwSaa/dMz+VmUoo7VKtSfCoOI+6v5/z0sK3oT6sG6ZwyI47DBq2XqNC6tnAj
-  w+XmCywiTQrFzMMAvcA7rPI4F0nU1rZId51rOvvfxaONp+wgTi4P8owZLw0/j0m4
-  8C20DYi6EYx4AHDXiLpElWh3AgMBAAGjgZowgZcwCQYDVR0TBAIwADALBgNVHQ8E
-  BAMCBLAwHQYDVR0OBBYEFB6ZaeWKxQjGTI+pmz7cKRmMIywwMC4GA1UdEQQnMCWB
-  I3NhbXVlbC53aWxsaWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MC4GA1UdEgQnMCWB
-  I3NhbXVlbC53aWxsaWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MA0GCSqGSIb3DQEB
-  CwUAA4IBgQBVoM+pu3dpdUhZM1w051iw5GfiqclAr1Psypf16Tiod/ho//4oAu6T
-  9fj3DPX/acWV9P/FScvqo4Qgv6g4VWO5ZU7z2JmPoTXZtYMunRAmQPFL/gSUc6aK
-  vszMHIyhtyzRc6DnfW2AiVOjMBjaYv8xXZc9bduniRVPrLR4J7ozmGLh4o4uJp7w
-  x9KCFaR8Lvn/r0oJWJOqb/DMAYI83YeN2Dlt3jpwrsmsONrtC5S3gOUle5afSGos
-  bYt5ocnEpKSomR9ZtnCGljds/aeO1Xgpn2r9HHcjwnH346iNrnHmMlC7BtHUFPDg
-  Ts92S47PTOXzwPBDsrFiq3VLbRjHSwf8rpqybQBH9MfzxGGxTaETQYOd6b4e4Ag6
-  y92abGna0bmIEb4+Tx9rQ10Uijh1POzvr/VTH4bbIPy9FbKrRsIQ24qDbNJRtOpE
-  RAOsIl+HOBTb252nx1kIRN5hqQx272AJCbCjKx8egcUQKffFVVCI0nye09v5CK+a
-  HiLJ8VOFx6w=
+  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: 2022-06-10 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  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'
-- !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'
+date: 2024-02-07 00:00:00.000000000 Z
+dependencies: []
 description:
 email:
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- changelog.md
 - lib/composite_io.rb
 - lib/multipart/post.rb
 - lib/multipart/post/composite_read_io.rb
@@ -118,6 +94,8 @@ files:
 - lib/multipartable.rb
 - lib/net/http/post/multipart.rb
 - lib/parts.rb
+- license.md
+- readme.md
 homepage: https://github.com/socketry/multipart-post
 licenses:
 - MIT
@@ -130,14 +108,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: A multipart form post accessory for Net::HTTP.