From f43f029a1878ebabc61cc0a191f1c35acd55439b Mon Sep 17 00:00:00 2001 From: Agate <me@agate.blue> Date: Sun, 23 Aug 2020 15:21:29 +0200 Subject: [PATCH] Version bump and changelog for 1.0-rc1 --- CHANGELOG | 137 +++++++++++++++++- api/funkwhale_api/__init__.py | 2 +- changes/changelog.d/1053.feature | 1 - changes/changelog.d/1083.enhancement | 1 - changes/changelog.d/1088.enhancement | 1 - changes/changelog.d/1089.bugfix | 1 - changes/changelog.d/1099.enhancement | 1 - changes/changelog.d/1102.enhancement | 1 - changes/changelog.d/1105.feature | 1 - changes/changelog.d/1121.enhancement | 1 - changes/changelog.d/1125.enhancement | 1 - changes/changelog.d/1127.enhancement | 1 - changes/changelog.d/1128.enhancement | 1 - changes/changelog.d/1130.enhancement | 1 - changes/changelog.d/1131.enhancement | 1 - changes/changelog.d/1140.bugfix | 1 - changes/changelog.d/1144.bugfix | 1 - changes/changelog.d/1178.enhancement | 1 - changes/changelog.d/1180.bugfix | 1 - changes/changelog.d/1190.enhancement | 1 - changes/changelog.d/1193.bugfix | 1 - changes/changelog.d/292.enhancement | 1 - changes/changelog.d/370.feature | 1 - changes/changelog.d/407.enhancement | 1 - changes/changelog.d/858.enhancement | 1 - changes/changelog.d/996.feature | 1 - .../docker-installation-and-upgrade.doc | 1 - changes/changelog.d/import-eaccess-fix.bugfix | 1 - changes/changelog.d/logout.enhancement | 1 - changes/changelog.d/search-page.bugfix | 1 - changes/changelog.d/thunbnails.enhancement | 1 - 31 files changed, 137 insertions(+), 31 deletions(-) delete mode 100644 changes/changelog.d/1053.feature delete mode 100644 changes/changelog.d/1083.enhancement delete mode 100644 changes/changelog.d/1088.enhancement delete mode 100644 changes/changelog.d/1089.bugfix delete mode 100644 changes/changelog.d/1099.enhancement delete mode 100644 changes/changelog.d/1102.enhancement delete mode 100644 changes/changelog.d/1105.feature delete mode 100644 changes/changelog.d/1121.enhancement delete mode 100644 changes/changelog.d/1125.enhancement delete mode 100644 changes/changelog.d/1127.enhancement delete mode 100644 changes/changelog.d/1128.enhancement delete mode 100644 changes/changelog.d/1130.enhancement delete mode 100644 changes/changelog.d/1131.enhancement delete mode 100644 changes/changelog.d/1140.bugfix delete mode 100644 changes/changelog.d/1144.bugfix delete mode 100644 changes/changelog.d/1178.enhancement delete mode 100644 changes/changelog.d/1180.bugfix delete mode 100644 changes/changelog.d/1190.enhancement delete mode 100644 changes/changelog.d/1193.bugfix delete mode 100644 changes/changelog.d/292.enhancement delete mode 100644 changes/changelog.d/370.feature delete mode 100644 changes/changelog.d/407.enhancement delete mode 100644 changes/changelog.d/858.enhancement delete mode 100644 changes/changelog.d/996.feature delete mode 100644 changes/changelog.d/docker-installation-and-upgrade.doc delete mode 100644 changes/changelog.d/import-eaccess-fix.bugfix delete mode 100644 changes/changelog.d/logout.enhancement delete mode 100644 changes/changelog.d/search-page.bugfix delete mode 100644 changes/changelog.d/thunbnails.enhancement diff --git a/CHANGELOG b/CHANGELOG index 7a4fde6098..9fff56b899 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -10,6 +10,140 @@ This changelog is viewable on the web at https://docs.funkwhale.audio/changelog. .. towncrier +1.0-rc1 (2020-23-08) +-------------------- + +Upgrade instructions are available at +https://docs.funkwhale.audio/index.html + + +Dropped python 3.5 support [manual action required, non-docker only] +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +With Funkwhale 1.0, we're dropping support for Python 3.5. Before upgrading, +ensure ``python3 --version`` returns ``3.6`` or higher. + +If it returns ``3.6`` or higher, you have nothing to do. + +If it returns ``3.5``, you will need to upgrade your Python version/Host, then recreate your virtual environment:: + + rm -rf /srv/funkwhale/virtualenv + python3 -m venv /srv/funkwhale/virtualenv + + +Increased quality of JPEG thumbnails [manual action required] +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Default quality for JPEG thumbnails was increased from 70 to 95, as 70 was producing visible artifacts in resized images. + +Because of this change, existing thumbnails will not load, and you will need to: + +1. delete the ``__sized__`` directory in your ``MEDIA_ROOT`` directory +2. run ``python manage.py fw media generate-thumbnails`` to regenerate thumbnails with the enhanced quality + +If you don't want to regenerate thumbnails, you can keep the old ones by adding ``THUMBNAIL_JPEG_RESIZE_QUALITY=70`` to your .env file. + +Small API breaking change in ``/api/v1/libraries`` +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To allow easier crawling of public libraries on a pod,we had to make a slight breaking change +to the behaviour of ``GET /api/v1/libraries``. + +Before, it returned only libraries owned by the current user. + +Now, it returns all the accessible libraries (including ones from other users and pods). + +If you are consuming the API via a third-party client and need to retrieve your libraries, +use the ``scope`` parameter, like this: ``GET /api/v1/libraries?scope=me`` + +API breaking change in ``/api/v1/albums`` +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To increase performance, querying ``/api/v1/albums`` doesn't return album tracks anymore. This caused +some performance issues, especially as some albums and series have dozens or even hundreds of tracks. + +If you want to retrieve tracks for an album, you can query ``/api/v1/tracks/?album=<albumid>``. + +JWT deprecation +^^^^^^^^^^^^^^^ + +API Authentication using JWT is deprecated and will be removed in Funkwhale 1.0. Please use OAuth or application tokens +and refer to our API documentation at https://docs.funkwhale.audio/swagger/ for guidance. + +Full list of changes +^^^^^^^^^^^^^^^^^^^^ + +Features: + +- Allow users to hide compilation artists on the artist search page (#1053) +- Can now launch server import from the UI (#1105) +- Dedicated, advanced search page (#370) +- Persist theme and language settings accross sessions (#996) + + +Enhancements: + +- Add support for unauthenticated users hitting the logout page +- Added support for Licence Art Libre (#1088) +- Broadcast/handle rejected follows (#858) +- Confirm email without requiring the user to validate the form manually (#407) +- Display channel and track downloads count (#1178) +- Do not include tracks in album API representation (#1102) +- Dropped python 3.5 support. Python 3.6 is the minimum required version (#1099) +- Improved keyboard accessibility (#1125) +- Improved naming of pages for accessibility (#1127) +- Improved shuffle behaviour (#1190) +- Increased quality of JPEG thumbnails +- Lock focus in modals to improve accessibility (#1128) +- More consistent search UX on /albums, /artists, /radios and /playlists (#1131) +- Play button now replace current queue instead of appending to it (#1083) +- Set proper lang attribute on HTML document (#1130) +- Use semantic headers for accessibility (#1121) +- Users can now update their email address (#292) + + +Bugfixes: + +- Fix broken media support detection (#1180) +- Fix layout issue with playbar on landscape tablets (#1144) +- Fix random radio so that podcast content is not picked up (#1140) +- Fixed an issue with search pages where results would not appear after navigating to another page +- Fixed crash with negative track position in file tags (#1193) +- Handle access errors scanning directories when importing files +- Make channel card updated times more humanly readable, add internationalization (#1089) + + +Documentation: + +- Simplify Docker mono-container installation and upgrade documentation + + +Contributors to this release (translation, development, documentation, reviews, design, testing, third-party projects): + +- Agate +- Andy Craze +- anonymous +- appzer0 +- Arne +- Bheesham Persaud +- Ciarán Ainsworth +- Creak +- Daniele Lira Mereb +- dulz +- Francesc Galà +- ghose +- mekind +- Puri +- Quentin PAGÈS +- Raphaël Ventura +- Simon Arlott +- Slimane Selyan Amiri +- Stefano Pigozzi +- Sébastien de Melo +- vicdorke +- Xosé M + + 0.21.2 (2020-07-27) ------------------- @@ -223,7 +357,8 @@ All user-related commands are available under the ``python manage.py fw users`` Please refer to the `Admin documentation <https://docs.funkwhale.audio/admin/commands.html#user-management>`_ for more information and instructions. -Progressive web app [Manual action suggested, non-docker only] +Progressive web app [Manual action sugFull list of changes +^^^^^^^^^^^^^^^^^^^^gested, non-docker only] ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ We've made Funkwhale's Web UI a Progressive Web Application (PWA), in order to improve the user experience diff --git a/api/funkwhale_api/__init__.py b/api/funkwhale_api/__init__.py index 0317f7328d..72a793c35e 100644 --- a/api/funkwhale_api/__init__.py +++ b/api/funkwhale_api/__init__.py @@ -1,5 +1,5 @@ # -*- coding: utf-8 -*- -__version__ = "0.21.2" +__version__ = "1.0-rc1" __version_info__ = tuple( [ int(num) if num.isdigit() else num diff --git a/changes/changelog.d/1053.feature b/changes/changelog.d/1053.feature deleted file mode 100644 index 8f4c1b9d4d..0000000000 --- a/changes/changelog.d/1053.feature +++ /dev/null @@ -1 +0,0 @@ -Allow users to hide compilation artists on the artist search page (#1053) \ No newline at end of file diff --git a/changes/changelog.d/1083.enhancement b/changes/changelog.d/1083.enhancement deleted file mode 100644 index 375ccd3dce..0000000000 --- a/changes/changelog.d/1083.enhancement +++ /dev/null @@ -1 +0,0 @@ -Play button now replace current queue instead of appending to it (#1083) \ No newline at end of file diff --git a/changes/changelog.d/1088.enhancement b/changes/changelog.d/1088.enhancement deleted file mode 100644 index 150a7e2cd6..0000000000 --- a/changes/changelog.d/1088.enhancement +++ /dev/null @@ -1 +0,0 @@ -Added support for Licence Art Libre (#1088) \ No newline at end of file diff --git a/changes/changelog.d/1089.bugfix b/changes/changelog.d/1089.bugfix deleted file mode 100644 index bc3b774391..0000000000 --- a/changes/changelog.d/1089.bugfix +++ /dev/null @@ -1 +0,0 @@ -Make channel card updated times more humanly readable, add internationalization (#1089) \ No newline at end of file diff --git a/changes/changelog.d/1099.enhancement b/changes/changelog.d/1099.enhancement deleted file mode 100644 index 1c74e1fa3d..0000000000 --- a/changes/changelog.d/1099.enhancement +++ /dev/null @@ -1 +0,0 @@ -Dropped python 3.5 support. Python 3.6 is the minimum required version (#1099) \ No newline at end of file diff --git a/changes/changelog.d/1102.enhancement b/changes/changelog.d/1102.enhancement deleted file mode 100644 index 6c80b79381..0000000000 --- a/changes/changelog.d/1102.enhancement +++ /dev/null @@ -1 +0,0 @@ -Do not include tracks in album API representation (#1102) \ No newline at end of file diff --git a/changes/changelog.d/1105.feature b/changes/changelog.d/1105.feature deleted file mode 100644 index 152c2a7bee..0000000000 --- a/changes/changelog.d/1105.feature +++ /dev/null @@ -1 +0,0 @@ -Can now launch server import from the UI (#1105) \ No newline at end of file diff --git a/changes/changelog.d/1121.enhancement b/changes/changelog.d/1121.enhancement deleted file mode 100644 index 188865c94c..0000000000 --- a/changes/changelog.d/1121.enhancement +++ /dev/null @@ -1 +0,0 @@ -Use semantic headers for accessibility (#1121) \ No newline at end of file diff --git a/changes/changelog.d/1125.enhancement b/changes/changelog.d/1125.enhancement deleted file mode 100644 index 78de39e001..0000000000 --- a/changes/changelog.d/1125.enhancement +++ /dev/null @@ -1 +0,0 @@ -Improved keyboard accessibility (#1125) \ No newline at end of file diff --git a/changes/changelog.d/1127.enhancement b/changes/changelog.d/1127.enhancement deleted file mode 100644 index 415b97b334..0000000000 --- a/changes/changelog.d/1127.enhancement +++ /dev/null @@ -1 +0,0 @@ -Improved naming of pages for accessibility (#1127) \ No newline at end of file diff --git a/changes/changelog.d/1128.enhancement b/changes/changelog.d/1128.enhancement deleted file mode 100644 index 375d33ad30..0000000000 --- a/changes/changelog.d/1128.enhancement +++ /dev/null @@ -1 +0,0 @@ -Lock focus in modals to improve accessibility (#1128) \ No newline at end of file diff --git a/changes/changelog.d/1130.enhancement b/changes/changelog.d/1130.enhancement deleted file mode 100644 index 07318ba95d..0000000000 --- a/changes/changelog.d/1130.enhancement +++ /dev/null @@ -1 +0,0 @@ -Set proper lang attribute on HTML document (#1130) \ No newline at end of file diff --git a/changes/changelog.d/1131.enhancement b/changes/changelog.d/1131.enhancement deleted file mode 100644 index eb2f25b0b8..0000000000 --- a/changes/changelog.d/1131.enhancement +++ /dev/null @@ -1 +0,0 @@ -More consistent search UX on /albums, /artists, /radios and /playlists (#1131) \ No newline at end of file diff --git a/changes/changelog.d/1140.bugfix b/changes/changelog.d/1140.bugfix deleted file mode 100644 index d9702a5f45..0000000000 --- a/changes/changelog.d/1140.bugfix +++ /dev/null @@ -1 +0,0 @@ -Fix random radio so that podcast content is not picked up (#1140) \ No newline at end of file diff --git a/changes/changelog.d/1144.bugfix b/changes/changelog.d/1144.bugfix deleted file mode 100644 index 3e96c031d3..0000000000 --- a/changes/changelog.d/1144.bugfix +++ /dev/null @@ -1 +0,0 @@ -Fix layout issue with playbar on landscape tablets (#1144) \ No newline at end of file diff --git a/changes/changelog.d/1178.enhancement b/changes/changelog.d/1178.enhancement deleted file mode 100644 index b247fd0986..0000000000 --- a/changes/changelog.d/1178.enhancement +++ /dev/null @@ -1 +0,0 @@ -Display channel and track downloads count (#1178) \ No newline at end of file diff --git a/changes/changelog.d/1180.bugfix b/changes/changelog.d/1180.bugfix deleted file mode 100644 index 262d1037ef..0000000000 --- a/changes/changelog.d/1180.bugfix +++ /dev/null @@ -1 +0,0 @@ -Fix broken media support detection (#1180) \ No newline at end of file diff --git a/changes/changelog.d/1190.enhancement b/changes/changelog.d/1190.enhancement deleted file mode 100644 index b64dc9d920..0000000000 --- a/changes/changelog.d/1190.enhancement +++ /dev/null @@ -1 +0,0 @@ -Improved shuffle behaviour (#1190) \ No newline at end of file diff --git a/changes/changelog.d/1193.bugfix b/changes/changelog.d/1193.bugfix deleted file mode 100644 index 2362eef8e6..0000000000 --- a/changes/changelog.d/1193.bugfix +++ /dev/null @@ -1 +0,0 @@ -Fixed crash with negative track position in file tags (#1193) \ No newline at end of file diff --git a/changes/changelog.d/292.enhancement b/changes/changelog.d/292.enhancement deleted file mode 100644 index 8da9e9a13d..0000000000 --- a/changes/changelog.d/292.enhancement +++ /dev/null @@ -1 +0,0 @@ -Users can now update their email address (#292) \ No newline at end of file diff --git a/changes/changelog.d/370.feature b/changes/changelog.d/370.feature deleted file mode 100644 index 381cd8e7cf..0000000000 --- a/changes/changelog.d/370.feature +++ /dev/null @@ -1 +0,0 @@ -Dedicated, advanced search page (#370) \ No newline at end of file diff --git a/changes/changelog.d/407.enhancement b/changes/changelog.d/407.enhancement deleted file mode 100644 index c21a34063e..0000000000 --- a/changes/changelog.d/407.enhancement +++ /dev/null @@ -1 +0,0 @@ -Confirm email without requiring the user to validate the form manually (#407) \ No newline at end of file diff --git a/changes/changelog.d/858.enhancement b/changes/changelog.d/858.enhancement deleted file mode 100644 index 7e0135e7c1..0000000000 --- a/changes/changelog.d/858.enhancement +++ /dev/null @@ -1 +0,0 @@ -Broadcast/handle rejected follows (#858) \ No newline at end of file diff --git a/changes/changelog.d/996.feature b/changes/changelog.d/996.feature deleted file mode 100644 index 6c57c3c60d..0000000000 --- a/changes/changelog.d/996.feature +++ /dev/null @@ -1 +0,0 @@ -Persist theme and language settings accross sessions (#996) \ No newline at end of file diff --git a/changes/changelog.d/docker-installation-and-upgrade.doc b/changes/changelog.d/docker-installation-and-upgrade.doc deleted file mode 100644 index e5cb86c803..0000000000 --- a/changes/changelog.d/docker-installation-and-upgrade.doc +++ /dev/null @@ -1 +0,0 @@ -Simplify Docker mono-container installation and upgrade documentation diff --git a/changes/changelog.d/import-eaccess-fix.bugfix b/changes/changelog.d/import-eaccess-fix.bugfix deleted file mode 100644 index 841a820d9d..0000000000 --- a/changes/changelog.d/import-eaccess-fix.bugfix +++ /dev/null @@ -1 +0,0 @@ -Handle access errors scanning directories when importing files diff --git a/changes/changelog.d/logout.enhancement b/changes/changelog.d/logout.enhancement deleted file mode 100644 index 4a0ccb81c7..0000000000 --- a/changes/changelog.d/logout.enhancement +++ /dev/null @@ -1 +0,0 @@ -Add support for unauthenticated users hitting the logout page \ No newline at end of file diff --git a/changes/changelog.d/search-page.bugfix b/changes/changelog.d/search-page.bugfix deleted file mode 100644 index eb9bc69ddc..0000000000 --- a/changes/changelog.d/search-page.bugfix +++ /dev/null @@ -1 +0,0 @@ -Fixed an issue with search pages where results would not appear after navigating to another page \ No newline at end of file diff --git a/changes/changelog.d/thunbnails.enhancement b/changes/changelog.d/thunbnails.enhancement deleted file mode 100644 index a402c654a5..0000000000 --- a/changes/changelog.d/thunbnails.enhancement +++ /dev/null @@ -1 +0,0 @@ -Increased quality of JPEG thumbnails -- GitLab