kern/v4/lev0/helpers/helpers.go

// 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/lev0/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_()
}