FlashGui 0.1.5

✨ Perché FlashGui?

Hai presente quando vuoi creare una piccola app desktop in Python e ti scontri con la complessità di Tkinter o la verbosità di wxPython? FlashGui nasce per darti calcolatrice, blocco note, paint, orologio e calendario già funzionanti in 3 righe di codice. Se vuoi costruire la tua interfaccia da zero, il componente WINDOW ti permette di posizionare qualsiasi widget usando coordinate proporzionali (0.0 → 1.0) e i font si ridimensionano da soli. Tutto con un look pulito, moderno e completamente personalizzabile.

📦 Installazione in un soffio

pip install FlashGui

wxPython e charset_normalizer verranno installati automaticamente. Nessun'altra dipendenza.

📚 Dipendenze

FlashGui è costruito sopra wxPython Phoenix (wxWidgets) e utilizza charset_normalizer per il rilevamento automatico delle codifiche nel blocco note. Entrambe le librerie vengono installate automaticamente con pip.

📜 Licenze – Leggi con attenzione

🧮 CALCULATOR – La calcolatrice che puoi vestire a modo tuo

Una calcolatrice completa con display, 20 pulsanti e gestione degli errori. Puoi cambiarne ogni singolo aspetto e agganciare le tue funzioni a ogni tasto.

Costruttore

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

Metodo .Edit() – Personalizzazione completa

Modifica testi, colori e aspetto di ogni elemento. Tutti i parametri sono opzionali.

Metodo .Logic() – Callback personalizzati

Ogni parametro accetta una funzione senza argomenti (o None per comportamento predefinito).

Metodi pubblici aggiuntivi

• GetText() → str: restituisce il testo nel display.
• SetText(testo) → imposta il display e l'espressione interna.
• AppendText(testo) → aggiunge testo in coda all'espressione.
• Clear() → svuota display e memoria.
• AddTimer(ms, command) → avvia un timer che esegue command ogni ms millisecondi.
• run() → avvia il loop principale.

📘 Esempio CALCULATOR

from FlashGui import CALCULATOR

def mio_callback():
    print("Hai premuto un tasto personalizzato!")

calc = CALCULATOR(title="La mia calcolatrice", size=(3,2), color=(50,50,60), style="dark")
calc.Edit(
    button_eq_bg=(200,50,50),
    button_eq_fg=(255,255,255),
    entry_bg_color=(30,30,40),
    entry_text_color=(0,200,0),
    message_error="ERRORE"
)
calc.Logic(button_0_command=mio_callback)
calc.run()

📝 NOTEPAD – Un editor di testo con i fiocchi

Blocco note completo: apertura/salvataggio con rilevamento automatico della codifica (charset_normalizer), menu personalizzabili, barra di stato, menu contestuale e temi scuri.

Costruttore

Stessi parametri di CALCULATOR (title, size, color, icon, maximized, min_size, max_size, style).

Metodo .Edit() – Personalizzazione totale

Oltre 50 parametri per personalizzare ogni testo, colore e comportamento.

Metodo .Logic() – Sostituisci le azioni predefinite

📘 Esempio NOTEPAD

from FlashGui import NOTEPAD

def salva_personalizzato():
    print("Salvataggio personalizzato!")

nota = NOTEPAD(title="Mio Blocco Note", size=(2,2), style="dark")
nota.Edit(
    file_menu_text="Archivio",
    edit_menu_text="Modifica",
    text_ctrl_bg=(40,40,50),
    text_ctrl_fg=(200,200,100),
    menubar_bg=(60,60,70),
    menubar_fg=(255,255,255)
)
nota.Logic(menu_save_command=salva_personalizzato)
nota.run()

🎨 PAINT – Disegna come su una tela vera

Pennello, gomma, secchiello (riempimento), linea, cerchio, rettangolo. Salva in PNG o JPG.

Costruttore

Stessi parametri standard, incluso style.

Metodo .Edit()

Metodo .Logic()

📘 Esempio PAINT

from FlashGui import PAINT

paint = PAINT(title="Mio Paint", size=(2,2), style="light")
paint.Edit(
    brush_button_text="Pennello",
    eraser_button_text="Gomma",
    canvas_bg=(200,230,200),
    width_text="Spessore"
)
paint.Logic(current_tool="brush", slider_start_value=10)
paint.run()

⏰ CLOCK – Orologio, Timer e Cronometro in un'unica finestra

Costruttore

Parametri standard + style.

Metodo .Edit() – Parametri completi

La tabella seguente elenca tutti i parametri modificabili.

Metodo .Logic()

📘 Esempio CLOCK

from FlashGui import CLOCK

clock = CLOCK(title="Orologio multifunzione", size=(2,2), style="dark")
clock.Edit(
    nav_clock_text="OROLOGIO",
    nav_timer_text="TIMER",
    nav_stopwatch_text="CRONOMETRO",
    clock_time_fg_color=(255,100,100),
    clock_date_fg_color=(100,200,255),
    timer_btn_start_text="AVVIA",
    timer_btn_reset_text="RESET"
)
clock.Logic(timer_base_h=0, timer_base_m=1, timer_base_s=30)
clock.run()

📅 CALENDAR – Un calendario interattivo e internazionalizzabile

Costruttore

Parametri standard + style.

Metodo .Edit() – Parametri completi

Metodo .Logic()

Metodi pubblici aggiuntivi

• get_selected_date() → datetime.date
• go_to_date(d) → sposta la vista a una data
• set_info_text(testo) → aggiorna footer

📘 Esempio CALENDAR

from FlashGui import CALENDAR
from datetime import date

def giorno_selezionato(d):
    print(f"Hai scelto il {d}")

cal = CALENDAR(title="Calendario Eventi", size=(2,2), style="light")
cal.Edit(
    week_start_monday=False,
    monday_text="LUN",
    tuesday_text="MAR",
    info_text="Seleziona una data per l'evento",
    day_today_bg_color=(200,100,50)
)
cal.Logic(day_command=giorno_selezionato)
cal.go_to_date(date(2025, 12, 25))
cal.run()

🪟 WINDOW – La tua tela bianca proporzionale

Layout proporzionale automatico: coordinate relative (0.0‑1.0) e font scalati. Ogni metodo Add... restituisce un oggetto widget con un metodo .Modify() per cambiare proprietà a runtime.

Costruttore

Stessi parametri degli altri componenti (title, size, color, icon, maximized, min_size, max_size, style).

➕ Metodi per aggiungere widget

Tutti i metodi accettano i parametri comuni relx, rely, relwidth, relheight (float tra 0 e 1) e opzionalmente font_scale, tooltip, enabled, visible, cursor, parent. Di seguito i dettagli specifici per ciascun widget.

🛠️ Metodi di utilità e modifica

Barra menu e status bar

• AddMenuBar() → crea barra menu.
• AddMenu(title) → restituisce un wx.Menu.
• AddMenuItem(menu, label, command, shortcut) → aggiunge voce con scorciatoia (es. "Ctrl+N").
• AddStatusBar(text, color, bg, highlight, text_size, height_scale, relx, rely, relwidth, relheight, font_scale) → crea status bar personalizzabile con posizionamento proporzionale del testo.
• SetStatusText(testo, field=0) → imposta testo status bar (se usata barra standard).

Timer e dialoghi

• AddTimer(ms, command, one_shot=False) → avvia un timer. Restituisce l'oggetto wx.Timer.
• StopTimer(timer) → ferma e rimuove il timer.
• Message(testo, titolo="Message") → messaggio informativo.
• AskSave(wildcard, default_dir) → percorso o None.
• AskOpen(wildcard, default_dir) → percorso o None.
• exit() → chiude l'applicazione.

Manipolazione widget

• EnableWidget(widget, enable=True) → abilita/disabilita.
• ShowWidget(widget, show=True) → mostra/nasconde (ricalcola layout).
• CanvasSetPen(canvas, color=None, width=None) → imposta colore/spessore per canvas.
• CanvasClear(canvas, bg=None) → pulisce canvas.

Il metodo .Modify() dei widget

Ogni widget restituito dai metodi Add... possiede un metodo .Modify(**kwargs) che permette di cambiare proprietà dopo la creazione. I parametri variano in base al tipo di widget, ma includono sempre relx, rely, relwidth, relheight, font_scale, tooltip, enabled, visible, cursor, bg, fg.

Esempi per tipo:

# Label
label = win.AddLabel("Ciao", relx=0.3, rely=0.4)
label.Modify(text="Nuovo testo", fg=(255,0,0), font_scale=1.5)

# Button
btn = win.AddButton("Click")
btn.Modify(text="Premi", bg=(100,200,100), command=nuova_funzione)

# Input / TextArea
inp = win.AddInput()
inp.Modify(text="Valore", hint="Inserisci...", readonly=True)

# Counter
cnt = win.AddCounter(min_val=1, max_val=10)
cnt.Modify(value=5, step=2)

# CheckBox / RadioButton
cb = win.AddCheckBox("Opzione")
cb.Modify(checked=True, text="Abilitato")

# ComboBox / ListBox
cbx = win.AddComboBox(choices=["A","B"])
cbx.Modify(choices=["X","Y","Z"], value="Y")

# Canvas
canvas = win.AddCanvas(bg="white")
canvas.Modify(bg=(200,220,240))
win.CanvasSetPen(canvas, color="blue", width=3)
win.CanvasClear(canvas, bg="lightgray")

📘 Esempi WINDOW

from FlashGui import WINDOW

win = WINDOW(title="Demo Base", size=(2,2))
win.AddLabel("Ciao Mondo!", relx=0.3, rely=0.4, relwidth=0.4, relheight=0.1)
win.AddButton("Click", command=lambda: win.Message("Ciao!"), relx=0.4, rely=0.6, relwidth=0.2, relheight=0.1)
win.run()

from FlashGui import WINDOW

win = WINDOW(title="Esempio Tabs", size=(2,2))
tabs = win.AddTabs(relx=0.1, rely=0.1, relwidth=0.8, relheight=0.8)

pagina1 = win.AddPage(tabs, title="Home", bg="#FFFFFF")
win.AddLabel("Benvenuto nella prima scheda", parent=pagina1, relx=0.1, rely=0.4)

pagina2 = win.AddPage(tabs, title="Impostazioni", bg="#F0F0F0")
win.AddCheckBox("Opzione 1", parent=pagina2, relx=0.2, rely=0.2)

win.run()

🔁 La triade magica: run(), Edit(), Logic()

Ogni componente FlashGui espone questi tre metodi fondamentali:

• .run() – Avvia il loop principale dell'applicazione (bloccante).
• .Edit(**kwargs) – Modifica l'aspetto: testi, colori, messaggi. Ogni componente ha i suoi parametri specifici (elencati sopra).
• .Logic(**kwargs) – Collega le tue funzioni agli eventi (click pulsanti, selezione voci di menu, ecc.).

⏱️ AddTimer() – comune a tutti i componenti

Tutti i componenti (CALCULATOR, NOTEPAD, PAINT, CLOCK, CALENDAR, WINDOW) possiedono il metodo AddTimer(ms, command) che avvia un timer periodico. Restituisce l'oggetto wx.Timer. In WINDOW è presente anche StopTimer(timer).

def aggiorna():
    print("Timer scattato")

calc = CALCULATOR()
calc.AddTimer(1000, aggiorna)   # ogni secondo
calc.run()