Quick fire bug fixes
Bug fixes from initial release found when updating.
* If you ping a session and it's successful, set the session without requiring a handshake
* All docs and examples are updated and fully functional
* set_key would overwrite your session instead of setting AMPACHE_KEY
* artists was missing the album_artist parameter
* docs/MANUAL.md added to the repo with a breakdown of the class structure
Ready for Ampache 5
A python3 library for interaction with your Ampache 5.x.x server using the XML & JSON [API](https://ampache.org/API/)
* Additional methods in this release match up with the current develop branch (soon to be Ampache 5.0.0)
* Password auth is available instead of just API Keys
* The structural changes to the lib do not support Ampache 4 and do not support old versions of the lib.
* Version 4 will be maintained along with Ampache 4 until the end of PHP 7.4 support.
Changes in this release
There has been a pretty significant change in the library between Ampache 4 and Ampache 5.
For anyone wanting to stay on v4 the branch has been separated into it's own [branch](https://github.com/ampache/python3-ampache/tree/api4).
Once you connect with your passphrase or api key the url and auth token are stored for most methods allowing you to call methods without them.
Below is a quick example of the changes.
import ampache
import time
load up the lib
ampacheConnection = ampache.API()
if using password auth use encrypt_password
mytime = int(time.time())
passphrase = ampacheConnection.encrypt_password('mypassword', mytime)
auth = ampacheConnection.handshake('https://music.com.au', passphrase, 'my username', mytime)
if using an API key auth keep using encrypt_string
passphrase = ampacheConnection.encrypt_string('my apikey', 'my username')
auth = ampacheConnection.handshake('https://music.com.au', passphrase)
now you can call methods without having to keep putting in the url and userkey
ampacheConnection.label(1677)
ping has always allowed empty calls so you have to ping with a url and session still
ampacheConnection.ping('https://music.com.au', auth)