progress

type PhaseConfig ¶

type PhaseConfig struct {
	Name        string
	Title       string
	Description string
}

PhaseConfig 定义一个阶段的配置。

type PhaseInfo ¶

type PhaseInfo struct {
	Name        string      `json:"name"`
	Title       string      `json:"title"`
	Description string      `json:"description"`
	Status      PhaseStatus `json:"status"`
	Progress    float64     `json:"progress"`
	StartTime   time.Time   `json:"start_time,omitempty"`
	EndTime     time.Time   `json:"end_time,omitempty"`
	Duration    int64       `json:"duration_ms,omitempty"`
}

PhaseInfo 表示单个阶段的运行时信息。

type PhaseStatus ¶

type PhaseStatus string

PhaseStatus 表示阶段的状态。

const (
	PhasePending   PhaseStatus = "pending"
	PhaseActive    PhaseStatus = "active"
	PhaseCompleted PhaseStatus = "completed"
	PhaseFailed    PhaseStatus = "failed"
	PhaseSkipped   PhaseStatus = "skipped"
)

type TaskStatus ¶

type TaskStatus string

TaskStatus 表示整个追踪任务的状态。

const (
	// TaskRunning 任务进行中。
	TaskRunning TaskStatus = "running"
	// TaskCompleted 任务已成功完成。
	TaskCompleted TaskStatus = "completed"
	// TaskFailed 任务失败。
	TaskFailed TaskStatus = "failed"
)

type Tracker ¶

type Tracker struct {
	// contains filtered or unexported fields
}

Tracker 是多阶段进度追踪器。 线程安全，支持并发更新。

用法:

t := progress.NewTracker([]progress.PhaseConfig{
    {Name: "init", Title: "Initialization"},
    {Name: "process", Title: "Processing"},
    {Name: "finish", Title: "Finalization"},
})
t.UpdatePhase("init", progress.PhaseActive, 0)
t.UpdatePhase("init", progress.PhaseCompleted, 100)

func NewTracker(phases []PhaseConfig) *Tracker

func (t *Tracker) Complete()

func (t *Tracker) Fail()

func (t *Tracker) GetDuration() time.Duration

func (t *Tracker) GetOverallProgress() float64

func (t *Tracker) GetPhase(name string) (PhaseInfo, bool)

func (t *Tracker) GetPhases() []PhaseInfo

func (t *Tracker) GetStatus() TaskStatus

func (t *Tracker) IsCompleted() bool

func (t *Tracker) UpdatePhase(name string, status PhaseStatus, progress float64)