kern/v4/lev0/helpers/helpers.go

// package helpers -- содержит всякие полезняшки.
//
// Пакет импортировать где нужно в нотации `. "gitlab.c2g.pw/back/uaj-abstract-client/pkg/helpers"`
package helpers

import (
	"fmt"
	"log"
	"os"
	"time"

	"gitp78su.ipnodns.ru/svi/kern/v4/lev0/defs/def_spec"
)

var (
	IsStageLocal bool
	IsStageProd  bool
)

// FnAssert -- проверка на правильность утверждения с падением в панику на локальном стенде (soft assert).
//
//	(isCond bool, msgFormat defs.Str, args ...any)
// type FnAssert func(isCond bool, msgFormat def_spec.ATxt, args ...any)

// Assert -- проверка на правильность утверждения с падением в панику на локальном стенде (soft assert).
// func Assert(isCond bool, msgFormat def_spec.ATxt, args ...any) {
// 	if isCond {
// 		return
// 	}
// 	msg := def_spec.Sprintf("SOFT ASSERT "+msgFormat+"\n", args...)
// 	if IsStageLocal {
// 		panic(msg)
// 	}
// 	log.Print(msg)
// }

// IAssertAction -- действие, которое будет выполнено при проверке.
type IAssertAction interface {
	// Assert -- жёсткое падение кроме прода
	Assert(msgFormat def_spec.ATxt, args ...any)
	// Hassert -- жёсткое падение даже на проде
	Hassert(msgFormat def_spec.ATxt, args ...any)
}

type IfAction func(msgFormat def_spec.ATxt, args ...any)

type AssertAction struct {
	isCond def_spec.Bool
}

// Hassert -- проверка на правильность утверждения с безусловным падением в панику даже на проде (hard assert).
func (sf *AssertAction) Hassert(msgFormat def_spec.ATxt, args ...any) {
	if !sf.isCond {
		return
	}
	msg := def_spec.Sprintf("HARD ASSERT "+msgFormat+"\n", args...)
	panic(msg)
}

// Assert -- проверка на правильность утверждения с падением в панику кроме прода (soft assert).
func (sf *AssertAction) Assert(msgFormat def_spec.ATxt, args ...any) {
	if !sf.isCond {
		return
	}
	msg := def_spec.Sprintf("SOFT ASSERT "+msgFormat+"\n", args...)
	if IsStageLocal {
		panic(msg)
	}
	log.Print(msg)
}

type FnIf func(isCond def_spec.Bool) IAssertAction

// If -- условие для проверки.
func If(isCond def_spec.Bool) IAssertAction {
	sf := &AssertAction{
		isCond: isCond,
	}
	return sf
}

// FnHassert -- проверяет с жёстким падением условие.
//
//	(isCond bool, msgFormat defs.Str, args ...any)
// type FnHassert func(isCond def_spec.Bool, msgFormat def_spec.ATxt, args ...any)

// Hassert -- проверка на правильность утверждения с безусловным падением в панику (hard assert).
// func Hassert(isCond def_spec.Bool, msgFormat def_spec.ATxt, args ...any) {
// 	if isCond {
// 		return
// 	}
// 	msg := def_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))
	}
}

func init() {
	init_()
}