Description:

tkvue 2.1.6

TKVue
Declarative Tkinter UI using makup language with reactive data binding.
Description
TKVue bring familiar advantages in web development to traditional development. This project allow you to create modern graphical user interface written in Python using Tkinter library.
TKVue provide a declarative language to build user interface with Markup language.
<Label text="Hello world!" />

TKVue provide databinding to quickly make your graphical user interface dynamic.
<ComboBox pack-side="left" pack-expand="1" values="['zero', 'one', 'two', 'three']" textvariable="{{ myvariable }}" />
<Label text="{{ myvariable }}" />

TKVue provide a babel entry point to support internationalization.
babel.cfg:
[tkvue: **/templates/**.tkml]

Installation
TKVue is available on pypi and can be installed using pip.
pip install tkvue

Usage
Once installed you may take a look at various examples available:
https://gitlab.com/ikus-soft/tkvue/-/tree/master/doc/examples
Help is welcome to write proper documentation about how to use TKVue.
Support
If you need help or experience problem while using TKvue, open a ticket in Gitlab.
Result
Once you have customize the Tkinter themes, the result could be astonishing. Here the result of Minarca interface build using TKVue.

Translation
Tkvue provide a babel extention to extract static text from xml template.
You must configure babel to use the right plugin to extract the values from the templates.
babel.cfg:
[tkvue: **/templates/**.tkml]

Then You may use babel and other gettext tools to complete the translation using the .po file.
python setup.py extract_messages

See Also
Other Tkinter-related projects worth mentioning:

witkets: Create Tkinter interface using XML similar to TKVue
ttkbootstrap: Theme extension for tkinter inspire by Bootstrap

Changelog
2.1.6 ()

Add support @tkvue.computed() annotation to register attribute dynamically
Add support Python 3.12
Ajust asyncio event loop to keep it running when mainloop() exit
Add support Grid Geometry manager
Add support @tkvue.attr() annotation to register attribute dynamically for custom component
Add support style attribute on TopLevel to inherit background color
Add loop_idx variable when using for attribute

2.1.5 (2023-10-18)

Fix infinit recursion depth when root is not yet defined

2.1.4 (2023-07-26)

Update background of ScrolledFrame when style is configure
Register "wrap" attribute only for Label

2.1.3 (2023-07-25)

Define minimum height for ScrolledFrame.

2.1.2 (2023-07-13)

Fix display of scrollbar in ScrolledFrame when resize on Y axis.

2.1.1 (2023-07-12)

Fix display of scrollbar on initialization.

2.1.0 (2023-04-20)

Add many examples for self documentation
Provide the @tkvue.widget annotation to register a new widget.
Provide the @tkvue.attr annotation to register the custom attributes of the widget.

2.0.3 (2023-02-26)

Support resizable attribute on TopLevel not_resizable.py
Support theme attribute on TopLevel theme.py

2.0.2 (2023-02-08)

Add example to demonstrate usage of variables dynamic.py
Add example to demonstrate usage of visible= attribute to show or hide widget dynamic_visible.py
Add example to demonstrate usage of for= attribute to create list of widget dynamic_loop.py
Add example to demonstrate style customization color.py

2.0.1 (2023-01-16)

Support assignment of None to <Label image="..." > to hide image animated_gif.py
Add example to demonstrate usage of <Progressbar> progressbar.py

2.0.0 (2022-12-13)

Implement mainloop using asyncio to avoid multi-threading #1
Increase default offset when displaying <Tooltip> to avoid flikering when user hover a widget
<ScrolledFrame> inherit the background color from the style
Show or hide scroll bar of <ScrolledFrame> when needed
Pin version of black, isort and flake8
Add support for place geometry manager

1.0.1 (2022-11-09)

Fix license badge
Declare babel entry point for translation
Add combobox example
Use private gitlab runner for running test

1.0.0 (2022-04-06)

Initial version of TKVue writting for Minarca project

License

For personal and professional use. You cannot resell or redistribute these repositories in their original state.

Share

• Share on Facebook
• Share on Twitter