MoreCustomTkinterWidgets 5.2.0__tar.gz → 5.4.0__tar.gz

{morecustomtkinterwidgets-5.2.0 → morecustomtkinterwidgets-5.4.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024-2025 Fastattack
+Copyright (c) 2024-2026 Fastattack
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{morecustomtkinterwidgets-5.2.0/src/MoreCustomTkinterWidgets.egg-info → morecustomtkinterwidgets-5.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MoreCustomTkinterWidgets
-Version: 5.2.0
+Version: 5.4.0
 Summary: A package containing more widgets for customtkinter
 Author: Fastattack
 License: MIT License
@@ -17,14 +17,13 @@ Requires-Dist: Pillow>=9.5.0
 Dynamic: license-file
 
 # MoreCustomTkinterWidgets
-By Fastattack, 2024
+By Fastattack, 2024-2026
 
 [![Pypi](https://img.shields.io/pypi/v/MoreCustomTkinterWidgets?label=Pypi)](https://pypi.org/project/MoreCustomTkinterWidgets)
 [![GitHub - Total commits](https://img.shields.io/github/commit-activity/t/fastattackv/MoreCustomTkinterWidgets?label=Total%20GitHub%20commits&color=darkblue)](https://github.com/fastattackv/MoreCustomTkinterWidgets)
 [![GitHub - Last commit](https://img.shields.io/github/last-commit/fastattackv/MoreCustomTkinterWidgets?label=Last%20GitHub%20commit&color=darkblue)](https://github.com/fastattackv/MoreCustomTkinterWidgets)
 [![Pypi - Monthly downloads](https://img.shields.io/pypi/dm/MoreCustomTkinterWidgets)](https://pypi.org/project/MoreCustomTkinterWidgets)
 [![Pypi - Total downloads](https://static.pepy.tech/personalized-badge/MoreCustomTkinterWidgets?period=total&units=international_system&left_color=grey&right_color=green&left_text=Total%20Downloads)](https://pypi.org/project/MoreCustomTkinterWidgets)
-[![Lines number](https://tokei.rs/b1/github/fastattackv/MoreCustomTkinterWidgets?category=lines)](https://github.com/fastattackv/MoreCustomTkinterWidgets/tree/main/Source%20Code)
 
 > [!NOTE]
 > The package is cross-platform, but the Message class will only be able to create sounds if the winsound module is installed (only available on windows)
@@ -39,8 +38,8 @@ To install the package, you should use pip. Install the package with the followi
 
 ## Widgets
 
-[![Examples](https://img.shields.io/badge/Examples_for_all_widgets-red)](Examples.md)
-[![Patch Notes](https://img.shields.io/badge/Patch_Notes-yellow)](Patch%20notes.md)
+[Examples](Examples.md)
+[Patch Notes](Patch%20notes.md)
 
 ### SmoothFrame
 This widget is a normal frame but with one upgrade: animations !

{morecustomtkinterwidgets-5.2.0 → morecustomtkinterwidgets-5.4.0}/README.md

@@ -1,12 +1,11 @@
 # MoreCustomTkinterWidgets
-By Fastattack, 2024
+By Fastattack, 2024-2026
 
 [![Pypi](https://img.shields.io/pypi/v/MoreCustomTkinterWidgets?label=Pypi)](https://pypi.org/project/MoreCustomTkinterWidgets)
 [![GitHub - Total commits](https://img.shields.io/github/commit-activity/t/fastattackv/MoreCustomTkinterWidgets?label=Total%20GitHub%20commits&color=darkblue)](https://github.com/fastattackv/MoreCustomTkinterWidgets)
 [![GitHub - Last commit](https://img.shields.io/github/last-commit/fastattackv/MoreCustomTkinterWidgets?label=Last%20GitHub%20commit&color=darkblue)](https://github.com/fastattackv/MoreCustomTkinterWidgets)
 [![Pypi - Monthly downloads](https://img.shields.io/pypi/dm/MoreCustomTkinterWidgets)](https://pypi.org/project/MoreCustomTkinterWidgets)
 [![Pypi - Total downloads](https://static.pepy.tech/personalized-badge/MoreCustomTkinterWidgets?period=total&units=international_system&left_color=grey&right_color=green&left_text=Total%20Downloads)](https://pypi.org/project/MoreCustomTkinterWidgets)
-[![Lines number](https://tokei.rs/b1/github/fastattackv/MoreCustomTkinterWidgets?category=lines)](https://github.com/fastattackv/MoreCustomTkinterWidgets/tree/main/Source%20Code)
 
 > [!NOTE]
 > The package is cross-platform, but the Message class will only be able to create sounds if the winsound module is installed (only available on windows)
@@ -21,8 +20,8 @@ To install the package, you should use pip. Install the package with the followi
 
 ## Widgets
 
-[![Examples](https://img.shields.io/badge/Examples_for_all_widgets-red)](Examples.md)
-[![Patch Notes](https://img.shields.io/badge/Patch_Notes-yellow)](Patch%20notes.md)
+[Examples](Examples.md)
+[Patch Notes](Patch%20notes.md)
 
 ### SmoothFrame
 This widget is a normal frame but with one upgrade: animations !

{morecustomtkinterwidgets-5.2.0 → morecustomtkinterwidgets-5.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "MoreCustomTkinterWidgets"
-version = "5.2.0"
+version = "5.4.0"
 dependencies = [
     "customtkinter>=5.2.1",
     "Pillow>=9.5.0",

{morecustomtkinterwidgets-5.2.0 → morecustomtkinterwidgets-5.4.0}/src/MoreCustomTkinterWidgets/AnimatedImage.py

@@ -95,11 +95,14 @@ class AnimatedImage(ctk.CTkImage):
         return self._currently_animating
 
     def start_animation(self):
-        """ Starts the animation loop """
-        self._currently_animating = True
-        time_between_2_frames = self._light_image.info["duration"] if self._light_image is not None else self._dark_image.info["duration"]
-        self._time_between_frames = int(time_between_2_frames * self._speed_multiplier)
-        self._next_frame()
+        """ Starts the animation loop. HAS TO BE CALLED AFTER THE IMAGE IS USED """
+        if self._configure_callback_list:
+            self._currently_animating = True
+            time_between_2_frames = self._light_image.info["duration"] if self._light_image is not None else self._dark_image.info["duration"]
+            self._time_between_frames = int(time_between_2_frames * self._speed_multiplier)
+            self._next_frame()
+        else:
+            raise RuntimeError("Tried to start the animation before using the image in a widget")
 
     def stop_animation(self):
         """ Stops the animation loop """
@@ -112,18 +115,21 @@ class AnimatedImage(ctk.CTkImage):
             raise RuntimeError("Tried to stop the animation but it was not already running")
 
     def start_animation_for(self, ms: int, reset_after_complete=False):
-        """Starts the animation and stops automatically after the given time
+        """Starts the animation and stops automatically after the given time. HAS TO BE CALLED AFTER THE IMAGE IS USED
 
         :param ms: time to run the animation for (in ms)
         :param reset_after_complete: if set to True: resets to the first frame of the animation when the animation stops
         """
-        try:
-            self._configure_callback_list[0].__self__.after(ms, self.stop_animation)
-        except AttributeError:
-            pass
+        if self._configure_callback_list:
+            try:
+                self._configure_callback_list[0].__self__.after(ms, self.stop_animation)
+            except AttributeError:
+                pass
+            else:
+                self.start_animation()
+                self.reset_after_complete = reset_after_complete
         else:
-            self.start_animation()
-            self.reset_after_complete = reset_after_complete
+            raise RuntimeError("Tried to start the animation before using the image in a widget")
 
     def set_to_frame(self, frame_index: int):
         """Sets the animation to the given frame

{morecustomtkinterwidgets-5.2.0 → morecustomtkinterwidgets-5.4.0}/src/MoreCustomTkinterWidgets/Selector.py

@@ -1,36 +1,52 @@
 import customtkinter as ctk
+from customtkinter import ThemeManager
 
 
 class Selector(ctk.CTkFrame):
-    def __init__(self, master, items: list[str], multiple_choices=True, *args, **kwargs):
+    def __init__(self, master, names_list: list[str], multiple_choices=True, search_mode: str="fuzzy", *args, **kwargs):
         """Selector widgets to select options in a list of options. Includes a search bar to find different elements faster.
 
         :param master: master window for the widget
-        :param items: list of the possible options, they should all be different
+        :param names_list: list of the possible options, they should all be different
         :param multiple_choices: Optional: if set to False, the user will be allowed to select only one item (default=True)
+        :param search_mode: Optional: if set to "exact": the search will only show the items that start with exactly the given string, if set to "fuzzy": the search will show items that contain the search as a substring (default="fuzzy")
         :param args: args for the CTkFrame widget
         :param kwargs: kwargs for the CTkFrame widget
         """
         super().__init__(master, *args, **kwargs)
 
+        self.grid_rowconfigure(0, weight=0)
+        self.grid_rowconfigure(1, weight=1)
+        self.grid_columnconfigure(0, weight=1)
+        self.grid_columnconfigure(1, weight=0)
+
         self.search_var = ctk.StringVar(self)
         self.search_var.trace_add("write", self._search_modified)
         self.search_bar = ctk.CTkEntry(self, textvariable=self.search_var)
+        self.empty_search_button = ctk.CTkButton(self, width=10, height=10, fg_color="transparent", border_color=ThemeManager.theme["CTkEntry"]["border_color"], border_width=2, text="X", command=self._empty_search)
         color = kwargs.pop("fg_color") if "fg_color" in kwargs else "transparent"
         self.checkboxes_frame = ctk.CTkScrollableFrame(self, fg_color=color, *args, **kwargs)
-        self.search_bar.pack(anchor="n", fill="x")
-        self.checkboxes_frame.pack(expand=True, fill="both", side="bottom")
+        self.search_bar.grid(row=0, column=0, padx=3, pady=3, sticky="nsew")
+        self.empty_search_button.grid(row=0, column=1, padx=3, pady=3, sticky="nsew")
+        self.checkboxes_frame.grid(row=1, column=0, columnspan=2, padx=3, pady=3, sticky="nsew")
 
         self.checkboxes = []
         self.selected_indexes = []
         self.multiple_choices = multiple_choices
 
-        if len(set(items)) == len(items):  # not 2 times the same item
-            for index in range(len(items)):
-                self.checkboxes.append(ctk.CTkCheckBox(self.checkboxes_frame, text=items[index], command=lambda a=index: self._selection(a)))
+        if search_mode == "exact":
+            self.exact_search = True
+        elif search_mode == "fuzzy":
+            self.exact_search = False
+        else:
+            raise ValueError(f"The given search_mode is incorrect: {search_mode}")
+
+        if len(set(names_list)) == len(names_list):  # not 2 times the same item
+            for index in range(len(names_list)):
+                self.checkboxes.append(ctk.CTkCheckBox(self.checkboxes_frame, text=names_list[index], command=lambda a=index: self._selection(a)))
             self._search_modified()
         else:
-            raise ValueError("There is two times or more the same item in the given items list")
+            raise ValueError("There is two times or more the same item in the given names_list")
 
     def _selection(self, index: int):
         """ Internal method: selects / unselects the given index """
@@ -56,42 +72,45 @@ class Selector(ctk.CTkFrame):
         """ Internal method: modifies the search """
         value = self.search_var.get()
         row = 0
-        for x in range(len(self.checkboxes)):
-            if self.checkboxes[x].cget("text").startswith(value):
-                self.checkboxes[x].grid(row=row, column=0, padx=3, pady=3)
+        for i in range(len(self.checkboxes)):
+            text = self.checkboxes[i].cget("text")
+            if (self.exact_search and text.startswith(value)) or (not self.exact_search and value in text.lower()):
+                self.checkboxes[i].grid(row=row, column=0, pady=3, sticky="w")
                 row += 1
             else:
-                self.checkboxes[x].grid_forget()
+                self.checkboxes[i].grid_forget()
         self._reset_scroll()
 
+    def _empty_search(self):
+        """ Internal method: empties the search bar """
+        self.search_var.set("")
+
     def get_all_items(self) -> list:
         """ Returns all the items in the selector """
         return [checkbox.cget("text") for checkbox in self.checkboxes]
 
-    def configure_selector(self, items: list = None, multiple_choices: bool = None):
-        """Changes the given arguments
-
-        :param items: new items to show, if [] is given: deletes all old items
-        :param multiple_choices: if set to False, the user will be allowed to select only one item
-        """
-        if items is not None:
-            if len(set(items)) == len(items):  # not 2 times the same item
+    def configure(self, require_redraw=False, **kwargs):
+        if "names_list" in kwargs:
+            names_list = kwargs.pop("names_list")
+            if len(set(names_list)) == len(names_list):  # not 2 times the same item
                 # destroy old widgets
                 for checkbox in self.checkboxes:
                     checkbox.destroy()
                 self.checkboxes.clear()
                 self.selected_indexes.clear()
-
                 # create new ones
-                for index in range(len(items)):
-                    self.checkboxes.append(ctk.CTkCheckBox(self.checkboxes_frame, text=items[index], command=lambda a=index: self._selection(a)))
+                for index in range(len(names_list)):
+                    self.checkboxes.append(ctk.CTkCheckBox(self.checkboxes_frame, text=names_list[index], command=lambda a=index: self._selection(a)))
                 self._search_modified()
             else:
-                raise ValueError("There is two times or more the same item in the given items list")
+                raise ValueError("There is two times or more the same item in the given names_list")
 
-        if multiple_choices is not None:
+        if "multiple_choices" in kwargs:
+            multiple_choices = kwargs.pop("multiple_choices")
             self.multiple_choices = multiple_choices
 
+        super().configure(require_redraw=require_redraw, **kwargs)
+
     def clear_selections(self):
         """ Clears the selections """
         for index in self.selected_indexes:

{morecustomtkinterwidgets-5.2.0 → morecustomtkinterwidgets-5.4.0}/src/MoreCustomTkinterWidgets/__init__.py

@@ -10,5 +10,5 @@ from .Separator import Separator
 from .DateSelector import Date, DateSelector, DateSelectorButton
 
 
-_version = "5.2.0"
-__version__ = "5.2.0"
+_version = "5.4.0"
+__version__ = "5.4.0"

{morecustomtkinterwidgets-5.2.0 → morecustomtkinterwidgets-5.4.0/src/MoreCustomTkinterWidgets.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MoreCustomTkinterWidgets
-Version: 5.2.0
+Version: 5.4.0
 Summary: A package containing more widgets for customtkinter
 Author: Fastattack
 License: MIT License
@@ -17,14 +17,13 @@ Requires-Dist: Pillow>=9.5.0
 Dynamic: license-file
 
 # MoreCustomTkinterWidgets
-By Fastattack, 2024
+By Fastattack, 2024-2026
 
 [![Pypi](https://img.shields.io/pypi/v/MoreCustomTkinterWidgets?label=Pypi)](https://pypi.org/project/MoreCustomTkinterWidgets)
 [![GitHub - Total commits](https://img.shields.io/github/commit-activity/t/fastattackv/MoreCustomTkinterWidgets?label=Total%20GitHub%20commits&color=darkblue)](https://github.com/fastattackv/MoreCustomTkinterWidgets)
 [![GitHub - Last commit](https://img.shields.io/github/last-commit/fastattackv/MoreCustomTkinterWidgets?label=Last%20GitHub%20commit&color=darkblue)](https://github.com/fastattackv/MoreCustomTkinterWidgets)
 [![Pypi - Monthly downloads](https://img.shields.io/pypi/dm/MoreCustomTkinterWidgets)](https://pypi.org/project/MoreCustomTkinterWidgets)
 [![Pypi - Total downloads](https://static.pepy.tech/personalized-badge/MoreCustomTkinterWidgets?period=total&units=international_system&left_color=grey&right_color=green&left_text=Total%20Downloads)](https://pypi.org/project/MoreCustomTkinterWidgets)
-[![Lines number](https://tokei.rs/b1/github/fastattackv/MoreCustomTkinterWidgets?category=lines)](https://github.com/fastattackv/MoreCustomTkinterWidgets/tree/main/Source%20Code)
 
 > [!NOTE]
 > The package is cross-platform, but the Message class will only be able to create sounds if the winsound module is installed (only available on windows)
@@ -39,8 +38,8 @@ To install the package, you should use pip. Install the package with the followi
 
 ## Widgets
 
-[![Examples](https://img.shields.io/badge/Examples_for_all_widgets-red)](Examples.md)
-[![Patch Notes](https://img.shields.io/badge/Patch_Notes-yellow)](Patch%20notes.md)
+[Examples](Examples.md)
+[Patch Notes](Patch%20notes.md)
 
 ### SmoothFrame
 This widget is a normal frame but with one upgrade: animations !