// package helpers -- содержит всякие полезняшки. // // Пакет импортировать где нужно в нотации `. "gitlab.c2g.pw/back/uaj-abstract-client/pkg/helpers"` package helpers import ( "fmt" "log" "os" "reflect" "time" "gitp78su.ipnodns.ru/svi/kern/v4/d0/defs/def_spec_base" ) var ( IsStageLocal def_spec_base.Bool IsStageProd def_spec_base.Bool ) // AssertAction -- хранит состояние для проверки. type AssertAction[T ~bool] struct { isCond T } // Hassert -- проверка на правильность утверждения с безусловным падением в панику даже на проде (hard assert). func (sf *AssertAction[T]) Hassert(msgFormat def_spec_base.Txt, args ...any) { if !sf.isCond { return } msg := fmt.Sprintf("HARD ASSERT "+string(msgFormat)+"\n", args...) panic(msg) } // Assert -- проверка на правильность утверждения с падением в панику кроме прода (soft assert). func (sf *AssertAction[T]) Assert(msgFormat def_spec_base.Txt, args ...any) { if !sf.isCond { return } msg := fmt.Sprintf("SOFT ASSERT"+string(msgFormat)+"\n", args...) if IsStageLocal { panic(msg) } log.Print(msg) } // If -- условие для проверки. func If[T ~bool](isCond T) *AssertAction[T] { sf := &AssertAction[T]{ isCond: isCond, } return sf } // FnHassert -- проверяет с жёстким падением условие. // // (isCond bool, msgFormat defs.Str, args ...any) // type FnHassert func(isCond d_ef_spec.Bool, msgFormat d_ef_spec.ATxt, args ...any) // Hassert -- проверка на правильность утверждения с безусловным падением в панику (hard assert). // func Hassert(isCond d_ef_spec.Bool, msgFormat d_ef_spec.ATxt, args ...any) { // if isCond { // return // } // msg := d_ef_spec.Sprintf("HARD ASSERT "+msgFormat+"\n", args...) // panic(msg) // } // TimeNow -- возвращает локальное Unix сейчас-время (мсек, не зависит от положения). func TimeNow() int64 { timeNow := time.Now().Local().UnixMilli() return timeNow } // SleepMs -- спит миллисекунду (иногда бывает полезно). func SleepMs() { time.Sleep(time.Millisecond * 1) } func init_() { strStage := os.Getenv("STAGE") switch strStage { case "local": IsStageLocal = true IsStageProd = false case "prod": IsStageProd = true IsStageLocal = false case "": IsStageLocal = true IsStageProd = false default: panic(fmt.Sprintf("lepers.init_(): unknown env STAGE (%v)\n", strStage)) } } // IsNil -- проверяет абсолютно любой Go-объект на nil. // Она безопасно обрабатывает как прямые nil-значения, так и "типизированные" nil // (когда интерфейс содержит внутри себя nil-указатель). func IsNil(i any) def_spec_base.Bool { if i == nil { return true } val := reflect.ValueOf(i) switch val.Kind() { case reflect.Pointer, reflect.Chan, reflect.Map, reflect.Slice, reflect.Func, reflect.Interface: return def_spec_base.Bool(val.IsNil()) default: // Все остальные типы (структуры, int, string, bool) не могут быть nil return false } } func init() { init_() }