fog--fog-aws/lib/fog/aws/requests/storage/initiate_multipart_upload.rb

module Fog
  module Storage
    class AWS
      class Real
        require 'fog/aws/parsers/storage/initiate_multipart_upload'

        # Initiate a multipart upload to an S3 bucket
        #
        # @param bucket_name [String] Name of bucket to create object in
        # @param object_name [String] Name of object to create
        # @param options [Hash]:
        # @option options [String] Cache-Control Caching behaviour
        # @option options [String] Content-Disposition Presentational information for the object
        # @option options [String] Content-Encoding Encoding of object data
        # @option options [String] Content-MD5 Base64 encoded 128-bit MD5 digest of message (defaults to Base64 encoded MD5 of object.read)
        # @option options [String] Content-Type Standard MIME type describing contents (defaults to MIME::Types.of.first)
        # @option options [String] x-amz-acl Permissions, must be in ['private', 'public-read', 'public-read-write', 'authenticated-read']
        # @option options [String] x-amz-meta-#{name} Headers to be returned with object, note total size of request without body must be less than 8 KB.
        #
        # @return [Excon::Response] response:
        #   * body [Hash]:
        #     * Bucket [String] - Bucket where upload was initiated
        #     * Key [String] - Object key where the upload was initiated
        #     * UploadId [String] - Id for initiated multipart upload
        #
        # @see http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadInitiate.html
        #
        def initiate_multipart_upload(bucket_name, object_name, options = {})
          request({
            :expects    => 200,
            :headers    => options,
            :bucket_name => bucket_name,
            :object_name => object_name,
            :method     => 'POST',
            :parser     => Fog::Parsers::Storage::AWS::InitiateMultipartUpload.new,
            :query      => {'uploads' => nil}
          })
        end
      end # Real

      class Mock # :nodoc:all
        require 'fog/aws/requests/storage/shared_mock_methods'
        include Fog::Storage::AWS::SharedMockMethods

        def initiate_multipart_upload(bucket_name, object_name, options = {})
          verify_mock_bucket_exists(bucket_name)
          upload_id = UUID.uuid
          self.data[:multipart_uploads][bucket_name] ||= {}
          self.data[:multipart_uploads][bucket_name][upload_id] = {
            :parts => {},
            :options => options,
          }

          response = Excon::Response.new
          response.status = 200
          response.body = {
            "Bucket" => bucket_name,
            "Key" => object_name,
            "UploadId" => upload_id,
          }
          response
        end
      end # Mock
    end # Storage
  end # AWS
end # Fog