RubyGems - cos - Versions diffs - 0.1.1 → 0.1.2 - Mend

cos 0.1.1 → 0.1.2

Files changed (13) hide show

checksums.yaml CHANGED

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8dd5186b7dc60c10661854d62c9ce39d4b13b52b
-  data.tar.gz: 16ec04430868339b7ef0806167c2273a90b8ff31
+  metadata.gz: 3df8feb5feb55c8ddf5ae731af49b213922403df
+  data.tar.gz: a5dda119bacdf36fd039c83b5576680ae175cd5f
 SHA512:
-  metadata.gz: c0e1a7704fe2b84be3a4b1901e1426bd0a8806ec4da8a95727496ac11cc3e234c4460d2e962e146f70e90c7841696d50d489d18085d16461a8e08b9ee9683b33
-  data.tar.gz: c6ce091a53d60fdbf3408815b0df75c4f7bd4b2d4da95df40634a1a634fd2ef4b431e385ad16040386b977e2ed5f977386a81d9c53c93bece631f2e4ef12c909
+  metadata.gz: 4095898e274f51ba793ac739b7ec69cddae487c13ef430015bfa533d163afc07f6bb7ad75ae4fb9c06fdab01625c5100d85f3ee983543222fa7206fa0f14e5de
+  data.tar.gz: a4f5268e15a3a20b2dfabd0a52c3ddeb2a06b8519ac4666906df81cc3853a7b503fb0a1a76a3a2603a7ae97ab9598349ec39e3edb37d04e2aef03c4a7ab60f2b

data/.travis.yml CHANGED

@@ -1,7 +1,7 @@
 language: ruby
 rvm:
   - 1.9.3
-  - jruby-19mode
+#  - jruby-19mode
   - 2.0
   - 2.1
   - 2.2
@@ -12,4 +12,4 @@ before_install: gem install bundler
 addons:
   code_climate:
-    repo_token: 1f460aa92bd5cff641f3ab71dad000c3c102689d97e2b4df90cb90789161284a
+    repo_token: 21930d55f6bdf5716ba7138f38e30ea6726226b3219ae17372e254700f58fe09

data/README.md CHANGED

@@ -1,6 +1,7 @@
 # Tencent COS Ruby SDK
-[![Gem Version](https://badge.fury.io/rb/cos.svg)](https://badge.fury.io/rb/cos) [![Dependency Status](https://gemnasium.com/bfcd58e8c449a47dcf4bd15e35806dc8.svg)](https://gemnasium.com/RaymondChou/cos-ruby-sdk) [![Code Climate](https://codeclimate.com/repos/5690d89cb1a7430e970051c5/badges/e1ec353330a7f9bb90a1/gpa.svg)](https://codeclimate.com/repos/5690d89cb1a7430e970051c5/feed) [![Build Status](https://travis-ci.com/RaymondChou/cos-ruby-sdk.svg?token=J7GcZgoty9nseAGRShu5&branch=master)](https://travis-ci.com/RaymondChou/cos-ruby-sdk) [![Test Coverage](https://codeclimate.com/repos/5690d89cb1a7430e970051c5/badges/e1ec353330a7f9bb90a1/coverage.svg)](https://codeclimate.com/repos/5690d89cb1a7430e970051c5/coverage)
+[![Gem Version](https://badge.fury.io/rb/cos.svg)](https://badge.fury.io/rb/cos) [![Dependency Status](https://gemnasium.com/RaymondChou/cos-ruby-sdk.svg)](https://gemnasium.com/RaymondChou/cos-ruby-sdk)
+ [![Code Climate](https://codeclimate.com/github/RaymondChou/cos-ruby-sdk/badges/gpa.svg)](https://codeclimate.com/github/RaymondChou/cos-ruby-sdk) [![Build Status](https://travis-ci.org/RaymondChou/cos-ruby-sdk.svg?branch=master)](https://travis-ci.org/RaymondChou/cos-ruby-sdk) [![Test Coverage](https://codeclimate.com/github/RaymondChou/cos-ruby-sdk/badges/coverage.svg)](https://codeclimate.com/github/RaymondChou/cos-ruby-sdk/coverage)
 [![Gitter](https://badges.gitter.im/RaymondChou/cos-ruby-sdk.svg)](https://gitter.im/RaymondChou/cos-ruby-sdk?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) [![Gem Downloads](http://ruby-gem-downloads-badge.herokuapp.com/cos?type=total)](https://rubygems.org/gems/cos) [![Github Code](http://img.shields.io/badge/github-code-blue.svg)](https://github.com/RaymondChou/cos-ruby-sdk) [![Yard Docs](http://img.shields.io/badge/yard-docs-blue.svg)](http://rubydoc.info/github/RaymondChou/cos-ruby-sdk)
@@ -20,7 +21,7 @@ Tencent🐧 COS(Cloud Object Service) SDK for Ruby  [腾讯云对象存储服务
 - 支持Rails
-- 提供便捷的CLI工具:
+- 提供便捷的[CLI工具:](#6-cli%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7)
   ![CLI示例](http://mytest-10016219.file.myqcloud.com/out2.gif)
@@ -38,69 +39,69 @@ Tencent🐧 COS(Cloud Object Service) SDK for Ruby  [腾讯云对象存储服务
   - [4 SDK详细说明](#4-sdk%E8%AF%A6%E7%BB%86%E8%AF%B4%E6%98%8E)
     - [4.1 初始化与配置](#41-%E5%88%9D%E5%A7%8B%E5%8C%96%E4%B8%8E%E9%85%8D%E7%BD%AE)
     - [4.2 指定Bucket](#42-%E6%8C%87%E5%AE%9Abucket)
-    - [4.3 Bucket操作（COS::Bucket）](#43-bucket%E6%93%8D%E4%BD%9C%EF%BC%88cosbucket%EF%BC%89)
+    - [4.3 Bucket操作（COS::Bucket）](#43-bucket%E6%93%8D%E4%BD%9Ccosbucket)
       - [4.3.1 获取Bucket属性](#431-%E8%8E%B7%E5%8F%96bucket%E5%B1%9E%E6%80%A7)
-      - [4.3.2 创建目录（create_folder，mkdir）](#432-%E5%88%9B%E5%BB%BA%E7%9B%AE%E5%BD%95%EF%BC%88create_folder%EF%BC%8Cmkdir%EF%BC%89)
-      - [4.3.3 列举目录（list，ls）](#433-%E5%88%97%E4%B8%BE%E7%9B%AE%E5%BD%95%EF%BC%88list%EF%BC%8Cls%EF%BC%89)
-      - [4.3.4 上传文件（upload）](#434-%E4%B8%8A%E4%BC%A0%E6%96%87%E4%BB%B6%EF%BC%88upload%EF%BC%89)
-      - [4.3.4 资源属性（stat）](#434-%E8%B5%84%E6%BA%90%E5%B1%9E%E6%80%A7%EF%BC%88stat%EF%BC%89)
-      - [4.3.5 更新资源属性（upadte）](#435-%E6%9B%B4%E6%96%B0%E8%B5%84%E6%BA%90%E5%B1%9E%E6%80%A7%EF%BC%88upadte%EF%BC%89)
-      - [4.3.6 删除资源（delete）](#436-%E5%88%A0%E9%99%A4%E8%B5%84%E6%BA%90%EF%BC%88delete%EF%BC%89)
-      - [4.3.7 删除资源（无异常）（delete!）](#437-%E5%88%A0%E9%99%A4%E8%B5%84%E6%BA%90%EF%BC%88%E6%97%A0%E5%BC%82%E5%B8%B8%EF%BC%89%EF%BC%88delete%EF%BC%89)
-      - [4.3.8 判断目录是否为空（empty?）](#438-%E5%88%A4%E6%96%AD%E7%9B%AE%E5%BD%95%E6%98%AF%E5%90%A6%E4%B8%BA%E7%A9%BA%EF%BC%88empty%EF%BC%89)
-      - [4.3.9 判断资源是否存在（exist?，exists?）](#439-%E5%88%A4%E6%96%AD%E8%B5%84%E6%BA%90%E6%98%AF%E5%90%A6%E5%AD%98%E5%9C%A8%EF%BC%88exist%EF%BC%8Cexists%EF%BC%89)
-      - [4.3.9 判断文件是否上传完成（complete?）](#439-%E5%88%A4%E6%96%AD%E6%96%87%E4%BB%B6%E6%98%AF%E5%90%A6%E4%B8%8A%E4%BC%A0%E5%AE%8C%E6%88%90%EF%BC%88complete%EF%BC%89)
-      - [4.3.10 获取文件的访问URL（url）](#4310-%E8%8E%B7%E5%8F%96%E6%96%87%E4%BB%B6%E7%9A%84%E8%AE%BF%E9%97%AEurl%EF%BC%88url%EF%BC%89)
-      - [4.3.11 下载文件（download）](#4311-%E4%B8%8B%E8%BD%BD%E6%96%87%E4%BB%B6%EF%BC%88download%EF%BC%89)
-      - [4.3.12 获取Object树形结构（tree）](#4312-%E8%8E%B7%E5%8F%96object%E6%A0%91%E5%BD%A2%E7%BB%93%E6%9E%84%EF%BC%88tree%EF%BC%89)
-      - [4.3.13 获取Hash树形结构（hash_tree）](#4313-%E8%8E%B7%E5%8F%96hash%E6%A0%91%E5%BD%A2%E7%BB%93%E6%9E%84%EF%BC%88hash_tree%EF%BC%89)
-      - [4.3.14 批量下载目录下的所有文件（download_all）](#4314-%E6%89%B9%E9%87%8F%E4%B8%8B%E8%BD%BD%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84%E6%89%80%E6%9C%89%E6%96%87%E4%BB%B6%EF%BC%88download_all%EF%BC%89)
-      - [4.3.15 批量上传目录中的所有文件（upload_all）](#4315-%E6%89%B9%E9%87%8F%E4%B8%8A%E4%BC%A0%E7%9B%AE%E5%BD%95%E4%B8%AD%E7%9A%84%E6%89%80%E6%9C%89%E6%96%87%E4%BB%B6%EF%BC%88upload_all%EF%BC%89)
-      - [4.3.16 获取资源个数详情（支持前缀搜索）（list_count）](#4316-%E8%8E%B7%E5%8F%96%E8%B5%84%E6%BA%90%E4%B8%AA%E6%95%B0%E8%AF%A6%E6%83%85%EF%BC%88%E6%94%AF%E6%8C%81%E5%89%8D%E7%BC%80%E6%90%9C%E7%B4%A2%EF%BC%89%EF%BC%88list_count%EF%BC%89)
-      - [4.3.17 获取资源个数（count, size）](#4317-%E8%8E%B7%E5%8F%96%E8%B5%84%E6%BA%90%E4%B8%AA%E6%95%B0%EF%BC%88count-size%EF%BC%89)
-      - [4.3.18 获取文件个数（count_files）](#4318-%E8%8E%B7%E5%8F%96%E6%96%87%E4%BB%B6%E4%B8%AA%E6%95%B0%EF%BC%88count_files%EF%BC%89)
-      - [4.3.19 获取目录个数（count_dirs）](#4319-%E8%8E%B7%E5%8F%96%E7%9B%AE%E5%BD%95%E4%B8%AA%E6%95%B0%EF%BC%88count_dirs%EF%BC%89)
+      - [4.3.2 创建目录（create_folder，mkdir）](#432-%E5%88%9B%E5%BB%BA%E7%9B%AE%E5%BD%95create_folder)
+      - [4.3.3 列举目录（list，ls）](#433-%E5%88%97%E4%B8%BE%E7%9B%AE%E5%BD%95listls)
+      - [4.3.4 上传文件（upload）](#434-%E4%B8%8A%E4%BC%A0%E6%96%87%E4%BB%B6upload)
+      - [4.3.4 资源属性（stat）](#434-%E8%B5%84%E6%BA%90%E5%B1%9E%E6%80%A7stat)
+      - [4.3.5 更新资源属性（upadte）](#435-%E6%9B%B4%E6%96%B0%E8%B5%84%E6%BA%90%E5%B1%9E%E6%80%A7upadte)
+      - [4.3.6 删除资源（delete）](#436-%E5%88%A0%E9%99%A4%E8%B5%84%E6%BA%90delete)
+      - [4.3.7 删除资源（无异常）（delete!）](#437-%E5%88%A0%E9%99%A4%E8%B5%84%E6%BA%90%E6%97%A0%E5%BC%82%E5%B8%B8delete)
+      - [4.3.8 判断目录是否为空（empty?）](#438-%E5%88%A4%E6%96%AD%E7%9B%AE%E5%BD%95%E6%98%AF%E5%90%A6%E4%B8%BA%E7%A9%BAempty)
+      - [4.3.9 判断资源是否存在（exist?，exists?）](#439-%E5%88%A4%E6%96%AD%E8%B5%84%E6%BA%90%E6%98%AF%E5%90%A6%E5%AD%98%E5%9C%A8existexists)
+      - [4.3.9 判断文件是否上传完成（complete?）](#439-%E5%88%A4%E6%96%AD%E6%96%87%E4%BB%B6%E6%98%AF%E5%90%A6%E4%B8%8A%E4%BC%A0%E5%AE%8C%E6%88%90complete)
+      - [4.3.10 获取文件的访问URL（url）](#4310-%E8%8E%B7%E5%8F%96%E6%96%87%E4%BB%B6%E7%9A%84%E8%AE%BF%E9%97%AEurlurl)
+      - [4.3.11 下载文件（download）](#4311-%E4%B8%8B%E8%BD%BD%E6%96%87%E4%BB%B6download)
+      - [4.3.12 获取Object树形结构（tree）](#4312-%E8%8E%B7%E5%8F%96object%E6%A0%91%E5%BD%A2%E7%BB%93%E6%9E%84tree)
+      - [4.3.13 获取Hash树形结构（hash_tree）](#4313-%E8%8E%B7%E5%8F%96hash%E6%A0%91%E5%BD%A2%E7%BB%93%E6%9E%84hash_tree)
+      - [4.3.14 批量下载目录下的所有文件（download_all）](#4314-%E6%89%B9%E9%87%8F%E4%B8%8B%E8%BD%BD%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84%E6%89%80%E6%9C%89%E6%96%87%E4%BB%B6download_all)
+      - [4.3.15 批量上传目录中的所有文件（upload_all）](#4315-%E6%89%B9%E9%87%8F%E4%B8%8A%E4%BC%A0%E7%9B%AE%E5%BD%95%E4%B8%AD%E7%9A%84%E6%89%80%E6%9C%89%E6%96%87%E4%BB%B6upload_all)
+      - [4.3.16 获取资源个数详情（支持前缀搜索）（list_count）](#4316-%E8%8E%B7%E5%8F%96%E8%B5%84%E6%BA%90%E4%B8%AA%E6%95%B0%E8%AF%A6%E6%83%85%E6%94%AF%E6%8C%81%E5%89%8D%E7%BC%80%E6%90%9C%E7%B4%A2list_count)
+      - [4.3.17 获取资源个数（count, size）](#4317-%E8%8E%B7%E5%8F%96%E8%B5%84%E6%BA%90%E4%B8%AA%E6%95%B0count-size)
+      - [4.3.18 获取文件个数（count_files）](#4318-%E8%8E%B7%E5%8F%96%E6%96%87%E4%BB%B6%E4%B8%AA%E6%95%B0count_files)
+      - [4.3.19 获取目录个数（count_dirs）](#4319-%E8%8E%B7%E5%8F%96%E7%9B%AE%E5%BD%95%E4%B8%AA%E6%95%B0count_dirs)
     - [4.4 资源操作](#44-%E8%B5%84%E6%BA%90%E6%93%8D%E4%BD%9C)
-      - [4.4.1 文件操作（COS::COSFile）](#441-%E6%96%87%E4%BB%B6%E6%93%8D%E4%BD%9C%EF%BC%88coscosfile%EF%BC%89)
+      - [4.4.1 文件操作（COS::COSFile）](#441-%E6%96%87%E4%BB%B6%E6%93%8D%E4%BD%9Ccoscosfile)
         - [4.4.1.1 获取文件属性](#4411-%E8%8E%B7%E5%8F%96%E6%96%87%E4%BB%B6%E5%B1%9E%E6%80%A7)
-        - [4.4.1.2 获取当前文件属性（刷新）（stat）](#4412-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%E5%B1%9E%E6%80%A7%EF%BC%88%E5%88%B7%E6%96%B0%EF%BC%89%EF%BC%88stat%EF%BC%89)
-        - [4.4.1.3 更新当前文件属性（upadte）](#4413-%E6%9B%B4%E6%96%B0%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%E5%B1%9E%E6%80%A7%EF%BC%88upadte%EF%BC%89)
-        - [4.4.1.4 删除当前文件（delete）](#4414-%E5%88%A0%E9%99%A4%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%EF%BC%88delete%EF%BC%89)
-        - [4.4.1.5 删除当前文件（无异常）（delete!）](#4415-%E5%88%A0%E9%99%A4%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%EF%BC%88%E6%97%A0%E5%BC%82%E5%B8%B8%EF%BC%89%EF%BC%88delete%EF%BC%89)
-        - [4.4.1.6 判断当前文件是否存在（exist?，exists?）](#4416-%E5%88%A4%E6%96%AD%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%E6%98%AF%E5%90%A6%E5%AD%98%E5%9C%A8%EF%BC%88exist%EF%BC%8Cexists%EF%BC%89)
-        - [4.4.1.7 判断当前文件是否上传完成（complete?）](#4417-%E5%88%A4%E6%96%AD%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%E6%98%AF%E5%90%A6%E4%B8%8A%E4%BC%A0%E5%AE%8C%E6%88%90%EF%BC%88complete%EF%BC%89)
-        - [4.4.1.8 获取当前文件的访问URL（url）](#4418-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%E7%9A%84%E8%AE%BF%E9%97%AEurl%EF%BC%88url%EF%BC%89)
-        - [4.4.1.9 下载当前文件（download）](#4419-%E4%B8%8B%E8%BD%BD%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%EF%BC%88download%EF%BC%89)
+        - [4.4.1.2 获取当前文件属性（刷新）（stat）](#4412-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%E5%B1%9E%E6%80%A7%E5%88%B7%E6%96%B0stat)
+        - [4.4.1.3 更新当前文件属性（upadte）](#4413-%E6%9B%B4%E6%96%B0%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%E5%B1%9E%E6%80%A7upadte)
+        - [4.4.1.4 删除当前文件（delete）](#4414-%E5%88%A0%E9%99%A4%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6delete)
+        - [4.4.1.5 删除当前文件（无异常）（delete!）](#4415-%E5%88%A0%E9%99%A4%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%E6%97%A0%E5%BC%82%E5%B8%B8delete)
+        - [4.4.1.6 判断当前文件是否存在（exist?，exists?）](#4416-%E5%88%A4%E6%96%AD%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%E6%98%AF%E5%90%A6%E5%AD%98%E5%9C%A8existexists)
+        - [4.4.1.7 判断当前文件是否上传完成（complete?）](#4417-%E5%88%A4%E6%96%AD%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%E6%98%AF%E5%90%A6%E4%B8%8A%E4%BC%A0%E5%AE%8C%E6%88%90complete)
+        - [4.4.1.8 获取当前文件的访问URL（url）](#4418-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%E7%9A%84%E8%AE%BF%E9%97%AEurlurl)
+        - [4.4.1.9 下载当前文件（download）](#4419-%E4%B8%8B%E8%BD%BD%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6download)
         - [4.4.1.10 判断当前文件与本地文件是否相同](#44110-%E5%88%A4%E6%96%AD%E5%BD%93%E5%89%8D%E6%96%87%E4%BB%B6%E4%B8%8E%E6%9C%AC%E5%9C%B0%E6%96%87%E4%BB%B6%E6%98%AF%E5%90%A6%E7%9B%B8%E5%90%8C)
-      - [4.4.2 目录操作（COS::COSDir）](#442-%E7%9B%AE%E5%BD%95%E6%93%8D%E4%BD%9C%EF%BC%88coscosdir%EF%BC%89)
+      - [4.4.2 目录操作（COS::COSDir）](#442-%E7%9B%AE%E5%BD%95%E6%93%8D%E4%BD%9Ccoscosdir)
         - [4.4.2.1 获取目录属性](#4421-%E8%8E%B7%E5%8F%96%E7%9B%AE%E5%BD%95%E5%B1%9E%E6%80%A7)
-        - [4.4.2.2 列举当前目录（前缀搜索）（list，ls）](#4422-%E5%88%97%E4%B8%BE%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%EF%BC%88%E5%89%8D%E7%BC%80%E6%90%9C%E7%B4%A2%EF%BC%89%EF%BC%88list%EF%BC%8Cls%EF%BC%89)
-        - [4.4.2.3 创建子目录（create_folder，mkdir）](#4423-%E5%88%9B%E5%BB%BA%E5%AD%90%E7%9B%AE%E5%BD%95%EF%BC%88create_folder%EF%BC%8Cmkdir%EF%BC%89)
-        - [4.4.2.4 上传文件至当前目录（upload）](#4424-%E4%B8%8A%E4%BC%A0%E6%96%87%E4%BB%B6%E8%87%B3%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%EF%BC%88upload%EF%BC%89)
-        - [4.4.2.5 批量上传本地目录中的所有文件至当前目录（upload_all）](#4425-%E6%89%B9%E9%87%8F%E4%B8%8A%E4%BC%A0%E6%9C%AC%E5%9C%B0%E7%9B%AE%E5%BD%95%E4%B8%AD%E7%9A%84%E6%89%80%E6%9C%89%E6%96%87%E4%BB%B6%E8%87%B3%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%EF%BC%88upload_all%EF%BC%89)
-        - [4.4.2.6 批量下载当前目录下的所有文件（download_all）](#4426-%E6%89%B9%E9%87%8F%E4%B8%8B%E8%BD%BD%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84%E6%89%80%E6%9C%89%E6%96%87%E4%BB%B6%EF%BC%88download_all%EF%BC%89)
-        - [4.4.2.7 当前目录属性（刷新）（stat）](#4427-%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E5%B1%9E%E6%80%A7%EF%BC%88%E5%88%B7%E6%96%B0%EF%BC%89%EF%BC%88stat%EF%BC%89)
-        - [4.4.2.8 更新当前目录属性（upadte）](#4428-%E6%9B%B4%E6%96%B0%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E5%B1%9E%E6%80%A7%EF%BC%88upadte%EF%BC%89)
-        - [4.4.2.9 删除当前目录（delete）](#4429-%E5%88%A0%E9%99%A4%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%EF%BC%88delete%EF%BC%89)
-        - [4.4.2.10 删除当前目录（无异常）（delete!）](#44210-%E5%88%A0%E9%99%A4%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%EF%BC%88%E6%97%A0%E5%BC%82%E5%B8%B8%EF%BC%89%EF%BC%88delete%EF%BC%89)
-        - [4.4.2.11 判断当前目录是否为空（empty?）](#44211-%E5%88%A4%E6%96%AD%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E6%98%AF%E5%90%A6%E4%B8%BA%E7%A9%BA%EF%BC%88empty%EF%BC%89)
-        - [4.4.2.12 判断当前目录是否存在（exist?，exists?）](#44212-%E5%88%A4%E6%96%AD%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E6%98%AF%E5%90%A6%E5%AD%98%E5%9C%A8%EF%BC%88exist%EF%BC%8Cexists%EF%BC%89)
-        - [4.4.2.13 获取当前目录下的Object树形结构（tree）](#44213-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84object%E6%A0%91%E5%BD%A2%E7%BB%93%E6%9E%84%EF%BC%88tree%EF%BC%89)
-        - [4.4.2.14 获取当前目录下的Hash树形结构（hash_tree）](#44214-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84hash%E6%A0%91%E5%BD%A2%E7%BB%93%E6%9E%84%EF%BC%88hash_tree%EF%BC%89)
-        - [4.4.2.15 获取当前目录下的资源个数详情（支持前缀搜索）（list_count）](#44215-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84%E8%B5%84%E6%BA%90%E4%B8%AA%E6%95%B0%E8%AF%A6%E6%83%85%EF%BC%88%E6%94%AF%E6%8C%81%E5%89%8D%E7%BC%80%E6%90%9C%E7%B4%A2%EF%BC%89%EF%BC%88list_count%EF%BC%89)
-        - [4.4.2.16 获取当前目录下的资源个数（count, size）](#44216-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84%E8%B5%84%E6%BA%90%E4%B8%AA%E6%95%B0%EF%BC%88count-size%EF%BC%89)
-        - [4.4.2.17 获取当前目录下的文件个数（count_files）](#44217-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84%E6%96%87%E4%BB%B6%E4%B8%AA%E6%95%B0%EF%BC%88count_files%EF%BC%89)
-        - [4.4.2.18 获取当前目录下的子目录个数（count_dirs）](#44218-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84%E5%AD%90%E7%9B%AE%E5%BD%95%E4%B8%AA%E6%95%B0%EF%BC%88count_dirs%EF%BC%89)
-    - [4.5 签名操作（COS::Signature）](#45-%E7%AD%BE%E5%90%8D%E6%93%8D%E4%BD%9C%EF%BC%88cossignature%EF%BC%89)
-      - [4.5.1 获取单次有效签名（once）](#451-%E8%8E%B7%E5%8F%96%E5%8D%95%E6%AC%A1%E6%9C%89%E6%95%88%E7%AD%BE%E5%90%8D%EF%BC%88once%EF%BC%89)
-      - [4.5.2 获取多次有效签名（multiple）](#452-%E8%8E%B7%E5%8F%96%E5%A4%9A%E6%AC%A1%E6%9C%89%E6%95%88%E7%AD%BE%E5%90%8D%EF%BC%88multiple%EF%BC%89)
-  - [5 底层API（COS::API）](#5-%E5%BA%95%E5%B1%82api%EF%BC%88cosapi%EF%BC%89)
+        - [4.4.2.2 列举当前目录（前缀搜索）（list，ls）](#4422-%E5%88%97%E4%B8%BE%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E5%89%8D%E7%BC%80%E6%90%9C%E7%B4%A2listls)
+        - [4.4.2.3 创建子目录（create_folder，mkdir）](#4423-%E5%88%9B%E5%BB%BA%E5%AD%90%E7%9B%AE%E5%BD%95create_folder)
+        - [4.4.2.4 上传文件至当前目录（upload）](#4424-%E4%B8%8A%E4%BC%A0%E6%96%87%E4%BB%B6%E8%87%B3%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95upload)
+        - [4.4.2.5 批量上传本地目录中的所有文件至当前目录（upload_all）](#4425-%E6%89%B9%E9%87%8F%E4%B8%8A%E4%BC%A0%E6%9C%AC%E5%9C%B0%E7%9B%AE%E5%BD%95%E4%B8%AD%E7%9A%84%E6%89%80%E6%9C%89%E6%96%87%E4%BB%B6%E8%87%B3%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95upload_all)
+        - [4.4.2.6 批量下载当前目录下的所有文件（download_all）](#4426-%E6%89%B9%E9%87%8F%E4%B8%8B%E8%BD%BD%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84%E6%89%80%E6%9C%89%E6%96%87%E4%BB%B6download_all)
+        - [4.4.2.7 当前目录属性（刷新）（stat）](#4427-%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E5%B1%9E%E6%80%A7%E5%88%B7%E6%96%B0stat)
+        - [4.4.2.8 更新当前目录属性（upadte）](#4428-%E6%9B%B4%E6%96%B0%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E5%B1%9E%E6%80%A7upadte)
+        - [4.4.2.9 删除当前目录（delete）](#4429-%E5%88%A0%E9%99%A4%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95delete)
+        - [4.4.2.10 删除当前目录（无异常）（delete!）](#44210-%E5%88%A0%E9%99%A4%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E6%97%A0%E5%BC%82%E5%B8%B8delete)
+        - [4.4.2.11 判断当前目录是否为空（empty?）](#44211-%E5%88%A4%E6%96%AD%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E6%98%AF%E5%90%A6%E4%B8%BA%E7%A9%BAempty)
+        - [4.4.2.12 判断当前目录是否存在（exist?，exists?）](#44212-%E5%88%A4%E6%96%AD%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E6%98%AF%E5%90%A6%E5%AD%98%E5%9C%A8existexists)
+        - [4.4.2.13 获取当前目录下的Object树形结构（tree）](#44213-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84object%E6%A0%91%E5%BD%A2%E7%BB%93%E6%9E%84tree)
+        - [4.4.2.14 获取当前目录下的Hash树形结构（hash_tree）](#44214-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84hash%E6%A0%91%E5%BD%A2%E7%BB%93%E6%9E%84hash_tree)
+        - [4.4.2.15 获取当前目录下的资源个数详情（支持前缀搜索）（list_count）](#44215-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84%E8%B5%84%E6%BA%90%E4%B8%AA%E6%95%B0%E8%AF%A6%E6%83%85%E6%94%AF%E6%8C%81%E5%89%8D%E7%BC%80%E6%90%9C%E7%B4%A2list_count)
+        - [4.4.2.16 获取当前目录下的资源个数（count, size）](#44216-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84%E8%B5%84%E6%BA%90%E4%B8%AA%E6%95%B0count-size)
+        - [4.4.2.17 获取当前目录下的文件个数（count_files）](#44217-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84%E6%96%87%E4%BB%B6%E4%B8%AA%E6%95%B0count_files)
+        - [4.4.2.18 获取当前目录下的子目录个数（count_dirs）](#44218-%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84%E5%AD%90%E7%9B%AE%E5%BD%95%E4%B8%AA%E6%95%B0count_dirs)
+    - [4.5 签名操作（COS::Signature）](#45-%E7%AD%BE%E5%90%8D%E6%93%8D%E4%BD%9Ccossignature)
+      - [4.5.1 获取单次有效签名（once）](#451-%E8%8E%B7%E5%8F%96%E5%8D%95%E6%AC%A1%E6%9C%89%E6%95%88%E7%AD%BE%E5%90%8Donce)
+      - [4.5.2 获取多次有效签名（multiple）](#452-%E8%8E%B7%E5%8F%96%E5%A4%9A%E6%AC%A1%E6%9C%89%E6%95%88%E7%AD%BE%E5%90%8Dmultiple)
+  - [5 底层API（COS::API）](#5-%E5%BA%95%E5%B1%82apicosapi)
     - [5.1 创建目录(create_folder)](#51-%E5%88%9B%E5%BB%BA%E7%9B%AE%E5%BD%95create_folder)
-    - [5.2 目录列表（前缀搜索）(list)](#52-%E7%9B%AE%E5%BD%95%E5%88%97%E8%A1%A8%EF%BC%88%E5%89%8D%E7%BC%80%E6%90%9C%E7%B4%A2%EF%BC%89list)
-    - [5.3 上传文件（完整上传）(upload)](#53-%E4%B8%8A%E4%BC%A0%E6%96%87%E4%BB%B6%EF%BC%88%E5%AE%8C%E6%95%B4%E4%B8%8A%E4%BC%A0%EF%BC%89upload)
-    - [5.4 上传文件（分片上传）(upload_slice)](#54-%E4%B8%8A%E4%BC%A0%E6%96%87%E4%BB%B6%EF%BC%88%E5%88%86%E7%89%87%E4%B8%8A%E4%BC%A0%EF%BC%89upload_slice)
-    - [5.5 更新文件、目录属性(update)](#55-%E6%9B%B4%E6%96%B0%E6%96%87%E4%BB%B6%E3%80%81%E7%9B%AE%E5%BD%95%E5%B1%9E%E6%80%A7update)
-    - [5.6 删除文件、目录(delete)](#56-%E5%88%A0%E9%99%A4%E6%96%87%E4%BB%B6%E3%80%81%E7%9B%AE%E5%BD%95delete)
+    - [5.2 目录列表（前缀搜索）(list)](#52-%E7%9B%AE%E5%BD%95%E5%88%97%E8%A1%A8%E5%89%8D%E7%BC%80%E6%90%9C%E7%B4%A2list)
+    - [5.3 上传文件（完整上传）(upload)](#53-%E4%B8%8A%E4%BC%A0%E6%96%87%E4%BB%B6%E5%AE%8C%E6%95%B4%E4%B8%8A%E4%BC%A0upload)
+    - [5.4 上传文件（分片上传）(upload_slice)](#54-%E4%B8%8A%E4%BC%A0%E6%96%87%E4%BB%B6%E5%88%86%E7%89%87%E4%B8%8A%E4%BC%A0upload_slice)
+    - [5.5 更新文件、目录属性(update)](#55-%E6%9B%B4%E6%96%B0%E6%96%87%E4%BB%B6%E7%9B%AE%E5%BD%95%E5%B1%9E%E6%80%A7update)
+    - [5.6 删除文件、目录(delete)](#56-%E5%88%A0%E9%99%A4%E6%96%87%E4%BB%B6%E7%9B%AE%E5%BD%95delete)
     - [5.7 获取文件或目录属性(stat)](#57-%E8%8E%B7%E5%8F%96%E6%96%87%E4%BB%B6%E6%88%96%E7%9B%AE%E5%BD%95%E5%B1%9E%E6%80%A7stat)
     - [5.8下载文件](#58%E4%B8%8B%E8%BD%BD%E6%96%87%E4%BB%B6)
   - [6 CLI命令行工具](#6-cli%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7)
@@ -152,7 +153,7 @@ client = COS::Client.new({
 })
 ```
-更多初始化参数及加载方式请见：4.1 初始化与配置
+更多初始化参数及加载方式请见： [4.1 初始化与配置](#41-%E5%88%9D%E5%A7%8B%E5%8C%96%E4%B8%8E%E9%85%8D%E7%BD%AE)
 ### 3.3 指定Bucket
@@ -282,7 +283,7 @@ file.delete
     # 使用协议,默认为http,可选https
     :protocol => 'https',
     # 接口通讯建立连接超时秒数
-    :open_timeout => 15,
+    :open_timeout => 30,
     # 接口通讯读取数据超时秒数
     :read_timeout => 120,
     # 加载配置文件路径
@@ -440,21 +441,21 @@ end
 参数：
-| 参数名                          |   类型    |     必须      |       默认值        | 参数描述                                    |
-| :--------------------------- | :-----: | :---------: | :--------------: | --------------------------------------- |
-| path_or_dir                  | String\ | COS::COSDir |        是         | 无                                       |
-| file_name                    | String  |      是      |        无         | 存储文件名                                   |
-| file_src                     | String  |      是      |        无         | 本地文件路径                                  |
-| options                      |  Hash   |      否      |        无         |                                         |
-| options[:auto_create_folder] | Boolean |      否      |      false       | 自动创建远端目录                                |
-| options[:min_slice_size]     | Integer |      否      | 10 * 1024 * 1024 | 完整上传最小文件大小,超过此大小将会使用分片多线程断点续传           |
-| options[:upload_retry]       | Integer |      否      |        10        | 上传重试次数                                  |
-| options[:biz_attr]           | String  |      否      |        无         | 业务属性                                    |
-| options[:disable_cpt]        | Boolean |      否      |      false       | 是否禁用checkpoint，如禁用仍可通过服务端进行断点续传         |
-| options[:threads]            | Integer |      否      |        10        | 多线程上传线程数                                |
-| options[:slice_size]         | Integer |      否      | 3 * 1024 * 1024  | 设置分片上传时每个分片的大小。默认为3 MB, 目前服务端最大限制也为3MB。 |
-| options[:cpt_file]           | String  |      否      |        无         | 断点续传的checkpoint文件                       |
-| yield                        |  Float  |      否      |        无         | 上传进度百分比回调, 进度值是一个0-1之间的小数               |
+| 参数名                          |         类型         |  必须  |       默认值        | 参数描述                                     |
+| :--------------------------- | :----------------: | :--: | :--------------: | ---------------------------------------- |
+| path_or_dir                  | String/COS::COSDir |  否   |        空         | 目录路径或目录对象COSDir目录路径如: '/', 'path1', 'path1/path2', sdk会补齐末尾的 '/' |
+| file_name                    |       String       |  是   |        无         | 存储文件名                                    |
+| file_src                     |       String       |  是   |        无         | 本地文件路径                                   |
+| options                      |        Hash        |  否   |        无         |                                          |
+| options[:auto_create_folder] |      Boolean       |  否   |      false       | 自动创建远端目录                                 |
+| options[:min_slice_size]     |      Integer       |  否   | 10 * 1024 * 1024 | 完整上传最小文件大小,超过此大小将会使用分片多线程断点续传            |
+| options[:upload_retry]       |      Integer       |  否   |        10        | 上传重试次数                                   |
+| options[:biz_attr]           |       String       |  否   |        无         | 业务属性                                     |
+| options[:disable_cpt]        |      Boolean       |  否   |      false       | 是否禁用checkpoint，如禁用仍可通过服务端进行断点续传          |
+| options[:threads]            |      Integer       |  否   |        10        | 多线程上传线程数                                 |
+| options[:slice_size]         |      Integer       |  否   | 3 * 1024 * 1024  | 设置分片上传时每个分片的大小。默认为3 MB, 目前服务端最大限制也为3MB。  |
+| options[:cpt_file]           |       String       |  否   |        无         | 断点续传的checkpoint文件                        |
+| yield                        |       Float        |  否   |        无         | 上传进度百分比回调, 进度值是一个0-1之间的小数                |
 注：SDK会自动使用分片断点续传上传大文件。
@@ -658,13 +659,13 @@ puts @bucket.complete?('path/file1')
 参数：
-| 参数名                      |   类型    |      必须      |  默认值  | 参数描述                            |
-| :----------------------- | :-----: | :----------: | :---: | ------------------------------- |
-| path_or_file             | String\ | COS::COSFile |   否   | 空                               |
-| options                  |  Hash   |              |       |                                 |
-| options[:cname]          | String  |      否       |   无   | 获取使用cname的url。在cos控制台设置的cname域名 |
-| options[:https]          | Boolean |      否       | false | 是否获取https的url                   |
-| options[:expire_seconds] | Integer |      否       |  600  | 签名有效时间(秒,私有读取bucket时需要)         |
+| 参数名                      |         类型          |  必须  |  默认值  | 参数描述                            |
+| :----------------------- | :-----------------: | :--: | :---: | ------------------------------- |
+| path_or_file             | String/COS::COSFile |  否   |   空   | 文件资源COSFile或路径, 如: 'path1/file' |
+| options                  |        Hash         |      |       |                                 |
+| options[:cname]          |       String        |  否   |   无   | 获取使用cname的url。在cos控制台设置的cname域名 |
+| options[:https]          |       Boolean       |  否   | false | 是否获取https的url                   |
+| options[:expire_seconds] |       Integer       |  否   |  600  | 签名有效时间(秒,私有读取bucket时需要)         |
 返回：
@@ -686,16 +687,17 @@ puts bucket.url('path1/file1', https: true, cname: 'static.domain.com')
 参数：
-| 参数名                      |   类型    |      必须      |      默认值      | 参数描述                          |
-| :----------------------- | :-----: | :----------: | :-----------: | ----------------------------- |
-| path_or_file             | String\ | COS::COSFile |       是       | 无                             |
-| file_store               | String  |      是       |       无       | 本地文件存储路径                      |
-| options                  |  Hash   |      否       |       无       |                               |
-| options[:disable_mkdir]  | Boolean |      否       |     true      | 禁止自动创建本地文件夹, 默认会创建            |
-| options[:min_slice_size] | Integer |      否       | 5 * 10 * 1024 | 完整下载最小文件大小,超过此大小将会使用分片多线程断点续传 |
-| options[:download_retry] | Integer |      否       |      10       | 下载重试次数                        |
-| options[:disable_cpt]    | Boolean |      否       |     false     | 是否禁用checkpoint，如果禁用则不使用断点续传   |
-| yield                    |  Float  |      否       |       无       | 下载进度百分比回调, 进度值是一个0-1之间的小数     |
+| 参数名                      |         类型          |  必须  |      默认值      | 参数描述                            |
+| :----------------------- | :-----------------: | :--: | :-----------: | ------------------------------- |
+| path_or_file             | String/COS::COSFile |  是   |       无       | 文件资源COSFile或路径, 如: 'path1/file' |
+| file_store               |       String        |  是   |       无       | 本地文件存储路径                        |
+| options                  |        Hash         |  否   |       无       |                                 |
+| options[:disable_mkdir]  |       Boolean       |  否   |     true      | 禁止自动创建本地文件夹, 默认会创建              |
+| options[:min_slice_size] |       Integer       |  否   | 5 * 10 * 1024 | 完整下载最小文件大小,超过此大小将会使用分片多线程断点续传   |
+| options[:part_size] |       Integer       |  否   | 5 * 10 * 1024 | 分片下载大小,如多线程下载时使用该大小分片下载   |
+| options[:download_retry] |       Integer       |  否   |      10       | 下载重试次数                          |
+| options[:disable_cpt]    |       Boolean       |  否   |     false     | 是否禁用checkpoint，如果禁用则不使用断点续传     |
+| yield                    |        Float        |  否   |       无       | 下载进度百分比回调, 进度值是一个0-1之间的小数       |
 注：支持私有访问资源下载，SDK会自动携带鉴权签名。SDK会自动使用分片断点续传下载大文件。
@@ -724,11 +726,12 @@ puts file
 参数：
-| 参数名             |   类型    |     必须      | 默认值  | 参数描述       |
-| :-------------- | :-----: | :---------: | :--: | ---------- |
-| path_or_dir     | String\ | COS::COSDir |  否   | 空          |
-| options         |  Hash   |             |      |            |
-| options[:depth] | Integer |      否      |  5   | 子目录深度,默认为5 |
+| 参数名             |         类型         |  必须  | 默认值  | 参数描述                                     |
+| :-------------- | :----------------: | :--: | :--: | ---------------------------------------- |
+| path_or_dir     | String/COS::COSDir |  否   |  空   | 目录路径或目录对象COSDir目录路径如: '/', 'path1', 'path1/path2', sdk会补齐末尾的 '/' |
+| options         |        Hash        |      |      |                                          |
+| options[:depth] |      Integer       |  否   |  5   | 子目录深度,默认为5                               |
+| options[:files] |      Boolean       |  否   |  false   | 同时列出文件,默认不列出                               |
 返回：
@@ -761,11 +764,12 @@ end
 参数：
-| 参数名             |   类型    |     必须      | 默认值  | 参数描述       |
-| :-------------- | :-----: | :---------: | :--: | ---------- |
-| path_or_dir     | String\ | COS::COSDir |  否   | 空          |
-| options         |  Hash   |             |      |            |
-| options[:depth] | Integer |      否      |  5   | 子目录深度,默认为5 |
+| 参数名             |         类型         |  必须  | 默认值  | 参数描述                                     |
+| :-------------- | :----------------: | :--: | :--: | ---------------------------------------- |
+| path_or_dir     | String/COS::COSDir |  否   |  空   | 目录路径或目录对象COSDir目录路径如: '/', 'path1', 'path1/path2', sdk会补齐末尾的 '/' |
+| options         |        Hash        |      |      |                                          |
+| options[:depth] |      Integer       |  否   |  5   | 子目录深度,默认为5                               |
+| options[:files] |      Boolean       |  否   |  false   | 同时列出文件,默认不列出                               |
 返回：
@@ -799,16 +803,16 @@ puts tree.to_json # 可直接转为json
 参数：
-| 参数名                      |   类型    |     必须      |      默认值      | 参数描述                          |
-| :----------------------- | :-----: | :---------: | :-----------: | ----------------------------- |
-| path_or_dir              | String\ | COS::COSDir |       是       | 无                             |
-| file_store_path          | String  |      是      |       无       | 本地文件存储目录                      |
-| options                  |  Hash   |      否      |       无       |                               |
-| options[:disable_mkdir]  | Boolean |      否      |     true      | 禁止自动创建本地文件夹, 默认会创建            |
-| options[:min_slice_size] | Integer |      否      | 5 * 10 * 1024 | 完整下载最小文件大小,超过此大小将会使用分片多线程断点续传 |
-| options[:download_retry] | Integer |      否      |      10       | 下载重试次数                        |
-| options[:disable_cpt]    | Boolean |      否      |     false     | 是否禁用checkpoint，如果禁用则不使用断点续传   |
-| yield                    |  Float  |      否      |       无       | 下载进度百分比回调, 进度值是一个0-1之间的小数     |
+| 参数名                      |         类型         |  必须  |      默认值      | 参数描述                                     |
+| :----------------------- | :----------------: | :--: | :-----------: | ---------------------------------------- |
+| path_or_dir              | String/COS::COSDir |  否   |       空       | 目录路径或目录对象COSDir目录路径如: '/', 'path1', 'path1/path2', sdk会补齐末尾的 '/' |
+| file_store_path          |       String       |  是   |       无       | 本地文件存储目录                                 |
+| options                  |        Hash        |  否   |       无       |                                          |
+| options[:disable_mkdir]  |      Boolean       |  否   |     true      | 禁止自动创建本地文件夹, 默认会创建                       |
+| options[:min_slice_size] |      Integer       |  否   | 5 * 10 * 1024 | 完整下载最小文件大小,超过此大小将会使用分片多线程断点续传            |
+| options[:download_retry] |      Integer       |  否   |      10       | 下载重试次数                                   |
+| options[:disable_cpt]    |      Boolean       |  否   |     false     | 是否禁用checkpoint，如果禁用则不使用断点续传              |
+| yield                    |       Float        |  否   |       无       | 下载进度百分比回调, 进度值是一个0-1之间的小数                |
 注：不包含子目录。支持私有访问资源下载，SDK会自动携带鉴权签名。SDK会自动使用分片断点续传下载大文件。
@@ -835,21 +839,21 @@ puts files
 参数：
-| 参数名                          |   类型    |     必须      |       默认值        | 参数描述                                    |
-| :--------------------------- | :-----: | :---------: | :--------------: | --------------------------------------- |
-| path_or_dir                  | String\ | COS::COSDir |        是         | 无                                       |
-| file_src_path                | String  |      是      |        无         | 本地文件夹路径                                 |
-| options                      |  Hash   |      否      |        无         |                                         |
-| options[:skip_error]         | Boolean |      否      |      false       | 是否跳过错误仍继续上传下一个文件                        |
-| options[:auto_create_folder] | Boolean |      否      |      false       | 自动创建远端目录                                |
-| options[:min_slice_size]     | Integer |      否      | 10 * 1024 * 1024 | 完整上传最小文件大小,超过此大小将会使用分片多线程断点续传           |
-| options[:upload_retry]       | Integer |      否      |        10        | 上传重试次数                                  |
-| options[:biz_attr]           | String  |      否      |        无         | 业务属性                                    |
-| options[:disable_cpt]        | Boolean |      否      |      false       | 是否禁用checkpoint，如禁用仍可通过服务端进行断点续传         |
-| options[:threads]            | Integer |      否      |        10        | 多线程上传线程数                                |
-| options[:slice_size]         | Integer |      否      | 3 * 1024 * 1024  | 设置分片上传时每个分片的大小。默认为3 MB, 目前服务端最大限制也为3MB。 |
-| options[:cpt_file]           | String  |      否      |        无         | 断点续传的checkpoint文件                       |
-| yield                        |  Float  |      否      |        无         | 上传进度百分比回调, 进度值是一个0-1之间的小数               |
+| 参数名                          |         类型         |  必须  |       默认值        | 参数描述                                     |
+| :--------------------------- | :----------------: | :--: | :--------------: | ---------------------------------------- |
+| path_or_dir                  | String/COS::COSDir |  否   |        空         | 目录路径或目录对象COSDir目录路径如: '/', 'path1', 'path1/path2', sdk会补齐末尾的 '/' |
+| file_src_path                |       String       |  是   |        无         | 本地文件夹路径                                  |
+| options                      |        Hash        |  否   |        无         |                                          |
+| options[:skip_error]         |      Boolean       |  否   |      false       | 是否跳过错误仍继续上传下一个文件                         |
+| options[:auto_create_folder] |      Boolean       |  否   |      false       | 自动创建远端目录                                 |
+| options[:min_slice_size]     |      Integer       |  否   | 10 * 1024 * 1024 | 完整上传最小文件大小,超过此大小将会使用分片多线程断点续传            |
+| options[:upload_retry]       |      Integer       |  否   |        10        | 上传重试次数                                   |
+| options[:biz_attr]           |       String       |  否   |        无         | 业务属性                                     |
+| options[:disable_cpt]        |      Boolean       |  否   |      false       | 是否禁用checkpoint，如禁用仍可通过服务端进行断点续传          |
+| options[:threads]            |      Integer       |  否   |        10        | 多线程上传线程数                                 |
+| options[:slice_size]         |      Integer       |  否   | 3 * 1024 * 1024  | 设置分片上传时每个分片的大小。默认为3 MB, 目前服务端最大限制也为3MB。  |
+| options[:cpt_file]           |       String       |  否   |        无         | 断点续传的checkpoint文件                        |
+| yield                        |       Float        |  否   |        无         | 上传进度百分比回调, 进度值是一个0-1之间的小数                |
 注：不包含子目录。SDK会自动使用分片断点续传上传大文件。
@@ -2022,6 +2026,7 @@ $ cos upload path/path2 file1 ~/file1
 ## 7 运行测试
+### 7.1 单元测试
 ```
 rspec
 ```
@@ -2030,4 +2035,14 @@ rspec
 ```
 bundle exec rake spec
+```
+### 7.2 集成测试
+先安装memory_profiler
+```
+gem install memory_profiler
+```
+```
+bundle exec rake test
 ```

data/bin/cos CHANGED

@@ -115,12 +115,12 @@ class COS_CLI < Thor
   method_option :disable_cpt, aliases: '-d', desc: '禁用断点续传(分片下载时有效)', type: :boolean, default: false
   method_option :threads, aliases: '-t', desc: '线程数(分片下载时有效)', type: :numeric
   method_option :download_retry, aliases: '-n', desc: '重试次数(分片下载时有效)', type: :numeric
-  method_option :slice_size, aliases: '-s', desc: '分片下载时每个分片的大小(分片下载时有效)', type: :numeric
+  method_option :part_size, aliases: '-s', desc: '分片下载时每个分片的大小(分片下载时有效)', type: :numeric
   method_option :cpt_file, aliases: '-e', desc: '指定断点续传记录(分片下载时有效)'
   def download(path, file_store)
     rescue_errors do
       file = bucket.download(path, file_store,
-                             enabled_options([:min_slice_size, :disable_cpt, :threads, :download_retry, :slice_size, :cpt_file])) do |percent|
+                             enabled_options([:min_slice_size, :disable_cpt, :threads, :download_retry, :part_size, :cpt_file])) do |percent|
         puts("下载进度: #{(percent*100).round(2)}%", :green)
       end
       puts(file, :blue)
@@ -134,12 +134,12 @@ class COS_CLI < Thor
   method_option :disable_cpt, aliases: '-d', desc: '禁用断点续传(分片下载时有效)', type: :boolean, default: false
   method_option :threads, aliases: '-t', desc: '线程数(分片下载时有效)', type: :numeric
   method_option :download_retry, aliases: '-n', desc: '重试次数(分片下载时有效)', type: :numeric
-  method_option :slice_size, aliases: '-s', desc: '分片下载时每个分片的大小(分片下载时有效)', type: :numeric
+  method_option :part_size, aliases: '-s', desc: '分片下载时每个分片的大小(分片下载时有效)', type: :numeric
   method_option :cpt_file, aliases: '-e', desc: '指定断点续传记录(分片下载时有效)'
   def download_all(path, file_store_path)
     rescue_errors do
       files = bucket.download_all(path, file_store_path,
-                                  enabled_options([:min_slice_size, :disable_mkdir, :disable_cpt, :threads, :download_retry, :slice_size, :cpt_file])) do |percent|
+                                  enabled_options([:min_slice_size, :disable_mkdir, :disable_cpt, :threads, :download_retry, :part_size, :cpt_file])) do |percent|
         puts("下载进度: #{(percent*100).round(2)}%", :green)
       end

data/lib/cos/bucket.rb CHANGED

@@ -213,6 +213,10 @@ module COS
       min_size    = options[:min_slice_size] || MIN_UPLOAD_SLICE_SIZE
       retry_times = options[:upload_retry] || DEFAULT_UPLOAD_RETRY
+      if min_size > 20 * 1024 * 1024
+        raise EntireUploadTooLarge, 'entire upload file too large, file size must < 20MB'
+      end
       options.merge!({bucket: bucket_name})
       file_src  = File.expand_path(file_src)
       file_size = File.size(file_src)
@@ -272,7 +276,7 @@ module COS
     #     puts file.url
     #   end
     def upload_all(path_or_dir, file_src_path, options = {}, &block)
-      local_path = Util.get_local_path(file_src_path, false)
+      local_path = Util.get_local_path(file_src_path, true)
       uploaded   = []
       Dir.foreach(local_path) do |file|

data/lib/cos/download.rb CHANGED

@@ -22,7 +22,8 @@ module COS
     def initialize(opts = {})
       super(opts)
-      @cpt_file = options[:cpt_file] || "#{File.expand_path(file_store)}.cpt"
+      @file_store = File.expand_path(file_store)
+      @cpt_file = options[:cpt_file] || "#{@file_store}.cpt"
     end
     # 开始下载

data/lib/cos/exception.rb CHANGED

@@ -59,4 +59,7 @@ module COS
   # 本地目录不存在
   class LocalPathNotExist < Exception; end
+  # 完整上传文件过大
+  class EntireUploadTooLarge < Exception; end
 end

data/lib/cos/file.rb CHANGED

@@ -20,7 +20,8 @@ module COS
     # @option attrs [String] :filesize 文件存储大小
     # @option attrs [String] :filelen 文件大小
     # @option attrs [String] :sha 文件sha1值
-    # @option attrs [String] :access_url 文件访问地址
+    # @option attrs [String] :access_url 文件CDN访问地址
+    # @option attrs [String] :source_url 文件外网访问地址
     #
     # @raise [AttrError] 缺少参数
     #

data/lib/cos/http.rb CHANGED

@@ -11,7 +11,7 @@ module COS
     DEFAULT_CONTENT_TYPE = 'application/json'
     # 请求创建超时
-    OPEN_TIMEOUT = 15
+    OPEN_TIMEOUT = 30
     # 响应读取超时
     READ_TIMEOUT = 120

data/lib/cos/resource.rb CHANGED

@@ -79,6 +79,7 @@ module COS
     required_attrs :bucket, :path, :name, :ctime, :mtime
     optional_attrs :biz_attr, :filesize, :filelen, :sha, :access_url,
+                   :source_url,
                    # 根目录(bucket)参数
                    :authority, :bucket_type, :migrate_source_domain,
                    :need_preview, :refers, :blackrefers, :brower_exec,

data/lib/cos/slice.rb CHANGED

@@ -38,27 +38,35 @@ module COS
       # 未完成的片段
       @todo_parts = @parts.reject { |p| p[:done] }
-      begin
-        # 多线程上传
-        (1..@num_threads).map do
-          Thread.new do
-            loop do
-              # 获取下一个未上传的片段
-              p = sync_get_todo_part
-              break unless p
-              # 上传片段
-              upload_part(p)
-            end
+      # 多线程上传
+      Thread.abort_on_exception = true
+      threads = []
+      @num_threads.times do
+        threads << Thread.new do
+          loop do
+            # 获取下一个未上传的片段
+            p = sync_get_todo_part
+            break unless p
+            # 上传片段
+            upload_part(p)
           end
-        end.map(&:join)
-      rescue => error
-        unless finish?
-          # 部分服务端异常需要重新初始化, 可能上传已经完成了
-          if error.is_a?(ServerError) and error.error_code == -288
-            File.delete(cpt_file) unless options[:disable_cpt]
+        end
+      end
+      threads.each do |thread|
+        begin
+          thread.join
+        rescue => error
+          unless finish?
+            # 部分服务端异常需要重新初始化, 可能上传已经完成了
+            if error.is_a?(ServerError) and error.error_code == -288
+              File.delete(cpt_file) unless options[:disable_cpt]
+            end
+            threads.each {|t| t.exit}
+            raise error
           end
-          raise error
         end
       end

data/lib/cos/version.rb CHANGED

@@ -1,3 +1,3 @@
 module COS
-  VERSION = '0.1.1'
+  VERSION = '0.1.2'
 end

metadata CHANGED

@@ -1,125 +1,125 @@
 --- !ruby/object:Gem::Specification
 name: cos
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - RaymondChou
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2016-01-18 00:00:00.000000000 Z
+date: 2016-03-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.8'
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.19'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.19'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.10'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '10.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '10.4'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.3'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.22'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.22'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.10'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '5.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '5.8'
 description: Tencent Cloud Object Service Ruby SDK.
@@ -130,9 +130,9 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".travis.yml"
+- .gitignore
+- .rspec
+- .travis.yml
 - Gemfile
 - LICENSE
 - README.md
@@ -182,17 +182,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project:
-rubygems_version: 2.4.5.1
+rubygems_version: 2.0.14
 signing_key:
 specification_version: 4
 summary: Tencent COS Ruby SDK.