Natywne GUI — Pytigon na pulpicie

Desktopowy klient Pytigon zbudowany jest na wxPython, dając aplikacjom autentyczny natywny wygląd na Windows, Linux i macOS. Ta sama logika aplikacji, która napędza interfejs webowy, jest renderowana przez kontrolki wxPython — bez potrzeby osobnej bazy kodu.

Jak to działa

Desktopowy klient to nie osobna aplikacja. To proces Pythona, który:

1. Uruchamia osadzony serwer Django (lub łączy się ze zdalnym)
2. Otwiera okno wxPython ze zintegrowaną przeglądarką internetową
3. Renderuje widoki Pytigon przy użyciu natywnych kontrolek lub osadzonej przeglądarki

Taka architektura oznacza, że desktopowy klient automatycznie korzysta z każdej aktualizacji aplikacji webowej. Nie ma „budowania wersji desktopowej” — po prostu inny cel renderowania.

Klient wxPython

Klient wxPython (pytigon/pytigon/ptig.py) zapewnia:

• Główne okno aplikacji — ramkę z paskiem menu, paskiem narzędzi, paskiem stanu
• Osadzoną przeglądarkę WebKit — wyświetla zawartość renderowaną przez WWW w linii
• Natywne kontrolki — okna dialogowe plików, okna komunikatów, powiadomienia typu toast
• Integrację z zasobnikiem systemowym — minimalizacja do zasobnika, praca w tle
• Automatyczną aktualizację — sprawdza nowe wersje przy starcie

Tryb hybrydowy

Killer-feature desktopowego klienta to tryb hybrydowy — natywne kontrolki i zawartość webowa dzielą to samo okno. Na przykład:

• Widok listy może używać komponentu przeglądarki do bogatego renderowania tabeli
• Formularz edycji tego samego rekordu może używać natywnych pól tekstowych wxPython (szybsze, lepsza obsługa klawiatury)
• Okno dialogowe przesyłania plików używa natywnego selektora plików systemu
• Wykresy i raporty renderowane są w osadzonej przeglądarce przy użyciu Plotly/Chart.js

Komunikacja między komponentami natywnymi a webowymi odbywa się przez mostek JavaScript Pytigon, pozwalający JavaScript wywoływać funkcje natywne i odwrotnie.

Renderer schhtml (wxPython)

Podczas renderowania zawartości dla wxPython, Pytigon używa schhtml z kontekstem urządzenia wxPython (wxdc). To konwertuje szablony .ihtml bezpośrednio w hierarchie widgetów wxPython:

Szablon .ihtml → Parser schhtml → Drzewo widgetów wxPython → Wyświetlenie

Renderer wxPython obsługuje: - Etykiety, pola tekstowe, listy rozwijane - Tabele z sortowaniem, zmianą rozmiaru kolumn i edycją w linii - Wyświetlanie obrazów - Układ formularzy z sizerami - Panele z zakładkami i notebooki - Okna dialogowe

Tagi kontrolek

Pytigon definiuje niestandardowe tagi kontrolek dla widgetów specyficznych dla pulpitu:

[wx_button label="Click me" action="my_action"]
[wx_listbox name="items" source="my_view"]
[wx_treectrl name="hierarchy"]

Zobacz Control tags dla pełnego opisu.

Wtyczki

Desktopowy klient wspiera system wtyczek do rozszerzania funkcjonalności natywnej:

• Obserwatory plików — monitorują katalogi i reagują na zmiany
• Haki systemowe — integracja ze zdarzeniami na poziomie systemu operacyjnego
• Niestandardowe kontrolki — rejestracja nowych typów kontrolek wxPython

Zobacz Plugins dla API wtyczek.

Platformy