Getui为ownCloud定制开发的Python客户端库
gtocclient的Python项目详细描述
这个纯python库使连接到ownCloud实例成为可能 并执行文件、共享和属性操作。在
请注意,不是一个同步客户端实现,而是一个库 它提供了一些函数来抽象各种owncloudapi的HTTP调用。在
有关ownCloud的更多信息,请参见ownCloud homepage。在
特点
支持连接到ownCloud 8.2、9.0、9.1及更高版本。在
一般信息
- 检索自有云实例信息(如版本、主机、URL等)
访问文件
- 基本文件操作,如获取目录列表、文件上载/下载、目录创建等
- 从字符串读取/写入文件内容
- 使用分块和mtime保持上传
- 上传整个目录
- 以zip格式下载目录
- 从公共链接访问文件
- 上载文件到文件删除链接目标
应用程序编程接口3>- 启用/禁用应用程序
- 检索已启用应用程序的列表
用户(OCS配置API)
- 创建/删除用户
- 创建/删除组
- 从组中添加/删除用户
应用程序数据
- 使用privatedata OCS API将应用程序数据存储为键/值
要求
- Python>;=2.7或Python>;=3.5
- 请求模块(用于发出HTTP请求)
安装
带pip的自动安装:
$ pip install gtocclient
使用
上载文件然后与link共享的示例:
^{pr2}$运行单元测试
要运行单元测试,请创建一个名为“owncloud/test”的配置文件/配置.py”. 有一个名为“owncloud/test”的配置文件示例/config.py.sample文件”. 所有的 所需信息在该文件中。 它应该指向一个正在运行的ownCloud实例进行测试。在
您可能还需要安装unittest数据提供程序包:
$ pip install unittest-data-provider
然后运行脚本“运行测试.sh“:
$ ./runtests.sh
构建文档
要构建文档,您需要安装Sphinx和docutil。 然后运行以下命令:
$ sphinx-apidoc -e -f -o docs/source owncloud/ owncloud/test
$ cd docs
$ make html
然后可以在“doc/build/html”中找到文档。在
- 项目
标签: