- Playlist history works for Radio Browser as well

- Updating docs

Author: s-n-g

Changelog

@@ -1,6 +1,7 @@
-2019-12-02 s-n-g
+2019-12-08 s-n-g
     * Adding playlist history (for local playlists)
     * WINDOWS: Volume will be saved when mplayer is installed in %APPDATA%\pyradio
+    * Fixing station moving when appending station
 
 2019-11-15 s-n-g
     * PyRadio will not crush with mpv 0.30.0

README.html

@@ -179,6 +179,10 @@ <h3 id="managing-foreign-playlists">Managing “foreign” playlists</h3>
 <p>A playlist that does not reside within the program’s configuration directory is considered a “<strong><em>foreign</em></strong>” playlist. This playlist can only be opened by the <strong>-s</strong> command line option.</p>
 <p>When this happens, <strong>PyRadio</strong> will offer you the choice to copy the playlist in its configuration directory, thus making it available for manipulation within the program.</p>
 <p>If a playlist of the same name already exists in the configuration directory, the “<strong><em>foreign</em></strong>” playlist will be time-stamped. For example, if a “<strong><em>foreign</em></strong>” playlist is named “<em>stations.csv</em>”, it will be named “<em>2019-01-11_13-35-47_stations.csv</em>” (provided that the action was taken on January 11, 2019 at 13:35:47).</p>
+<h3 id="playlist-history">Playlist history</h3>
+<p><strong>PyRadio</strong> will keep a history of all the playlists opened (within a given session), so that navigating between them is made easy.</p>
+<p>In order to go back to the previous playlist, the user just has to press “<strong><em>\\</em></strong>” (double backslash). To get to the first playlist “<strong><em>\]</em></strong>” (backslash - closing square bracket) can be used.</p>
+<p>Going forward in history is not supported.</p>
 <h2 id="search-function">Search function <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></style></h2>
 <p>On any window presenting a list of items (stations, playlists, themes) a <strong>search function</strong> is available by pressing “<strong>/</strong>”.</p>
 <p>The <em>Search Window</em> supports normal and extend editing and in session history.</p>

README.md

@@ -211,6 +211,13 @@ When this happens, **PyRadio** will offer you the choice to copy the playlist in
 
 If a playlist of the same name already exists in the configuration directory, the "***foreign***" playlist will be time-stamped. For example, if a "***foreign***" playlist is named "*stations.csv*", it will be named "*2019-01-11_13-35-47_stations.csv*" (provided that the action was taken on January 11, 2019 at 13:35:47).
 
+### Playlist history
+
+**PyRadio** will keep a history of all the playlists opened (within a given session), so that navigating between them is made easy.
+
+In order to go back to the previous playlist, the user just has to press "***\\\\***" (double backslash). To get to the first playlist "***\\]***" (backslash - closing square bracket) can be used.
+
+Going forward in history is not supported.
 
 ## Search function
 

pyradio.1

@@ -229,6 +229,16 @@ When this happens, \fBpyradio\fR will offer you the choise to copy the playlist
 If a playlist of the same name already exists in the configuration directory, the "\fIforeign\fR" playlist will be time-stamped. For example, if a "\fIforeign\fR" playlist is named "\fIstations.csv\fR", it will be named "\fI2019-01-11_13-35-47_stations.csv\fR" (provided that the action was taked on January 11, 2019 at 13:35:47).
 
 
+.PP
+.B
+PLAYLIST HISTORY
+
+\fBpyradio\fR will keep a history of all the playlists opened (within a given session), so that navigating between them is made easy.
+
+In order to go back to the previous playlist, the user just has to press "\fI\\\\\fR" (double backslash). To get to the first playlist "\fI\\]\fR" (backslash - closing square bracket) can be used.
+
+Going forward in history is not supported.
+
 .SH SEARCH FUNCTION
 
 On any window presenting a list of items (stations, playlists, themes) a \fBsearch function\fR is available by pressing "\fI/\fR".

pyradio/browser.py

@@ -23,6 +23,7 @@ class PyRadioStationsBrowser(object):
     """
 
     BASE_URL = ''
+    TITLE = ''
     _raw_stations = []
     _last_search = None
     _have_to_retrieve_url = False
@@ -77,6 +78,14 @@ def have_to_retrieve_url(self):
     def have_to_retrieve_url(self, value):
         raise ValueError('property is read only')
 
+    @property
+    def title(self):
+        return self.TITLE
+
+    @title.setter
+    def title(self, value):
+        self.TITLE = value
+
     def stations(self, playlist_format=1):
         return []
 
@@ -140,6 +149,7 @@ def format_station_line(self, id_in_list, pad, width):
 class PyRadioBrowserInfoBrowser(PyRadioStationsBrowser):
 
     BASE_URL = 'www.radio-browser.info'
+    TITLE = 'Radio Browser'
 
     _open_url = \
              'http://www.radio-browser.info/webservice/json/stations/topvote/100'