fog-aws 0.0.5

data/lib/fog/aws/requests/storage/put_bucket_logging.rb

@@ -0,0 +1,80 @@
+module Fog
+  module Storage
+    class AWS
+      class Real
+        # Change logging status for an S3 bucket
+        #
+        # @param bucket_name [String] name of bucket to modify
+        # @param logging_status [Hash]:
+        #   * LoggingEnabled [Hash]: logging options or {} to disable
+        #     * Owner [Hash]:
+        #       * ID [String]: id of owner
+        #       * DisplayName [String]: display name of owner
+        #     * AccessControlList [Array]:
+        #       * Grantee [Hash]:
+        #         * DisplayName [String] Display name of grantee
+        #         * ID [String] Id of grantee
+        #         or
+        #         * EmailAddress [String] Email address of grantee
+        #         or
+        #         * URI [String] URI of group to grant access for
+        #       * Permission [String] Permission, in [FULL_CONTROL, WRITE, WRITE_ACP, READ, READ_ACP]
+        #
+        # @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTlogging.html
+
+        def put_bucket_logging(bucket_name, logging_status)
+          if logging_status['LoggingEnabled'].empty?
+            data =
+<<-DATA
+<BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01" />
+DATA
+          else
+            data =
+<<-DATA
+<BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01">
+  <LoggingEnabled>
+    <TargetBucket>#{logging_status['LoggingEnabled']['TargetBucket']}</TargetBucket>
+    <TargetPrefix>#{logging_status['LoggingEnabled']['TargetBucket']}</TargetPrefix>
+    <TargetGrants>
+DATA
+
+            logging_status['AccessControlList'].each do |grant|
+              data << "      <Grant>"
+              type = case grant['Grantee'].keys.sort
+              when ['DisplayName', 'ID']
+                'CanonicalUser'
+              when ['EmailAddress']
+                'AmazonCustomerByEmail'
+              when ['URI']
+                'Group'
+              end
+              data << "        <Grantee xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:type=\"#{type}\">"
+              for key, value in grant['Grantee']
+                data << "          <#{key}>#{value}</#{key}>"
+              end
+              data << "        </Grantee>"
+              data << "        <Permission>#{grant['Permission']}</Permission>"
+              data << "      </Grant>"
+            end
+
+            data <<
+<<-DATA
+    </TargetGrants>
+  </LoggingEnabled>
+</BucketLoggingStatus>
+DATA
+          end
+
+          request({
+            :body     => data,
+            :expects  => 200,
+            :headers  => {},
+            :bucket_name => bucket_name,
+            :method   => 'PUT',
+            :query    => {'logging' => nil}
+          })
+        end
+      end
+    end
+  end
+end

data/lib/fog/aws/requests/storage/put_bucket_notification.rb

@@ -0,0 +1,83 @@
+module Fog
+  module Storage
+    class AWS
+      class Real
+        # Change notification configuration for an S3 bucket
+        #
+        # @param bucket_name [String] name of bucket to set notification configuration for
+        # * notications [Hash]:
+        #   * Topics [Array] SNS topic configurations for the notification
+        #     * ID [String] Unique identifier for the configuration
+        #     * Topic [String] Amazon SNS topic ARN to which Amazon S3 will publish a message when it detects events of specified type
+        #     * Event [String] Bucket event for which to send notifications
+        #   * Queues [Array] SQS queue configurations for the notification
+        #     * ID [String] Unique identifier for the configuration
+        #     * Queue [String] Amazon SQS queue ARN to which Amazon S3 will publish a message when it detects events of specified type
+        #     * Event [String] Bucket event for which to send notifications
+        #   * CloudFunctions [Array] AWS Lambda notification configurations
+        #     * ID [String] Unique identifier for the configuration
+        #     * CloudFunction [String] Lambda cloud function ARN that Amazon S3 can invoke when it detects events of the specified type
+        #     * InvocationRole [String] IAM role ARN that Amazon S3 can assume to invoke the specified cloud function on your behalf
+        #     * Event [String] Bucket event for which to send notifications
+        #
+        # @see http://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTnotification.html
+        #
+        def put_bucket_notification(bucket_name, notification)
+          builder = Nokogiri::XML::Builder.new do
+            NotificationConfiguration do
+              notification.fetch('Topics', []).each do |topic|
+                TopicConfiguration do
+                  Id    topic['Id']
+                  Topic topic['Topic']
+                  Event topic['Event']
+                end
+              end
+              notification.fetch('Queues', []).each do |queue|
+                QueueConfiguration do
+                  Id    queue['Id']
+                  Queue queue['Queue']
+                  Event topic['Event']
+                end
+              end
+              notification.fetch('CloudFunctions', []).each do |func|
+                CloudFunctionConfiguration do
+                  Id             func['Id']
+                  CloudFunction  func['CloudFunction']
+                  InvocationRole func['InvocationRole']
+                  Event          func['Event']
+                end
+              end
+            end
+          end
+          body = builder.to_xml
+          body.gsub!(/<([^<>]+)\/>/, '<\1></\1>')
+          request({
+            :body     => body,
+            :expects  => 200,
+            :headers  => {'Content-MD5' => Base64.encode64(Digest::MD5.digest(body)).chomp!,
+              'Content-Type' => 'application/xml'},
+            :bucket_name => bucket_name,
+            :method   => 'PUT',
+            :query    => {'notification' => nil}
+          })
+        end
+      end
+
+      class Mock
+        def put_bucket_notification(bucket_name, notification)
+          response = Excon::Response.new
+
+          if self.data[:buckets][bucket_name]
+            self.data[:bucket_notifications][bucket_name] = notification
+            response.status = 204
+          else
+            response.status = 404
+            raise(Excon::Errors.status_error({:expects => 204}, response))
+          end
+
+          response
+        end
+      end
+    end
+  end
+end

data/lib/fog/aws/requests/storage/put_bucket_policy.rb

@@ -0,0 +1,25 @@
+module Fog
+  module Storage
+    class AWS
+      class Real
+        # Change bucket policy for an S3 bucket
+        #
+        # @param bucket_name [String] name of bucket to modify
+        # @param policy [Hash] policy document
+        #
+        # @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTpolicy.html
+
+        def put_bucket_policy(bucket_name, policy)
+          request({
+            :body     => Fog::JSON.encode(policy),
+            :expects  => 204,
+            :headers  => {},
+            :bucket_name => bucket_name,
+            :method   => 'PUT',
+            :query    => {'policy' => nil}
+          })
+        end
+      end
+    end
+  end
+end

data/lib/fog/aws/requests/storage/put_bucket_tagging.rb

@@ -0,0 +1,55 @@
+module Fog
+  module Storage
+    class AWS
+      class Real
+        # Change tag set for an S3 bucket
+        #
+        # @param bucket_name [String] name of bucket to modify
+        # @param tags [Hash]:
+        #   * Key [String]: tag key
+        #   * Value [String]: tag value
+        #
+        # @see http://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTtagging.html
+
+        def put_bucket_tagging(bucket_name, tags)
+          tagging = tags.map do |k,v|
+            "<Tag><Key>#{k}</Key><Value>#{v}</Value></Tag>"
+          end.join("\n")
+          data =
+<<-DATA
+<Tagging xmlns="http://doc.s3.amazonaws.com/2006-03-01" >
+  <TagSet>
+    #{tagging}
+  </TagSet>
+</Tagging>
+DATA
+
+          request({
+            :body     => data,
+            :expects  => 204,
+            :headers  => {'Content-MD5' => Base64.encode64(Digest::MD5.digest(data)).chomp!, 'Content-Type' => 'application/xml'},
+            :bucket_name => bucket_name,
+            :method   => 'PUT',
+            :query    => {'tagging' => nil}
+          })
+        end
+      end
+
+      class Mock # :nodoc:all
+        def put_bucket_tagging(bucket_name, tags)
+          response = Excon::Response.new
+
+          if self.data[:buckets][bucket_name]
+            self.data[:bucket_tagging][bucket_name] = tags
+            response.status = 204
+          else
+            response.status = 404
+            raise(Excon::Errors.status_error({:expects => 204}, response))
+          end
+
+          response
+        end
+      end
+    end
+  end
+end

data/lib/fog/aws/requests/storage/put_bucket_versioning.rb

@@ -0,0 +1,74 @@
+module Fog
+  module Storage
+    class AWS
+      class Real
+        # Change versioning status for an S3 bucket
+        #
+        # @param bucket_name [String] name of bucket to modify
+        # @param status [String] Status to change to in ['Enabled', 'Suspended']
+        #
+        # @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTVersioningStatus.html
+
+        def put_bucket_versioning(bucket_name, status)
+          data =
+<<-DATA
+<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
+  <Status>#{status}</Status>
+</VersioningConfiguration>
+DATA
+
+          request({
+            :body     => data,
+            :expects  => 200,
+            :headers  => {},
+            :bucket_name => bucket_name,
+            :method   => 'PUT',
+            :query    => {'versioning' => nil}
+          })
+        end
+      end
+
+      class Mock
+        def put_bucket_versioning(bucket_name, status)
+          response = Excon::Response.new
+          bucket = self.data[:buckets][bucket_name]
+
+          if bucket
+            if ['Enabled', 'Suspended'].include?(status)
+              bucket[:versioning] = status
+
+              response.status = 200
+            else
+              response.status = 400
+              response.body = {
+                'Error' => {
+                  'Code' => 'MalformedXML',
+                  'Message' => 'The XML you provided was not well-formed or did not validate against our published schema',
+                  'RequestId' => Fog::Mock.random_hex(16),
+                  'HostId' => Fog::Mock.random_base64(65)
+                }
+              }
+
+              raise(Excon::Errors.status_error({:expects => 200}, response))
+            end
+          else
+            response.status = 404
+            response.body = {
+              'Error' => {
+                'Code' => 'NoSuchBucket',
+                'Message' => 'The specified bucket does not exist',
+                'BucketName' => bucket_name,
+                'RequestId' => Fog::Mock.random_hex(16),
+                'HostId' => Fog::Mock.random_base64(65)
+              }
+            }
+
+            raise(Excon::Errors.status_error({:expects => 200}, response))
+          end
+
+          response
+        end
+      end
+    end
+  end
+end

data/lib/fog/aws/requests/storage/put_bucket_website.rb

@@ -0,0 +1,87 @@
+module Fog
+  module Storage
+    class AWS
+      class Real
+        # Change website configuration for an S3 bucket
+        #
+        # @param bucket_name [String] name of bucket to modify
+        # @param options [Hash]
+        # @option options RedirectAllRequestsTo [String] Host name to redirect all requests to - if this is set, other options are ignored
+        # @option options IndexDocument [String] suffix to append to requests for the bucket
+        # @option options ErrorDocument [String] key to use for 4XX class errors
+        #
+        # @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTwebsite.html
+
+        def put_bucket_website(bucket_name, options, options_to_be_deprecated = {})
+          options ||= {}
+
+          # Method used to be called with the suffix as the second parameter. Warn user that this is not the case any more and move on
+          if options.is_a?(String)
+            Fog::Logger.deprecation("put_bucket_website with #{options.class} param is deprecated, use put_bucket_website('#{bucket_name}', :IndexDocument => '#{options}') instead [light_black](#{caller.first})[/]")
+            options = { :IndexDocument => options }
+          end
+
+          # Parameter renamed from "key" to "ErrorDocument"
+          if options_to_be_deprecated[:key]
+            Fog::Logger.deprecation("put_bucket_website with three parameters is deprecated, use put_bucket_website('#{bucket_name}', :ErrorDocument => '#{options_to_be_deprecated[:key]}') instead [light_black](#{caller.first})[/]")
+            options[:ErrorDocument] = options_to_be_deprecated[:key]
+          end
+
+          options.merge!(options_to_be_deprecated) { |key, o1, o2| o1 }
+
+          data = "<WebsiteConfiguration xmlns=\"http://s3.amazonaws.com/doc/2006-03-01/\">"
+
+          if options[:RedirectAllRequestsTo]
+            # Redirect precludes all other options
+            data << <<-DATA
+                      <RedirectAllRequestsTo>
+                        <HostName>#{options[:RedirectAllRequestsTo]}</HostName>
+                      </RedirectAllRequestsTo>
+                    DATA
+          else
+
+            if options[:IndexDocument]
+            data << <<-DATA
+                      <IndexDocument>
+                        <Suffix>#{options[:IndexDocument]}</Suffix>
+                      </IndexDocument>
+                    DATA
+            end
+
+            if options[:ErrorDocument]
+              data << <<-DATA
+                        <ErrorDocument>
+                          <Key>#{options[:ErrorDocument]}</Key>
+                        </ErrorDocument>
+                      DATA
+            end
+          end
+
+          data << '</WebsiteConfiguration>'
+          request({
+            :body     => data,
+            :expects  => 200,
+            :headers  => {},
+            :bucket_name => bucket_name,
+            :method   => 'PUT',
+            :query    => {'website' => nil}
+          })
+        end
+      end
+
+      class Mock # :nodoc:all
+        def put_bucket_website(bucket_name, suffix, options = {})
+          response = Excon::Response.new
+          if self.data[:buckets][bucket_name]
+            response.status = 200
+          else
+            response.status = 404
+            raise(Excon::Errors.status_error({:expects => 200}, response))
+          end
+
+          response
+        end
+      end
+    end
+  end
+end

data/lib/fog/aws/requests/storage/put_object.rb

@@ -0,0 +1,87 @@
+module Fog
+  module Storage
+    class AWS
+      class Real
+        # Create an object in an S3 bucket
+        #
+        # @param bucket_name [String] Name of bucket to create object in
+        # @param object_name [String] Name of object to create
+        # @param data [File||String] File or String to create object from
+        # @param options [Hash]
+        # @option options Cache-Control [String] Caching behaviour
+        # @option options Content-Disposition [String] Presentational information for the object
+        # @option options Content-Encoding [String] Encoding of object data
+        # @option options Content-Length [String] Size of object in bytes (defaults to object.read.length)
+        # @option options Content-MD5 [String] Base64 encoded 128-bit MD5 digest of message
+        # @option options Content-Type [String] Standard MIME type describing contents (defaults to MIME::Types.of.first)
+        # @option options Expires [String] Cache expiry
+        # @option options x-amz-acl [String] Permissions, must be in ['private', 'public-read', 'public-read-write', 'authenticated-read']
+        # @option options x-amz-storage-class [String] Default is 'STANDARD', set to 'REDUCED_REDUNDANCY' for non-critical, reproducable data
+        # @option options x-amz-meta-#{name} Headers to be returned with object, note total size of request without body must be less than 8 KB. Each name, value pair must conform to US-ASCII.
+        #
+        # @return [Excon::Response] response:
+        #   * headers [Hash]:
+        #     * ETag [String] etag of new object
+        #
+        # @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectPUT.html
+
+        def self.conforming_to_us_ascii!(keys, hash)
+          return if RUBY_VERSION =~ /^1\.8\./
+          keys.each do |k|
+            v = hash[k]
+            if !v.encode(::Encoding::US_ASCII, :undef => :replace).eql?(v)
+              raise Excon::Errors::BadRequest.new("invalid #{k} header: value must be us-ascii")
+            end
+          end
+        end
+
+        def put_object(bucket_name, object_name, data, options = {})
+          data = Fog::Storage.parse_data(data)
+          headers = data[:headers].merge!(options)
+          self.class.conforming_to_us_ascii! headers.keys.grep(/^x-amz-meta-/), headers
+
+          request({
+            :body       => data[:body],
+            :expects    => 200,
+            :headers    => headers,
+            :bucket_name => bucket_name,
+            :object_name => object_name,
+            :idempotent => true,
+            :method     => 'PUT',
+          })
+        end
+      end
+
+      class Mock # :nodoc:all
+        require 'fog/aws/requests/storage/shared_mock_methods'
+        include Fog::Storage::AWS::SharedMockMethods
+
+        def put_object(bucket_name, object_name, data, options = {})
+          define_mock_acl(bucket_name, object_name, options)
+
+          data = parse_mock_data(data)
+          headers = data[:headers].merge!(options)
+          Fog::Storage::AWS::Real.conforming_to_us_ascii! headers.keys.grep(/^x-amz-meta-/), headers
+          bucket = verify_mock_bucket_exists(bucket_name)
+
+          options['Content-Type'] ||= data[:headers]['Content-Type']
+          options['Content-Length'] ||= data[:headers]['Content-Length']
+          object = store_mock_object(bucket, object_name, data[:body], options)
+
+          response = Excon::Response.new
+          response.status = 200
+
+          response.headers = {
+            'Content-Length'   => object['Content-Length'],
+            'Content-Type'     => object['Content-Type'],
+            'ETag'             => object['ETag'],
+            'Last-Modified'    => object['Last-Modified'],
+          }
+
+          response.headers['x-amz-version-id'] = object['VersionId'] if object['VersionId'] != 'null'
+          response
+        end
+      end
+    end
+  end
+end