TkEasyGUI 0.1.6__tar.gz

tkeasygui-0.1.6/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 kujirahand
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tkeasygui-0.1.6/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.1
+Name: tkeasygui
+Version: 0.1.6
+Summary: Easy and Simple GUI Library
+Author-email: kujirahand <web@kujirahand.com>
+Project-URL: Homepage, https://github.com/kujirahand/tkeasygui-pythont
+Project-URL: Issues, https://github.com/kujirahand/tkeasygui-python/issues
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# TkEasyGUI
+
+`TkEasyGUI` is a Python library that allows for the easy and simple creation of GUI applications.
+In the event model, it is compatible with the well-known GUI library `PySimpleGUI`.
+
+Python's standard UI library `Tkinter`, is often considered to have a high barrier to entry and to be difficult to use. By using this library, you can create GUI applications easily and intuitively.
+
+## Install
+
+Install from pypi
+
+
+```sh
+python -m pip install tkeasygui
+```
+
+Install from GitHub Repository
+
+
+```sh
+python -m pip install git+https://github.com/kujirahand/tkeasygui-python
+```
+
+## How to use
+
+To create a simple window with only labels and buttons, you would write as follows:
+
+```py
+import tkeasygui as eg
+
+# Create window
+layout = [
+    [eg.Text("Hello, World!")],
+    [eg.Button("OK")]
+]
+window = eg.Window("Hello", layout=layout)
+
+# Event loop
+while window.is_alive():
+    # get event
+    event, values = window.read()
+    # check event
+    if event == "OK":
+        eg.popup("Pushed OK Button")
+        break
+window.close()
+```
+
+## Samples
+
+- [samples](https://github.com/kujirahand/tkeasygui-python/tree/main/tests).
+
+## Documents
+
+- [docs](https://github.com/kujirahand/tkeasygui-python/tree/main/docs)
+
+## Regarding the relationship with PySimpleGUI
+
+This was developed with reference to PySimpleGUI, but has been re-implemented from scratch.
+While its usage is similar to PySimpleGUI, it has been expanded with unique features.
+
+## Link
+
+- [pypi.org > TkEasyGUI](https://pypi.org/project/tkeasygui/)
+- [GitHub > TkEasyGUI](https://github.com/kujirahand/tkeasygui-python/)
+

tkeasygui-0.1.6/README.md

@@ -0,0 +1,66 @@
+# TkEasyGUI
+
+`TkEasyGUI` is a Python library that allows for the easy and simple creation of GUI applications.
+In the event model, it is compatible with the well-known GUI library `PySimpleGUI`.
+
+Python's standard UI library `Tkinter`, is often considered to have a high barrier to entry and to be difficult to use. By using this library, you can create GUI applications easily and intuitively.
+
+## Install
+
+Install from pypi
+
+
+```sh
+python -m pip install tkeasygui
+```
+
+Install from GitHub Repository
+
+
+```sh
+python -m pip install git+https://github.com/kujirahand/tkeasygui-python
+```
+
+## How to use
+
+To create a simple window with only labels and buttons, you would write as follows:
+
+```py
+import tkeasygui as eg
+
+# Create window
+layout = [
+    [eg.Text("Hello, World!")],
+    [eg.Button("OK")]
+]
+window = eg.Window("Hello", layout=layout)
+
+# Event loop
+while window.is_alive():
+    # get event
+    event, values = window.read()
+    # check event
+    if event == "OK":
+        eg.popup("Pushed OK Button")
+        break
+window.close()
+```
+
+## Samples
+
+- [samples](https://github.com/kujirahand/tkeasygui-python/tree/main/tests).
+
+## Documents
+
+- [docs](https://github.com/kujirahand/tkeasygui-python/tree/main/docs)
+
+## Regarding the relationship with PySimpleGUI
+
+This was developed with reference to PySimpleGUI, but has been re-implemented from scratch.
+While its usage is similar to PySimpleGUI, it has been expanded with unique features.
+
+## Link
+
+- [pypi.org > TkEasyGUI](https://pypi.org/project/tkeasygui/)
+- [GitHub > TkEasyGUI](https://github.com/kujirahand/tkeasygui-python/)
+

tkeasygui-0.1.6/pyproject.toml

@@ -0,0 +1,38 @@
+[project]
+name = "tkeasygui"
+version = "0.1.6"
+authors = [
+  { name="kujirahand", email="web@kujirahand.com" },
+]
+description = "Easy and Simple GUI Library"
+readme = "README.md"
+requires-python = ">=3.8"
+classifiers = [
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development :: User Interfaces",
+]
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project.urls]
+Homepage = "https://github.com/kujirahand/tkeasygui-pythont"
+Issues = "https://github.com/kujirahand/tkeasygui-python/issues"
+
+[tool.poetry.dependencies]
+python = "^3.8"
+tkinter = "*"
+Pillow = "*"
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]
+ignore = ["E501"]

tkeasygui-0.1.6/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tkeasygui-0.1.6/tkeasygui/__init__.py

@@ -0,0 +1,9 @@
+"""
+TkEasyGUI - A simple GUI library for Python using tkinter.
+"""
+
+from tkeasygui.dialogs import *  # noqa: F403
+from tkeasygui.widgets import *  # noqa: F403
+
+__version__ = "0.1.6"
+

tkeasygui-0.1.6/tkeasygui/dialogs.py

@@ -0,0 +1,167 @@
+"""
+TkEasyGUI dialogs
+"""
+import tkinter.filedialog as filedialog
+import tkinter.messagebox as messagebox
+import tkinter.simpledialog as simpledialog
+from tkinter import colorchooser
+
+import tkeasygui as eg
+
+
+#------------------------------------------------------------------------------
+# Dialogs
+#------------------------------------------------------------------------------
+# like PySimpleGUI
+def popup(message: str, title: str = "") -> None:
+    """
+    Display a message in a popup window.
+    
+    #### Example:
+    ```py
+    eg.popup("I like an apple.", "Information")
+    ```
+    """
+    # messagebox.showinfo(title, message)
+    win = eg.Window(title, layout=[[eg.Text(message)], [eg.Button("OK")]], modal=True)
+    while win.is_alive():
+        event, _ = win.read()
+        if event in (None, "OK"):
+            break
+    win.close()
+
+def popup_ok(message: str, title: str="") -> None:
+    """Display a message in a popup window.(Alias popup)"""
+    popup(title, message)
+
+def popup_buttons(message: str, title: str = "Question", buttons: list[str] = ["OK", "Cancel"]) -> str:
+    """
+    Popup window with user defined buttons. Return button's label.
+
+    #### Example:
+    ```py
+    color = eg.popup_buttons(
+        "Which color do you like?", 
+        "Question",
+        buttons=["red","yellow","green"])
+    print(color)
+    ```
+    """
+    result = buttons[-1]
+    # create window
+    win = eg.Window(title, layout=[
+        [eg.Text(message)],
+        [eg.Button(s, width=9) for s in buttons],
+    ], modal=True)
+    # event loop
+    while win.is_alive():
+        event, _ = win.read()
+        if event in buttons:
+            result = event
+            break
+    win.close()
+    return result
+
+def popup_yes_no(message: str, title: str = "Question", yes_label: str="Yes", no_label: str="No") -> str:
+    """
+    Display a message in a popup window with Yes and No buttons. Return "Yes" or "No".
+
+    #### Example:
+    Ask user question, [Yes] or [No]
+    ```py
+    a = eg.popup_yes_no("Do you like Sushi?", "Question")
+    print(a) # "Yes" or "No"
+    ```
+    Ask user question in Japanes [はい] or [いいえ]
+    ```py
+    ja_a = eg.popup_yes_no("寿司は好き?", "質問", yes_label="はい", no_label="いいえ")
+    print(ja_a) # "はい" or "いいえ"
+    ```
+    """
+    # return "Yes" if messagebox.askyesno(title, message) else "No"
+    return popup_buttons(message, title, buttons=[yes_label, no_label])
+
+def popup_yes_no_cancel(message: str, title: str = "Question") -> str:
+    """Display a message in a popup window with Yes and No buttons. Return "Yes" or "No" or "Cancel"."""
+    return popup_buttons(message, title, buttons=["Yes", "No", "Cancel"])
+
+def popup_get_text(message: str, title: str = "", default: str = "") -> (str|None):
+    """Display a message in a popup window with a text entry. Return the text entered."""
+    return simpledialog.askstring(title, message, initialvalue=default)
+
+def popup_input(message: str, title: str = "", default: str = "") -> (str|None):
+    """Display a message in a popup window with a text entry. Return the text entered."""
+    result = None
+    win = eg.Window(title, layout=[
+        [eg.Text(message)],
+        [eg.Input(default, key="-user-", width=40)],
+        [eg.Button("OK", width=9), eg.Button("Cancel", width=9)]
+    ], modal=True)
+    while win.is_alive():
+        event, values = win.read()
+        if event == "OK":
+            result = values["-user-"]
+            break
+        if event == "Cancel":
+            break
+    win.close()
+    return result
+
+def popup_error(message: str, title: str="Error") -> None:
+    """Display a message in a popup window with an error icon."""
+    messagebox.showerror(title, message, icon="error")
+
+def popup_get_file(title: str="", initial_folder: str="", save_as: bool=False, multiple_files: bool=False, file_types: tuple[tuple[str, str]]=(("All Files", "*.*"),), **kw) -> (str|tuple[str]|None):
+    """Popup a file selection dialog. Return the file selected."""
+    if save_as:
+        result = filedialog.asksaveasfilename(
+            title=title,
+            initialdir=initial_folder,
+            filetypes=file_types,
+            **kw)
+    else:
+        result = filedialog.askopenfilename(
+            title=title, 
+            initialdir=initial_folder,
+            filetypes=file_types,
+            multiple=multiple_files, # type: ignore
+            **kw)
+    return result
+
+def popup_get_folder(title: str="", default_path: str="", **kw) -> (str|None):
+    """Popup a folder selection dialog. Return the folder selected."""
+    return filedialog.askdirectory(title=title, initialdir=default_path, **kw)
+
+def popup_color(title: str="", default_color: str|None=None) -> (str|None):
+    """Popup a color selection dialog. Return the color selected."""
+    col = colorchooser.askcolor(title=title, color=default_color)
+    if col[1] is None:
+        return default_color
+    return col[1]
+
+#------------------------------------------------------------------------------
+# TKinter
+def ask_yes_no(message: str, title: str="Question") -> bool:
+    """Display a message in a popup window with Yes and No buttons. Return True or False. (use Tkinter)"""
+    return messagebox.askyesno(title, message)
+
+def ask_ok_cancel(message: str, title: str="Question") -> bool:
+    """Display a message in a popup window with OK and Cancel buttons. Return True or False. (use Tkinter)"""
+    return messagebox.askokcancel(title, message)
+
+def ask_retry_cancel(message: str, title: str="Question") -> bool:
+    """Display a message in a popup window with Retry and Cancel buttons. Return True or False. (use Tkinter)"""
+    return messagebox.askretrycancel(title, message)
+
+def show_message(message: str, title: str="Information") -> None:
+    """show message in a popup window"""
+    messagebox.showinfo(title, message)
+
+def show_info(message: str, title: str="Information") -> None:
+    """show message in a popup window"""
+    messagebox.showinfo(title, message)
+
+def msgbox(message: str, title: str="Message") -> None:
+    """show message in a popup window like VB"""
+    messagebox.showinfo(title, message)
+