PyGUIBuilder - README

Overview

Welcome to the PyGUIBuilder, designed to help you create GUI applications with ease. Whether you are building a simple tool or a complex application, our library provides everything you need.

Table of Contents

1. Installation
2. Getting Started
3. Features
4. Usage
   • Creating a Window
   • Adding Widgets
   • Other Functions
5. Examples
6. License
7. Thanks

Installation

To install the PyGUIBuilder, use pip:

pip install PyGUIBuilder

Getting Started

Creating your first GUI application is simple. Here’s a quick example to get you started:

import PyGUIBuilder

# Create the main application window
app = PyGUIBuilder.createWindow("My First App", "icon.ico", 400, 400)

# Create a label widget
label = PyGUIBuilder.createLabel(app, "Hello, World!", 1, 0)

# Run the application
PyGUIBuilder.run()

Features

• Works on Windows
• Ease of use: The library provides a simple and intuitive interface for creating GUI elements.
• Widgets: Buttons, labels, text entries, buttons, radio buttons and many others.
• Grid placement: placing widgets in rows and columns.
• Alerts and Warnings: Simple dialog boxes for messages and warnings.

Usage

Creating a Window

To create a main application window, use the CreateWindow function:

import PyGUIBuilder

window = PyGUIBuilder.createWindow("My App", "icon.ico", 400, 400)

Adding Widgets

Widgets are the building blocks of a GUI application. You can add various widgets to your window.

Here's an example of adding a label:

label = PyGUIBuilder.createLabel(window, "Hello, World!", 1, 0)

Here's an example of adding a entrybox:

entry = PyGUIBuilder.createEntry(window, "text", 3, 0)

Here's an example of adding a button:

def callback():
   print("Button clicked!")

button = PyGUIBuilder.createButton(window, "Click Me!", callback, 2, 0)

Here's an example of adding a combobox:

langs = ["1", "2", "3", "4"]
combobox = PyGUIBuilder.createComboBox(window, langs, 1, 0)

Here's an example of messagebox:

PyGUIBuilder.showMessageBox("showinfo", "Information", "This is an info message.")
PyGUIBuilder.showMessageBox("showwarning", "Warning", "This is a warning message.")
PyGUIBuilder.showMessageBox("showerror", "Error", "This is an error message.")
PyGUIBuilder.showMessageBox("askquestion", "Question", "Are you sure?")
PyGUIBuilder.showMessageBox("askokcancel", "OK Cancel", "Do you want to continue?")
PyGUIBuilder.showMessageBox("askyesno", "Yes No", "Do you agree?")
PyGUIBuilder.showMessageBox("askretrycancel", "Retry Cancel", "Do you want to retry?")

Here's an example of adding a Checkbox:

PyGUIBuilder.createCheckbox(window, "text", 1, 0)

Here's an example of adding a RadioButton:

PyGUIBuilder.createRadioButton(window, "text", 1, 0)

Other Functions:

Clearing text in an entry box:

PyGUIBuilder.clearText(entry)

Setting text in an entry box:

PyGUIBuilder.setText(entry, "text")

Getting text from an entry box:

PyGUIBuilder.getText(entry)

Destroying an element:

PyGUIBuilder.destroyElement(label)

Getting selection on Combobox:

print(PyGUIBuilder.getComboBoxSelection(combobox))

Getting Checkbox state:

PyGUIBuilder.getCheckbox()

Getting RadioButton state:

PyGUIBuilder.getRadioButton()

Running the application:

PyGUIBuilder.run()

Examples

Simple Form

import PyGUIBuilder

def on_submit():
    r = PyGUIBuilder.getCheckbox(Robot)
    if r == 1:
        check = "Not a robot"
    else:
        check = "Robot"
    print(f"First Name: {PyGUIBuilder.getText(e_firstname)}, Last Name: {PyGUIBuilder.getText(e_lastname)}, Age: {PyGUIBuilder.getText(e_age)}, EMAIL: {PyGUIBuilder.getText(e_email)}, Phone number: {PyGUIBuilder.getText(e_phone_number)}, Password: {PyGUIBuilder.getText(e_password)}, {check}")

app = PyGUIBuilder.createWindow("Simple Form", "icon.ico", 400, 400)

l_firstname = PyGUIBuilder.createLabel(app, "First Name:", 1, 0)
e_firstname = PyGUIBuilder.createEntry(app, "", 1, 1)

l_lastname = PyGUIBuilder.createLabel(app, "Last Name:", 2, 0)
e_lastname = PyGUIBuilder.createEntry(app, "", 2, 1)

l_age = PyGUIBuilder.createLabel(app, "Age:", 3, 0)
e_age = PyGUIBuilder.createEntry(app, "", 3, 1)

l_email = PyGUIBuilder.createLabel(app, "EMAIL:", 4, 0)
e_email = PyGUIBuilder.createEntry(app, "", 4, 1)

l_phone_number = PyGUIBuilder.createLabel(app, "Phone number:", 5, 0)
e_phone_number = PyGUIBuilder.createEntry(app, "", 5, 1)

l_password = PyGUIBuilder.createLabel(app, "Password:", 6, 0)
e_password = PyGUIBuilder.createEntry(app, "", 6, 1)

Robot = PyGUIBuilder.createCheckbox(app, "I am not a robot", 8, 0)

submit_button = PyGUIBuilder.createButton(app, "Submit", on_submit, 9, 0)

PyGUIBuilder.run()

License

This project is licensed under the MIT License. See LICENSE for details.

Thanks

Thank you for using the PyGUIBuilder! We hope it helps you build amazing applications. If you have questions or need additional help, feel free to contact panovartem690@gmail.com.

---

Please keep in mind that there may be bugs and flaws.