upyun-sdk 0.1.1 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +20 -14
- data/lib/upyun/version.rb +1 -1
- data/lib/upyun-sdk.rb +5 -1
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: ef8e3fa6232933b7512f4052c5ac549e1cacf790
|
|
4
|
+
data.tar.gz: 072ac5d0a2a6b80cfe78f003df2a52ae1fd6aa0d
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 76b8ec04405fa90fd07e4b8f7dc8fb436d8bcb85e6c698b9e9e55c4bb62099ec32eb7583cf7ef8b4bb57e8e1e74d71f44cdbc95376c946b3b10024345e362bf6
|
|
7
|
+
data.tar.gz: eb7559b2e6ae6f61928cb1a09040d2f10e4ff33558a64f705bfe283ca8aeff5262a60412d086386155651efcba581a261fa8f98a99d1e2367a6cb2462e3d6e7b
|
data/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
又拍云存储 Ruby SDK，基于 [又拍云存储 HTTP REST API 接口](http://wiki.upyun.com/index.php?title=HTTP_REST_API%E6%8E%A5%E5%8F%A3) 开发。
|
|
4
4
|
|
|
5
|
-
###
|
|
5
|
+
### 安装
|
|
6
6
|
|
|
7
7
|
```
|
|
8
8
|
gem install upyun-sdk
|
|
@@ -29,7 +29,7 @@ up = UpYun.new('bucket', 'username', 'password', 0)
|
|
|
29
29
|
3 移动铁通接入点
|
|
30
30
|
````
|
|
31
31
|
|
|
32
|
-
默认设置为 `0
|
|
32
|
+
默认设置为 `0`，推荐根据服务器网络状况，手动设置合理的接入点以获取最佳的访问速度。同时，也可通过：
|
|
33
33
|
|
|
34
34
|
````
|
|
35
35
|
up.endpoint = 1
|
|
@@ -46,9 +46,6 @@ up.endpoint = 1
|
|
|
46
46
|
up.put('/upyun-sdk/ascii.txt', 'abcdefghijklmnopqrstuvwxyz\n')
|
|
47
47
|
````
|
|
48
48
|
|
|
49
|
-
其中，方法 `up.put` 默认已开启相应目录的自动创建。
|
|
50
|
-
|
|
51
|
-
|
|
52
49
|
其中，参数 `auto_mkdir` 默认为 true，表示自动创建目录；`checksum`，默认 False，表示不进行 MD5 校验; `headers` ，可根据需求设置自定义 HTTP Header，例如作图参数 x-gmkerl-*, 具体请参考 [标准 API 上传文件](http://wiki.upyun.com/index.php?title=%E6%A0%87%E5%87%86API%E4%B8%8A%E4%BC%A0%E6%96%87%E4%BB%B6) 。
|
|
53
50
|
|
|
54
51
|
上传成功，返回 true; 失败返回错误信息。
|
|
@@ -66,7 +63,7 @@ res = up.get('/upyun-sdk/ascii.txt')
|
|
|
66
63
|
### 获取文件信息
|
|
67
64
|
|
|
68
65
|
````
|
|
69
|
-
res = up.getinfo('/upyun-sdk/
|
|
66
|
+
res = up.getinfo('/upyun-sdk/ascii.txt')
|
|
70
67
|
````
|
|
71
68
|
|
|
72
69
|
获取成功，返回一个 Hash 对象; 失败则返回错误信息。
|
|
@@ -77,17 +74,18 @@ res = up.getinfo('/upyun-sdk/xinu.png')
|
|
|
77
74
|
up.mkdir('/upyun-sdk/temp/')
|
|
78
75
|
````
|
|
79
76
|
|
|
80
|
-
其中，参数 `auto_mkdir` 默认为 true
|
|
81
|
-
创建成功，返回 true;
|
|
77
|
+
其中，参数 `auto_mkdir` 默认为 true，表示自动创建目录。
|
|
78
|
+
创建成功，返回 true; 失败则返回错误信息。
|
|
82
79
|
|
|
83
80
|
### 删除目录或文件
|
|
84
81
|
|
|
85
82
|
````
|
|
86
|
-
up.delete('/upyun-sdk/
|
|
83
|
+
up.delete('/upyun-sdk/ascii.txt')
|
|
87
84
|
up.delete('/upyun-sdk/temp/')
|
|
88
85
|
````
|
|
89
86
|
|
|
90
|
-
|
|
87
|
+
注意删除目录时，必须保证目录为空。
|
|
88
|
+
删除成功，返回 true; 失败则返回 false。
|
|
91
89
|
|
|
92
90
|
### 获取目录文件列表
|
|
93
91
|
|
|
@@ -95,8 +93,8 @@ up.delete('/upyun-sdk/temp/')
|
|
|
95
93
|
res = up.getlist('/upyun-sdk/')
|
|
96
94
|
````
|
|
97
95
|
|
|
98
|
-
|
|
99
|
-
|
|
96
|
+
该方法默认获取根目录列表信息。
|
|
97
|
+
获取成功，返回一个包含该目录下所有目录或文件条目信息的 Hash 对象数组; 失败则返回错误信息。
|
|
100
98
|
|
|
101
99
|
|
|
102
100
|
### 获取空间使用情况
|
|
@@ -105,5 +103,13 @@ res = up.getlist('/upyun-sdk/')
|
|
|
105
103
|
res = up.usage()
|
|
106
104
|
````
|
|
107
105
|
|
|
108
|
-
|
|
109
|
-
|
|
106
|
+
该方法默认获取根目录空间使用情况。
|
|
107
|
+
获取成功，返回该空间当前使用的总容量，单位 Bytes; 失败则返回错误信息。
|
|
108
|
+
|
|
109
|
+
## License
|
|
110
|
+
|
|
111
|
+
[WTFPL (Do What the Fuck You Want)](http://www.wtfpl.net/about/)
|
|
112
|
+
|
|
113
|
+
## Thanks
|
|
114
|
+
|
|
115
|
+
[gccyugi](https://github.com/gccyugi)
|
data/lib/upyun/version.rb
CHANGED
data/lib/upyun-sdk.rb
CHANGED