nextcloud-api-wrapper 0.2.3

Overview

Python wrapper for NextCloud’s API.

The lib tends to support most common features i.e. :

• User provisioning

• OCS Share

• WebDAV (files)

• Tags

• Activity app

• Notifications app

• LDAP configuration

• Capabilities

• Group Folders

Tested with :

• NextCloud 14, python 3.7 (automated test)

• NextCloud 20, python 2.7

• NextCloud 20, python 3.6

The main lines :

• NextCloud(URL, auth=…) provide you a connection manager. You can use it with with … as nxc: to open a session.

• The session is the connection object that make the requests.

• The requests are initiated by a requester associated to an API wrapper.

• API wrappers are the definition of how to use the NextCloud REST API : it provide functions that will be attached to the NextCloud object.

• Functions can return : - Response object with attributes is_ok, data. If is_ok is False, you can use get_error_message. - Data objects (File, Tag…) or None.

• Data objects are useable as dict object or with attribute. They provide operations. If the operation fails, you’ll get an exception.

For quick start, check out examples and the tests.

Install

# use 'pip3' for python3 or 'python -m pip' instead of pip
pip install nextcloud-api-wrapper
# the associated python lib is nammed 'nextcloud'
# beware the conflicts

Fork Changes

This version is a fork (mainly refactoring, fixes and optimization) of nextcloud-API .

Contributing

Pull Request

According to the testing procedure, you shall fork and PR on branch develop.