Ampache

This is a big one, we have now added **ALL** functions to execute. This allows you to use a dictionary of parameters for calls and makes it a lot easier to write your code.

Using `get_config` and `save_config` allows you to simplify the handshake process by storing your details and allowing you to just pull from history and get right back into it.


import ampache

ampache_connection = ampache.API()

if ampache_connection.get_config():
ampache_session = ampache_connection.execute('handshake')


**Note** that for a password handshake you need to send a timestamp as well (and import time)

`ampache_session = ampache_connection.execute('handshake', {'timestamp': int(time.time())}`

Added

* stream, download added `stats` parameter (enable/disable stat recording)
* Added missing parameters to playlist_edit (owner, items, tracks)
* Added a constant `CLIENT_NAME` for fallback name 'python3-ampache'

Changed

* Updated requirement for requests to `>=`
* Updated readme examples to use new functions (execute, config save/get)
* playlist_create, playlist_edit parameter names changed to match each other (playlist_name, playlist_type)
* username parameters require string
* parameter names updated for a lot of methods
* update_art
* update_from_tags
* update_artist_info

**Full Changelog**: https://github.com/ampache/python3-ampache/compare/6.6.1...6.6.3

Bug update to fix a few things found in testing Ampache releases. Adding more checks to the build process has helped me find a few issues here.

The execute function allows simpler code creation. (Currently only supports handshake and ping but will be expanded to all methods)

The project readme and examples will be updated as this function expands support for other methods and will help reduce work connecting to Ampache servers.

Added

* new function execute: `execute(self, method: str, params=None)`
* new function set_version: set the class `AMPACHE_VERSION` variable
* debug messages for some helper functions
* flag: add date parameter
* record_play: add date parameter

Fixed

* get_id_list fixes for more types of returned data

**Full Changelog**: https://github.com/ampache/python3-ampache/compare/6.6.0...6.6.1

This is the first major update for a while. API6 has had a lot of updates since the last release.

Added

* API6
* New Method: now_playing
* New Method: player
* New Method playlist_hash

Changed

* API6
* playlists: added `include` parameter
* download: added `bitrate` parameter
* artist_albums: added album_artist parameter
* Changed default client name from 'api' to 'python3-ampache'

Fixed

* get_id_list and get_object_list functions are able to get data from all previous API versions

**Full Changelog**: https://github.com/ampache/python3-ampache/compare/6.3.0...6.6.0

API6 continues it's run and has had a lot of new methods added.

Nothing major in the library beyond updates to match the Ampache release and expanded docs in the build script.

Added

* API6
* New Method: search_group (return multiple object types from a single set of search rules)
* New Method: search (alias for advanced_search)
* New Method: user_playlists (return user playlists and does not include smartlists)
* New Method: user_smartlists (return user smartlists (searches) and does not include playlists)
* New Method: playlist_add (add songs to a playlist, allowing different song parent types)
* New Method: index (replaces get_indexes with a simpler list of id's. children can be included)
* Add `has_art` parameter to any object with an `art` url
* Add avatar url to user objects

Changed

* API6
* playlist_add_song: depreciated and will be removed in **API7** (Use playlist_add)
* share_create: add more valid types ('playlist', 'podcast', 'podcast_episode', 'video')
* user: make username optional

Fixed

* ALL
* Userflag wasn't sending bool when cached in the database
* Admin would always get everyones playlists when filtering
* Stream methods would not send the bitrate correctly
* API6
* playlists method not respecting like for smartlists
* playlist_edit method will decode html `,` separators

Ampache 6.1.0 is the latest API6 release.

This release has two new methods have been added

The bookmark methods have had a bit of a rework as they were not very useful

Added

* New Method: bookmark (Get single bookmark by bookmark_id)
* New Method: lost_password (Allows a non-admin user to reset their password)
* bookmark_create: Add `include` parameter (if true include the object in the bookmark)
* bookmark_edit: Add `include` parameter (if true include the object in the bookmark)
* get_bookmark
* Add `include` parameter (if true include the object in the bookmark)
* Add `all` parameter (if true include every bookmark for the object)
* bookmarks
* Add parameter `client` to filter by specific groups of bookmarks
* Add `include` parameter (if true include the object in the bookmark)

Changed

* get_bookmark
* add bookmark as a valid `object_type`
* Don't return single JSON bookmarks as an object
* bookmark_create: Remove `client` parameter default value ('AmpacheAPI')
* bookmark_edit
* Remove `client` parameter default value ('AmpacheAPI')
* show error on missing bookmark instead of empty object
* add bookmark as a valid `object_type`
* Don't return single JSON bookmarks as an object
* bookmark_delete
* Remove `client` parameter default value ('AmpacheAPI')
* show error on missing bookmark instead of empty object
* add bookmark as a valid `object_type`

Fixed

* video: error type was song instead of filter

Ampache 6 is here and this lib is done for the initial release. there are a few changes that aren't completely compatible if you've been using 6.*.* version of the library.

Fixed

* Fix preference methods returning all the preferences by paulijar in https://github.com/ampache/python3-ampache/pull/13