pkoch-httmultiparty 0.3.6a

data/README.md

@@ -0,0 +1,28 @@
+<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>Quick Start and Example</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>
+
+<pre>
+require 'httmultiparty'
+class SomeClient
+  include HTTMultiParty
+  base_uri 'http://localhost:3000'
+end
+
+response = SomeClient.post('/', :query => {
+  :foo      => 'bar',
+  :somefile => File.new('README.md')
+})
+</pre>
+
+Aside from that it provides all the usual HTTParty gimmicks.

data/lib/httmultiparty.rb

@@ -0,0 +1,110 @@
+gem 'httparty'
+gem 'multipart-post'
+require 'tempfile'
+require 'httparty'
+require 'net/http/post/multipart'
+
+module HTTMultiParty
+  TRANSFORMABLE_TYPES = [File, Tempfile]
+
+  QUERY_STRING_NORMALIZER = Proc.new do |params|
+    HTTMultiParty.flatten_params(params).map do |(k,v)|
+      [k, TRANSFORMABLE_TYPES.include?(v.class) ? HTTMultiParty.file_to_upload_io(v) : v]
+    end
+  end
+
+  def self.included(base)
+    base.send :include, HTTParty
+    base.extend ClassMethods
+  end
+
+  def self.file_to_upload_io(file)
+    if file.respond_to? :original_filename
+      filename = file.original_filename
+    else
+      filename =  File.split(file.path).last
+    end
+    content_type = 'application/octet-stream'
+    UploadIO.new(file, content_type, filename)
+  end
+
+  def self.flatten_params(params={}, prefix='')
+    flattened = []
+    params.each do |(k,v)|
+      if params.is_a?(Array)
+        v = k
+        k = ""
+      end
+
+      flattened_key = prefix == "" ? "#{k}" : "#{prefix}[#{k}]"
+      if v.is_a?(Hash) || v.is_a?(Array)
+        flattened += flatten_params(v, flattened_key)
+      else
+        flattened << [flattened_key, v]
+      end
+    end
+    flattened
+  end
+
+  class Basement
+    include HTTMultiParty
+  end
+
+  def self.get(*args)
+    Basement.get(*args)
+  end
+
+  def self.post(*args)
+    Basement.post(*args)
+  end
+
+  def self.put(*args)
+    Basement.put(*args)
+  end
+
+  def self.delete(*args)
+    Basement.delete(*args)
+  end
+
+  def self.head(*args)
+    Basement.head(*args)
+  end
+
+  def self.options(*args)
+    Basement.options(*args)
+  end
+
+   module ClassMethods
+     def post(path, options={})
+       method = Net::HTTP::Post
+       options[:body] ||= options.delete(:query)
+       if hash_contains_files?(options[:body])
+         method = MultipartPost
+         options[:query_string_normalizer] = HTTMultiParty::QUERY_STRING_NORMALIZER
+       end
+       perform_request method, path, options
+     end
+
+     def put(path, options={})
+       method = Net::HTTP::Put
+       options[:body] ||= options.delete(:query)
+       if hash_contains_files?(options[:body])
+         method = MultipartPut
+         options[:query_string_normalizer] = HTTMultiParty::QUERY_STRING_NORMALIZER
+       end
+       perform_request method, path, options
+     end
+
+    private
+      def hash_contains_files?(hash)
+        hash.is_a?(Hash) && HTTMultiParty.flatten_params(hash).select do |(k,v)| 
+          TRANSFORMABLE_TYPES.include?(v.class) || v.is_a?(UploadIO)
+        end.size > 0
+      end
+   end
+end
+
+require 'httmultiparty/version'
+require 'httmultiparty/multipartable'
+require 'httmultiparty/multipart_post'
+require '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,28 @@
+module HTTMultiParty::Multipartable
+  DEFAULT_BOUNDARY = "-----------RubyMultipartPost"
+  # prevent reinitialization of headers
+  def initialize_http_header(initheader)
+    super
+    set_headers_for_body
+  end
+
+  def body=(value)
+    @body_parts = value.map {|(k,v)| Parts::Part.new(boundary, k, v)}
+    @body_parts << Parts::EpiloguePart.new(boundary)
+    set_headers_for_body
+  end
+
+  def boundary
+    DEFAULT_BOUNDARY
+  end
+
+private
+
+  def set_headers_for_body
+    if @body_parts
+      self.set_content_type("multipart/form-data", { "boundary" => boundary })
+      self.content_length = @body_parts.inject(0) {|sum,i| sum + i.length }
+      self.body_stream = CompositeReadIO.new(*@body_parts.map { |part| part.to_io })
+    end
+  end
+end

data/lib/httmultiparty/version.rb

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

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification
+name: pkoch-httmultiparty
+version: !ruby/object:Gem::Version
+  version: 0.3.6a
+  prerelease: 5
+platform: ruby
+authors:
+- Paulo Köch"
+- Johannes Wagener
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.7.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.7.3
+- !ruby/object:Gem::Dependency
+  name: multipart-post
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: HTTMultiParty is a thin wrapper around HTTParty to provide multipart
+  uploads.
+email:
+- paulo.koch@gmail.com
+- 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/version.rb
+- lib/httmultiparty.rb
+- README.md
+homepage: http://github.com/pkoch/httmultiparty
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: HTTMultiParty is a thin wrapper around HTTParty to provide multipart uploads.
+test_files: []