64/100 Dias de Golang - Iniciando uma TUI - Terminal User Interface
Table of Contents
#
Iniciando uma TUI - Terminal User Interface
Vamos verificar um lib muito legal do ecosistema, para a criação de Interfaces de usuário no terminal (TUIs), a Bubble Tea e aproveitar para ver a lib lipgloss. Vamos iniciar nosso projeto e instalar essas duas libs:
go get github.com/charmbracelet/bubbletea
go get github.com/charmbracelet/lipgloss
O Bubble Tea segue uma arquitetura bem definida:
- Model: Representa o estado da aplicação.
- Update: Lida com as atualizações de estado.
- View: Define como a interface é renderizada.
Esse código gera uma TUI, quando apertamos “i” um contador é incrementado, “d” decrementado e “q” a aplicação encerra.
package main
import (
"fmt"
tea "github.com/charmbracelet/bubbletea"
)
type model struct {
counter int
}
func (m model) Init() tea.Cmd {
return nil
}
func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
switch msg := msg.(type) {
case tea.KeyMsg:
switch msg.String() {
case "q":
return m, tea.Quit
case "i":
m.counter++
case "d":
m.counter--
}
}
return m, nil
}
func (m model) View() string {
return fmt.Sprintf("Contador: %d\n\nPressione 'i' para incrementar, 'd' para decrementar, 'q' para sair.", m.counter)
}
func main() {
p := tea.NewProgram(model{})
if _, err := p.Run(); err != nil {
fmt.Printf("Err: %v", err)
}
}
Veja a explicação de cada parte:
A estrutura model representa o estado da aplicação, que no caso é um contador.
type model struct {
counter int
}
Um método init para quando o programa é iniciado
func (m model) Init() tea.Cmd {
return nil
}
O método Update é responsável por atualizar o estado do modelo quando uma mensagem (tea.Msg) é recebida. Aqui está a lógica de incrementar e decrementar.
func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
switch msg := msg.(type) {
case tea.KeyMsg:
switch msg.String() {
case "q":
return m, tea.Quit
case "i":
m.counter++
case "d":
m.counter--
}
}
return m, nil
}
O método View é responsável por renderizar o estado atual no terminal.
func (m model) View() string {
return fmt.Sprintf("Contador: %d\n\nPressione 'i' para incrementar, 'd' para decrementar, 'q' para sair.", m.counter)
}
Cria uma nova instância de um programa Bubble Tea com um modelo inicial vazio (model{}) e executa o programa com o Run()
func main() {
p := tea.NewProgram(model{})
if _, err := p.Run(); err != nil {
fmt.Printf("Err: %v", err)
}
}
Podemos fazer o jogo UDP usando essa lib, essa atualização de estados é onde a “mágica” acontece e podemos usar para atualizar a posição e o estado do jogo.