Instalace

Pro většinu uživatelů je instalace jen jeden pip příkaz. Build ze zdrojů je potřeba pouze tehdy, pokud chcete pracovat na samotném projektu nebo potřebujete vlastní nativní sestavení.

Doporučený postupZačněte s předpřipraveným wheel balíčkem přes pip. Na build ze zdrojů přejděte jen tehdy, pokud pip install tuix-core selže na vaší platformě nebo pokud vyvíjíte samotný TUIX Core.

Požadavky

Python 3.10 nebo novější
Terminál s podporou ANSI escape sekvencí
C kompilátor pouze v případě, že chcete build ze zdrojů

pip

pip install tuix-core

Předpřipravené balíčky (wheels) jsou dostupné pro Python 3.10+ na Windows (x86, AMD64), Linuxu (x86_64, i686, aarch64) a macOS (x86_64, arm64).

Sestavení ze zdrojů

Sestavení ze zdrojů vyžaduje Cython >= 0.29 a C kompilátor. Build zkompiluje Cython rozšíření (_tuix_cy) a slinkuje 23 C zdrojových souborů.

pip install cython>=0.29
pip install .

Vlastní kompilaceZdrojová distribuce obsahuje všechny C soubory. Pokročilí uživatelé mohou C knihovnu zkompilovat ručně a zahrnout volitelné moduly (např. halfblock renderer nebo cache manager), které nejsou součástí výchozího buildu.

Build ze zdrojů dělejte jen když je to potřebaPokud chcete TUIX Core jen používat, build ze zdrojů vám přidává zbytečné proměnné navíc. Preferujte wheel, pokud nepotřebujete ladit kompilaci nebo upravovat nativní kód.

Závislosti

TUIX Core nemá žádné externí Python závislosti. Všechny importy pocházejí ze standardní knihovny Pythonu: os, sys, time, ctypes a typing.

Poznámky k platformám

WindowsVstup se zachytává přes ReadConsoleInputW s nativními záznamy KEY_EVENT a MOUSE_EVENT. Renderování ANSI escape sekvencí funguje v cmd.exe, PowerShellu i Windows Terminalu.

LinuxVstup se zachytává v raw režimu (termios/tty) se SGR parsováním myši. Build se linkuje proti pthread pro vlákno posluchače vstupu.

macOSStejná POSIX cesta vstupu jako na Linuxu. Vyžaduje terminál s podporou ANSI escape sekvencí a ideálně truecolor.

Ověření instalace

Než začnete psát celou aplikaci, spusťte tento krátký snippet. Ověří, že se nativní rozšíření načte a že jádro zvládne korektní inicializaci.

from tuix.core import engine
engine.init()
print("TUIX Core v0.3 loaded successfully")
engine.shutdown()

HotovoPokud se neobjeví žádné chyby, TUIX Core je nainstalováno správně. Pokračujte na tutoriál První widget.

Časté problémy

pip install selže na nepodporované platformě: zkuste build ze zdrojů a ověřte, že vám funguje toolchain kompilátoru.
Terminál zobrazuje rozbité barvy: přepněte na moderní terminál s podporou ANSI, například Windows Terminal, novější PowerShell nebo běžný emulátor terminálu na Linuxu/macOS.
engine.init() spadne hned při startu: ověřte, že wheel nebo rozšíření byly nainstalovány pro stejnou verzi Pythonu, kterou právě používáte.