EasyGUI

Warnings

• gotcha EasyGUI programs often conflict with the IDLE IDE (Python's default editor) because both EasyGUI (via Tkinter) and IDLE use their own event loops, leading to unpredictable behavior or freezing.
  Fix: Always run EasyGUI scripts directly from a terminal or another IDE (e.g., VS Code, PyCharm) rather than from IDLE.
• breaking EasyGUI 0.98.0 introduced a syntax error (`except Exception, e:`) that was incompatible with Python 3.5+ due to changes in exception handling syntax.
  Fix: Upgrade to EasyGUI 0.98.1 or any later version (e.g., `pip install --upgrade easygui`). This issue was resolved in 0.98.1.
• gotcha EasyGUI is NOT event-driven. Its functions are blocking calls; the program execution pauses until the user interacts with and closes the displayed dialog box. This is fundamentally different from traditional GUI frameworks.
  Fix: Design your application flow around sequential, blocking user interactions. If you require complex, responsive, or multi-threaded GUIs, consider a full-fledged event-driven framework like Tkinter, PyQt, or Kivy.
• gotcha The `multenterbox()` function (and similar input boxes) returns user input as a list of strings, even for single fields or intended numeric inputs. Attempting to perform arithmetic directly on these string elements will result in `TypeError`.
  Fix: Always extract values from the returned list and explicitly convert them to the appropriate data type (e.g., `int()`, `float()`) before performing numeric operations. For example: `value = int(multenterbox(...)[0])`.
• gotcha When displaying images in functions like `buttonbox()`, EasyGUI only natively supports GIF (.gif) file format.
  Fix: Ensure that any image files you intend to display with EasyGUI functions are in the GIF format. Convert other formats if necessary.

Install

• pip install easygui Install latest version

Imports

• easygui

  import easygui as eg

  Using an alias (e.g., `eg`) is recommended to keep the namespace clean and minimize typing. `import easygui` is also correct but requires `easygui.func()` calls.
• *
  While functional, 'import *' is generally considered bad Python practice as it pollutes the global namespace with all EasyGUI functions, potentially leading to name clashes.

Quickstart

This quickstart demonstrates basic EasyGUI interactions: displaying a message box, asking a yes/no question, and getting text input from the user. EasyGUI functions are blocking, meaning the program waits for user interaction before proceeding. Remember to run EasyGUI scripts outside of IDLE for best compatibility.

import easygui as eg
import sys

# Display a simple message box
eg.msgbox("Hello from EasyGUI!", "Welcome")

# Ask a yes/no question
if eg.ynbox("Shall I continue?", "Question"): 
    # If user chose Yes, ask for input
    name = eg.enterbox("What is your name?", "Name Input")
    if name:
        eg.msgbox(f"Hello, {name}!", "Greeting")
    else:
        eg.msgbox("You cancelled the name input.", "Cancelled")
else:
    eg.msgbox("You chose to exit.", "Exit")
    sys.exit(0)