mss-sdk 1.0.0

data/lib/mss/s3/website_configuration.rb

@@ -0,0 +1,101 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+require 'uri'
+require 'base64'
+
+module MSS
+  class S3
+    class WebsiteConfiguration
+
+      # @option options [Hash] :redirect_all_requests_to
+      #   Describes the redirect behavior for every request to this
+      #   bucket's website endpoint. If this element is present, no
+      #   other options are are allowed.
+      #   * `:host_name` - (*required*, String)
+      #     Name of the host where requests will be redirected.
+      #   * `:protocol` - (String)
+      #     Protocol to use (http, https) when redirecting requests. The
+      #     default is the protocol that is used in the original request.
+      # @option options [Hash] :index_document
+      #   * `:suffix` - (*required*, String) - A suffix that is appended to
+      #     a request that is for a directory on the website endpoint
+      #     (e.g. if the suffix is index.html and you make a request to
+      #     samplebucket/images/ the data that is returned will be for
+      #     the object with the key name images/index.html).
+      #     The suffix must not be empty and must not include a
+      #     slash character.
+      # @option options [Hash] :error_document
+      #   * `:key` - (*required*, String) - The object key name to use
+      #     when a 4XX class error occurs.
+      # @option options [Array<Hash>] :routing_rules
+      #   * `:redirect` - (*required*, Hash)
+      #     * `:host_name` - (String)
+      #     * `:protocol` - (String)
+      #     * `:replace_key_prefix_with` - (String)
+      #     * `:replace_key_with` - (String)
+      #     * `:http_redirect_code` - (String)
+      #   * `:condition` - (Hash)
+      #     * `:key_prefix_equals` - (String)
+      #     * `:http_error_code_returned_equals` - (String)
+      def initialize options = {}
+        @options = deep_copy(options)
+        if @options.empty?
+          @options[:index_document] = { :suffix => 'index.html' }
+          @options[:error_document] = { :key => 'error.html' }
+        end
+      end
+
+      # @return [Hash]
+      attr_reader :options
+
+      alias_method :to_hash, :options
+
+      # This method exists for backwards compatability.
+      # @return [String,nil]
+      # @api private
+      def index_document_suffix
+        (@options[:index_document] || {})[:suffix]
+      end
+
+      # This method exists for backwards compatability.
+      # @api private
+      def index_document_suffix= suffix
+        @options.delete(:redirect_all_requests_to)
+        @options[:index_document] ||= {}
+        @options[:index_document][:suffix] = suffix
+      end
+
+      # This method exists for backwards compatability.
+      # @return [String,nil]
+      # @api private
+      def error_document_key
+        (@options[:error_document] || {})[:key]
+      end
+
+      # This method exists for backwards compatability.
+      # @api private
+      def error_document_key= key
+        @options.delete(:redirect_all_requests_to)
+        @options[:error_document] ||= {}
+        @options[:error_document][:key] = key
+      end
+
+      private
+
+      def deep_copy hash
+        Marshal.load(Marshal.dump(hash))
+      end
+
+    end
+  end
+end

data/lib/mss/s3.rb

@@ -0,0 +1,161 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+require 'mss/core'
+require 'mss/s3/config'
+
+module MSS
+
+  # Provides an expressive, object-oriented interface to Amazon S3.
+  #
+  # To use Amazon S3 you must first
+  #
+  # For more information about Amazon S3, see:
+  #
+  #
+  # # Credentials
+  #
+  # You can setup default credentials for all MSS services via
+  # MSS.config:
+  #
+  #     MSS.config(
+  #       :access_key_id => 'YOUR_ACCESS_KEY_ID',
+  #       :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
+  #
+  # Or you can set them directly on the S3 interface:
+  #
+  #     s3 = MSS::S3.new(
+  #       :access_key_id => 'YOUR_ACCESS_KEY_ID',
+  #       :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
+  #
+  # # Buckets
+  #
+  # Before you can upload files to S3, you need to create a bucket.
+  #
+  #     s3 = MSS::S3.new
+  #     bucket = s3.buckets.create('my-bucket')
+  #
+  # If a bucket already exists, you can get a reference to the bucket.
+  #
+  #     bucket = s3.buckets['my-bucket'] # no request made
+  #
+  # You can also enumerate all buckets in your account.
+  #
+  #     s3.buckets.each do |bucket|
+  #       puts bucket.name
+  #     end
+  #
+  # See {BucketCollection} and {Bucket} for more information on working
+  # with buckets.
+  #
+  # # Objects
+  #
+  # Buckets contain objects.  Each object in a bucket has a unique key.
+  #
+  # ## Getting an Object
+  #
+  # If the object already exists, you can get a reference to the object.
+  #
+  #     # makes no request, returns an MSS::S3::S3Object
+  #     obj = bucket.objects['key']
+  #
+  # ## Reading and Writing an Object
+  #
+  # The example above returns an {S3Object}.  You call {S3Object#write} and
+  # {S3Object#read} to upload to and download from S3 respectively.
+  #
+  #     # streaming upload a file to S3
+  #     obj.write(Pathname.new('/path/to/file.txt'))
+  #
+  #     # streaming download from S3 to a file on disk
+  #     File.open('file.txt', 'wb') do |file|
+  #       obj.read do |chunk|
+  #          file.write(chunk)
+  #       end
+  #     end
+  #
+  # ## Enumerating Objects
+  #
+  # You can enumerate objects in your buckets.
+  #
+  #     # enumerate ALL objects in the bucket (even if the bucket contains
+  #     # more than 1k objects)
+  #     bucket.objects.each do |obj|
+  #       puts obj.key
+  #     end
+  #
+  #     # enumerate at most 20 objects with the given prefix
+  #     bucket.objects.with_prefix('photos/').each(:limit => 20) do |photo|
+  #       puts photo.key
+  #     end
+  #
+  # See {ObjectCollection} and {S3Object} for more information on working
+  # with objects.
+  #
+  class S3
+
+    autoload :AccessControlList, 'mss/s3/access_control_list'
+    autoload :ACLObject, 'mss/s3/acl_object'
+    autoload :ACLOptions, 'mss/s3/acl_options'
+    autoload :Bucket, 'mss/s3/bucket'
+    autoload :BucketCollection, 'mss/s3/bucket_collection'
+    #autoload :BucketTagCollection, 'mss/s3/bucket_tag_collection'
+    #autoload :BucketLifecycleConfiguration, 'mss/s3/bucket_lifecycle_configuration'
+    #autoload :BucketRegionCache, 'mss/s3/bucket_region_cache'
+    #autoload :BucketVersionCollection, 'mss/s3/bucket_version_collection'
+    autoload :Client, 'mss/s3/client'
+    #autoload :CORSRule, 'mss/s3/cors_rule'
+    #autoload :CORSRuleCollection, 'mss/s3/cors_rule_collection'
+    autoload :DataOptions, 'mss/s3/data_options'
+    autoload :EncryptionUtils, 'mss/s3/encryption_utils'
+    autoload :CipherIO, 'mss/s3/cipher_io'
+    autoload :Errors, 'mss/s3/errors'
+    autoload :MultipartUpload, 'mss/s3/multipart_upload'
+    autoload :MultipartUploadCollection, 'mss/s3/multipart_upload_collection'
+    autoload :ObjectCollection, 'mss/s3/object_collection'
+    autoload :ObjectMetadata, 'mss/s3/object_metadata'
+    autoload :ObjectUploadCollection, 'mss/s3/object_upload_collection'
+    #autoload :ObjectVersion, 'mss/s3/object_version'
+    #autoload :ObjectVersionCollection, 'mss/s3/object_version_collection'
+    autoload :PaginatedCollection, 'mss/s3/paginated_collection'
+    #autoload :Policy, 'mss/s3/policy'
+    autoload :PrefixAndDelimiterCollection, 'mss/s3/prefix_and_delimiter_collection'
+    autoload :PrefixedCollection, 'mss/s3/prefixed_collection'
+    autoload :PresignedPost, 'mss/s3/presigned_post'
+    #autoload :PresignV4, 'mss/s3/presign_v4'
+    autoload :Request, 'mss/s3/request'
+    #autoload :RegionDetection, 'mss/s3/region_detection'
+    autoload :S3Object, 'mss/s3/s3_object'
+    autoload :Tree, 'mss/s3/tree'
+    autoload :UploadedPart, 'mss/s3/uploaded_part'
+    autoload :UploadedPartCollection, 'mss/s3/uploaded_part_collection'
+    #autoload :WebsiteConfiguration, 'mss/s3/website_configuration'
+
+    include Core::ServiceInterface
+
+    endpoint_prefix 's3'
+
+    #BUCKET_REGIONS = BucketRegionCache.new
+
+    # @return [BucketCollection] Returns a collection that represents all
+    #  buckets in the account.
+    def buckets
+      BucketCollection.new(:config => @config)
+    end
+
+    def presigned_post_info(bucket, key = "${filename}", opts)
+      pp = buckets[bucket].presigned_post({:key => key, :secure => config.use_ssl}.merge(opts))
+      {:form => pp.fields, :url => pp.url.to_s}
+    end
+
+  end
+end

data/lib/mss/version.rb

@@ -0,0 +1,16 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module MSS
+  # Current version of the MSS SDK for Ruby
+  VERSION = '1.0.0'
+end

data/lib/mss-sdk.rb

@@ -0,0 +1,2 @@
+require 'mss/core'
+require 'mss/rails'

data/lib/mss.rb

@@ -0,0 +1,14 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+require 'mss-sdk'

data/rails/init.rb

@@ -0,0 +1,14 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+# this file exists for Rails < v3
+MSS::Rails.setup

metadata

@@ -0,0 +1,201 @@
+--- !ruby/object:Gem::Specification
+name: mss-sdk
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Meituan Storage Service
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-03-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+description: Meituan Storage Service SDK for Ruby.
+email: mos@meituan.com
+executables:
+- mss-rb
+extensions: []
+extra_rdoc_files: []
+files:
+- ".yardopts"
+- LICENSE.txt
+- README.md
+- bin/mss-rb
+- ca-bundle.crt
+- lib/mss-sdk.rb
+- lib/mss.rb
+- lib/mss/core.rb
+- lib/mss/core/async_handle.rb
+- lib/mss/core/cacheable.rb
+- lib/mss/core/client.rb
+- lib/mss/core/collection.rb
+- lib/mss/core/collection/simple.rb
+- lib/mss/core/collection/with_limit_and_next_token.rb
+- lib/mss/core/collection/with_next_token.rb
+- lib/mss/core/configuration.rb
+- lib/mss/core/credential_providers.rb
+- lib/mss/core/data.rb
+- lib/mss/core/deprecations.rb
+- lib/mss/core/endpoints.rb
+- lib/mss/core/http/connection_pool.rb
+- lib/mss/core/http/curb_handler.rb
+- lib/mss/core/http/handler.rb
+- lib/mss/core/http/net_http_handler.rb
+- lib/mss/core/http/patch.rb
+- lib/mss/core/http/request.rb
+- lib/mss/core/http/response.rb
+- lib/mss/core/indifferent_hash.rb
+- lib/mss/core/inflection.rb
+- lib/mss/core/ini_parser.rb
+- lib/mss/core/json_client.rb
+- lib/mss/core/json_parser.rb
+- lib/mss/core/json_request_builder.rb
+- lib/mss/core/json_response_parser.rb
+- lib/mss/core/lazy_error_classes.rb
+- lib/mss/core/log_formatter.rb
+- lib/mss/core/managed_file.rb
+- lib/mss/core/meta_utils.rb
+- lib/mss/core/model.rb
+- lib/mss/core/naming.rb
+- lib/mss/core/option_grammar.rb
+- lib/mss/core/options/json_serializer.rb
+- lib/mss/core/options/validator.rb
+- lib/mss/core/options/xml_serializer.rb
+- lib/mss/core/page_result.rb
+- lib/mss/core/policy.rb
+- lib/mss/core/query_client.rb
+- lib/mss/core/query_error_parser.rb
+- lib/mss/core/query_request_builder.rb
+- lib/mss/core/query_response_parser.rb
+- lib/mss/core/region.rb
+- lib/mss/core/region_collection.rb
+- lib/mss/core/resource.rb
+- lib/mss/core/resource_cache.rb
+- lib/mss/core/response.rb
+- lib/mss/core/response_cache.rb
+- lib/mss/core/rest_error_parser.rb
+- lib/mss/core/rest_json_client.rb
+- lib/mss/core/rest_request_builder.rb
+- lib/mss/core/rest_response_parser.rb
+- lib/mss/core/rest_xml_client.rb
+- lib/mss/core/service_interface.rb
+- lib/mss/core/signers/base.rb
+- lib/mss/core/signers/cloud_front.rb
+- lib/mss/core/signers/s3.rb
+- lib/mss/core/signers/version_2.rb
+- lib/mss/core/signers/version_3.rb
+- lib/mss/core/signers/version_3_https.rb
+- lib/mss/core/signers/version_4.rb
+- lib/mss/core/signers/version_4/chunk_signed_stream.rb
+- lib/mss/core/uri_escape.rb
+- lib/mss/core/xml/frame.rb
+- lib/mss/core/xml/frame_stack.rb
+- lib/mss/core/xml/grammar.rb
+- lib/mss/core/xml/parser.rb
+- lib/mss/core/xml/root_frame.rb
+- lib/mss/core/xml/sax_handlers/libxml.rb
+- lib/mss/core/xml/sax_handlers/nokogiri.rb
+- lib/mss/core/xml/sax_handlers/ox.rb
+- lib/mss/core/xml/sax_handlers/rexml.rb
+- lib/mss/core/xml/stub.rb
+- lib/mss/errors.rb
+- lib/mss/rails.rb
+- lib/mss/s3.rb
+- lib/mss/s3/access_control_list.rb
+- lib/mss/s3/acl_object.rb
+- lib/mss/s3/acl_options.rb
+- lib/mss/s3/bucket.rb
+- lib/mss/s3/bucket_collection.rb
+- lib/mss/s3/bucket_lifecycle_configuration.rb
+- lib/mss/s3/bucket_region_cache.rb
+- lib/mss/s3/bucket_tag_collection.rb
+- lib/mss/s3/bucket_version_collection.rb
+- lib/mss/s3/cipher_io.rb
+- lib/mss/s3/client.rb
+- lib/mss/s3/client/xml.rb
+- lib/mss/s3/config.rb
+- lib/mss/s3/cors_rule.rb
+- lib/mss/s3/cors_rule_collection.rb
+- lib/mss/s3/data_options.rb
+- lib/mss/s3/encryption_utils.rb
+- lib/mss/s3/errors.rb
+- lib/mss/s3/multipart_upload.rb
+- lib/mss/s3/multipart_upload_collection.rb
+- lib/mss/s3/object_collection.rb
+- lib/mss/s3/object_metadata.rb
+- lib/mss/s3/object_upload_collection.rb
+- lib/mss/s3/object_version.rb
+- lib/mss/s3/object_version_collection.rb
+- lib/mss/s3/paginated_collection.rb
+- lib/mss/s3/policy.rb
+- lib/mss/s3/prefix_and_delimiter_collection.rb
+- lib/mss/s3/prefixed_collection.rb
+- lib/mss/s3/presign_v4.rb
+- lib/mss/s3/presigned_post.rb
+- lib/mss/s3/region_detection.rb
+- lib/mss/s3/request.rb
+- lib/mss/s3/s3_object.rb
+- lib/mss/s3/tree.rb
+- lib/mss/s3/tree/branch_node.rb
+- lib/mss/s3/tree/child_collection.rb
+- lib/mss/s3/tree/leaf_node.rb
+- lib/mss/s3/tree/node.rb
+- lib/mss/s3/tree/parent.rb
+- lib/mss/s3/uploaded_part.rb
+- lib/mss/s3/uploaded_part_collection.rb
+- lib/mss/s3/website_configuration.rb
+- lib/mss/version.rb
+- rails/init.rb
+homepage: https://mos.meituan.com
+licenses:
+- Apache 2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: MSS SDK for Ruby
+test_files: []