multipart-post 2.1.1 → 2.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e64b8bb7510028e6d5c5ca9626ff5448a12ee4e393938a69edd9eddfedf04e70
-  data.tar.gz: dddcaa65fa823b59d0d3a025c8ad1e88eae0e2fe976469c9b69931a0bc66af6a
+  metadata.gz: a490fccc98196854246d34c31cfb5a02027e6de137056244c64243861c4300d4
+  data.tar.gz: f30b2512b74ff3000ca0f8d6fcc2a0fe323532049a2710870a95b3a719fe8391
 SHA512:
-  metadata.gz: a046600778502bf34933ca1f4b2abd7ce0c7e8b4911ab9abc2bc74316cd42ce2f9167c6a40254ffb290ede586de81500a03500c09bfcb15ed96c0495bed19964
-  data.tar.gz: 422aa7086f923b29e545cba81cd1caca270ed4e86f0d29a50a8c61bc111ad30d546b353ef3db5eb52f63f697d03a5671e759f3119c8c200807184c9cfe3c1f58
+  metadata.gz: 020ed9e1c057b7a71278c7fa3b3449084d96d3088165e8e1954175b5df28a73528fda7740a8598ed16de3ed111dd5b693d0363dced16f66d2fe48edbcdd624d0
+  data.tar.gz: dad4720dca5d10ff7b5806931a4ce91c2858217e4212b5d4c9355383945b4750b17e19d7290d521287f402b23108ddfb2d351215332f96579bec13156f219d71

data/lib/composite_io.rb

@@ -1,108 +1,2 @@
-#--
-# 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
+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

@@ -0,0 +1,78 @@
+# 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.
+
+module Multipart
+  module Post
+    # 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("") : String.new
+
+        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
+  end
+end
+
+CompositeIO = Multipart::Post::CompositeReadIO
+Object.deprecate_constant :CompositeIO

data/lib/multipart/post/multipartable.rb

@@ -0,0 +1,86 @@
+# 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.
+
+require_relative 'parts'
+require_relative 'composite_read_io'
+
+require 'securerandom'
+
+module Multipart
+  module Post
+    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 = symbolize_keys(headers.delete(:parts) || {})
+
+        super(path, headers)
+        parts = symbolize_keys(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
+
+      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
+      end
+    end
+  end
+end
+
+Multipartable = Multipart::Post::Multipartable
+Object.deprecate_constant :Multipartable

data/lib/multipart/post/parts.rb

@@ -0,0 +1,152 @@
+# 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.
+
+require 'stringio'
+
+module Multipart
+  module Post
+    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 and Content-ID are 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 = String.new
+          part << "--#{boundary}\r\n"
+          part << "Content-ID: #{headers["Content-ID"]}\r\n" if headers["Content-ID"]
+          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 = String.new
+          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 = String.new("--#{boundary}--\r\n")
+          @io = StringIO.new(@part)
+        end
+      end
+    end
+  end
+end
+
+Parts = Multipart::Post::Parts
+Object.deprecate_constant :Parts

data/lib/multipart/post/upload_io.rb

@@ -0,0 +1,81 @@
+# 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.
+
+module Multipart
+  module Post
+    # 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
+  end
+end
+
+UploadIO = Multipart::Post::UploadIO
+Object.deprecate_constant :UploadIO

data/lib/multipart/post/version.rb

@@ -0,0 +1,27 @@
+# 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.
+
+module Multipart
+  module Post
+    VERSION = "2.2.3"
+  end
+end

data/lib/multipart/post.rb

@@ -0,0 +1,24 @@
+# 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.
+
+require_relative 'post/multipartable'
+require_relative 'post/upload_io'

data/lib/multipart_post.rb

@@ -1,9 +1,3 @@
-#--
-# 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
+warn "Top level ::MultipartPost is deprecated, require 'multipart/post' and use `Multipart::Post` instead!"
+require_relative 'multipart/post'
+MultipartPost = Multipart::Post

data/lib/multipartable.rb

@@ -1,48 +1,2 @@
-#--
-# 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
+warn "Top level ::Multipartable is deprecated, require 'multipart/post' and use `Multipart::Post::Multipartable` instead!"
+require_relative 'multipart/post'