added support for public links

[mrwunderbar666]

Adds support to manipulate files in a publicly shared folder (with and without password). As described in #12

anon_session = owncloud.Client.from_public_link(public_link, password)

[PVince81]

Great addition, thanks !

Would be good to add some unit tests.
You could use the API from within the test to create a public link, then access it using the new API and perform some operation like upload or creating a folder, then assert that the folder exists.

A slight worry might be that not all the session operations will work in anonymous mode like creating shares when connecting through that session. Might not be a big issue as calling those would result in an HTTPResponseError with code 403 or 401.

[PVince81]

it would also be nice to add an example usage in the README :-)

[PVince81]

that's more tests than I expected, awesome!

[PVince81]

👍

[mrwunderbar666]

Thanks!

I forgot to push the updated examples:

Example for uploading a file to a public shared folder:

.. code-block:: python

    import owncloud

    public_link = 'http://domain.tld/owncloud/A1B2C3D4'

    oc = owncloud.Client.from_public_link(public_link)
    oc.drop_file('myfile.zip')


Example for downloading a file from a public shared folder with password:

.. code-block:: python

    import owncloud

    public_link = 'http://domain.tld/owncloud/A1B2C3D4'
    folder_password = 'secret'

    oc = owncloud.Client.from_public_link(public_link, password=folder_password)
    oc.get_file('/sharedfile.zip', 'download/destination/sharedfile.zip')

[PVince81]

@mrwunderbar666 mind sending in another PR ? else I can copy paste this later on