add list_all

Author: SunRunAway

docs/README.gist.md

@@ -420,6 +420,13 @@ ret是一个字典，含有`hash`，`key`等信息。
 
 @gist(demo.py#list_prefix)
 ```
+
+一个典型的对整个bucket遍历的操作为：
+
+```{python}
+@gist(demo.py#list_all)
+```
+
 <a name="fop"></a>
 ### 云处理
 

docs/README.md

@@ -559,6 +559,26 @@ if err is not None:
 	return
 print rets2
 ```
+
+一个典型的对整个bucket遍历的操作为：
+
+```{python}
+def list_all(bucket, rs=None, prefix=None, limit=None):
+	if rs is None:
+		rs = qiniu.rsf.Client()
+	marker = None
+	err = None
+	while err is None:
+		ret, err = rs.list_prefix(bucket_name, prefix=prefix, limit=limit, marker=marker)
+		marker = ret.get('marker', None)
+		for item in ret['items']:
+			#do something
+			pass
+	if err is not qiniu.rsf.EOF:
+		# 错误处理
+		pass
+```
+
 <a name="fop"></a>
 ### 云处理
 

docs/demo.py

@@ -68,7 +68,7 @@ def get_demo_list():
 			resumable_put, resumable_put_file,
 			stat, copy, move, delete, batch,
 			image_info, image_exif, image_view,
-			list_prefix,
+			list_prefix, list_prefix_all,
 	]
 
 def run_demos(demos):
@@ -332,6 +332,27 @@ def list_prefix():
 	print rets2
 	# @endgist
 
+def list_prefix_all():
+	''' 列出所有 '''
+	list_all(bucket_name, prefix='test_Z', limit=10)
+
+# @gist list_all
+def list_all(bucket, rs=None, prefix=None, limit=None):
+	if rs is None:
+		rs = qiniu.rsf.Client()
+	marker = None
+	err = None
+	while err is None:
+		ret, err = rs.list_prefix(bucket_name, prefix=prefix, limit=limit, marker=marker)
+		marker = ret.get('marker', None)
+		for item in ret['items']:
+			#do something
+			pass
+	if err is not qiniu.rsf.EOF:
+		# 错误处理
+		pass
+# @endgist
+
 if __name__ == "__main__":
 	_setup()