pgex

A Python PyGame package extension.

Desription

Pgex is a package that will help you to create games with PyGame easier and more convenient. There is no longer any need to register the functionality of text fields, buttons and other widgets each time. Everything has already been done for you!

Installation

Package is uploaded on PyPI and can be downloaded through

pip install pgex

Links

Link on PyPI: https://pypi.org/project/pgex/
GitHub Repository: https://github.com/IvanFoke/pgex

Usage

1. Text creation
Before you start creating any project on PyGame, you must initialize it. Use standard commands like screen creation and title setting.
All widgets in pgex are stored in pgex.widgets. For example, let's import Text widget. Pgex also describes a large number of different colors. They can be found in pgex.parameters.

import pygame as pg
from pgex.widgets import Text
from pgex.parameters import colors

pg.init()
screen = pg.display.set_mode((800, 600))
pg.display.set_caption("Pgex Example")
clock = pg.time.Clock()

txt = Text("SomeText", r'Crushez.ttf', 100, font_color=colors["dark_gray"], bg_color=colors["white"], border_width=1)

game = True
while game:
    for event in pg.event.get():
        if event.type == pg.QUIT:
            game = False
            break
    screen.fill(colors["light_blue"])
    txt.draw(screen, (100, 300))
    pg.display.update()
    clock.tick(30)

As you can see in the example, text widget is created with Text class. First 3 arguments are the text, the path to a font and the font size. Result of the work of this program:

2. A Button that gets a value of an Entry field
Button and Entry are another widgets from pgex. They also can be imported from pgex.widgets.
A distinctive feature of the Button is the passing of a function into it through the action argument, which will be called when the user clicks on it.
The Entry requires the passing of PyGame events. This allows widget to intercept the data entered in the field. Field supports backspace key. To stop entering the text in field, you can press escape, enter, or simply click the left mouse button outside the field.

from pgex.widgets import Button
from pgex.widgets import Entry


def get_entry_value():
    global entry
    print(f"Got text: {entry.text}")


entry = Entry(200, 50, r'Crushez.ttf', 20, centralized=True)
btn = Button(200, 100, "Btn", r'Crushez.ttf', 40, r'button.wav', action=get_entry_value, centralized=True)

def handle_events(events):
    for event in events:
        if event.type == pg.QUIT:
            return False
    return True

# ... in game cycle
while True:
    # ...
    events = pg.event.get()
    if not handle_events(events):
        break
    btn.draw(screen, (500, 100))
    entry.draw(screen, (100, 200), events)      

Result:

Full example can be seen in examples folder.
All other possibilities will be described soon.