Package: dtool-lookup-gui
dtool-lookup-gui is a graphical user interface fordtool,dtool-lookup-serveranddtool-lookup-server-dependency-graph-pluginwritten inPythonandGTK.Quick startJust download the pre-packaged binaries of thelatest releaseand follow thequick start guideto get started.If the binaries won’t run out-of-the-box on your system, continue below.OS-specific notesmacOSAfter downloading thedmgApple Disk Image of thelatest releaseand copyingdtool-lookup-guiover to yourApplicationsfolder,macOSwill likely complain aboutdtool-lookup-guibeing damaged
and refuse to execute it. This is due to the fact that we are no
Apple-verified developers. To run the app anyway, open a terminal and
remove Apple’s quarantine attribute from the app withsudoxattr-rdscom.apple.quarantine/Applications/dtool-lookup-gui.appThat should enable you to launch the app as usual. Another option is to
call/Applications/dtool-lookup-gui.app/Contents/MacOS/dtool-lookup-guidirectly from the command line.RequirementsThis application requiresGtk3 andGtkSourceView4.On Ubuntu (20.04),aptinstall-ygir1.2-gtksource-4suffices to to install these dependencies from the standard system package repositories.On recent macOS (>= 10.15) use homebrew,brewinstallgtksourceview4gnome-icon-themeOn earlie macOs,MacPortsallows the installation ofgtksourceview4sudoport-vselfupdatesudoportinstallxorg-serversudoportinstallgtksourceview4py-gobject3py-pippy-numpypy-scipysudoportinstalladwaita-icon-themesudoportselect--setpythonpython310sudoportselect--setpippip310mkdir-p~/venvpython-mvenv--system-site-packages~/venv/python-3.10source~/venv/python-3.10/bin/activatepipinstall--upgradepippipinstallwheelpipinstalldtool-lookup-guidtool-s3dtool-smbThis has been tested on macOS 10.13.6.On Windows, usemingw64/msys2and refer to theUsing GTK from MSYS2 packageson the GTK project’s pages.Also refer to the build workflows.github/workflows/build-on-[linux|macos|windows].ymlwithin this repository
for understanding the requirements for the different systems.InstallationThe application usessetuptools. It can be installed withpip:pipinstalldtool-lookup-guiIf you want the latest development release, then use:pipinstallgit+https://github.com/livMatS/dtool-lookup-gui.gitWhen already clone into a local directly viagit, either usepipor install via the standard routepythonsetup.pyinstallFor an editable install,pipinstall-e.also runglib-compile-schemas.from within subdirectorydtool_lookup_gui. Otherwise, GUI launch fails withgi.repository.GLib.Error: g-file-error-quark: Failed to open file “/path/to/repository/dtool_lookup_gui/gschemas.compiled”: open() failed: No such file or directory (4)Running the GUIAfter installation, run the GUI with:python-mdtool_lookup_guiNote that when you run the GUI for the first time, you will need to configure
the URL of the lookup and the authentication server as well as provide a
username and a password. To do this, click on the “Burger” symbol and selectSettings.DevelopmentPinned requirementsrequirements.incontains unpinned dependencies.requirements.txtwith pinned versions has been auto-generated withpipinstallpip-toolspip-compilerequirements.in>requirements.txtTesting github workflows locallyIt is possible to run github workflows locally
with the help ofdockerandact.Install and configure actat a specific version withgoinstallgithub.com/nektos/act@v0.2.24and run a workflow withact-sGITHUB_TOKEN=$GITHUB_TOKEN-W.github/workflows/publish-on-pypi.ymlfrom within this repository.$GITHUB_TOKENmust hold a validaccess token.
The evoking user must be member of thedockergroup.To generate a pyinstaller-packaged application by the according workflow and
store it locally, use the--bindflag, i.e.act-sGITHUB_TOKEN=$GITHUB_TOKEN-W.github/workflows/build-on-ubuntu.yml--bindThis will bind-mount the current folder into the workflow-executing container.
All locally generated artifacts will hence survive the container’s lifespan,
but usually belong toroot. The executable resides belowdist. Usesudochown-R$USER:$USER.gitclean-fdxto remove the generatedbuild,dist, andworkflowfolders and all other artifacts.GTK debuggingAftergsettingssetorg.gtk.Settings.Debugenable-inspector-keybindingtrueuse CTRL-SHIFT-D during execution to display the GTK inspector for interactive debugging.GUI designThe GUI uses custom Gtk widgets. To edit the the XML UI definition files withGlade, add the directoryglade/catalogtoExtra Catalog & Template pathswithin Glade’s preferences dialog.FundingThis development has received funding from the Deutsche Forschungsgemeinschaft within the Cluster of ExcellencelivMatS.