aesonus/tklife

Make TKinter life easier

tklife's Issues

Command Kwarg Late Binding

For widgets that have a 'command' kwarg, a simple Event enumeration member can be passed in and the widgets method will create the command from the enumeration member such that the created widget will be the source of the event.

Create a testing framework to assist with unit testing

Add grid_config property to SkeletonMixin classes

The SkeletonMixin class should configure its grid using settings returned by SkeletonMixin.grid_config property method. IE:

class Frame(SkeletonMixin, Frame):
    # ...
    @property
    def grid_config(self) -> tuple[Iterable[dict[str, Any]], Iterable[dict[str, Any]]]:
        return (
            [{"weight": 1}, {"weight": 1}],  # Columns 0 and 1 has a weight of 1
            [{}, {}, {"weight": 1}],  # Row 2 has a weight of 1
        )

Add a configure method to `SkelWidget` class to allow for post-creation widget config

Some custom widgets do not allow for certain options to be specified in the constructor, so this method is intended to allow the configuration of the widget after it has been instantiated.

Use protected methods for each stage of SkeletonMixin initialization.

SkeletonMixin._create_all is handling creating widgets as well as configuring the grid. This should be separated out.

Affected code:

    def _create_all(self):
        """Creates all the widgets in template."""
        global_grid_args = self.__global_gridargs
        for row_index, row in enumerate(self.template):
            for col_index, skel_widget in enumerate(row):
                w = self.__widget_create(skel_widget, row_index, col_index)
                if w is None:
                    continue
                self._grid_widget(
                    row_index, col_index, w, **global_grid_args, **skel_widget.grid_args
                )
        cols, rows = self.grid_config
        for index, col in enumerate(cols):
            if col:
                self.columnconfigure(index, **col)
        for index, row in enumerate(rows):
            if row:
                self.rowconfigure(index, **row)

Bug when extracting command that isn't a late event binding in widgets() method

Event unbind should raise Exception when funcid is not found.

Add a check for when an event funcid is not found, a key error is emitted.

Widget Initialize Exception Message

The exception message when skeleton initialization fails does not mention where the template definition is. It would be very helpful to know which skeleton is actually raising the exception.

Variable Containers

In the skeleton configuration of tkinter frames or frame-like widgets the variables will be done in a configuration style like the rest of the widgets and layout. This will require a special deferred creation object that will reference the actual tk variable upon widget creation.

Events Enumeration

A special Enum type will be used for generating and binding events to a widget

Binding Event methods

• bind method
• bind_all method
• bind_class method

Generating event methods

• generate

ModalDialog master always set to root

The master for the ModalDialog class needs to be set to the specified master in the constructor.

Prevent images from being garbage collected

https://stackoverflow.com/questions/53682612/tkinter-gui-label-image-not-showing-but-is-still-there-kinda?rq=3

The init and configure method of SkelWidget should use a private instance variable to store the given Image object so python does not garbage collect it.

Add documentation with Sphinx

• Normalize doc strings to comply with google formatting