kern/v4/kern.go

// package kern -- библиотека гибкого универсального облегчённого ядра для любого микросервиса
package kern

import (
	"context"
	"fmt"

	"gitp78su.ipnodns.ru/svi/kern/v4/kc/log_buf"
	"gitp78su.ipnodns.ru/svi/kern/v4/kc/safe_bool_react"
	"gitp78su.ipnodns.ru/svi/kern/v4/kc/safe_int"
	"gitp78su.ipnodns.ru/svi/kern/v4/kc/safe_string"
	"gitp78su.ipnodns.ru/svi/kern/v4/krn/kbus/kbus_http"
	"gitp78su.ipnodns.ru/svi/kern/v4/krn/kbus/kbus_http/client_bus_http"
	"gitp78su.ipnodns.ru/svi/kern/v4/krn/kbus/kbus_local"
	"gitp78su.ipnodns.ru/svi/kern/v4/krn/kbus/kbus_local/client_bus_local"
	"gitp78su.ipnodns.ru/svi/kern/v4/krn/kctx"
	"gitp78su.ipnodns.ru/svi/kern/v4/krn/kint"
	"gitp78su.ipnodns.ru/svi/kern/v4/krn/kmodule"
	"gitp78su.ipnodns.ru/svi/kern/v4/krn/kmonolit"
	"gitp78su.ipnodns.ru/svi/kern/v4/krn/kserv_http"
	"gitp78su.ipnodns.ru/svi/kern/v4/krn/kstore_kv"
	. "gitp78su.ipnodns.ru/svi/kern/v4/lev0/kalias"
	. "gitp78su.ipnodns.ru/svi/kern/v4/lev0/ktypes"
	"gitp78su.ipnodns.ru/svi/kern/v4/lev1/helpers"
	. "gitp78su.ipnodns.ru/svi/kern/v4/lev1/helpers"
	"gitp78su.ipnodns.ru/svi/kern/v4/lev1/local_ctx"
	. "gitp78su.ipnodns.ru/svi/kern/v4/lev1/option"
	. "gitp78su.ipnodns.ru/svi/kern/v4/lev1/result"
	"gitp78su.ipnodns.ru/svi/kern/v4/lev1/safe_bool"
	"gitp78su.ipnodns.ru/svi/kern/v4/mds/mod_kctx"
	"gitp78su.ipnodns.ru/svi/kern/v4/mds/mod_keeper"
	"gitp78su.ipnodns.ru/svi/kern/v4/mds/mod_serv_http"
	"gitp78su.ipnodns.ru/svi/kern/v4/mds/mod_wui"
)

// GetKernelCtx -- возвращает контекст ядра
func GetKernelCtx() IKernelCtx {
	ctx := kctx.GetKernelCtx()
	return ctx
}

// GetKernelStoreKv -- возвращает быстрое key-value хранилище ядра
func GetKernelStoreKv() IKernelStoreKv {
	store := kstore_kv.GetKernelStore()
	return store
}

// GetKernelServerHttp -- возвращает веб-сервер ядра
func GetKernelServerHttp() IResult[IKernelServerHttp] {
	kernServHttp := kserv_http.GetKernelServHttp()
	return kernServHttp
}

// NewSafeBool -- возвращает новый потокобезопасный булевый признак
func NewSafeBool() ISafeBool {
	sb := safe_bool.NewSafeBool()
	return sb
}

// GetKernelBusLocal -- возвращает локальную шину данных
func GetKernelBusLocal() IKernelBus {
	ctx := kctx.GetKernelCtx()
	ctx.Set("monolitName", "unknown monolit", "GetKernelBusLocal()")
	bus := kbus_local.GetKernelBusLocal()
	return bus
}

// GetKernelBusHttp -- возвращает HTTP шину данных
func GetKernelBusHttp() IResult[IKernelBus] {
	bus := kbus_http.GetKernelBusHttp()
	return bus
}

// GetMonolitLocal -- возвращает монолит с локальной шиной
func GetMonolitLocal(name string) IResult[IKernelMonolit] {
	ctx := kctx.GetKernelCtx()
	ctx.Set("isLocal", true, "bus type")
	for {
		SleepMs()
		if ctx.Get("isLocal") != nil {
			break
		}
	}
	res := kmonolit.GetMonolit(name)
	if res.IsErr() {
		err := fmt.Errorf("GetMonolitLocal(): err=\n\t%w", res.Err())
		return NewErr[IKernelMonolit](err)
	}
	_ = kbus_local.GetKernelBusLocal()
	return NewRes(IKernelMonolit(res.Val()))
}

// GetMonolitHttp -- возвращает монолит с локальной шиной поверх HTTP
func GetMonolitHttp(name string) IResult[IKernelMonolit] {
	ctx := kctx.GetKernelCtx()
	_ = kbus_http.GetKernelBusHttp()
	ctx.Set("isLocal", false, "bus type")
	for {
		SleepMs()
		if ctx.Get("isLocal") != nil {
			break
		}
	}
	res := kmonolit.GetMonolit(name)
	if res.IsErr() {
		err := fmt.Errorf("GetMonolitHttp(): err=\n\t%w", res.Err())
		return NewErr[IKernelMonolit](err)
	}
	return NewRes(IKernelMonolit(res.Val()))
}

// NewKernelModule -- возвращает новый модуль на ядре
func NewKernelModule(name AModuleName) IResult[IKernelModule] {
	resMod := kmodule.NewKernelModule(name)
	return resMod
}

// NewClientBusLocal -- возвращает клиент для работы с локальной шиной
func NewClientBusLocal() IBusClient {
	client := client_bus_local.NewClientBusLocal()
	return client
}

// NewClientBusHttp -- возвращает клиент для работы с шиной поверх HTTP
func NewClientBusHttp(url string) IResult[IBusClient] {
	client := client_bus_http.NewClientBusHttp(url)
	return client
}

// GetModuleServHttp -- возвращает модуль для IKernelServHttp
func GetModuleServHttp() IResult[IKernelModule] {
	resHttp := mod_serv_http.GetModuleServHttp()
	if resHttp.IsErr() {
		err := fmt.Errorf("GetModuleServHttp(): err=\n\t%w", resHttp.Err())
		return NewErr[IKernelModule](err)
	}
	modServHttp := resHttp.Val()
	return NewRes(IKernelModule(modServHttp))
}

// GetModuleKernelCtx -- возвращает модуль для IKernelCtx
func GetModuleKernelCtx() IResult[IKernelModule] {
	resMod := mod_kctx.GetModuleKernelCtx()
	if resMod.IsErr() {
		err := fmt.Errorf("GetModuleKernelCtx(): err=\n\t%w", resMod.Err())
		return NewErr[IKernelModule](err)
	}
	mod := resMod.Val()
	return NewRes(IKernelModule(mod))
}

// GetModuleKernelKeeper -- возвращает модуль для IKernelKeeper
func GetModuleKernelKeeper() IResult[IKernelModule] {
	resKeeper := mod_keeper.GetModuleKeeper()
	if resKeeper.IsErr() {
		err := fmt.Errorf("GetModuleKernelKeeper(): err=\n\t%w", resKeeper.Err())
		return NewErr[IKernelModule](err)
	}
	modKernelKeeper := resKeeper.Val()
	return NewRes(IKernelModule(modKernelKeeper))
}

// GetModuleWui -- возвращает модуль для WUI
func GetModuleWui() IResult[IKernelModule] {
	resMod := mod_wui.GetModuleWui()
	if resMod.IsErr() {
		err := fmt.Errorf("GetModuleWui(): err=\n\t%w", resMod.Err())
		return NewErr[IKernelModule](err)
	}
	modWui := resMod.Val()
	return NewRes(IKernelModule(modWui))
}

// NewLogBuf -- возвращает новый буферизованный лог
func NewLogBuf(opts ...log_buf.OptionLogBuf) ILogBuf {
	log := log_buf.NewLogBuf(opts...)
	return log
}

// NewSafeBoolReact -- возвращает новую потокобезопасную реактивную булеву переменную
func NewSafeBoolReact() ISafeBoolReact {
	val := safe_bool_react.NewSafeBoolReact()
	return val
}

// NewSafeInt -- возвращает новую потокобезопасную целочисленную переменную
func NewSafeInt(val int) ISafeInt {
	val_ := safe_int.NewSafeInt(val)
	return val_
}

// NewInt -- возвращает новую целочисленную переменную
func NewInt(val int) Int {
	val_ := kint.NewInt(val)
	return val_
}

// NewLocalCtx -- возвращает новый локальный контекст
func NewLocalCtx(ctx context.Context) ILocalCtx {
	ctx_ := local_ctx.NewLocalCtx(ctx)
	return ctx_
}

// NewSafeString -- возвращает новую потокобезопасную строку
func NewSafeString() ISafeString {
	str := safe_string.NewSafeString()
	return str
}

// MakeOk -- возвращает новый положительный результат операции
func MakeOk[T any](res T) IResult[T] {
	return NewRes(res)
}

// MakeErr -- возвращает новую ошибку результат операции
func MakeErr[T any](err error) IResult[T] {
	return NewErr[T](err)
}

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

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

// GetFnHassert -- возвращает ссылку на функцию Hassert
func GetFnHassert() helpers.FnHassert {
	return helpers.Hassert
}

// GetFnAssert -- возвращает ссылку на функцию Hassert
func GetFnAssert() helpers.FnAssert {
	return helpers.Assert
}