skip to navigation
skip to content

pyocclient 0.1

Python client library for ownCloud

This library makes it possible to connect to an ownCloud instance and perform file, share and attribute operations in python.

Please note that this is not a sync client implementation but rather a wrapper around various APIs.

See the ownCloud homepage for more information about ownCloud.


Accessing files

  • basic file operations like getting a directory listing, file upload/download, directory creation, etc
  • read/write file contents from strings
  • upload with chunking and mtime keeping
  • upload whole directories
  • directory download as zip


  • share a file with public link using the OCS Share API

App data

  • store app data as key/values using the privatedata OCS API


  • Python >= 2.7 (no support for Python 3 yet)
  • requests module (for making HTTP requests)


To install pyocclient, simply:

$ pip install pyocclient


Example for uploading a file then sharing with link:

import owncloud

oc = owncloud.Client('http://domain.tld/owncloud')

oc.login('user', 'password')


oc.put_file('testdir/remotefile.txt', 'localfile.txt')

link_info = oc.share_file_with_link('testdir/remotefile.txt')

print "Here is your link: http://domain.tld/owncloud/" +

Running the unit tests

To run the unit tests, edit the config file in “owncloud/test/” to point to a running ownCloud instance to test against. Then run the script “”:

$ ./

Building the documentation

To build the documentation, you will need to install Sphinx and docutil. Then run the following commands:

$ cd doc
$ make html

You can then find the documentation inside of “doc/build/html”.





  • Make python egg [PVince81]
  • Initial release [PVince81]
File Type Py Version Uploaded on Size
pyocclient-0.1.tar.gz (md5) Source 2014-08-19 11KB
  • Downloads (All Versions):
  • 4 downloads in the last day
  • 38 downloads in the last week
  • 224 downloads in the last month