xiao

type CancelFunc = gcontext.CancelFunc

type Context interface {
	// composite
	gcontext.Context

	// Fork return a copied context, if there is a new goroutine generated
	// it will use my name with a sequential number suffix started from 1
	Fork() Context
	// At return a copied context, specify the current location where it is in,
	// it should chain all locations start from root
	At(location string) Context
	ForkAt(location string) Context
	// Reborn will use gcontext.Background() instead of internal context,
	// it used for escaping internal context's cancel request
	Reborn() Context
	// RebornWith will use specified context instead of internal context,
	// it used for escaping internal context's cancel request
	RebornWith(gcontext.Context) Context
	// Name return my logger's name
	Name() string
	// Location return my logger's location
	Location() string

	// integrated base official context action
	WithCancel() (Context, CancelFunc)
	WithDeadline(time.Time) (Context, CancelFunc)
	WithTimeout(time.Duration) (Context, CancelFunc)
	WithValue(key, value any) Context

	// Env return my env
	// WARN: env value and official context value are two diffrent things
	Env() Env
	// shortcut methods of my env
	Set(key, value any)
	Get(key any) (value any, ok bool)
	GetString(key any) string
	GetInt(key any) int
	GetUint(key any) uint
	GetFloat(key any) float64
	GetBool(key any) bool

	// mute/unmute my logger
	Mute()
	Unmute()
	// Logger return my logger
	Logger() Logger
	// shortcut methods of my logger
	Debug(msg string, kvs ...any)
	Debugf(template string, args ...any)
	Info(msg string, kvs ...any)
	Infof(template string, args ...any)
	Warn(msg string, kvs ...any)
	Warnf(template string, args ...any)
	Error(msg string, kvs ...any)
	Errorf(template string, args ...any)
	Panic(msg string, kvs ...any)
	Panicf(template string, args ...any)
	Fatal(msg string, kvs ...any)
	Fatalf(template string, args ...any)
}

type ContextGenerator = func() Context

type Env interface {
	// Fork return an inherited sub Env, and I am it's parent
	Fork() Env

	// Set always set key & value at local storage
	Set(key, value any)
	// Get always check local, if the key not exists, then check parent
	Get(key any) (value any, ok bool)
	Has(key any) (ok bool)
	Keys() []any

	GetInt(key any) int
	GetInt64(key any) int64
	GetUint(key any) uint
	GetUint64(key any) uint64
	GetBool(key any) bool
	GetFloat(key any) float64
	GetString(key any) string
	GetIP(key any) net.IP
	GetAddr(key any) net.Addr
	GetTime(key any) time.Time
	GetDuration(key any) time.Duration
}

type Event struct {
	Args []any // 触发事件时提供的关联数据
	// contains filtered or unexported fields
}

type LocationJoiner func(origin, given string) (field, location string)

type Logger interface {
	// Fork return a new logger, with the given name and location,
	// but it's full name and full location should inhert from me.
	// It could just simplely join my name and location.
	// e.g. my name = ServiceMonitor, name = go1, then new name = ServiceMonitor.go1.
	// e.g. my location = CheckPort, location = CheckAlive, then new location = CheckPort/CheckAlive.
	// name will be print as zap logger's name, mostly it looks like a uuid
	// location will be print as a data field, field name is '@' mostly.
	Fork(name, location string) Logger

	// Name return my full name
	Name() string
	// Location return my full location
	Location() string

	// Debug("New user created", "name", "CJey", "sex", "male")
	Debug(msg string, kvs ...any)
	Debugf(template string, args ...any)
	Info(msg string, kvs ...any)
	Infof(template string, args ...any)
	Warn(msg string, kvs ...any)
	Warnf(template string, args ...any)
	Error(msg string, kvs ...any)
	Errorf(template string, args ...any)
	Panic(msg string, kvs ...any)
	Panicf(template string, args ...any)
	Fatal(msg string, kvs ...any)
	Fatalf(template string, args ...any)

	// With return a Logger with specified key/value pairs
	With(kvs ...any) Logger
	// Sync flush log buffers
	Sync() error

	// Mute
	Mute()
	// Unmute
	Unmute()
}

type NameJoiner func(origin, given string) (name string)

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