Provide functions to manage users

[PVince81]

OC 8 now has a provisioning API (OCS)

Question here is whether it's a good time to split pyocclient into modules or just add extra functions in the main class.

Note: this will also need a version/capabilities check based on #39
If we go the modules route, modules should be able to provide required dependencies (minimum OC version / capability)

@Gomez

[Gomez]

I am still thinking about the integration of a wrapper for ./occ. That would be a good place for a module too.
Modules as own py files with an extra import?

[PVince81]

An extra import sounds good.
One concern is whether the API consumer needs to instantiate a Client for every module or whether we can make the main module return submodules ?
For example:

client = owncloud.Client(...)
client.put_file_contents(...) # for file operations
client.get_users_module().create_user(...) # for user operations

or should it be:

client = owncloud.Client(...)
client.put_file_contents(...) # for file operations

# instantiate a client for the users module
users = owncloud.users.Client(...)
users.create_user(...)

What do you think ?

I find the first approach better because we can reuse the auth/requests object.

[PVince81]

I raised another ticket to discuss modules: #67

Let's keep this one here for the "users API" implementation.

[jnfrmarks]

I like the first approach.

In the case of approach 2, If we have to create users and groups, then we would need create two client instances: one to create the users and one to create the groups (assuming I'm understanding what you said ... ;) )

[PVince81]

@jnfrmarks as discussed, can you send a PR that adds the functions to manage users ? (with unit tests, if possible 😄)

[PVince81]

Functions were added through #76