From b92d87bb066707f8d1a6f9b0e2c681f50981e8b0 Mon Sep 17 00:00:00 2001 From: Matthias Meulien Date: Tue, 2 May 2023 12:15:43 +0200 Subject: [PATCH] Remove unused imports and document library window --- argos/widgets/librarywindow.py | 26 ++++++++++++++++++++++++++ argos/widgets/tracksview.py | 1 - 2 files changed, 26 insertions(+), 1 deletion(-) diff --git a/argos/widgets/librarywindow.py b/argos/widgets/librarywindow.py index cb7b6d8..e8de2b6 100644 --- a/argos/widgets/librarywindow.py +++ b/argos/widgets/librarywindow.py @@ -40,6 +40,32 @@ class DirectoryItemType(IntEnum): @Gtk.Template(resource_path="/io/github/orontee/Argos/ui/library_window.ui") class LibraryWindow(Gtk.Box): + """Vertical box with stack of widgets dedicated to library browsing. + + It also contains a condensed playing box to ease access to playback + controls. + + The stack is contained in an overlay used to display to notify library + loading progress. + + The stack contains: + + - The ``directory_page`` page to view a directory content + (implemented through Gtk.IconView). It's able to display child + directories, albums, playlists and tracks. + + - The ``album_details_page`` page to view details on an album (see + ``AlbumDetailsBox``). + + - The ``tracks_view_page`` page to view a track list (see ``TracksView``). + + Whether entering a directory must switch to the ``tracks_view_page`` + page, depends on the entered directory: It should contain only tracks. + The setting ``disable-tracks-view-pattern`` can be used to disable that + behavior. + + """ + __gtype_name__ = "LibraryWindow" library_overlay: Gtk.Overlay = Gtk.Template.Child() diff --git a/argos/widgets/tracksview.py b/argos/widgets/tracksview.py index 5f552ae..c6d7e03 100644 --- a/argos/widgets/tracksview.py +++ b/argos/widgets/tracksview.py @@ -4,7 +4,6 @@ from gi.repository import Gio, GLib, GObject, Gtk -from argos.message import MessageType from argos.model import DirectoryModel, TrackModel from argos.utils import ms_to_text from argos.widgets.trackbox import TrackBox