MoreCustomTkinterWidgets 3.0.0__tar.gz → 4.0.0__tar.gz

{morecustomtkinterwidgets-3.0.0/src/MoreCustomTkinterWidgets.egg-info → morecustomtkinterwidgets-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: MoreCustomTkinterWidgets
-Version: 3.0.0
+Version: 4.0.0
 Summary: A package containing more widgets for customtkinter
 Author: Fastattack
 License: MIT License
@@ -57,6 +57,14 @@ It also comes with a class to ask for a file in a TopLevel (FileDialog).
 
 The FileDialog class comes with prebuilt functions to ask for files more easily: askdir, askfile
 
+### AnimatedImage
+This class is used like `CTkImage` but allows to run an animation if an image sequence (FLI/FLC, GIF) was given.
+
+You can start the animation, and it will run until you call the method to stop it, or you can run it for a given time.
+
+### Separator
+This widget is used just like the separator in classic tkinter: it allows to separate other widgets more clearly (draws a line to separate widgets).
+
 ### BetterCTkImage
 This class is used like CTkImage, but you can round the images corners !
 

{morecustomtkinterwidgets-3.0.0 → morecustomtkinterwidgets-4.0.0}/README.md

@@ -40,6 +40,14 @@ It also comes with a class to ask for a file in a TopLevel (FileDialog).
 
 The FileDialog class comes with prebuilt functions to ask for files more easily: askdir, askfile
 
+### AnimatedImage
+This class is used like `CTkImage` but allows to run an animation if an image sequence (FLI/FLC, GIF) was given.
+
+You can start the animation, and it will run until you call the method to stop it, or you can run it for a given time.
+
+### Separator
+This widget is used just like the separator in classic tkinter: it allows to separate other widgets more clearly (draws a line to separate widgets).
+
 ### BetterCTkImage
 This class is used like CTkImage, but you can round the images corners !
 

{morecustomtkinterwidgets-3.0.0 → morecustomtkinterwidgets-4.0.0}/pyproject.toml

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

{morecustomtkinterwidgets-3.0.0 → morecustomtkinterwidgets-4.0.0}/src/MoreCustomTkinterWidgets/AnimatedImage.py

@@ -136,16 +136,3 @@ class AnimatedImage(ctk.CTkImage):
             self._dark_image.seek(frame_index)
         for callback in self._configure_callback_list:
             callback()
-
-
-win = ctk.CTk()
-win.title("MoreCustomTkinterWidgets examples !")
-win.geometry("400x300")
-
-image = AnimatedImage(r"C:\Users\fastattack\Desktop\loading.gif", size=(100, 100))
-label = ctk.CTkLabel(win, text="", image=image)
-label.pack()
-
-image.start_animation()
-
-win.mainloop()

morecustomtkinterwidgets-4.0.0/src/MoreCustomTkinterWidgets/Separator.py

@@ -0,0 +1,174 @@
+import customtkinter as ctk
+from typing import Literal, Union, Tuple, Optional
+
+
+class Separator(ctk.CTkBaseClass):
+    """
+    Separator widget to mark a separation between 2 other widgets.
+    Using Separator.pack(expand=True, fill="both") or Separator.grid(sticky="nswe") doesn't work for now: you have to enter the size of the separator manually.
+    """
+
+    def __init__(self,
+                 master: any,
+                 length: int = 100,
+                 width: float = 4,
+                 corner_radius: Optional[int] = None,
+                 bg_color: Union[str, Tuple[str, str]] = "transparent",
+                 fg_color: Optional[Union[str, Tuple[str, str]]] = None,
+                 orientation: Literal["vertical", "horizontal"] = "vertical"
+                 ):
+
+        if orientation == "vertical":
+            height = length
+        elif orientation == "horizontal":
+            height = width
+            width = length
+        else:
+            raise ValueError(f"The value for orientation is incorrect: \"{orientation}\". Should be \"vertical\" or \"horizontal\"")
+
+        super().__init__(master=master, width=width, height=height, bg_color=bg_color)
+
+        self._corner_radius = 6 if corner_radius is None else corner_radius
+        self._fg_color = ctk.ThemeManager.theme["CTkFrame"]["border_color"] if fg_color is None else self._check_color_type(fg_color)
+        self._orientation = orientation
+
+        self._canvas = ctk.CTkCanvas(self, highlightthickness=0)
+        self._canvas.grid(row=0, column=0, sticky="e")
+        self._canvas.configure(bg=self._apply_appearance_mode(self._detect_color_of_master()), width=self._apply_widget_scaling(width), height=self._apply_widget_scaling(height))
+        self._draw_engine = ctk.DrawEngine(self._canvas)
+
+        self._draw()
+
+    def _set_scaling(self, *args, **kwargs):
+        super()._set_scaling(*args, **kwargs)
+
+        self._canvas.configure(width=self._apply_widget_scaling(self._desired_width),
+                               height=self._apply_widget_scaling(self._desired_height))
+        self._draw()
+
+    def _set_dimensions(self, width=None, height=None):
+        super()._set_dimensions(width, height)
+
+        self._canvas.configure(width=self._apply_widget_scaling(self._desired_width),
+                               height=self._apply_widget_scaling(self._desired_height))
+        self._draw()
+
+    def _draw(self, no_color_updates=False):
+        super()._draw(no_color_updates)
+
+        requires_recoloring = self._draw_engine.draw_rounded_rect_with_border(self._apply_widget_scaling(self._current_width),
+                                                                              self._apply_widget_scaling(self._current_height),
+                                                                              self._apply_widget_scaling(self._corner_radius),
+                                                                              0,
+                                                                              )
+
+        if no_color_updates is False or requires_recoloring:
+            self._canvas.itemconfig("inner_parts",
+                                    outline=self._apply_appearance_mode(self._fg_color),
+                                    fill=self._apply_appearance_mode(self._fg_color))
+
+    def configure(self, require_redraw=False, **kwargs):
+        """ Reconfigures the given arguments (length, width, corner_radius, bg_color, fg_color) """
+        if "height" in kwargs:
+            raise ValueError("Cannot modify directly the height of the widget. Use the length and width arguments instead.")
+
+        if "length" in kwargs or "width" in kwargs:
+            width, height = None, None
+
+            if "length" in kwargs:
+                if self._orientation == "vertical":
+                    height = kwargs.pop("length")
+                else:  # horizontal
+                    width = kwargs.pop("length")
+            if "width" in kwargs:
+                if self._orientation == "vertical":
+                    width = kwargs.pop("width")
+                else:  # horizontal
+                    height = kwargs.pop("width")
+
+            if width is not None:
+                kwargs["width"] = width
+            if height is not None:
+                kwargs["height"] = height
+
+        if "corner_radius" in kwargs:
+            corner_radius = kwargs.pop("corner_radius")
+            if type(corner_radius) is int:
+                self._corner_radius = corner_radius
+                require_redraw = True
+            elif corner_radius is None:
+                self._corner_radius = 1000
+                require_redraw = True
+            else:
+                raise ValueError(f"corner_radius should be int or NoneType, not {type(corner_radius)}")
+
+        if "fg_color" in kwargs:
+            fg_color = kwargs.pop("fg_color")
+            if isinstance(fg_color, (str, Tuple[str, str])):
+                self._fg_color = self._check_color_type(fg_color)
+                require_redraw = True
+            elif fg_color is None:
+                self._fg_color = ctk.ThemeManager.theme["CTkFrame"]["border_color"]
+                require_redraw = True
+            else:
+                raise ValueError(f"fg_color should be str, Tuple[str, str] or NoneType, not {type(fg_color)}")
+
+        super().configure(require_redraw=require_redraw, **kwargs)
+
+    def cget(self, attribute_name: str):
+        """ Returns the value of the given argument (length, width, corner_radius, fg_color, orientation, bg_color) """
+        if attribute_name == "height":
+            raise ValueError("Cannot directly get height of the widget. Use the length and width arguments instead.")
+
+        elif attribute_name == "length":
+            if self._orientation == "vertical":
+                return self._desired_height
+            else:
+                return self._desired_width
+
+        elif attribute_name == "width":
+            if self._orientation == "vertical":
+                return self._desired_width
+            else:
+                return self._desired_height
+
+        elif attribute_name == "corner_radius":
+            return self._corner_radius
+
+        elif attribute_name == "fg_color":
+            return self._fg_color
+
+        elif attribute_name == "orientation":
+            return self._orientation
+
+        else:
+            return super().cget(attribute_name)
+
+    def bind(self, sequence=None, command=None, add=True):
+        """ called on the tkinter.Canvas """
+        if not (add == "+" or add is True):
+            raise ValueError("'add' argument can only be '+' or True to preserve internal callbacks")
+        self._canvas.bind(sequence, command, add=True)
+
+    def unbind(self, sequence=None, funcid=None):
+        """ called on the tkinter.Canvas """
+        if funcid is not None:
+            raise ValueError("'funcid' argument can only be None, because there is a bug in" +
+                             " tkinter and its not clear whether the internal callbacks will be unbinded or not")
+        self._canvas.unbind(sequence, None)
+
+
+win = ctk.CTk()
+win.title("MoreCustomTkinterWidgets examples !")
+win.geometry("400x300")
+
+b1 = ctk.CTkButton(win, text="First button")
+b1.grid(row=0, column=0)
+
+sep = Separator(win, length=150, orientation="vertical")
+sep.grid(row=0, column=1, padx=5)
+
+b2 = ctk.CTkButton(win, text="Second Button")
+b2.grid(row=0, column=2)
+
+win.mainloop()

{morecustomtkinterwidgets-3.0.0 → morecustomtkinterwidgets-4.0.0}/src/MoreCustomTkinterWidgets/__init__.py

@@ -6,6 +6,7 @@ from .Selector import Selector
 from .SmoothFrame import SmoothFrame, get_coordinates_from_grid
 from .BetterCTkImage import BetterCTkImage
 from .AnimatedImage import AnimatedImage
+from .Separator import Separator
 
 
-_version = "3.0.0"
+_version = "4.0.0"

{morecustomtkinterwidgets-3.0.0 → morecustomtkinterwidgets-4.0.0/src/MoreCustomTkinterWidgets.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: MoreCustomTkinterWidgets
-Version: 3.0.0
+Version: 4.0.0
 Summary: A package containing more widgets for customtkinter
 Author: Fastattack
 License: MIT License
@@ -57,6 +57,14 @@ It also comes with a class to ask for a file in a TopLevel (FileDialog).
 
 The FileDialog class comes with prebuilt functions to ask for files more easily: askdir, askfile
 
+### AnimatedImage
+This class is used like `CTkImage` but allows to run an animation if an image sequence (FLI/FLC, GIF) was given.
+
+You can start the animation, and it will run until you call the method to stop it, or you can run it for a given time.
+
+### Separator
+This widget is used just like the separator in classic tkinter: it allows to separate other widgets more clearly (draws a line to separate widgets).
+
 ### BetterCTkImage
 This class is used like CTkImage, but you can round the images corners !
 

{morecustomtkinterwidgets-3.0.0 → morecustomtkinterwidgets-4.0.0}/src/MoreCustomTkinterWidgets.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ src/MoreCustomTkinterWidgets/BetterCTkImage.py
 src/MoreCustomTkinterWidgets/FileExplorer.py
 src/MoreCustomTkinterWidgets/Message.py
 src/MoreCustomTkinterWidgets/Selector.py
+src/MoreCustomTkinterWidgets/Separator.py
 src/MoreCustomTkinterWidgets/SmoothFrame.py
 src/MoreCustomTkinterWidgets/__init__.py
 src/MoreCustomTkinterWidgets.egg-info/PKG-INFO