From 7cf03c4de5244e7db3f44362a275f92368fd86ac Mon Sep 17 00:00:00 2001 From: Matthias Baumgartner Date: Sun, 8 Jan 2023 14:08:38 +0100 Subject: moved desktop widgets to windows --- tagit/apps/desktop.py | 2 +- tagit/widgets/__init__.py | 1 - tagit/widgets/desktop.kv | 136 ------------------------ tagit/widgets/desktop.py | 262 ---------------------------------------------- tagit/windows/desktop.kv | 136 ++++++++++++++++++++++++ tagit/windows/desktop.py | 258 +++++++++++++++++++++++++++++++++++++++++++++ 6 files changed, 395 insertions(+), 400 deletions(-) delete mode 100644 tagit/widgets/desktop.kv delete mode 100644 tagit/widgets/desktop.py create mode 100644 tagit/windows/desktop.kv create mode 100644 tagit/windows/desktop.py diff --git a/tagit/apps/desktop.py b/tagit/apps/desktop.py index 763439c..65501ad 100644 --- a/tagit/apps/desktop.py +++ b/tagit/apps/desktop.py @@ -13,7 +13,7 @@ from kivy.app import App from kivy.uix.settings import SettingsWithSidebar # tagit imports -from tagit.widgets import desktop +from tagit.windows import desktop # exports __all__: typing.Sequence[str] = ( diff --git a/tagit/widgets/__init__.py b/tagit/widgets/__init__.py index 3892a22..2899f85 100644 --- a/tagit/widgets/__init__.py +++ b/tagit/widgets/__init__.py @@ -6,6 +6,5 @@ Author: Matthias Baumgartner, 2022 """ # inner-module imports from .bindings import Binding -from .desktop import MainWindow ## EOF ## diff --git a/tagit/widgets/desktop.kv b/tagit/widgets/desktop.kv deleted file mode 100644 index cbc5c48..0000000 --- a/tagit/widgets/desktop.kv +++ /dev/null @@ -1,136 +0,0 @@ -#:import TileDecorationBorder tagit.tiles.decoration.TileDecorationBorder -#:import TileDecorationFilledRectangle tagit.tiles.decoration.TileDecorationFilledRectangle - -# DEBUG: Draw borders around all widgets -#: -# canvas.after: -# Line: -# rectangle: self.x+1,self.y+1,self.width-1,self.height-1 -# dash_offset: 5 -# dash_length: 3 - -: - # main content - # required by most tiles and actions - browser: browser - filter: filter - status: status - # required by actions.planes - planes: planes - # required by Menu - context: context - - Carousel: - id: planes - loop: True - scroll_timeout: 0 # disables switching by touch event - # plane references - dashboard: dashboard - browsing: browsing - codash: codash - - # planes - - TileDock: # static dashboard plane - id: dashboard - root: root - # plane config - size_hint: 1, 1 - visible: planes.current_slide == self - # dock config - name: 'dashboard' - decoration: TileDecorationBorder - cols: 3 - rows: 2 - # self.size won't be updated correctly - tile_width: self.width / self.cols - tile_height: self.height / self.rows - - BoxLayout: # browsing plane - id: browsing - orientation: 'horizontal' - visible: planes.current_slide == self - - ButtonDock: # one column of buttons on the left - root: root - orientation: 'tb-lr' - # one column of buttons - width: 30 + 2*10 - name: 'sidebar_left' - spacing: 10 - padding: 10 - size_hint: None, 1 - button_height: 30 - button_show: 'image', - - BoxLayout: # main content - orientation: 'vertical' - size_hint: 1, 1 - - BoxLayout: - orientation: 'horizontal' - size_hint: 1, 1 - current: 0 - - BoxLayout: - orientation: 'vertical' - size_hint: 1, 1 - - Filter: - id: filter - root: root - size_hint: 1, None - height: 30 - - Browser: - id: browser - root: root - size_hint: 1, 0.96 - - Status: - id: status - root: root - size_hint: 1, None - height: 30 - - TileDock: # context info to the right - root: root - visible: planes.current_slide == self.parent - name: 'sidebar_right' - decoration: TileDecorationFilledRectangle - cols: 1 - rows: 3 - # self.height won't be updated correctly - #tile_height: self.size[1] / 4 - width: 180 - size_hint: None, 1 - - TileDock: # contextual dashboard - id: codash - root: root - # plane config - size_hint: 1, 1 - visible: planes.current_slide == self - # dock config - name: 'codash' - decoration: TileDecorationBorder - cols: 4 - rows: 2 - # self.size won't be update correctly - tile_width: self.width / 4 - tile_height: self.height / 2 - - Context: # context menu - id: context - root: root - cancel_handler_widget: root - bounding_box_widget: root - name: 'context' - - KeybindDock: - # key-only actions - root: root - size_hint: None, None - size: 0, 0 - -## EOF ## diff --git a/tagit/widgets/desktop.py b/tagit/widgets/desktop.py deleted file mode 100644 index dffc3d7..0000000 --- a/tagit/widgets/desktop.py +++ /dev/null @@ -1,262 +0,0 @@ -"""Main container of the tagit UI. - -Part of the tagit module. -A copy of the license is provided with the project. -Author: Matthias Baumgartner, 2022 - -""" -# standard imports -import logging -import os -import typing - -# kivy imports -from kivy.clock import Clock -from kivy.lang import Builder -from kivy.uix.floatlayout import FloatLayout -import kivy.properties as kp - -# import Image and Loader to overwrite their caches later on -from kivy.loader import Loader -from kivy.cache import Cache - -# tagit imports -from tagit import actions -from tagit import config -from tagit import dialogues - -# inner-module imports -from .browser import Browser -from .context import Context -from .dock import TileDock, ButtonDock, KeybindDock -from .filter import Filter -from .keyboard import Keyboard -from .session import Session -from .status import Status - -# exports -__all__: typing.Sequence[str] = ( - 'KIVY_IMAGE_CACHE_SIZE', - 'KIVY_IMAGE_CACHE_TIMEOUT', - 'MainWindow', - ) - - -## code ## - -logger = logging.getLogger(__name__) - -# load kv -Builder.load_file(os.path.join(os.path.dirname(__file__), 'desktop.kv')) - -# classes -class MainWindow(FloatLayout): - """A self-contained user interface for desktop usage. - See `tagit.apps.gui` for an example of how to invoke it. - """ - - keys = kp.ObjectProperty(None) - - # unnecessary but nicely explicit - browser = kp.ObjectProperty(None) - filter = kp.ObjectProperty(None) - keytriggers = kp.ObjectProperty(None) - - # FIXME: log actions and and replay them - action_log = kp.ListProperty() - - def __init__ (self, cfg, stor, log, **kwargs): - # initialize the session - self._session = Session(cfg, stor, log) - # initialize key-only actions - self.keys = Keyboard() - - # initialize the cache - cache_size = max(0, cfg('ui', 'standalone', 'browser', 'cache_size')) - cache_size = cache_size if cache_size > 0 else None - cache_timeout = max(0, cfg('ui', 'standalone', 'browser', 'cache_timeout')) - cache_timeout = cache_timeout if cache_timeout > 0 else None - Cache.register('kv.loader', limit=cache_size, timeout=cache_timeout) - - # initialize the widget - super(MainWindow, self).__init__(**kwargs) - - # bind pre-close checks - from kivy.core.window import Window - Window.bind(on_request_close=self.on_request_close) - - - ## properties - - @property - def session(self): - return self._session - - def trigger(self, action, *args, **kwargs): - """Trigger an action once.""" - actions.ActionBuilder().get(action).single_shot(self, *args, **kwargs) - - - ## functions - - def autoindex(self, *args): - self.trigger('AutoImport') - - def autoupdate(self, *args): - self.trigger('AutoUpdate') - - def autosync(self, *args): - self.trigger('AutoSync') - - def autosave(self, *args): - if not self.session.storage.file_connected(): - return - - try: - self.trigger('SaveLibrary') - logger.info('Database: Autosaved') - except Exception as e: - logger.error(f'Database: Autosave failed ({e})') - - - ## startup and shutdown - - def on_startup(self): - # start autosave - autosave = self.session.cfg('storage', 'library', 'autosave') - if autosave > 0: - # autosave is in minutes - Clock.schedule_interval(self.autosave, autosave * 60) - - # start index - autoindex = self.session.cfg('storage', 'index', 'autoindex') - autoindex = 0 if autoindex == float('inf') else autoindex - if autoindex > 0: - # autoindex is in minutes - Clock.schedule_interval(self.autoindex, autoindex * 60) - - # start update - autoupdate = self.session.cfg('storage', 'index', 'autoupdate') - autoupdate = 0 if autoupdate == float('inf') else autoupdate - if autoupdate > 0: - # autoupdate is in minutes - Clock.schedule_interval(self.autoupdate, autoupdate * 60) - - # start sync - autosync = self.session.cfg('storage', 'index', 'autosync') - autosync = 0 if autosync == float('inf') else autosync - if autosync > 0: - # autosync is in minutes - Clock.schedule_interval(self.autosync, autosync * 60) - - # trigger operations on startup - if self.session.cfg('storage', 'index', 'index_on_startup'): - self.autoindex() - - if self.session.cfg('storage', 'index', 'update_on_startup'): - self.autoupdate() - - if self.session.cfg('storage', 'index', 'sync_on_startup'): - self.autosync() - - # switch to starting plane - if it's the dashboard no action is needed - if self.session.cfg('ui', 'standalone', 'plane') == 'browsing': - self.trigger('ShowBrowsing') - - # show welcome message - if self.session.cfg('session', 'first_start'): - self.display_welcome() - - # script - return - Clock.schedule_once(lambda dt: self.trigger('Search'), 0) - Clock.schedule_once(lambda dt: self.trigger('MoveCursorFirst'), 0) - Clock.schedule_once(lambda dt: self.trigger('SortKey', 'fid:image.colors_spatial:726b4e8ea45546e55dfcd4216b276284'), 0) - from kivy.app import App - App.get_running_app().stop() - Clock.schedule_once(lambda dt: self.trigger('ZoomOut'), 0) - Clock.schedule_once(lambda dt: self.trigger('ZoomOut'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) - #from kivy.app import App - #App.get_running_app().stop() - - def on_request_close(self, *args): - - with open('.action_history', 'a') as ofile: - for itm in self.action_log: - ofile.write(f'{itm}\n') - - return False # FIXME: mb/port - if self.session.storage.changed() and not self.session.cfg('session', 'debug'): - # save and close - self.trigger('CloseSessionAndExit') - return True - # close w/o saving - return False - - def display_welcome(self): - """Display a welcome dialogue on the first start.""" - message = """ -[size=20sp]Welcome to [b]tagit[/b]![/size] - -Since you see this message, it's time to configure tagit. It's a good idea to get familiar with the configuration. Hit F1 or the config button to see all relevant settings. There, you can also get rid of this message. If you desire more flexibility, you can edit the config file directly. Check out the project homepage for more details. -""" # FIXME! - dialogues.Message(text=message, align='left').open() - - -## config ## - -config.declare(('storage', 'library', 'autosave'), config.Float(), 0, - __name__, 'Autosave', 'Time interval in minutes at which the library is saved to disk while running the GUI. A value of 0 means that the feature is disabled.') - -config.declare(('storage', 'index', 'autoindex'), config.Float(), 0, - __name__, 'Autoindex', 'Time interval in minutes at which indexing is triggered while running the GUI. A value of 0 means that the feature is disabled. Also configure the index watchlist.') - -config.declare(('storage', 'index', 'autoupdate'), config.Float(), 0, - __name__, 'Autoupdate', 'Time interval in minutes at which updating is triggered while running the GUI. A value of 0 means that the feature is disabled.') - -config.declare(('storage', 'index', 'autosync'), config.Float(), 0, - __name__, 'Autosync', 'Time interval in minutes at which synchronization is triggered while running the GUI. A value of 0 means that the feature is disabled.') - -config.declare(('storage', 'index', 'index_on_startup'), config.Bool(), False, - __name__, 'Index on startup', 'Trigger indexing when the GUI is started. Also configure the index watchlist') - -config.declare(('storage', 'index', 'update_on_startup'), config.Bool(), False, - __name__, 'Update on startup', 'Trigger updating when the GUI is started.') - -config.declare(('storage', 'index', 'sync_on_startup'), config.Bool(), False, - __name__, 'Sync on startup', 'Trigger synchronization when the GUI is started.') - -config.declare(('session', 'first_start'), config.Bool(), True, - __name__, 'First start', 'Show the welcome message typically shown when tagit is started the first time.') - -config.declare(('ui', 'standalone', 'plane'), config.Enum('browsing', 'dashboard'), 'dashboard', - __name__, 'Initial plane', 'Start with the dashboard or browsing plane.') - -config.declare(('ui', 'standalone', 'browser', 'cache_size'), config.Unsigned(), 1000, - __name__, 'Cache size', 'Number of preview images that are held in the cache. Should be high or zero if memory is not an issue. Set to a small value to preserve memory, but should be at least the most common page size. It is advised to set a value in accordance with `ui.standalone.browser.cache_items`. If zero, no limit applies.') - -config.declare(('ui', 'standalone', 'browser', 'cache_timeout'), config.Unsigned(), 0, - __name__, 'Cache timeout', 'Number of seconds until cached items are discarded. Should be high or zero if memory is not an issue. Set it to a small value to preserve memory when browsing through many images. If zero, no limit applies. Specify in seconds.') - -## EOF ## diff --git a/tagit/windows/desktop.kv b/tagit/windows/desktop.kv new file mode 100644 index 0000000..cbc5c48 --- /dev/null +++ b/tagit/windows/desktop.kv @@ -0,0 +1,136 @@ +#:import TileDecorationBorder tagit.tiles.decoration.TileDecorationBorder +#:import TileDecorationFilledRectangle tagit.tiles.decoration.TileDecorationFilledRectangle + +# DEBUG: Draw borders around all widgets +#: +# canvas.after: +# Line: +# rectangle: self.x+1,self.y+1,self.width-1,self.height-1 +# dash_offset: 5 +# dash_length: 3 + +: + # main content + # required by most tiles and actions + browser: browser + filter: filter + status: status + # required by actions.planes + planes: planes + # required by Menu + context: context + + Carousel: + id: planes + loop: True + scroll_timeout: 0 # disables switching by touch event + # plane references + dashboard: dashboard + browsing: browsing + codash: codash + + # planes + + TileDock: # static dashboard plane + id: dashboard + root: root + # plane config + size_hint: 1, 1 + visible: planes.current_slide == self + # dock config + name: 'dashboard' + decoration: TileDecorationBorder + cols: 3 + rows: 2 + # self.size won't be updated correctly + tile_width: self.width / self.cols + tile_height: self.height / self.rows + + BoxLayout: # browsing plane + id: browsing + orientation: 'horizontal' + visible: planes.current_slide == self + + ButtonDock: # one column of buttons on the left + root: root + orientation: 'tb-lr' + # one column of buttons + width: 30 + 2*10 + name: 'sidebar_left' + spacing: 10 + padding: 10 + size_hint: None, 1 + button_height: 30 + button_show: 'image', + + BoxLayout: # main content + orientation: 'vertical' + size_hint: 1, 1 + + BoxLayout: + orientation: 'horizontal' + size_hint: 1, 1 + current: 0 + + BoxLayout: + orientation: 'vertical' + size_hint: 1, 1 + + Filter: + id: filter + root: root + size_hint: 1, None + height: 30 + + Browser: + id: browser + root: root + size_hint: 1, 0.96 + + Status: + id: status + root: root + size_hint: 1, None + height: 30 + + TileDock: # context info to the right + root: root + visible: planes.current_slide == self.parent + name: 'sidebar_right' + decoration: TileDecorationFilledRectangle + cols: 1 + rows: 3 + # self.height won't be updated correctly + #tile_height: self.size[1] / 4 + width: 180 + size_hint: None, 1 + + TileDock: # contextual dashboard + id: codash + root: root + # plane config + size_hint: 1, 1 + visible: planes.current_slide == self + # dock config + name: 'codash' + decoration: TileDecorationBorder + cols: 4 + rows: 2 + # self.size won't be update correctly + tile_width: self.width / 4 + tile_height: self.height / 2 + + Context: # context menu + id: context + root: root + cancel_handler_widget: root + bounding_box_widget: root + name: 'context' + + KeybindDock: + # key-only actions + root: root + size_hint: None, None + size: 0, 0 + +## EOF ## diff --git a/tagit/windows/desktop.py b/tagit/windows/desktop.py new file mode 100644 index 0000000..5128454 --- /dev/null +++ b/tagit/windows/desktop.py @@ -0,0 +1,258 @@ +"""Main container of the tagit UI. + +Part of the tagit module. +A copy of the license is provided with the project. +Author: Matthias Baumgartner, 2022 + +""" +# standard imports +import logging +import os +import typing + +# kivy imports +from kivy.clock import Clock +from kivy.lang import Builder +from kivy.uix.floatlayout import FloatLayout +import kivy.properties as kp + +# import Image and Loader to overwrite their caches later on +from kivy.loader import Loader +from kivy.cache import Cache + +# tagit imports +from tagit import actions, config, dialogues +from tagit.widgets.browser import Browser +from tagit.widgets.context import Context +from tagit.widgets.dock import TileDock, ButtonDock, KeybindDock +from tagit.widgets.filter import Filter +from tagit.widgets.keyboard import Keyboard +from tagit.widgets.session import Session +from tagit.widgets.status import Status + +# exports +__all__: typing.Sequence[str] = ( + 'KIVY_IMAGE_CACHE_SIZE', + 'KIVY_IMAGE_CACHE_TIMEOUT', + 'MainWindow', + ) + + +## code ## + +logger = logging.getLogger(__name__) + +# load kv +Builder.load_file(os.path.join(os.path.dirname(__file__), 'desktop.kv')) + +# classes +class MainWindow(FloatLayout): + """A self-contained user interface for desktop usage. + See `tagit.apps.gui` for an example of how to invoke it. + """ + + keys = kp.ObjectProperty(None) + + # unnecessary but nicely explicit + browser = kp.ObjectProperty(None) + filter = kp.ObjectProperty(None) + keytriggers = kp.ObjectProperty(None) + + # FIXME: log actions and and replay them + action_log = kp.ListProperty() + + def __init__ (self, cfg, stor, log, **kwargs): + # initialize the session + self._session = Session(cfg, stor, log) + # initialize key-only actions + self.keys = Keyboard() + + # initialize the cache + cache_size = max(0, cfg('ui', 'standalone', 'browser', 'cache_size')) + cache_size = cache_size if cache_size > 0 else None + cache_timeout = max(0, cfg('ui', 'standalone', 'browser', 'cache_timeout')) + cache_timeout = cache_timeout if cache_timeout > 0 else None + Cache.register('kv.loader', limit=cache_size, timeout=cache_timeout) + + # initialize the widget + super(MainWindow, self).__init__(**kwargs) + + # bind pre-close checks + from kivy.core.window import Window + Window.bind(on_request_close=self.on_request_close) + + + ## properties + + @property + def session(self): + return self._session + + def trigger(self, action, *args, **kwargs): + """Trigger an action once.""" + actions.ActionBuilder().get(action).single_shot(self, *args, **kwargs) + + + ## functions + + def autoindex(self, *args): + self.trigger('AutoImport') + + def autoupdate(self, *args): + self.trigger('AutoUpdate') + + def autosync(self, *args): + self.trigger('AutoSync') + + def autosave(self, *args): + if not self.session.storage.file_connected(): + return + + try: + self.trigger('SaveLibrary') + logger.info('Database: Autosaved') + except Exception as e: + logger.error(f'Database: Autosave failed ({e})') + + + ## startup and shutdown + + def on_startup(self): + # start autosave + autosave = self.session.cfg('storage', 'library', 'autosave') + if autosave > 0: + # autosave is in minutes + Clock.schedule_interval(self.autosave, autosave * 60) + + # start index + autoindex = self.session.cfg('storage', 'index', 'autoindex') + autoindex = 0 if autoindex == float('inf') else autoindex + if autoindex > 0: + # autoindex is in minutes + Clock.schedule_interval(self.autoindex, autoindex * 60) + + # start update + autoupdate = self.session.cfg('storage', 'index', 'autoupdate') + autoupdate = 0 if autoupdate == float('inf') else autoupdate + if autoupdate > 0: + # autoupdate is in minutes + Clock.schedule_interval(self.autoupdate, autoupdate * 60) + + # start sync + autosync = self.session.cfg('storage', 'index', 'autosync') + autosync = 0 if autosync == float('inf') else autosync + if autosync > 0: + # autosync is in minutes + Clock.schedule_interval(self.autosync, autosync * 60) + + # trigger operations on startup + if self.session.cfg('storage', 'index', 'index_on_startup'): + self.autoindex() + + if self.session.cfg('storage', 'index', 'update_on_startup'): + self.autoupdate() + + if self.session.cfg('storage', 'index', 'sync_on_startup'): + self.autosync() + + # switch to starting plane - if it's the dashboard no action is needed + if self.session.cfg('ui', 'standalone', 'plane') == 'browsing': + self.trigger('ShowBrowsing') + + # show welcome message + if self.session.cfg('session', 'first_start'): + self.display_welcome() + + # script + return + Clock.schedule_once(lambda dt: self.trigger('Search'), 0) + Clock.schedule_once(lambda dt: self.trigger('MoveCursorFirst'), 0) + Clock.schedule_once(lambda dt: self.trigger('SortKey', 'fid:image.colors_spatial:726b4e8ea45546e55dfcd4216b276284'), 0) + from kivy.app import App + App.get_running_app().stop() + Clock.schedule_once(lambda dt: self.trigger('ZoomOut'), 0) + Clock.schedule_once(lambda dt: self.trigger('ZoomOut'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + Clock.schedule_once(lambda dt: self.trigger('NextPage'), 0) + #from kivy.app import App + #App.get_running_app().stop() + + def on_request_close(self, *args): + + with open('.action_history', 'a') as ofile: + for itm in self.action_log: + ofile.write(f'{itm}\n') + + return False # FIXME: mb/port + if self.session.storage.changed() and not self.session.cfg('session', 'debug'): + # save and close + self.trigger('CloseSessionAndExit') + return True + # close w/o saving + return False + + def display_welcome(self): + """Display a welcome dialogue on the first start.""" + message = """ +[size=20sp]Welcome to [b]tagit[/b]![/size] + +Since you see this message, it's time to configure tagit. It's a good idea to get familiar with the configuration. Hit F1 or the config button to see all relevant settings. There, you can also get rid of this message. If you desire more flexibility, you can edit the config file directly. Check out the project homepage for more details. +""" # FIXME! + dialogues.Message(text=message, align='left').open() + + +## config ## + +config.declare(('storage', 'library', 'autosave'), config.Float(), 0, + __name__, 'Autosave', 'Time interval in minutes at which the library is saved to disk while running the GUI. A value of 0 means that the feature is disabled.') + +config.declare(('storage', 'index', 'autoindex'), config.Float(), 0, + __name__, 'Autoindex', 'Time interval in minutes at which indexing is triggered while running the GUI. A value of 0 means that the feature is disabled. Also configure the index watchlist.') + +config.declare(('storage', 'index', 'autoupdate'), config.Float(), 0, + __name__, 'Autoupdate', 'Time interval in minutes at which updating is triggered while running the GUI. A value of 0 means that the feature is disabled.') + +config.declare(('storage', 'index', 'autosync'), config.Float(), 0, + __name__, 'Autosync', 'Time interval in minutes at which synchronization is triggered while running the GUI. A value of 0 means that the feature is disabled.') + +config.declare(('storage', 'index', 'index_on_startup'), config.Bool(), False, + __name__, 'Index on startup', 'Trigger indexing when the GUI is started. Also configure the index watchlist') + +config.declare(('storage', 'index', 'update_on_startup'), config.Bool(), False, + __name__, 'Update on startup', 'Trigger updating when the GUI is started.') + +config.declare(('storage', 'index', 'sync_on_startup'), config.Bool(), False, + __name__, 'Sync on startup', 'Trigger synchronization when the GUI is started.') + +config.declare(('session', 'first_start'), config.Bool(), True, + __name__, 'First start', 'Show the welcome message typically shown when tagit is started the first time.') + +config.declare(('ui', 'standalone', 'plane'), config.Enum('browsing', 'dashboard'), 'dashboard', + __name__, 'Initial plane', 'Start with the dashboard or browsing plane.') + +config.declare(('ui', 'standalone', 'browser', 'cache_size'), config.Unsigned(), 1000, + __name__, 'Cache size', 'Number of preview images that are held in the cache. Should be high or zero if memory is not an issue. Set to a small value to preserve memory, but should be at least the most common page size. It is advised to set a value in accordance with `ui.standalone.browser.cache_items`. If zero, no limit applies.') + +config.declare(('ui', 'standalone', 'browser', 'cache_timeout'), config.Unsigned(), 0, + __name__, 'Cache timeout', 'Number of seconds until cached items are discarded. Should be high or zero if memory is not an issue. Set it to a small value to preserve memory when browsing through many images. If zero, no limit applies. Specify in seconds.') + +## EOF ## -- cgit v1.2.3