Package: guikit
GUIKITThis little tool's purpose is to facilitate getting started building a GUI for your
software. It takes care of most of the boilerplate code that you need to build a GUI -
making some opinionated decisions about the general layout of the application - so you
can focus on adding the business logic and views specific to your problem.guikituseswXPythonas the GUI framework, meaning that the resulting application
will have a native look and feel regadless of running it on Windows, Linux or MacOS.Whatguikitis and what is notguikittakes care of the boilerplate code and enables you to have a minimal
application running in no time, but you still need to code the rest of your GUI
mannually yourself. That means you will need to learn how to usewxPython, the widgets
it offers and their options.This is not a graphical designer for GUIs, as it could beQT
Designer,GladeorMatlab's App Designer.
All of those are excellent tools... just a different kind of tools.guikitwill
save you some valuable time when creating a GUI, but it is still a low level library.WhywxPythonas GUI frameworkWhile there are several excellent frameworks available, mature, well supported and with
many options for customization - in particularPySide2andPyQt, both based in QT -wxPythonoffers a licensing scheme a little bit more flexible that makes it suitable
for both open and close source projects.We strongly support open source software and open research, but we understand that it is
not always possible or advisable, at least at beginning, and we want to offer a tool
that could suit most users most of the time.Installation instructionsWARNING:guikitis in an early stage of development and the API might change
without notice. Use it in production with caution. And please, contribute to it to
help improving its maturity as fast as posisble!guikitand its dependencies can be installed withpipin Windows,LinuxandMacOS(see notes below):pipinstallguikitWhat about linuxguikitcan be installed in Linux withpip, butwxPythonwill likely need to be
built from source as there are notmanylinuxwheels for it, yet.The best option is for you to check if there is a wheel available for your specific
linux distirbution and python version in thewxPython downloads
webpageand install that one before
installingguikit. Otherwise, in the same webpage you have instructions on how to
installwxPythonfrom source.Alternatively, if you useconda, you can installwxPythonfromconda-forgeand
then installguikitas above.What about MacOSwxPythoncauses some issue on MacOS when installed with a "Non Framework" version of
python. It typically complains with this error message:This program needs access to the screen. Please run with a
Framework build of python, and only when you are logged in
on the main display of your Mac.To work around this:Install a python.org version of python.Find executable under/Library/Frameworks/Python.framework/....Use that executable to create a virtual environment:/Library/Frameworks/Python.framework/Versions/<version>/bin/python3 -m venv .venv.Installguikitinside virtual environment, and all should work!Alternatively, if you usecondato installwxPython, you will need to usepythonwto execute your applications. SeewxPython downloads
webpagefor more information on this.UsingguikitThere are several ways you can benefit fromguikit, depending on what you want to
achieve. Check thedocumentationfor full
details.Initialise your current directory with a skeleton for your GUI application usingguikitwithpython -m guikit init my_app.Runguikitwith all its available expensions for your to have a look and explore
the things you can do with it, uwingpython -m guikit run.Exploreguikit's repo, flick trhough the code, learn how to do things, brings
those which are useful to your own application, or clone the whole repo and customize
the core classes and functions to fully suit your needs.