kern/v4/lev0/lev0.go

// package lev0 -- сущности уровня 0
package lev0

import (
	"time"

	mKs "gitp78su.ipnodns.ru/svi/kern/v4/lev0/core_spec"
	mEt "gitp78su.ipnodns.ru/svi/kern/v4/lev0/etypes"
	"gitp78su.ipnodns.ru/svi/kern/v4/lev0/helpers"
	"gitp78su.ipnodns.ru/svi/kern/v4/lev0/option"
	mRes "gitp78su.ipnodns.ru/svi/kern/v4/lev0/result"
)

// ETime -- расширенное время.
type ETime = mKs.ITime

// EStr -- расширенная строка.
type EStr = mKs.EStr

// EStrMut -- расширенная строка с признаком мутабельности.
type EStrMut = mKs.EStrMut

// FnOptStr -- опция для установки параметров расширенной строки.
type FnOptStr = mEt.FnOptStr

// OptStr -- устанавливает начальное значение строки.
func OptStr(val string) FnOptStr {
	return mEt.OptStr(val)
}

// OptStrMut -- устанавливает признак мутабельности.
func OptStrMut() FnOptStr {
	return mEt.OptStrMut()
}

// OptStrMinLen -- устанавливает минимальную длину строки.
func OptStrMinLen(lenMin int) FnOptStr {
	return mEt.OptStrMinLen(lenMin)
}

// OptStrMaxLen -- устанавливает максимальную длину строки.
func OptStrMaxLen(lenMax int) FnOptStr {
	return mEt.OptStrMaxLen(lenMax)
}

// StrNew -- возвращает новую строку KStr.
func StrNew(opt ...FnOptStr) EStr {
	return mEt.StrNew(opt...)
}

// StrMutNew -- возвращает новую строку KStrMut.
func StrMutNew(opt ...FnOptStr) EStrMut {
	return mEt.StrMutNew(opt...)
}

// Result — обёртка вокруг результата с возможной ошибкой.
type IResult[T any] = mKs.IResult[T]

// NewOk -- возвращает успешный Result с значением.
func NewOk[T any](res T) IResult[T] {
	return mRes.NewOk(res)
}

// NewErr -- возвращает Result с ошибкой.
func NewErr[T any](err error) IResult[T] {
	return mRes.NewErr[T](err)
}

// WrapErr -- оборачивает существующий Result с ошибкой с новой ошибкой.
func WrapErr[T any](res IResult[T], err error) IResult[T] {
	return mRes.WrapErr(res, err)
}

// IOption — обёртка вокруг результата с возможной пустотой.
type IOption[T any] = mKs.IOption[T]

// NewSome -- возвращает новый не пустой результат операции.
func NewSome[T any](some T) IOption[T] {
	return option.NewSome(some)
}

// NewNone -- возвращает новый пустой результат операции.
func NewNone[T any]() IOption[T] {
	return option.NewNone[T]()
}

// Hassert -- проверка на правильность утверждения с безусловным падением в панику (hard assert).
//
//go:fix inline
func Hassert(isCond bool, msgFormat string, args ...any) {
	helpers.Hassert(isCond, msgFormat, args)
}

// Assert -- проверка на правильность утверждения с падением в панику на локальном стенде (soft assert).
//
//go:fix inline
func Assert(isCond bool, msgFormat string, args ...any) {
	helpers.Assert(isCond, msgFormat, args)
}

// SleepMs -- задержка в миллисекундах.
//
//go:fix inline
func SleepMs() {
	time.Sleep(time.Millisecond * 1)
}