Ana içeriğe atla

Ziva Kurulumu

Gereksinimler

  • Go 1.23.0+ (toolchain 1.24.5 önerilir)
  • Pseudografiklerin doğru görüntülenmesi için UTF-8 destekli terminal
  • Terminal renk desteği (opsiyonel)

Kurulum

go get ile

go get github.com/qzeleza/ziva

go mod ile

go.mod dosyanıza ekleyin:
require github.com/qzeleza/ziva latest
Sonra çalıştırın:
go mod tidy

Kurulum Doğrulaması

Doğrulama için basit bir main.go dosyası oluşturun:
package main

import (
    "fmt"
    "log"
    "github.com/qzeleza/ziva"
)

func main() {
    // Basit görev oluştur
    task := ziva.NewYesNoTask("Test", "Ziva doğru kuruldu mu?")

    // Kuyruk oluştur ve görev ekle
    queue := ziva.NewQueue("Ziva Kurulum Kontrolü")
    queue.AddTasks(task)

    // Çalıştır
    if err := queue.Run(); err != nil {
        log.Fatal(err)
    }

    // Sonucu kontrol et
    if task.IsYes() {
        fmt.Println("✅ Harika! Ziva çalışmaya hazır.")
    } else {
        fmt.Println("❌ Kurulumu kontrol etmek gerekiyor.")
    }
}
Çalıştırın:
go run main.go

Ortam Yapılandırması

Yerel Ayar Yapılandırması (Türkçe için)

Türkçe metnin doğru görüntülenmesi için yerel ayarları yapılandırın: Ubuntu/Debian:
sudo locale-gen tr_TR.UTF-8
sudo update-locale LANG=tr_TR.UTF-8
export LANG=tr_TR.UTF-8
export LC_ALL=tr_TR.UTF-8
Entware/BusyBox:
opkg install locale-full glibc-binary-locales
export LANG=tr_TR.UTF-8

Font Yapılandırması

Gömülü sistemler için font yapılandırması gerekebilir:
setterm -reset
setterm -store
setterm -font ter-116n  # Turkish character support

Ortam Değişkenleri

Ziva, ortam değişkenleri ile yapılandırmayı destekler:
# Arayüz dili
export ZIVA_LANG=tr
export ZIVA_DEFAULT_LANG=tr

# Gömülü sistemler için
export ZIVA_MEMORY_PRESSURE_THRESHOLD=50M
export ZIVA_MAX_COMPLETED_TASKS=10

# Terminal renkleri
export COLORTERM=truecolor
export TERM=xterm-256color

Proje Yapısı

Ziva ile önerilen Go projesi yapısı:
uygulamam/
├── go.mod
├── go.sum
├── main.go
├── cmd/
│   └── uygulamam/
│       └── main.go
├── internal/
│   ├── tasks/
│   ├── config/
│   └── ui/
└── pkg/
    └── validation/

Bağımlılıklar

Ziva şu ana bağımlılıkları kullanır:
  • Bubble Tea - TUI için temel
  • Lip Gloss - stil ve renkler
  • Cobra - CLI (opsiyonel)
Tüm bağımlılıklar go get ile otomatik olarak yüklenir.

Sonraki Adım

İlk TUI uygulamanızı oluşturun
I