0.20 release notes

doc/releases/0.20.rst

@@ -0,0 +1,46 @@
+SoCo 0.20 release notes
+***********************
+
+**SoCo 0.20** is the lastes increment to the SoCo module. Among the additions
+this time are support for adding stereo pairs, proper categorization of Sonos
+Amp as a playbar to add proper support for 'night sound' and 'speech
+enhancement' and finally a fix for a long running issue where vendor extended
+DIDL-Lite classes would cause events to crash without specific code added for
+each one. See the full list of additions and bugfixes below.
+
+`SoCo (Sonos Controller) <http://python-soco.com/>`_ is a Python
+package that allows you to programmatically control Sonos speakers.
+
+New Features and Improvements
+=============================
+
+* Add support for creating and separating stereo pairs of speakers. Note: works
+  with dissimilar Sonos speakers if required. Pull request `#704
+  <https://github.com/SoCo/SoCo/pull/704>`_.
+* Add support for autogenerating vendor extended DIDL-Lite classes. Pull request
+  `#713 <https://github.com/SoCo/SoCo/pull/713>`_. This should fix all the
+  problems where SoCo would crash if some vendor specific data type is
+  unknown. 
+* Categorize Sonos Amp as a playbar in order to provide support for 'night
+  sound' and 'speech enhancement'. Pull request `#721
+  <https://github.com/SoCo/SoCo/pull/721>`_
+* If port 1400 is in use, the next available 100 ports will be tried. Pull
+  request `#724 <https://github.com/SoCo/SoCo/pull/724>`_.
+
+Bugfixes
+========
+
+* Fix bug where data_structures_upgrade would fail on items that has no uri.
+  Issue `#702 <https://github.com/SoCo/SoCo/issues/702>`_.
+* Process share browsing correctly. Issue `#717
+  <https://github.com/SoCo/SoCo/issues/717>`_. Credit to @Sonosy for the fix.
+
+Developer improvements
+======================
+
+* Format all soco main, test and example code with the black code formatter
+  (https://github.com/psf/black) and make it mandatory going forward including a
+  TravisCI check. Pull request `#706 <https://github.com/SoCo/SoCo/pull/706>`_.
+* Improve `test_remove_playlist_bad_id()` to handle the case of no existing
+  playlists. Pull request `#726 <https://github.com/SoCo/SoCo/pull/726>`_, fixes
+  issue `#725 <https://github.com/SoCo/SoCo/issues/725>`_.

doc/releases/index.rst

@@ -7,6 +7,7 @@ SoCo releases
 .. toctree::
    :maxdepth: 1
 
+   0.20
    0.19
    0.18
    0.17