[![Join the chat at https://gitter.im/houtianze/bypy](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/houtianze/bypy?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
This is a Python client for Baidu Yun (a.k.a PCS - Personal Cloud Storage), an online storage website offering 2 TB (fast) free personal storage. This main purpose is to be able to utilize this stoarge service under Linux environment (console), e.g. Raspberry Pi.
**Due to Baidu PC permission restrictions, this program can only access your `/apps/bypy` directoy at Baidu PCS**
**It'ssaidtheBaiduPCSAPIwon't return more than 1000 items inside a directory (#306 ),if this is true,you won't be able to see / download some files if you have a directoyr with more than 1000 files on Baidu Cloud**
**(Fixed) ~~It's said the Baidu PCS API won't return more than 1000 items inside a directory ( #306 ),if this is true,you won't be able to see / download some files if you have a directory with more than 1000 files on Baidu Cloud~~**
**Features: Unicode / Chinese support; Retry on failures; Recursive down/up-load; Directory comparison; Hash caching.**
Prerequisite
---
**Important: You need to set you system locale encoding to UTF-8 for this to work (You can refere here: http://perlgeek.de/en/article/set-up-a-clean-utf8-environment)**
------------
**Important: You need to set you system locale encoding to UTF-8 for this to work (You can refere here: http://perlgeek.de/en/article/set-up-a-clean-utf8-environment)**
Installation
---
-`pip install bypy` (Supports Python 2.7+, 3.3+)
------------
-`pip install bypy` (Supports Python 2.7+, 3.3+)
Usage
---
-----
- Standalone program
- Simply run `bypy` (or `python -m bypy`, or `python3 -m bypy`)
You will see all the commands and parameters it supports
...
...
@@ -150,10 +179,9 @@ Usage
Simple GUI:
Run `bypygui`
For advanced GUI with parallel downloading capbility, this seems a good choice: [bcloud](../../../../LiuLang/bcloud)
Getting started
---
---------------
To get help and a list of available commands:
```
bypy
...
...
@@ -197,24 +225,26 @@ bypy compare
To get more information about the commands, check the output of `bypy`.
Debug
---
-----
- Add in `-v` parameter, it will print more details about the progress.
- Add in `-d` parameter, it will print some debug messages.
- Add in `-ddd`, it will display HTTP messages as well (**Warning: A lot**)
Tips / Sharing
---
--------------
Please go to [wiki](../../wiki)
To call from Python code
----
------------------------
```python
frombypyimportByPy
bp=ByPy()
bp.list()# or whatever instance methods of ByPy class
```
License
---
...
...
@@ -222,4 +252,4 @@ Please refer to [LICENSE](LICENSE)
---
PCS API Document: http://developer.baidu.com/wiki/index.php?title=docs/pcs/rest/file_data_apis_list
PCS API Document (link dead 404): http://developer.baidu.com/wiki/index.php?title=docs/pcs/rest/file_data_apis_list (Offline pdf retrieved before: [baidudoc](baidudoc) directory)