upyun 1.0.5 → 1.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 27f13c813d11dd28a2ff2208053b616773c423c1
-  data.tar.gz: 3ce085cd227c44f2d6ddb9e6d5bbcea74f756c14
+  metadata.gz: 5a66fd1986e039bfa120d3ce923ab1809edd6c5a
+  data.tar.gz: cec146d124a0257d94540c4b23001d56b9589402
 SHA512:
-  metadata.gz: a2c3510754b1c6565a8fa562ac4d761bc68419c5bd7d115fc7329f532630e3f1f9471bbaf7614c54c1fba6428998a15a7f573f7e8857c9df1a534176fdabc1b4
-  data.tar.gz: ae4e7810041ae15e6537d510b260801d4e20d06aee8f0ca41aea103709c52c6652eb03b1a96b77b463ec7c5ba02fcbb6c7f05452d2b3425a3b7d91646d9a3c2d
+  metadata.gz: d8397e0d383e03a1574f47ed5ef1b18ce92ccc5b4ff3da243791b5dad47491c38136bbee8bf2adfcbb454ab6d743befb84c90b1535a19ce37db747e13aeb4f8e
+  data.tar.gz: 2760c52be9fb2be54d320c9b7064febc600163c98e888b6e47803b015670d4ad6d263a5c13838b520106a3a1e07ad5af526c629fcfd9227aa3d2a271aa48dedc

data/README.md

@@ -39,15 +39,17 @@ $ gem install upyun
 ```ruby
 require 'upyun'
 
-upyun = Upyun::Rest.new('bucket', 'operator', 'password', 'options', 'endpoint')
+upyun = Upyun::Rest.new(bucket, operator, password, options, endpoint)
 ```
 **参数**
 
-* `bucket`: UPYUN 空间名称
-* `operator`: 授权操作员帐号
-* `password`: 授权操作员密码
-* `options`: 连接选项，可用的选项见[RestClient::Resource](https://github.com/rest-client/rest-client/blob/master/lib/restclient/resource.rb), 默认设置超时时间 60s
-* `endpoint`（可选）（默认：`Upyun::ED_AUTO`）: API接入点，可根据具体网络情况设置最优的接入点，详情见 [API 域名](http://docs.upyun.com/api/)
+| 参数名  | 类型  | 可选 | 说明 |
+|:-------------:|:--------:|-------:| ------------- |
+| `bucket`      | `String` | 必选 | UPYUN 空间名称|
+| `operator`    | `String` | 必选 | 授权操作员帐号|
+| `password`    | `String` | 必选 | 授权操作员密码|
+| `options`     | `Hash`   | 可选 | 连接选项，可用的选项见[RestClient::Resource](https://github.com/rest-client/rest-client/blob/master/lib/restclient/resource.rb), 默认设置超时时间 60s |
+| `endpoint`    | `String` |  可选 | （默认：`Upyun::ED_AUTO`）: API接入点，可根据具体网络情况设置最优的接入点，详情见 [API 域名](http://docs.upyun.com/api/) |
 
 其中 `endpoint` 可选值如下：
 
@@ -90,12 +92,17 @@ headers = {'Content-Type' => 'image/jpeg', 'x-gmkerl-type' => 'fix_width', 'x-gm
 upyun.put('/save/to/path', 'file or binary', headers)
 ```
 
-其中， `/save/to/path` 和 `file or binary` 和默认上传方式中一致，`headers` 参数即为额外的可选 HTTP Header 参数，详情查阅 [Rest API](http://docs.upyun.com/api/rest_api/#_4)
+其中， `/save/to/path` 和 `file or binary` 和默认上传方式中一致，`headers` 参数即为额外的可选 HTTP Header 参数，
+详情查阅 [Rest API](http://docs.upyun.com/api/rest_api/#_4)
 
 **返回**
 
-上传成功返回 `true`，失败返回一个 `Hash` 结构: `{request_id: request_id, error: {code: code, message: message}}`,
-其中：
+上传成功:
+
+  * 如果是图片空间，返回图片原信息，如 `{:height=>629, :file_type=>"JPEG", :width=>440, :frames=>1}`
+  * 如果是其它空间，返回 `true`，
+
+失败返回一个 `Hash` 结构: `{request_id: request_id, error: {code: code, message: message}}`, 其中：
 
 * `request_id` 为本次请求的请求码，由 UPYUN 本台返回，可用该值查询 UPYUN 日志;
 * `code` 为又拍云返回的错误码；
@@ -126,13 +133,14 @@ file = upyun.get('/path/to/file')
 ##### 保存文件至本地
 
 ```ruby
-upyun.get('/path/to/file', 'saved/foo.png')
+upyun.get('/path/to/file', 'saved/foo.png', headers)
 ```
 
 **参数**
 
 * `'/path/to/file'`: 文件在 UPYUN 空间中的路径
 * `saved/foo.png`: 文件本地保存路径
+* `headers`: 指定下载时的头信息，默认为 `{}`
 
 **返回**
 下载成功返回获取的文件长度, 失败返回内容和上例一致。

data/lib/upyun/rest.rb

@@ -39,8 +39,8 @@ module Upyun
       file.close if file.respond_to?(:close)
     end
 
-    def get(path, savepath=nil)
-      res = request(:get, path)
+    def get(path, savepath=nil, headers={})
+      res = request(:get, path, headers: headers)
       return res if res.is_a?(Hash) || !savepath
 
       dir = File.dirname(savepath)

data/lib/upyun/version.rb

@@ -1,3 +1,3 @@
 module Upyun
-  VERSION = "1.0.5"
+  VERSION = "1.0.6"
 end

data/spec/upyun_spec.rb

@@ -92,6 +92,11 @@ describe "Upyun Restful API Basic testing" do
       File.delete('./save.jpg')
     end
 
+    it "GET a file with Accept Header" do
+      expect(@upyun.get(@path, nil, {'Accept' => '*/*'})).to eq(@str)
+    end
+
+
     it "GET a not-exist file" do
       res = @upyun.get("/ruby-sdk/foo/#{String.random}/test-not-exist.jpg")
       expect(res.is_a?(Hash) && res[:error][:code] == 404)
@@ -193,8 +198,7 @@ describe "Form Upload", current: true do
       expect(res.keys).to include(:code, :message, :url, :time)
       expect(res[:code]).to eq(200)
       expect(res[:message]).to match(/ok/)
-      now = Time.now
-      expect(res[:url]).to eq("/#{now.year}/#{now.mon}/#{now.day}/upyun.jpg")
+      expect(res[:url]).to eq(Time.now.utc.strftime('/%Y/%m/%d/upyun.jpg'))
     end
 
     it "with file descriptor should success" do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: upyun
 version: !ruby/object:Gem::Version
-  version: 1.0.5
+  version: 1.0.6
 platform: ruby
 authors:
 - jsvisa
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-08 00:00:00.000000000 Z
+date: 2015-03-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client