FlashGui 0.1.6

FlashGui è una libreria Python che ti offre calcolatrice, blocco note, paint, orologio, calendario, ricerca file già funzionanti con una riga di codice, più un componente WINDOW ad alto livello per costruire qualsiasi interfaccia usando coordinate proporzionali (0.0 → 1.0) e font che si ridimensionano automaticamente. Ogni modulo supporta temi light e dark, personalizzazione completa via Edit(), logica iniettabile via Logic() e un set di API comuni (timer, clipboard, HTTP asincrono).

Installazione

Novità in 0.1.6

Parametri del costruttore (tutti i moduli)

Tutti i moduli ad eccezione di WINDOW condividono gli stessi parametri di inizializzazione:

WINDOW usa invece size=(800,600) in pixel assoluti e min_size/max_size come pixel o float 0→1.

from FlashGui import CALCULATOR

calc = CALCULATOR(
    title="Calculator",
    size=(3, 2),
    color=(240, 240, 240),
    icon=None,
    maximized=False,
    min_size=(5, 4),
    max_size=(1, 1),
    style="light"  # oppure "dark"
)
calc.run()

Metodo Logic()

Permette di iniettare callback personalizzati per ogni pulsante. Se un callback è None il pulsante usa il comportamento default (calcolo, cancella, backspace).

Metodo Edit()

Personalizza colori, testi e stile di tutti i pulsanti e del display.

Metodi di testo AGGIORNATO

📘 Esempio

from FlashGui import CALCULATOR

calc = CALCULATOR(title="Calcolatrice personalizzata", style="dark")
calc.Edit(button_eq_bg=(0,200,100), button_eq_fg=(0,0,0), message_error="Errore!")

def on_equal():
    result = calc.Evaluate()
    calc.CopyToClipboard(result)  # copia il risultato negli appunti

calc.Logic(button_eq_command=on_equal)
calc.run()

from FlashGui import NOTEPAD

nota = NOTEPAD(title="Mio Blocco Note", size=(2,2), style="dark")
nota.run()

Metodo Logic()

Metodo Edit() — principali parametri

Metodi testo AGGIORNATO

📘 Esempio

from FlashGui import NOTEPAD

nota = NOTEPAD(title="Editor Markdown", size=(2,2), style="dark")
nota.Edit(
    file_menu_text="File", edit_menu_text="Modifica", help_menu_text="Aiuto",
    text_ctrl_bg=(25,25,25), text_ctrl_fg=(200,255,200),
    statusbar_bg=(20,20,20), statusbar_fg=(150,150,150),
    untitled_text="nuovo file"
)
nota.SetFont(size=14, family="default")
nota.AppendText("# Benvenuto!\n")
nota.run()

from FlashGui import PAINT

paint = PAINT(title="Mio Paint", size=(2,2), style="light")
paint.run()

Metodo Logic()

Metodo Edit() — principali parametri

Metodi canvas AGGIORNATO

📘 Esempio

from FlashGui import PAINT

paint = PAINT(title="Disegna", style="dark")
paint.Logic(current_tool="brush", color_picker_start_color=(255,100,100), slider_start_value=8)
paint.Edit(canvas_bg=(30,30,30), width_text="Spessore", title_save_image="Salva immagine")

def on_save(event):
    paint.GetSnapshot("output.png")

paint.Logic(save_button_command=on_save)
paint.run()

from FlashGui import CLOCK

clock = CLOCK(title="Orologio", size=(2,2), style="dark")
clock.run()

Metodo Logic()

Metodo Edit() — principali parametri

Metodi di navigazione & getter AGGIORNATO

📘 Esempio

from FlashGui import CLOCK

clock = CLOCK(title="⏱ Orologio", style="dark")
clock.Edit(
    nav_clock_text="ORA",
    nav_timer_text="TIMER",
    nav_stopwatch_text="CRONO",
    timer_btn_start_text="Avvia", timer_btn_pause_text="Pausa", timer_btn_reset_text="Reset"
)
clock.Logic(timer_base_m=5)  # timer parte da 5 minuti
clock.run()

from FlashGui import CALENDAR

cal = CALENDAR(title="Calendario", size=(2,2), style="light")
cal.run()

Metodo Logic()

Metodo Edit() — principali parametri

Metodi helper AGGIORNATO

📘 Esempio

from FlashGui import CALENDAR
from datetime import date

cal = CALENDAR(title="Agenda", style="dark")
cal.Edit(
    january_text="Gennaio", february_text="Febbraio",
    monday_text="Lun", tuesday_text="Mar",
    wednesday_text="Mer", thursday_text="Gio",
    friday_text="Ven", saturday_text="Sab", sunday_text="Dom",
    today_text="OGGI", week_start_monday=True
)

def giorno_cliccato(d):
    cal.set_info_text(f"Selezionato: {d.strftime('%d/%m/%Y')}")

cal.Logic(day_command=giorno_cliccato)
cal.run()

from FlashGui import SEARCHER

searcher = SEARCHER(title="Ricerca File", size=(3,2), style="light")
searcher.run()

Funzionamento di default

Cliccando Search viene avviato un thread in background che scansiona la directory indicata (o tutte le unità disco su Windows se vuota). I risultati appaiono in una ListCtrl con colonne Name, Type, Folder, Size, Modified. Il pulsante Stop interrompe la ricerca in modo sicuro. Clear svuota i risultati. Browse apre un dialog per scegliere la directory.

Metodo Logic()

Metodo Edit()

Metodi di controllo programmatico

📘 Esempio

from FlashGui import SEARCHER

s = SEARCHER(title="Cerca file Python", style="dark")
s.Edit(title_text="🔍 Ricerca File", btn_search_text="Cerca", btn_cancel_text="Stop")
s.SetSearchPath("C:/Users/me/Documents")
s.SetQuery(".py")
s.SetSearchType("Files")
s.SetRecursive(True)

def on_finish(count):
    s.SetStatus(f"Trovati {count} file Python!")

def on_open(path):
    import subprocess
    subprocess.Popen(["code", path])  # apri in VS Code

s.Logic(finish_command=on_finish, open_command=on_open)
s.run()

from FlashGui import WINDOW

win = WINDOW(
    title="La mia app",
    size=(800, 600),      # pixel assoluti (largh, alt)
    style="light",         # "light" o "dark"
    color=(240, 240, 240),
    icon=None,
    maximized=False,
    min_size=(400, 300),  # pixel o float 0→1
    max_size=(1920, 1080)
)

Widgets disponibili AGGIORNATO

Tutti i metodi add_* accettano i parametri comuni: relx, rely, relw, relh, fg, bg, font_scale, bold, tooltip, visible (dove applicabile). Restituiscono un FGProxy che puoi passare a Modify().

Metodo Modify(widget, **kwargs)

Aggiorna uno o più attributi di un widget già creato senza doverlo ricreare. Accetta widget= (il proxy restituito da add_*) oppure index= (posizione 0-based nella lista widget).

# Creo un label e poi lo modifico
lbl = win.add_label(text="Hello", relx=0.5, rely=0.3)
win.Modify(lbl, text="World", fg=(255,0,0), bold=True)

# Oppure tramite FGProxy
lbl.Modify(text="Ciao!", fg=(0,200,0))

Metodi di testo e file

Dialogs e helper file AGGIORNATO

FGCanvas — canvas di disegno integrato

Il canvas supporta cinque modalità: "free" (disegno libero), "line", "rect", "circle", "erase". L'anteprima della forma viene disegnata durante il drag. Supporta tasto sinistro e destro del mouse.

FGStatusBar — barra di stato personalizzabile

Via Modify(): status0…status3 per impostare i 4 slot testuali, oppure status_texts=[...] come lista.

BindKey — scorciatoie da tastiera NEW

# Collega Ctrl+S a una funzione
win.BindKey("Ctrl+S", salva_file)
win.BindKey("F5", esegui)
win.BindKey("Ctrl+Shift+Z", redo)
win.BindKey("Escape", chiudi_dialog)

Tasti speciali supportati: F1–F12, Escape, Enter, Delete, Backspace, Tab, Home, End, PageUp, PageDown, Up/Down/Left/Right, Space e tutti i caratteri ASCII.

Gestione finestra NEW

📘 Esempi WINDOW

from FlashGui import WINDOW

win = WINDOW(title="Calcolatrice custom", size=(500, 400))

display = win.add_entry(value="", relx=0.5, rely=0.12, relw=0.9, relh=0.12, read_only=True)

for i, (lbl, rx, ry) in enumerate([
    ("7", 0.2, 0.35), ("8", 0.4, 0.35), ("9", 0.6, 0.35),
    ("4", 0.2, 0.50), ("5", 0.4, 0.50), ("6", 0.6, 0.50),
]):
    win.add_button(text=lbl, relx=rx, rely=ry, relw=0.18, relh=0.12,
                   on_click=lambda l=lbl: display.SetText(display.GetText()+l))

win.run()

# Esempio con canvas + statusbar + BindKey
from FlashGui import WINDOW

win = WINDOW(title="Paint mini", size=(800, 600), style="dark")

cvs = win.add_canvas(bg=(30,30,30), pen=(255,255,255), width=3, mode="free",
                     relx=0.5, rely=0.48, relw=0.98, relh=0.9)
sb  = win.add_statusbar(proportions=[-1, -1], relx=0.5, rely=1.0, relw=1.0, relh=0.05)

sb.Modify(status0="Modalità: free", status1="Ctrl+L = linea | Ctrl+R = rettangolo")

win.BindKey("Ctrl+L", lambda: cvs.Modify(mode="line"))
win.BindKey("Ctrl+R", lambda: cvs.Modify(mode="rect"))
win.BindKey("Ctrl+Delete", lambda: cvs.Modify(clear=True))

win.run()

API Comuni a tutti i moduli AGGIORNATO

Le API seguenti sono disponibili su tutti i moduli: CALCULATOR, NOTEPAD, PAINT, CLOCK, CALENDAR, SEARCHER, WINDOW.

Timer

# Esempio: aggiorno un label ogni secondo
import time
lbl = win.add_label(relx=0.5, rely=0.5)

win.AddRepeatTimer(1000, lambda: lbl.SetText(time.strftime("%H:%M:%S")), name="clock")

# Per fermarlo dopo 10 secondi:
win.AddTimer(10000, lambda: win.DelTimer("clock"))

Clipboard

HTTP asincrono

Ogni modulo include un metodo per inviare richieste HTTP in un thread di background, senza bloccare la UI.

# Esempio: chiamata API REST da WINDOW
def on_response(resp, err):
    if err:
        win.ShowMessageBox(f"Errore: {err}")
    else:
        lbl.SetText(resp)

win.SendRequest(
    url="https://api.example.com/data",
    method="POST",
    data={"key": "valore"},
    use_json=True,
    callback=on_response
)

Filosofia: Logic() vs Edit()

Questa separazione netta permette di:

• Tradurre completamente l'interfaccia chiamando solo Edit() con le stringhe localizzate.
• Iniettare la logica applicativa senza toccare la UI, mantenendo il codice pulito.
• Ridefinire solo i comportamenti che interessano: se non passi un parametro a Logic(), il comportamento default rimane attivo.