메뉴
Loads JSON locale files into a nested key-tree with lookup, {placeholder} formatting, JSON serving, language-tag normalization, and Go-struct codegen. Use for any i18n/localization instead of hand-rolled JSON locale loading.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | goyacodedevutils-yalocales |
| description | Loads JSON locale files into a nested key-tree with lookup, {placeholder} formatting, JSON serving, language-tag normalization, and Go-struct codegen. Use for any i18n/localization instead of hand-rolled JSON locale loading. |
Import path: github.com/YaCodeDev/GoYaCodeDevUtils/yalocales.
Loads JSON locale files from an fs.FS into a nested key-tree, exposing lookup, {placeholder} formatting,
JSON serving, language-tag normalization, and Go-struct codegen for compile-time-safe key access.
Localizer interface — LoadLocales(fs.FS), GetDefaultLangValueByCompositeKey, GetValueByCompositeKeyAndLang, GetFormattedValueByCompositeKeyAndLang, GetJSONByCompositeKeyAndLang/GetDefaultLangJSONByCompositeKey, DeriveNewDefaultLang(newLang) (Localizer, error).NewLocalizer(fallbackLang string, enforceLocaleConsistency bool) Localizer.NewYaLocalizer(...) *YaLocalizer — concrete type; also has GenerateLocaleCode/HelperRepresentLocaleAsStruct for Go codegen and GetSupportedLanguages.SupportedLanguage struct — { Code, Emoji, Label }; LoadSupportedLanguages(fs.FS) ([]SupportedLanguage, error).IsSupportedLanguage/LookupSupportedLanguage/NormalizeLanguageTag/SupportedLanguageCodes helpers.const Separator = "." (composite key delimiter).ErrInvalidLanguage, ErrMismatchedKeys, ErrMismatchedPlaceholders, and other Err* vars.LoadLocales enforces strict cross-language consistency: every language must have identical key sets and identical {placeholder} sets per key, or loading fails — this catches missing translations at startup."." to address nested JSON (e.g. "greeting.hello"); locale files are one JSON file per language, optionally nested in subfolders (the folder path becomes the key prefix).enforceLocaleConsistency = true is required to use DeriveNewDefaultLang (used by yatgbot for per-user language switching). Depends only on yaerrors + golang.org/x/text.LocalizerModule (fx.go) provides Localizer from a supplied LocalizerParams.Index of every GoYaCodeDevUtils utility package (config, errors, logging, caching, rate limiting, backoff, hashing, gzip, RSA, feature flags, FSM, thread-safe collections, locales, Telegram bot stack) with a pointer to each package's own skill. Use before hand-rolling infrastructure code GoYaCodeDevUtils may already provide.
High-level Telegram bot framework on top of gotd/td - router/dispatcher with filters and middleware, FSM-aware routing, per-user localization, sequential-update scheduling, and a message-send queue. Use as the starting point for any Telegram bot.
Thin wrapper around gotd/td's telegram.Client adding background-connect-with-retry, bot-token authorization, updates.Manager wiring, and SOCKS5/MTProto proxy helpers. Use for direct low-level Telegram client control instead of raw gotd/td.
Redis-backed persistence for gotd/td's updates.Manager state (pts/qts/seq/date via RedisJSON) plus channel/user access-hash bookkeeping, and a GORM/AES-encrypted session-storage layer. Use for any yatgclient/yatgbot state or session persistence.
Generic pluggable key-value cache abstraction with interchangeable in-memory and Redis backends, hash-oriented API. Use for any caching/session-store need instead of hand-rolling a map or a bare redis.Client call.
Bidirectional converter between a custom Markdown-like syntax and Telegram (gotd) rich-text MessageEntityClass formatting, with correct UTF-16LE offsets. Use as the ParseMode for any yatgbot/gotd-based bot.