aliyun-oss-sdk 0.1.2 → 0.1.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b2e96e96c0a7b06bd88f47438253eafed9dc23e0
+  data.tar.gz: 45ea2abaf578d016a75cd6352bd4adb83a080ee4
+SHA512:
+  metadata.gz: 6281c501347c3a4b596737c259f43716fde2da7b54330534b88fab93d9a898583076b6e2747ba389c47ecfba95a359f8c90f9b4bb5ceacdaa183b9051b0f0ab9
+  data.tar.gz: 98d94648c71197f89b40f5d60c1dae649b27bca725926757dff834c31955e7d1a73d6a06bb1f6564ea7cd3b0012c74b46528f4a4d8ddf3aad4377acfb11f8983

data/.gitignore

@@ -7,3 +7,5 @@
 /pkg/
 /spec/reports/
 /tmp/
+demo/config/secrets.yml
+demo/config/database.yml

data/.rubocop.yml

@@ -1,5 +1,9 @@
 # This is the configuration used to check the rubocop source code.
 
+AllCops:
+  Exclude:
+    - 'demo/**/*'
+
 Metrics/LineLength:
   Max: 100
   Enabled: false

data/README.md

@@ -1,8 +1,8 @@
 # Aliyun OSS SDK
 
-[![Build Status](https://travis-ci.org/zlx/aliyun-oss-sdk.svg?branch=develop)](https://travis-ci.org/zlx/aliyun-oss-sdk)
-[![Code Climate](https://codeclimate.com/repos/56349060695680028b00b4a5/badges/fccd40948ea96a4eb507/gpa.svg)](https://codeclimate.com/repos/56349060695680028b00b4a5/feed)
-[![Coverage Status](https://coveralls.io/repos/zlx/aliyun-oss-sdk/badge.svg?branch=develop&service=github)](https://coveralls.io/github/zlx/aliyun-oss-sdk?branch=develop)
+[![Build Status](https://travis-ci.org/zlx/aliyun-oss-ruby-sdk.svg)](https://travis-ci.org/zlx/aliyun-oss-ruby-sdk)
+[![Coverage Status](https://coveralls.io/repos/zlx/aliyun-oss-ruby-sdk/badge.svg?branch=master&service=github)](https://coveralls.io/github/zlx/aliyun-oss-ruby-sdk?branch=master)
+[![Inline docs](http://inch-ci.org/github/zlx/aliyun-oss-ruby-sdk.svg?branch=master)](http://inch-ci.org/github/zlx/aliyun-oss-ruby-sdk)
 
 -----
 
@@ -19,7 +19,7 @@ It's a Ruby Gem, so you can install it like any Gem:
 
 If you use Gemfile manage your Gems, Add below to your Gemfile.
 
-    gem "aliyun-oss-sdk"
+    gem "aliyun-oss-sdk", require: 'aliyun/oss'
 
 And run:
 
@@ -73,7 +73,7 @@ Here are some more guides for help you. Welcome to advice.
     # Details: https://docs.aliyun.com/#/pub/oss/product-documentation/domain-region#menu2
     # bucket: your bucket name
 	
-	client = Aliyun::OSS::Client.new('ACCESS_KEY', 'SECRET_KEY', host: 'oss-cn-hangzhou.aliyuncs.com', bucket: 'oss-sdk-dev-hangzhou')
+	client = Aliyun::Oss::Client.new('ACCESS_KEY', 'SECRET_KEY', host: 'oss-cn-hangzhou.aliyuncs.com', bucket: 'oss-sdk-dev-hangzhou')
 	
 	
 	# Upload object
@@ -96,7 +96,7 @@ Here are some more guides for help you. Welcome to advice.
     # Details: https://docs.aliyun.com/#/pub/oss/product-documentation/domain-region#menu2
     # bucket: your bucket name
 	
-	client = Aliyun::OSS::Client.new('ACCESS_KEY', 'SECRET_KEY', host: 'oss-cn-hangzhou.aliyuncs.com', bucket: 'oss-sdk-dev-hangzhou')
+	client = Aliyun::Oss::Client.new('ACCESS_KEY', 'SECRET_KEY', host: 'oss-cn-hangzhou.aliyuncs.com', bucket: 'oss-sdk-dev-hangzhou')
 	
 	
 	# Upload object
@@ -116,12 +116,23 @@ Here are some more guides for help you. Welcome to advice.
 	bucket = client.buckets.list.first  || Aliyun::Oss::Struct::Bucket.new(name: bucket_name, client: client)
 	multipart = client.bucket_multiparts.list.first || Aliyun::Oss::Struct::Multipart.new(upload_id: upload_id, key: object_key, client: client)
 	bucket_object = client.bucket_objects.list.first || Aliyun::Oss::Struct::Object.new(key: object_key, client: client)
+	file = client.bucket_objects.list.select(&:file?).first || Aliyun::Oss::Struct::File.new(key: object_key, client: client)
+	directory = Client.bucket_objects.list.reject(&:file?) || Aliyun::Oss::Struct::Directory.new(key: object_key, client: client)
 
 ### Share your files
 
-Sometimes, you want to share some file in your private bucket with your friends , but you donot want to share your AccessKey, thus, Aliyun provide alternative way: [Put signature in URL](https://docs.aliyun.com/#/pub/oss/api-reference/access-control&signature-url)
+Sometimes, you want to share some file from your private bucket with your friends , but you donot want to share your AccessKey, thus, Aliyun provide alternative way: [Put signature in URL](https://docs.aliyun.com/#/pub/oss/api-reference/access-control&signature-url)
 
-We provide a method to calculate signature for you:
+We provide a method to get share link for your object:
+
+    # Generate Share link expired in 3600 seconds
+    share_link = client.bucket_get_object_share_link('object-key', 3600)
+    
+    # OR
+    file = Aliyun::Oss::Struct::File.new(key: 'object-key', client: client)
+    share_link = file.share_link(3600)
+
+Besides, if you need more control for temporary signature:     
 
     # Return Singature string
     Aliyun::Oss::Authorization.get_temporary_signature('SECRET_KEY', Time.now.to_i + 60*60, verb: 'GET', bucket: 'bucket-name', key: 'object-name')
@@ -141,6 +152,7 @@ With Post Form, we need Post Policy to restrict permissions, here we provide two
      # Return Signature with policy, can used to fill your form field: Signature
      client.get_policy_signature(SECRET_KEY, policy)
 
+Here, we provide a [DEMO](demo/app/views/home/new_post.html.erb).
 
 ### API Mapping
 
@@ -151,55 +163,82 @@ Note:
 + All Function Based API are instance methods of `Aliyun::Oss::Client`
 + Object Based API belongs to some other class list below:
 
-  + buckets: `Aliyun::Oss::Client::BucketsService`
-  + bucket_objects: `Aliyun::Oss::Client::BucketObjectsService`
-  + bucket_multiparts: `Aliyun::Oss::Client::BucketMultipartsService`
-  + bucket: `Aliyun::Oss::Struct::Bucket`
-  + multipart: `Aliyun::Oss::Struct::Multipart`
-  + object: `Aliyun::Oss::Struct::Object`
+  + Bucket: `Aliyun::Oss::Client::BucketsService`
+  + BucketObject: `Aliyun::Oss::Client::BucketObjectsService`
+  + BucketMultipart: `Aliyun::Oss::Client::BucketMultipartsService`
+  + Bucket: `Aliyun::Oss::Struct::Bucket`
+  + Multipart: `Aliyun::Oss::Struct::Multipart`
+  + Object: `Aliyun::Oss::Struct::Object`
+  + File: `Aliyun::Oss::Struct::File`
+  + Directory: `Aliyun::Oss::Strcut:Directory`
+
+
+#### Service
+
+| Restful API  |  Function Based |  Object Based |
+| ------------ | --------------- | ------------- |
+|[GetService (ListBucket)](https://docs.aliyun.com/#/pub/oss/api-reference/service&GetService)	|bucket_list	|Buckets#list	|
+
+#### Bucket
+
+| Restful API  |  Function Based |  Object Based |
+| ------------ | --------------- | ------------- |
+|[Put Bucket](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucket)		|bucket_create	|	Buckets#create|
+|[Put Bucket Acl](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketACL)	|bucket_set_acl	|	Bucket#set_acl|
+|[Put Bucket Logging](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketLogging)|bucket_enable_logging	|	Bucket#enable_logging|
+|[Put Bucket Website](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketWebsite)	|bucket_enable_website	|	Bucket#enable_website|
+|[Put Bucket Referer](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketReferer)	|bucket_set_referer	|	Bucket#set_referer|
+|[Put Bucket Lifecycle](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketLifecycle)	|	bucket_enable_lifecycle|	Bucket#enable_lifecycle|
+|[Get Bucket (List Object)](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucket)	|	bucket_list_objects|	Bucket_objects#list, Directory#list|
+|[Get Bucket ACL](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketAcl)	|	bucket_get_acl|	Bucket#acl!|
+|[Get Bucket Location](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketLocation)|	bucket_get_location|	Bucket#location!|
+|[Get Bucket Logging](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketLogging)	|	bucket_get_logging|	Bucket#logging!|
+|[Get Bucket Website](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketWebsite)	|	bucket_get_website|	Bucket#website!|
+|[Get Bucket Referer](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketReferer)	|	bucket_get_referer|	Bucket#referer!|
+|[Get Bucket Lifecycle](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketLifecycle)	|	bucket_get_lifecycle|	Bucket#lifecycle!|
+|[Delete Bucket](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&DeleteBucket)	|	bucket_delete|	Buckets#delete|
+|[Delete Bucket Logging](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&DeleteBucketLogging)	|	bucket_disable_logging|	Bucket#disable_logging|
+|[Delete Bucket Website](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&DeleteBucketWebsite)	|	bucket_disable_website|	Bucket#disable_website|
+|[Delete Bucket Lifecycle](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&DeleteBucketLifecycle)	|	bucket_disable_lifecycle|	Bucket#disable_lifecycle|
+
+
+#### Object
+
+| Restful API  |  Function Based |  Object Based |
+| ------------ | --------------- | ------------- |
+|[Put Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&PutObject)|	bucket_create_object|	BucketObject#create|
+|[Copy Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&CopyObject)	|	bucket_copy_object|	BucketObject#copy|
+|[Get Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&GetObject)	|	bucket_get_object|	BucketObject#get|
+|[Append Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&AppendObject)|	bucket_append_object|	BucketObject#append|
+|[Delete Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&DeleteObject)|	bucket_delete_object|	BucketObject#delete|
+|[Delete Multiple Objects](https://docs.aliyun.com/#/pub/oss/api-reference/object&DeleteMultipleObjects)|	bucket_delete_objects|	BucketObject#delete_multiple|
+|[Head Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&HeadObject)	|	bucket_preflight|	Bucket#preflight, Bucket#options|
+|[Put Object ACL](https://docs.aliyun.com/#/pub/oss/api-reference/object&PutObjectACL)	|	bucket_set_object_acl|	Object#set_acl|
+|[Get Object ACL](https://docs.aliyun.com/#/pub/oss/api-reference/object&GetObjectACL)	|	bucket_get_object_acl|	Object#acl!|
+|[Post Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&PostObject)	|	[DEMO](demo/app/views/home/new_post.html.erb)|	[DEMO](demo/app/views/home/new_post.html.erb)|
+| Share Link	| bucket_get_object_share_link	| file#share_link |
+
+
+#### Multipart Upload
+
+| Restful API  |  Function Based |  Object Based |
+| ------------ | --------------- | ------------- |
+|[Initiate Multipart Upload](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&InitiateMultipartUpload)	|	bucket_init_multipart|	BucketMultipart#init|
+|[Upload Part](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&UploadPart)	|	bucket_multipart_upload|	Multipart#upload|
+|[Upload Part Copy](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&UploadPartCopy)	|	bucket_multipart_copy_upload|	Multipart#copy|
+|[Complete Multipart Upload](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&CompleteMultipartUpload)	|	bucket_complete_multipart|	Multipart#complete|
+|[Abort Multipart Upload](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&AbortMultipartUpload)	|	bucket_abort_multipart|	Multipart#abort|
+|[List Multipart Uploads](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&ListMultipartUploads)	|	bucket_list_multiparts|	BucketMultipart#list|
+|[List Parts](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&ListParts)	|	bucket_list_parts|	Multipart#list_parts|
 
+#### CORS
 
 | Restful API  |  Function Based |  Object Based |
-|---|---|
-|[GetService (ListBucket)](https://docs.aliyun.com/#/pub/oss/api-reference/service&GetService)	|bucket_list	|buckets#list	|
-|[Put Bucket](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucket)		|bucket_create	|	buckets#create|
-|[Put Bucket Acl](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketACL)	|bucket_set_acl	|	bucket#set_acl|
-|[Put Bucket Logging](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketLogging)|bucket_enable_logging	|	bucket#enable_logging|
-|[Put Bucket Website](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketWebsite)	|bucket_enable_website	|	bucket#enable_website|
-|[Put Bucket Referer](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketReferer)	|bucket_set_referer	|	bucket#set_referer|
-|[Put Bucket Lifecycle](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketLifecycle)	|	bucket_enable_lifecycle|	bucket#enable_lifecycle|
-|[Get Bucket (List Object)](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucket)	|	bucket_list_objects|	bucket_objects#list|
-|[Get Bucket ACL](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketAcl)	|	bucket_get_acl|	bucket#acl!|
-|[Get Bucket Location](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketLocation)|	bucket_get_location|	bucket#location!|
-|[Get Bucket Logging](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketLogging)	|	bucket_get_logging|	bucket#logging!|
-|[Get Bucket Website](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketWebsite)	|	bucket_get_website|	bucket#website!|
-|[Get Bucket Referer](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketReferer)	|	bucket_get_referer|	bucket#referer!|
-|[Get Bucket Lifecycle](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketLifecycle)	|	bucket_get_lifecycle|	bucket#lifecycle!|
-|[Delete Bucket](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&DeleteBucket)	|	bucket_delete|	buckets#delete|
-|[Delete Bucket Logging](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&DeleteBucketLogging)	|	bucket_disable_logging|	bucket#disable_logging|
-|[Delete Bucket Website](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&DeleteBucketWebsite)	|	bucket_disable_website|	bucket#disable_website|
-|[Delete Bucket Lifecycle](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&DeleteBucketLifecycle)	|	bucket_disable_lifecycle|	bucket#disable_lifecycle|
-|[Put Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&PutObject)|	bucket_create_object|	bucket_objects#create|
-|[Copy Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&CopyObject)	|	bucket_copy_object|	bucket_objects#copy|
-|[Get Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&GetObject)	|	bucket_get_object|	bucket_objects#get|
-|[Append Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&AppendObject)|	bucket_append_object|	bucket_objects#append|
-|[Delete Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&DeleteObject)|	bucket_delete_object|	bucket_objects#delete|
-|[Delete Multiple Objects](https://docs.aliyun.com/#/pub/oss/api-reference/object&DeleteMultipleObjects)|	bucket_delete_objects|	bucket_objects#delete_multiple|
-|[Head Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&HeadObject)	|	bucket_preflight|	bucket#preflight, bucket#options|
-|[Put Object ACL](https://docs.aliyun.com/#/pub/oss/api-reference/object&PutObjectACL)	|	bucket_set_object_acl|	object#set_acl|
-|[Get Object ACL](https://docs.aliyun.com/#/pub/oss/api-reference/object&GetObjectACL)	|	bucket_get_object_acl|	object#acl!|
-|[Post Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&PostObject)	|	...|	...|
-|[Initiate Multipart Upload](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&InitiateMultipartUpload)	|	bucket_init_multipart|	bucket_multiparts#init|
-|[Upload Part](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&UploadPart)	|	bucket_multipart_upload|	multipart#upload|
-|[Upload Part Copy](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&UploadPartCopy)	|	bucket_multipart_copy_upload|	multipart#copy|
-|[Complete Multipart Upload](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&CompleteMultipartUpload)	|	bucket_complete_multipart|	multipart#complete|
-|[Abort Multipart Upload](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&AbortMultipartUpload)	|	bucket_abort_multipart|	multipart#abort|
-|[List Multipart Uploads](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&ListMultipartUploads)	|	bucket_list_multiparts|	bucket_multiparts#list|
-|[List Parts](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&ListParts)	|	bucket_list_parts|	multipart#list_parts|
-|[Put Bucket cors](https://docs.aliyun.com/#/pub/oss/api-reference/cors&PutBucketcors)	|	bucket_enable_cors|	bucket#enable_cors|
-|[Get Bucket cors](https://docs.aliyun.com/#/pub/oss/api-reference/cors&GetBucketcors)	|	bucket_get_cors|	bucket#cors!|
-|[Delete Bucket cors](https://docs.aliyun.com/#/pub/oss/api-reference/cors&DeleteBucketcors)	|	bucket_disable_cors|	bucket#disable_cors|
-|[OPTIONS Object](https://docs.aliyun.com/#/pub/oss/api-reference/cors&OptionObject)|	bucket_get_meta_object|	object#meta!|
+| ------------ | --------------- | ------------- |
+|[Put Bucket cors](https://docs.aliyun.com/#/pub/oss/api-reference/cors&PutBucketcors)	|	bucket_enable_cors|	Bucket#enable_cors|
+|[Get Bucket cors](https://docs.aliyun.com/#/pub/oss/api-reference/cors&GetBucketcors)	|	bucket_get_cors|	Bucket#cors!|
+|[Delete Bucket cors](https://docs.aliyun.com/#/pub/oss/api-reference/cors&DeleteBucketcors)	|	bucket_disable_cors|	Bucket#disable_cors|
+|[OPTIONS Object](https://docs.aliyun.com/#/pub/oss/api-reference/cors&OptionObject)|	bucket_get_meta_object|	Object#meta!|
 
 
 ## Test

data/aliyun-oss.gemspec

@@ -13,12 +13,13 @@ Gem::Specification.new do |spec|
   spec.description   = 'Aliyun OSS Ruby SDK'
   spec.homepage      = 'https://github.com/zlx/aliyun-oss-sdk'
 
-  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|demo)/}) }
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
   spec.add_dependency 'httparty'
+  spec.add_dependency 'addressable'
   spec.add_dependency 'gyoku'
 
   spec.add_development_dependency 'bundler'

data/lib/aliyun/oss.rb

@@ -1,13 +1,11 @@
 require 'aliyun/oss/version'
-require 'aliyun/oss/client'
 require 'aliyun/oss/struct'
 require 'aliyun/oss/error'
 
 module Aliyun
   module Oss
     autoload :Utils,            'aliyun/oss/utils'
-    autoload :Http,             'aliyun/oss/http'
+    autoload :Client,           'aliyun/oss/client'
     autoload :Authorization,    'aliyun/oss/authorization'
-    autoload :XmlGenerator,     'aliyun/oss/xml_generator'
   end
 end

data/lib/aliyun/oss/api/bucket_objects.rb

@@ -52,15 +52,13 @@ module Aliyun
         # @param source_bucket [String] the source bucket name
         # @param source_key [String] the source object name
         # @param [Hash] headers
-        # @option options [String] :source_bucket the source bucket name
-        # @option options [String] :source_key the source object name
-        # @option options [String] :x-oss-copy-source-if-match If the specified ETag match the source object ETag, normal transfer and return 200; Otherwise return 412(precondition)
-        # @option options [String] :x-oss-copy-source-if-none-match If the specified ETag not match the source object ETag, normal transfer and return 200; Otherwise return 304(Not Modified)
-        # @option options [String] :x-oss-copy-source-if-unmodified-since If the specified time is equal to or later than the source object last modification time, normal transfer ans return 200; Otherwise returns 412(precondition)
-        # @option options [String] :x-oss-copy-source-if-modified-since If the specified time is earlier than the source object last modification time, normal transfer ans return 200; Otherwise returns 304(not modified)
-        # @option options [String] :x-oss-metadata-directive ('COPY') supported value: COPY, REPLACE;
-        # @option options [String] :x-oss-server-side-encryption supported value: AES256
-        # @option options [String] :x-oss-object-acl supported value: public-read, private, public-read-write
+        # @option headers [String] :x-oss-copy-source-if-match If the specified ETag match the source object ETag, normal transfer and return 200; Otherwise return 412(precondition)
+        # @option headers [String] :x-oss-copy-source-if-none-match If the specified ETag not match the source object ETag, normal transfer and return 200; Otherwise return 304(Not Modified)
+        # @option headers [String] :x-oss-copy-source-if-unmodified-since If the specified time is equal to or later than the source object last modification time, normal transfer ans return 200; Otherwise returns 412(precondition)
+        # @option headers [String] :x-oss-copy-source-if-modified-since If the specified time is earlier than the source object last modification time, normal transfer ans return 200; Otherwise returns 304(not modified)
+        # @option headers [String] :x-oss-metadata-directive ('COPY') supported value: COPY, REPLACE;
+        # @option headers [String] :x-oss-server-side-encryption supported value: AES256
+        # @option headers [String] :x-oss-object-acl supported value: public-read, private, public-read-write
         #
         # @raise [RequestError]
         #
@@ -123,6 +121,27 @@ module Aliyun
           http.get("/#{key}", query: query, headers: headers, bucket: bucket, key: key)
         end
 
+        # Get object share link
+        #
+        # @param key [String] the Object name
+        # @param expired_in_seconds [Integer] expire after specify seconds
+        #
+        # @return [String]
+        def bucket_get_object_share_link(key, expired_in_seconds)
+          expire_time = Time.now.to_i + expired_in_seconds
+
+          signature = Authorization.get_temporary_signature(
+            @secret_key,
+            expire_time,
+            verb: 'GET',
+            bucket: bucket,
+            key: key
+          )
+
+          Utils.get_endpoint(bucket, @options[:host]) + "#{key}?" \
+            "OSSAccessKeyId=#{@access_key}&Expires=#{expire_time}&Signature=#{signature}"
+        end
+
         # Delete object from bucket
         #
         # @see https://docs.aliyun.com/#/pub/oss/api-reference/object&DeleteObject Delete Object

data/lib/aliyun/oss/api/buckets.rb

@@ -4,13 +4,15 @@ module Aliyun
       module Buckets
         # List buckets
         #
-        # @see https://docs.aliyun.com/#/pub/oss/api-reference/service&GetService GetService (ListBucket
+        # @see https://docs.aliyun.com/#/pub/oss/api-reference/service&GetService GetService (ListBucket)
         #
         # @param options [Hash] options
         # @option options [String] :prefix Filter buckets with prefix
         # @option options [String] :marker Bucket name should after marker in alphabetical order
         # @option options [Integer] :max-keys (100) Limit number of buckets, the maxinum should <= 1000
         #
+        # @raise [RequestError]
+        #
         # @return [Response]
         def list_buckets(options = {})
           Utils.stringify_keys!(options)
@@ -29,7 +31,7 @@ module Aliyun
         # @param location [String] Specify the bucket's data center location, can be one of below:
         #   oss-cn-hangzhou,oss-cn-qingdao,oss-cn-beijing,oss-cn-hongkong,
         #   oss-cn-shenzhen,oss-cn-shanghai,oss-us-west-1 ,oss-ap-southeast-1
-        # @param acl [String] Specify the bucket's access. (see #bucket_set_acl)
+        # @param acl [String] Specify the bucket's access. {Aliyun::Oss::Api::BucketProperty#bucket_set_acl}
         #
         # @raise [RequestError]
         #

data/lib/aliyun/oss/client.rb

@@ -1,9 +1,14 @@
+require 'aliyun/oss/xml_generator'
+# Function Based
 require 'aliyun/oss/api/buckets'
 require 'aliyun/oss/api/bucket_property'
 require 'aliyun/oss/api/bucket_objects'
 require 'aliyun/oss/api/bucket_multiparts'
+# Object Based
 require 'aliyun/oss/client/clients'
 
+require 'aliyun/oss/http'
+
 module Aliyun
   module Oss
     class Client

data/lib/aliyun/oss/client/bucket_multiparts.rb

@@ -4,13 +4,12 @@ module Aliyun
       module BucketMultiparts
         # Init a Multipart Upload Event
         #
-        # @param (see #bucket_init_multipart)
+        # @see Api::BucketMultiparts#bucket_init_multipart
+        # @example (see Api::BucketMultiparts#bucket_init_multipart)
+        # @param (see Api::BucketMultiparts#bucket_init_multipart)
+        # @raise (see Api::BucketMultiparts#bucket_init_multipart)
         #
-        # @raise [RequestError]
-        #
-        # @return [Aliyun::Oss::Struct::Multipart]
-        #
-        # @see Client#bucket_init_multipart
+        # @return [Struct::Multipart]
         def init(*args)
           result = client.bucket_init_multipart(*args).parsed_response
 
@@ -20,15 +19,12 @@ module Aliyun
 
         # List exist Multipart Upload Events of bucket
         #
-        # @param (see #bucket_list_multiparts)
-        #
-        # @option (see #bucket_list_multiparts)
-        #
-        # @raise [RequestError]
+        # @see Api::BucketMultiparts#bucket_list_multiparts
+        # @example (see Api::BucketMultiparts#bucket_list_multiparts)
+        # @param (see Api::BucketMultiparts#bucket_list_multiparts)
+        # @raise (see Api::BucketMultiparts#bucket_list_multiparts)
         #
         # @return [Array<Aliyun::Oss::Struct::Multipart>]
-        #
-        # @see Client#bucket_list_multiparts
         def list(*args)
           result = client.bucket_list_multiparts(*args).parsed_response
 

data/lib/aliyun/oss/client/bucket_objects.rb

@@ -4,14 +4,12 @@ module Aliyun
       module BucketObjects
         # List objects of bucket
         #
-        # @param (see #bucket_list_objects)
-        # @option (see #bucket_list_objects)
-        #
-        # @raise [RequestError]
+        # @see Api::BucketObjects#bucket_list_objects
+        # @example (see Api::BucketObjects#bucket_list_objects)
+        # @param (see Api::BucketObjects#bucket_list_objects)
+        # @raise (see Api::BucketObjects#bucket_list_objects)
         #
         # @return [Array<Aliyun::Oss::Struct::Object>]
-        #
-        # @see Client#bucket_list_objects
         def list(*args)
           result = client.bucket_list_objects(*args).parsed_response
 
@@ -23,84 +21,72 @@ module Aliyun
 
         # create object of bucket
         #
-        # @param (see #bucket_create_object)
-        #
-        # @raise [RequestError]
+        # @see Api::BucketObjects#bucket_create_object
+        # @example (see Api::BucketObjects#bucket_create_object)
+        # @param (see Api::BucketObjects#bucket_create_object)
+        # @raise (see Api::BucketObjects#bucket_create_object)
         #
         # @return [true]
-        #
-        # @see Client#bucket_create_object
         def create(*args)
           !!client.bucket_create_object(*args)
         end
 
         # Delete object for bucket
         #
-        # @param (see #bucket_delete_object)
-        #
-        # @raise [RequestError]
+        # @see Api::BucketObjects#bucket_delete_object
+        # @example (see Api::BucketObjects#bucket_delete_object)
+        # @param (see Api::BucketObjects#bucket_delete_object)
+        # @raise (see Api::BucketObjects#bucket_delete_object)
         #
         # @return [true]
-        #
-        # @see Client#bucket_delete_object
         def delete(*args)
           !!client.bucket_delete_object(*args)
         end
 
         # Delete objects for bucket
         #
-        # @param (see #bucket_delete_objects)
-        #
-        # @raise [RequestError]
+        # @see Api::BucketObjects#bucket_delete_objects
+        # @example (see Api::BucketObjects#bucket_delete_objects)
+        # @param (see Api::BucketObjects#bucket_delete_objects)
+        # @raise (see Api::BucketObjects#bucket_delete_objects)
         #
         # @return [true]
-        #
-        # @see Client#bucket_delete_objects
         def delete_multiple(*args)
           !!client.bucket_delete_objects(*args)
         end
 
         # Copy from existing object
         #
-        # @param (see #bucket_copy_object)
-        #
-        # @option (see #bucket_copy_object)
-        #
-        # @raise [RequestError]
+        # @see Api::BucketObjects#bucket_copy_object
+        # @example (see Api::BucketObjects#bucket_copy_object)
+        # @param (see Api::BucketObjects#bucket_copy_object)
+        # @raise (see Api::BucketObjects#bucket_copy_object)
         #
         # @return [true]
-        #
-        # @see Client#bucket_copy_object
         def copy(*args)
           !!client.bucket_copy_object(*args)
         end
 
         # Get Object
         #
-        # @param (see #bucket_get_object)
-        #
-        # @option (see #bucket_get_object)
-        #
-        # @raise [RequestError]
+        # @see Api::BucketObjects#bucket_get_object
+        # @example (see Api::BucketObjects#bucket_get_object)
+        # @param (see Api::BucketObjects#bucket_get_object)
+        # @raise (see Api::BucketObjects#bucket_get_object)
         #
-        # @return [String]
-        #
-        # @see Client#bucekt_get_object
+        # @return [BodyString]
         def get(*args)
           client.bucket_get_object(*args).body
         end
 
         # Append data to a object, will create Appendable object
         #
-        # @see https://docs.aliyun.com/#/pub/oss/api-reference/object&AppendObject Append Object
-        #
-        # @param (see #bucket_append_object)
-        #
-        # @raise (see #bucket_append_object)
+        # @see Api::BucketObjects#bucket_append_object
+        # @example (see Api::BucketObjects#bucket_append_object)
+        # @param (see Api::BucketObjects#bucket_append_object)
+        # @raise (see Api::BucketObjects#bucket_append_object)
         #
         # @return [HTTParty::Response::Headers]
-        #
-        # @see Client#bucket_append_object
         def append(*args)
           client.bucket_append_object(*args).headers
         end

data/lib/aliyun/oss/client/buckets.rb

@@ -4,12 +4,12 @@ module Aliyun
       module Buckets
         # List buckets
         #
-        # @param (see #list_buckets)
-        # @option (see #list_buckets)
+        # @see Api::Buckets#list_buckets
+        # @example (see Api::Buckets#list_buckets)
+        # @param (see Api::Buckets#list_buckets)
+        # @raise (see Api::Buckets#list_buckets)
         #
         # @return [Array<Aliyun::Oss::Struct::Bucket>]
-        #
-        # @see Client#list_buckets
         def list(options = {})
           result = client.list_buckets(options).parsed_response
 
@@ -21,22 +21,24 @@ module Aliyun
 
         # Create bucket
         #
-        # @param (see #bucket_create)
+        # @see Api::Buckets#bucket_create
+        # @example (see Api::Buckets#bucket_create)
+        # @param (see Api::Buckets#bucket_create)
+        # @raise (see Api::Buckets#bucket_create)
         #
         # @return [true]
-        #
-        # @see Client#bucket_create
         def create(*args)
           !!client.bucket_create(*args)
         end
 
         # Delete bucket
         #
-        # @param (see #bucket_delete)
+        # @see Api::Buckets#bucket_delete
+        # @example (see Api::Buckets#bucket_delete)
+        # @param (see Api::Buckets#bucket_delete)
+        # @raise (see Api::Buckets#bucket_delete)
         #
         # @return [true]
-        #
-        # @see Client#bucket_delete
         def delete(*args)
           !!client.bucket_delete(*args)
         end

data/lib/aliyun/oss/client/clients.rb

@@ -15,6 +15,10 @@ module Aliyun
     #
     #   client.bucket_multiparts
     #
+    # current_bucket: get current bucket
+    #
+    #   client.current_bucket
+    #
     #
     class Client
       def buckets
@@ -30,6 +34,11 @@ module Aliyun
           Client::BucketMultipartsService.new(self)
       end
 
+      def current_bucket
+        @services[:current_bucket] ||= \
+          Aliyun::Oss::Struct::Bucket.new(name: bucket, client: self)
+      end
+
       ClientService = ::Struct.new(:client)
 
       require 'aliyun/oss/client/buckets'

data/lib/aliyun/oss/http.rb

@@ -1,4 +1,5 @@
 require 'httparty'
+require 'addressable/uri'
 require 'aliyun/oss/error'
 
 module Aliyun
@@ -49,7 +50,7 @@ module Aliyun
         append_headers!(headers, verb, body, options)
 
         path = api_endpoint(headers['Host']) + resource
-        options = { headers: headers, query: query, body: body }
+        options = { headers: headers, query: query, body: body, uri_adapter: Addressable::URI }
 
         wrap(HTTParty.__send__(verb.downcase, path, options))
       end

data/lib/aliyun/oss/struct/bucket.rb

@@ -22,17 +22,18 @@ module Aliyun
         #
         # @return [String]
         #
-        # @see Client#bucket_get_location
+        # @see Api::BucketProperty#bucket_get_location
         def location!
           result = client.bucket_get_location.parsed_response
-          Utils.dig_value(result, 'LocationConstraint', '__content__')
+          Utils.dig_value(result, 'LocationConstraint', '__content__') ||
+            Utils.dig_value(result, 'LocationConstraint')
         end
 
         # Get Logging configration for bucket
         #
         # return [true]
         #
-        # @see Client#bucket_get_logging
+        # @see Api::BucketProperty#bucket_get_logging
         def logging!
           result = client.bucket_get_logging.parsed_response
           Struct::Logging.new(Utils.dig_value(result, 'BucketLoggingStatus'))
@@ -40,11 +41,12 @@ module Aliyun
 
         # Used to enable access logging.
         #
-        # @param (see #bucket_enable_logging)
+        # @see Api::BucketProperty#bucket_enable_logging
+        # @example (see Api::BucketProperty#bucket_enable_logging)
+        # @param (see Api::BucketProperty#bucket_enable_logging)
+        # @raise (see Api::BucketProperty#bucket_enable_logging)
         #
         # @return [true]
-        #
-        # @see Client#bucket_enable_logging
         def enable_logging(*args)
           !!client.bucket_enable_logging(*args)
         end
@@ -55,7 +57,7 @@ module Aliyun
         #
         # @return [true]
         #
-        # @see Client#bucket_disable_logging
+        # @see Api::BucketProperty#bucket_disable_logging
         def disable_logging
           !!client.bucket_disable_logging
         end
@@ -64,7 +66,7 @@ module Aliyun
         #
         # @return [String]
         #
-        # @see Client#bucket_get_acl
+        # @see Api::BucketProperty#bucket_get_acl
         def acl!
           result = client.bucket_get_acl.parsed_response
           acl_keys = %w(AccessControlPolicy AccessControlList Grant)
@@ -73,13 +75,12 @@ module Aliyun
 
         # Set ACL for bucket
         #
-        # @param (see #bucket_set_acl)
-        #
-        # @raise (see #bucket_set_acl)
+        # @see Api::BucketProperty#bucket_set_acl
+        # @example (see Api::BucketProperty#bucket_set_acl)
+        # @param (see Api::BucketProperty#bucket_set_acl)
+        # @raise (see Api::BucketProperty#bucket_set_acl)
         #
         # @return [true]
-        #
-        # @see Client#bucket_set_acl
         def set_acl(*args)
           !!client.bucket_set_acl(*args)
         end
@@ -88,7 +89,7 @@ module Aliyun
         #
         # @return [Array<Aliyun::Oss::Struct::Cors>]
         #
-        # @see Client#bucket_get_cors
+        # @see Api::BucketProperty#bucket_get_cors
         def cors!
           result = client.bucket_get_cors.parsed_response
           cors_keys = %w(CORSConfiguration CORSRule)
@@ -99,28 +100,21 @@ module Aliyun
 
         # Set CORS for bucket
         #
-        # @see (see #bucket_enable_cors)
-        #
-        # @param (see #bucket_enable_cors)
-        #
-        # @raise (see #bucket_enable_cors)
+        # @see Api::BucketProperty#bucket_enable_cors
+        # @example (see Api::BucketProperty#bucket_enable_cors)
+        # @param (see Api::BucketProperty#bucket_enable_cors)
+        # @raise (see Api::BucketProperty#bucket_enable_cors)
         #
         # @return [true]
-        #
-        # @see Client#bucket_enable_cors
         def enable_cors(*args)
           !!client.bucket_enable_cors(*args)
         end
 
         # Disable CORS for bucket
         #
-        # @see (see #bucket_disable_cors)
-        #
-        # @raise (see #bucket_disable_cors)
-        #
         # @return [true]
         #
-        # @see Client#bucket_disable_cors
+        # @see Api::BucketProperty#bucket_disable_cors
         def disable_cors
           !!client.bucket_disable_cors
         end
@@ -129,7 +123,7 @@ module Aliyun
         #
         # @return [Aliyun::Oss::Rule::Website]
         #
-        # @see Client#bucket_get_website
+        # @see Api::BucketProperty#bucket_get_website
         def website!
           result = client.bucket_get_website.parsed_response
           suffix_keys = %w(WebsiteConfiguration IndexDocument Suffix)
@@ -142,28 +136,21 @@ module Aliyun
 
         # Used to enable static website hosted mode.
         #
-        # @see (see #bucket_enable_website)
-        #
-        # @param (see #bucket_enable_website)
-        #
-        # @raise (see #bucket_enable_website)
+        # @see Api::BucketProperty#bucket_enable_website
+        # @example (see Api::BucketProperty#bucket_enable_website)
+        # @param (see Api::BucketProperty#bucket_enable_website)
+        # @raise (see Api::BucketProperty#bucket_enable_website)
         #
         # @return [true]
-        #
-        # @see Client#bucket_enable_website
         def enable_website(*args)
           !!client.bucket_enable_website(*args)
         end
 
         # Used to disable website hostted mode.
         #
-        # @see (see #bucket_disable_website)
-        #
-        # @raise (see #bucket_disable_website)
-        #
-        # @return [Response]
+        # @return [true]
         #
-        # @see Client#bucket_disable_website
+        # @see Api::BucketProperty#bucket_disable_website
         def disable_website
           !!client.bucket_disable_website
         end
@@ -172,7 +159,7 @@ module Aliyun
         #
         # @return [Aliyun::Oss::Struct::Referer]
         #
-        # @see Client#bucket_get_referer
+        # @see Api::BucketProperty#bucket_get_referer
         def referer!
           result = client.bucket_get_referer.parsed_response
           allow_empty = %w(RefererConfiguration AllowEmptyReferer)
@@ -185,15 +172,12 @@ module Aliyun
 
         # Used to set referer for bucket.
         #
-        # @see (see #bucket_set_referer)
-        #
-        # @param (see #bucket_set_referer)
-        #
-        # @raise (see #bucket_set_referer)
+        # @see Api::BucketProperty#bucket_set_referer
+        # @example (see Api::BucketProperty#bucket_set_referer)
+        # @param (see Api::BucketProperty#bucket_set_referer)
+        # @raise (see Api::BucketProperty#bucket_set_referer)
         #
         # @return [true]
-        #
-        # @see Client#set_referer
         def set_referer(*args)
           !!client.bucket_set_referer(*args)
         end
@@ -202,7 +186,7 @@ module Aliyun
         #
         # @return [Array<Aliyun::Oss::Struct::Lifecycle?]
         #
-        # @see Client#bucket_get_lifecycle
+        # @see Api::BucketProperty#bucket_get_lifecycle
         def lifecycle!
           result = client.bucket_get_lifecycle.parsed_response
           lifecycle_keys = %w(LifecycleConfiguration Rule)
@@ -226,26 +210,21 @@ module Aliyun
 
         # Used to disable lifecycle for bucket
         #
-        # @raise (see #bucket_disable_lifecycle)
-        #
         # @return [true]
         #
-        # @see Client#bucket_disable_lifecycle
+        # @see Api::BucketProperty#bucket_disable_lifecycle
         def disable_lifecycle
           !!client.bucket_disable_lifecycle
         end
 
         # OPTIONS Object
         #
-        # @see (see #bucket_preflight)
-        #
-        # @param (see #bucket_preflight)
-        #
-        # @raise (see #bucket_preflight)
+        # @see Api::BucketProperty#bucket_preflight
+        # @example (see Api::BucketProperty#bucket_preflight)
+        # @param (see Api::BucketProperty#bucket_preflight)
+        # @raise (see Api::BucketProperty#bucket_preflight)
         #
         # @return [true]
-        #
-        # @see Client#bucket_preflight
         def preflight(*args)
           !!client.bucket_preflight(*args)
         end

data/lib/aliyun/oss/struct/directory.rb

@@ -7,18 +7,20 @@ module Aliyun
 
         # List objects under directory
         #
-        # @see #bucket_list_objects
-        #
-        # @param (see #bucket_list_objects)
-        # @option (see #bucket_list_objects)
-        #
-        # @raise [RequestError]
+        # @see Api::BucketObjects#bucket_list_objects
+        # @example (see Api::BucketObjects#bucket_list_objects)
+        # @param (see Api::BucketObjects#bucket_list_objects)
+        # @raise (see Api::BucketObjects#bucket_list_objects)
         #
         # @return [Array<Aliyun::Oss::Struct::Object>]
         def list(options = {})
           Utils.stringify_keys!(options)
           client.bucket_objects.list(options.merge('prefix' => key))
         end
+
+        def file?
+          false
+        end
       end
     end
   end

data/lib/aliyun/oss/struct/file.rb

@@ -2,6 +2,18 @@ module Aliyun
   module Oss
     module Struct
       class File < Object
+        def file?
+          true
+        end
+
+        # Get object share link
+        #
+        # @param expired_in_seconds [Integer] expire after specify seconds
+        #
+        # @return [URL]
+        def share_link(expired_in_seconds)
+          client.bucket_get_object_share_link(key, expired_in_seconds)
+        end
       end
     end
   end

data/lib/aliyun/oss/struct/multipart.rb

@@ -23,11 +23,13 @@ module Aliyun
 
         # Upload part to Multipart Upload Event
         #
+        # @see Api::BucketMultiparts#bucket_multipart_upload
+        # @example (see Api::BucketMultiparts#bucket_multipart_upload)
+        # @raise (see Api::BucketMultiparts#bucket_multipart_upload)
+        #
         # @param number [Integer] the part number, Range in 1~10000.
         # @param file [File, bin data] the upload data
         #
-        # @raise (see #bucket_multipart_upload)
-        #
         # @return [HTTParty::Response::Headers]
         def upload(*args)
           client.bucket_multipart_upload(*args.unshift(upload_id, key)).headers
@@ -37,13 +39,12 @@ module Aliyun
         #
         # @param number [Integer] the part number, Range in 1~10000.
         # @param options [Hash] options
-        # @option (see #bucket_multipart_copy_upload)
         #
-        # @raise (see #bucket_multipart_copy_upload)
+        # @see Api::BucketMultiparts#bucket_multipart_copy_upload
+        # @example (see Api::BucketMultiparts#bucket_multipart_copy_upload)
+        # @raise (see Api::BucketMultiparts#bucket_multipart_copy_upload)
         #
         # @return [true]
-        #
-        # @see Client#bucket_list_parts
         def copy(*args)
           !!client.bucket_multipart_copy_upload(*args.unshift(upload_id, key))
         end
@@ -51,13 +52,12 @@ module Aliyun
         # List uploaded parts for the Multipart Upload Event
         #
         # @param options [Hash] options
-        # @option (see #bucket_list_parts)
         #
-        # @raise (see #bucket_list_parts)
+        # @see Api::BucketMultiparts#bucket_list_parts
+        # @example (see Api::BucketMultiparts#bucket_list_parts)
+        # @raise (see Api::BucketMultiparts#bucket_list_parts)
         #
         # @return [Array<Aliyun::Oss::Struct::Part>]
-        #
-        # @see Client#bucket_list_parts
         def list_parts(options = {})
           result = client.bucket_list_parts(upload_id, key, options)
                    .parsed_response
@@ -70,13 +70,13 @@ module Aliyun
 
         # Complete Multipart Upload Event
         #
-        # @param parts [Array<Multipart:Part>] parts
+        # @param parts [Array<Aliyun::Oss::Multipart:Part>] parts
         #
-        # @raise (see #bucket_complete_multipart)
+        # @see Api::BucketMultiparts#bucket_complete_multipart
+        # @example (see Api::BucketMultiparts#bucket_complete_multipart)
+        # @raise (see Api::BucketMultiparts#bucket_complete_multipart)
         #
         # @return [Struct::Object]
-        #
-        # @see Client#bucket_complete_multipart
         def complete(parts = [])
           resp = client.bucket_complete_multipart(upload_id, key, parts)
           keys = %w(CompleteMultipartUploadResult)
@@ -87,11 +87,12 @@ module Aliyun
 
         # Abort Multipart Upload Event
         #
-        # @raise (see #bucket_abort_multipart)
+        # @see Api::BucketMultiparts#bucket_abort_multipart
+        # @note (see Api::BucketMultiparts#bucket_abort_multipart)
+        # @example (see Api::BucketMultiparts#bucket_abort_multipart)
+        # @raise (see Api::BucketMultiparts#bucket_abort_multipart)
         #
         # @return [true]
-        #
-        # @see Client#bucket_abort_multipart
         def abort
           !!client.bucket_abort_multipart(upload_id, key)
         end

data/lib/aliyun/oss/struct/object.rb

@@ -10,6 +10,7 @@ module Aliyun
 
         # etag of object
         attr_accessor :etag
+        alias_method :e_tag=, :etag=
 
         # type of object
         attr_accessor :type

data/lib/aliyun/oss/utils.rb

@@ -6,6 +6,21 @@ require 'gyoku'
 module Aliyun
   module Oss
     class Utils
+      # Get endpoint
+      #
+      # @example
+      #
+      #   get_endpoint('bucket-name', 'oss-cn-hangzhou.aliyuncs.com')
+      #   # => 'http://bucket-name.oss-cn-hangzhou.aliyuncs.com'
+      #
+      # @param bucket [String] the Bucket name
+      # @param host [String] the host of Bucket
+      #
+      # @return [String]
+      def self.get_endpoint(bucket, host)
+        "http://#{bucket}.#{host}/"
+      end
+
       # Calculate content length
       #
       # @return [Integer]

data/lib/aliyun/oss/version.rb

@@ -1,5 +1,5 @@
 module Aliyun
   module Oss
-    VERSION = '0.1.2'
+    VERSION = '0.1.5'
   end
 end

data/wiki/error.md

@@ -6,7 +6,7 @@ If a error occurs when visit the OSS, the OSS will be return a error code and er
 
     require 'aliyun/oss'
     
-    client = Aliyun::OSS::Client.new('ACCESS_KEY', 'SECRET_KEY', host: 'oss-cn-hangzhou.aliyuncs.com', bucket: 'oss-sdk-dev-hangzhou')
+    client = Aliyun::Oss::Client.new('ACCESS_KEY', 'SECRET_KEY', host: 'oss-cn-hangzhou.aliyuncs.com', bucket: 'oss-sdk-dev-hangzhou')
     
     res = client.bucket_create("invalid_bucket_name")
     unless res.success?
@@ -66,4 +66,4 @@ Here,
 |RequestTimeout	|Request Timeout| 400|
 |RequestIsNotMultiPartContent | Content-Type Invalid| 400|
 |SignatureDoesNotMatch	|Signature Does Not Match|403|
-|TooManyBuckets	|Too Many Buckets| 400|
+|TooManyBuckets	|Too Many Buckets| 400|

data/wiki/object_based/error.md

@@ -6,7 +6,7 @@ If a error occurs when visit the OSS, the OSS will be return a error code and er
 
     require 'aliyun/oss'
     
-    client = Aliyun::OSS::Client.new('ACCESS_KEY', 'SECRET_KEY', host: 'oss-cn-hangzhou.aliyuncs.com', bucket: 'oss-sdk-dev-hangzhou')
+    client = Aliyun::Oss::Client.new('ACCESS_KEY', 'SECRET_KEY', host: 'oss-cn-hangzhou.aliyuncs.com', bucket: 'oss-sdk-dev-hangzhou')
     
     begin
       client.buckets.create("invalid_bucket_name")
@@ -67,4 +67,4 @@ Here,
 |RequestTimeout	|Request Timeout| 400|
 |RequestIsNotMultiPartContent | Content-Type Invalid| 400|
 |SignatureDoesNotMatch	|Signature Does Not Match|403|
-|TooManyBuckets	|Too Many Buckets| 400|
+|TooManyBuckets	|Too Many Buckets| 400|

metadata

@@ -1,158 +1,153 @@
 --- !ruby/object:Gem::Specification
 name: aliyun-oss-sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.2
-  prerelease: 
+  version: 0.1.5
 platform: ruby
 authors:
 - Newell Zhu
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-11-02 00:00:00.000000000 Z
+date: 2015-12-08 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'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: gyoku
   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: bundler
   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: rake
   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: minitest
   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: mocha
   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: webmock
   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: timecop
   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: rubocop
   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: Aliyun OSS Ruby SDK
@@ -162,9 +157,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .rubocop.yml
-- .travis.yml
+- ".gitignore"
+- ".rubocop.yml"
+- ".travis.yml"
 - Gemfile
 - LICENSE
 - README.md
@@ -219,32 +214,25 @@ files:
 - wiki/object_based/object.md
 homepage: https://github.com/zlx/aliyun-oss-sdk
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 314123667821853469
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 314123667821853469
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.23.2
+rubygems_version: 2.2.0
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Aliyun OSS Ruby SDK
 test_files: []