菜单
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 职业分类
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.
| 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.