httmultiparty 0.1

data/README.md

@@ -0,0 +1,27 @@
+<h2>Description</h2>
+<p>HTTMultiParty is a thin wrapper around HTTParty to provide multipart uploads.</p>
+
+<h2>Requirements</h2>
+<ul>
+  <li>httparty</li>
+  <li>multipart-post</li>
+</ul>
+
+<h2>O RLY?</h2>
+<p>To start just "include HTTMultiParty" instead of "include HTTParty" into your client class.
+When you pass a query with an instance of a File as a value for a PUT or POST request, the wrapper will 
+use a bit of magic and multipart-post to execute a multipart upload:</p>
+
+<h2>Example</h2>
+<pre>
+require 'lib/httmultiparty'
+class SomeClient
+  include HTTMultiParty
+  base_uri 'http://localhost:3000'
+end
+
+response = SomeClient.post('/', :query => {
+    :foo      => 'bar',
+    :somefile => File.new('README.md')
+  })
+</pre>

data/lib/httmultiparty.rb

@@ -0,0 +1,56 @@
+gem 'httparty'
+gem 'multipart-post'
+require 'httparty'
+require 'net/http/post/multipart'
+
+module HTTMultiParty
+  def self.included(base)
+    base.send :include, HTTParty
+    base.extend ClassMethods
+  end
+
+   module ClassMethods
+     def post(path, options={})
+       method = Net::HTTP::Post
+       if query_contains_files?(options[:query])
+         method = MultipartPost
+         options[:body] = map_files_to_upload_io(options.delete(:query))
+       end
+       perform_request method, path, options
+     end
+
+     def put(path, options={})
+       method = Net::HTTP::Put
+       if query_contains_files?(options[:query])
+         method = MultipartPut
+         options[:body] = map_files_to_upload_io(options.delete(:query))
+       end
+       perform_request method, path, options
+     end
+
+    private
+      def query_contains_files?(query)
+        query.is_a?(Hash) && query.select { |k,v| v.is_a?(File) }.length > 0
+      end
+
+      def map_files_to_upload_io(hash)
+        new_special_hash = SpecialHash.new
+        hash.each do |k,v|
+          new_special_hash[k] = v.is_a?(File) ? file_to_upload_io(v) : v
+        end
+        new_special_hash
+      end
+
+      def file_to_upload_io(file)
+        filename =  File.split(file.path).last
+        content_type = 'application/octet-stream'
+        UploadIO.new(file, content_type, filename)
+      end
+   end
+end
+
+dir = Pathname(__FILE__).dirname.expand_path
+require dir + 'httmultiparty/multipartable'
+require dir + 'httmultiparty/special_hash'
+require dir + 'httmultiparty/multipart_post'
+require dir + 'httmultiparty/multipart_put'

data/lib/httmultiparty/multipart_post.rb

@@ -0,0 +1,5 @@
+class HTTMultiParty::MultipartPost < Net::HTTP::Post
+  include HTTMultiParty::Multipartable
+end
+
+HTTParty::Request::SupportedHTTPMethods << HTTMultiParty::MultipartPost

data/lib/httmultiparty/multipart_put.rb

@@ -0,0 +1,5 @@
+class HTTMultiParty::MultipartPut < Net::HTTP::Put
+  include HTTMultiParty::Multipartable
+end
+
+HTTParty::Request::SupportedHTTPMethods << HTTMultiParty::MultipartPut

data/lib/httmultiparty/multipartable.rb

@@ -0,0 +1,17 @@
+module HTTMultiParty::Multipartable
+  DEFAULT_BOUNDARY = "-----------RubyMultipartPost"
+  # prevent reinitialization of headers
+  def initialize_http_header(initheader)
+    super if @header.nil?
+  end
+
+  def body=(value)
+    raise RuntimeError.new('body needs to be a SpecialHash') unless value.is_a?(HTTMultiParty::SpecialHash)
+    boundary = DEFAULT_BOUNDARY
+    parts = value.map {|k,v| Parts::Part.new(boundary, k, v)}
+    parts << Parts::EpiloguePart.new(boundary)
+    self.set_content_type("multipart/form-data", { "boundary" => boundary })
+    self.content_length = parts.inject(0) {|sum,i| sum + i.length }
+    self.body_stream = CompositeReadIO.new(*parts.map(&:to_io))
+  end
+end

data/lib/httmultiparty/special_hash.rb

@@ -0,0 +1,8 @@
+# SpecialHash is a hash that is pretending to be not a Hash.
+# its just a cheap way to get around the query normalization
+# happening in HTTParty::Request#body in lib/httparty/request.rb:118
+class HTTMultiParty::SpecialHash < Hash
+  def is_a?(klass)
+    klass == ::Hash ? false : super
+  end
+end

data/lib/httmultiparty/version.rb

@@ -0,0 +1,3 @@
+module HTTMultiParty
+  VERSION = '0.1'
+end

metadata

@@ -0,0 +1,130 @@
+--- !ruby/object:Gem::Specification 
+name: httmultiparty
+version: !ruby/object:Gem::Version 
+  hash: 9
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  version: "0.1"
+platform: ruby
+authors: 
+- Johannes Wagener
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-16 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: multipart-post
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: fakeweb
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+description: HTTMultiParty is a thin wrapper around HTTParty to provide multipart uploads.
+email: 
+- johannes@wagener.cc
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/httmultiparty/multipart_post.rb
+- lib/httmultiparty/multipart_put.rb
+- lib/httmultiparty/multipartable.rb
+- lib/httmultiparty/special_hash.rb
+- lib/httmultiparty/version.rb
+- lib/httmultiparty.rb
+- README.md
+has_rdoc: true
+homepage: http://github.com/jwagener/httmultiparty
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: HTTMultiParty is a thin wrapper around HTTParty to provide multipart uploads.
+test_files: []
+