adding -sdd (--show_dirs) command line parameter and updating docs

Author: s-n-g

docs/index.html

@@ -1310,13 +1310,15 @@ <h2 id="installation">Installation <span style="padding-left: 10px;"><sup style=
 <p>The best way to install <strong>PyRadio</strong> is via a distribution package, if one exists (<em>Arch Linux</em> and derivatives can install <a target="_blank" href="https://aur.archlinux.org/packages/?K=pyradio">any of these packages</a> from the AUR, <em>FreeBSD</em> users will find it in the <a target="_blank" href="https://www.freshports.org/audio/py-pyradio/">ports</a>, etc.).</p>
 <p>In any other case, and since <strong>PyRadio</strong> is currently not available via pip, you will have to <a href="build.html">build it from source</a>.</p>
 <h2 id="command-line-options">Command line options <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></span></h2>
-<pre>Usage: pyradio [-h] [-c CONFIG_DIR] [-p [STATION_NUMBER]] [-u PLAYER] [-l]
-               [-lt] [-sd] [-od] [-pc] [-d] [-ul] [-us] [-U] [-R] [-V] [-ls]
-               [-s PLAYLIST] [-tlp] [-t THEME] [--show-themes] [--no-themes]
-               [--write-theme IN_THEME OUT_THEME,] [--terminal TERMINAL]
-               [--terminal-param TERMINAL_PARAM] [-oc] [-sc] [-cc] [-gc] [-r]
-               [-or] [-lr] [-mkv MKV_FILE] [-scv PNG_FILE] [-srt] [-ach]
-               [--headless IP_AND_PORT] [--address] [-fd]
+<pre># pyradio -h
+Usage: pyradio [-h] [-c CONFIG_DIR] [-p [STATION_NUMBER]] [-u PLAYER] [-l]
+               [-lt] [-sds] [-sd] [-od] [-pc] [-d] [-ul] [-us] [-U] [-R] [-V]
+               [-ls] [-s PLAYLIST] [-tlp] [-t THEME] [--show-themes]
+               [--no-themes] [--write-theme IN_THEME OUT_THEME,]
+               [--terminal TERMINAL] [--terminal-param TERMINAL_PARAM] [-oc]
+               [-sc] [-cc] [-gc] [-r] [-or] [-lr] [-mkv MKV_FILE]
+               [-scv PNG_FILE] [-srt] [-ach] [--headless IP_AND_PORT]
+               [--address] [-fd]
 
 Curses based Internet Radio Player
 
@@ -1335,6 +1337,7 @@ <h2 id="command-line-options">Command line options <span style="padding-left: 10
                         mpv, mplayer, vlc.
   -l, --list            List of available stations in a playlist.
   -lt, --log-titles     Log titles to file.
+  -sds, --show-dirs     Print all the directories used by PyRadio and exit.
   -sd, --show-config-dir
                         Print config directory [CONFIG DIR] location and exit.
   -od, --open-config-dir

docs/index.md

@@ -121,13 +121,15 @@ In any other case, and since **PyRadio** is currently not available via pip, you
 ## Command line options
 
 ```
+# pyradio -h
 Usage: pyradio [-h] [-c CONFIG_DIR] [-p [STATION_NUMBER]] [-u PLAYER] [-l]
-               [-lt] [-sd] [-od] [-pc] [-d] [-ul] [-us] [-U] [-R] [-V] [-ls]
-               [-s PLAYLIST] [-tlp] [-t THEME] [--show-themes] [--no-themes]
-               [--write-theme IN_THEME OUT_THEME,] [--terminal TERMINAL]
-               [--terminal-param TERMINAL_PARAM] [-oc] [-sc] [-cc] [-gc] [-r]
-               [-or] [-lr] [-mkv MKV_FILE] [-scv PNG_FILE] [-srt] [-ach]
-               [--headless IP_AND_PORT] [--address] [-fd]
+               [-lt] [-sds] [-sd] [-od] [-pc] [-d] [-ul] [-us] [-U] [-R] [-V]
+               [-ls] [-s PLAYLIST] [-tlp] [-t THEME] [--show-themes]
+               [--no-themes] [--write-theme IN_THEME OUT_THEME,]
+               [--terminal TERMINAL] [--terminal-param TERMINAL_PARAM] [-oc]
+               [-sc] [-cc] [-gc] [-r] [-or] [-lr] [-mkv MKV_FILE]
+               [-scv PNG_FILE] [-srt] [-ach] [--headless IP_AND_PORT]
+               [--address] [-fd]
 
 Curses based Internet Radio Player
 
@@ -146,6 +148,7 @@ General options:
                         mpv, mplayer, vlc.
   -l, --list            List of available stations in a playlist.
   -lt, --log-titles     Log titles to file.
+  -sds, --show-dirs     Print all the directories used by PyRadio and exit.
   -sd, --show-config-dir
                         Print config directory [CONFIG DIR] location and exit.
   -od, --open-config-dir

docs/pyradio.1

@@ -38,6 +38,8 @@ used to specify detection order. Supported players:
 List of available stations in a playlist.
 .IP\ \fB-lt\fR,\ \fB--log\fR\fB-titles\fR
 Log titles to file.
+.IP\ \fB-sds\fR,\ \fB--show\fR\fB-dirs\fR
+Print all the directories used by PyRadio and exit.
 .IP\ \fB-sd\fR,\ \fB--show\fR\fB-config\fR\fB-dir\fR
 Print config directory [\fICONFIG\fR \fIDIR\fR] location and exit.
 .IP\ \fB-od\fR,\ \fB--open\fR\fB-config\fR\fB-dir\fR

pyradio/main.py

@@ -254,6 +254,8 @@ def shell():
 
     parser.add_argument('-lt', '--log-titles', action='store_true',
                         help='Log titles to file.')
+    parser.add_argument('-sds', '--show-dirs', action='store_true',
+                        help='Print all the directories used by PyRadio and exit.')
     parser.add_argument('-sd', '--show-config-dir', action='store_true',
                         help='Print config directory [CONFIG DIR] location and exit.')
     parser.add_argument('-od', '--open-config-dir', action='store_true',
@@ -649,6 +651,15 @@ def shell():
             pyradio_config.force_to_remove_lock_file = True
             return
 
+        if args.show_dirs:
+            print('[magenta]Directories used by PyRadio[/magenta]')
+            print('    Config dir: "[red]{}[/red]"'.format(pyradio_config.stations_dir))
+            print('      Data dir: "[red]{}[/red]"'.format(pyradio_config.data_dir))
+            print('     State dir: "[red]{}[/red]"'.format(pyradio_config.state_dir))
+            print('     Cache dir: "[red]{}[/red]"'.format(pyradio_config.cache_dir))
+            print('Recordings dir: "[red]{}[/red]"'.format(pyradio_config.recording_dir))
+            return
+
         if args.show_config_dir:
             print('[magenta]PyRadio[/magenta] config dir: "[red]{}[/red]"'.format(pyradio_config.stations_dir))
             return