Files
atomctl/pkg/utils/generator/template_funcs.go
Rogee e1f83ae469 feat: 重构 pkg/ast/provider 模块,优化代码组织逻辑和功能实现
## 主要改进

### 架构重构
- 将单体 provider.go 拆分为多个专门的模块文件
- 实现了清晰的职责分离和模块化设计
- 遵循 SOLID 原则,提高代码可维护性

### 新增功能
- **验证规则系统**: 实现了完整的 provider 验证框架
- **报告生成器**: 支持多种格式的验证报告 (JSON/HTML/Markdown/Text)
- **解析器优化**: 重新设计了解析流程,提高性能和可扩展性
- **错误处理**: 增强了错误处理和诊断能力

### 修复关键 Bug
- 修复 @provider(job) 注解缺失 __job 注入参数的问题
- 统一了 job 和 cronjob 模式的处理逻辑
- 确保了 provider 生成的正确性和一致性

### 代码质量提升
- 添加了完整的测试套件
- 引入了 golangci-lint 代码质量检查
- 优化了代码格式和结构
- 增加了详细的文档和规范

### 文件结构优化
```
pkg/ast/provider/
├── types.go              # 类型定义
├── parser.go             # 解析器实现
├── validator.go          # 验证规则
├── report_generator.go   # 报告生成
├── renderer.go           # 渲染器
├── comment_parser.go     # 注解解析
├── modes.go             # 模式定义
├── errors.go            # 错误处理
└── validator_test.go    # 测试文件
```

### 兼容性
- 保持向后兼容性
- 支持现有的所有 provider 模式
- 优化了 API 设计和用户体验

This completes the implementation of T025-T029 tasks following TDD principles,
including validation rules implementation and critical bug fixes.
2025-09-19 18:58:30 +08:00

127 lines
3.4 KiB
Go

package generator
import (
"fmt"
"strconv"
"strings"
)
// Stringify returns a string that is all of the enum value names concatenated without a separator
func Stringify(e Enum, forceLower bool) (ret string, err error) {
for _, val := range e.Values {
if val.Name != skipHolder {
next := val.RawName
if forceLower {
next = strings.ToLower(next)
}
ret = ret + next
}
}
return ret, err
}
// Mapify returns a map that is all of the indexes for a string value lookup
func Mapify(e Enum) (ret string, err error) {
strName := fmt.Sprintf(`_%sName`, e.Name)
ret = fmt.Sprintf("map[%s]string{\n", e.Name)
index := 0
for _, val := range e.Values {
if val.Name != skipHolder {
nextIndex := index + len(val.Name)
ret = fmt.Sprintf("%s%s: %s[%d:%d],\n", ret, val.PrefixedName, strName, index, nextIndex)
index = nextIndex
}
}
ret = ret + `}`
return ret, err
}
// Unmapify returns a map that is all of the indexes for a string value lookup
func Unmapify(e Enum, lowercase bool) (ret string, err error) {
if e.Type == "string" {
return UnmapifyStringEnum(e, lowercase)
}
strName := fmt.Sprintf(`_%sName`, e.Name)
ret = fmt.Sprintf("map[string]%s{\n", e.Name)
index := 0
for _, val := range e.Values {
if val.Name != skipHolder {
nextIndex := index + len(val.Name)
ret = fmt.Sprintf("%s%s[%d:%d]: %s,\n", ret, strName, index, nextIndex, val.PrefixedName)
if lowercase {
ret = fmt.Sprintf("%sstrings.ToLower(%s[%d:%d]): %s,\n", ret, strName, index, nextIndex, val.PrefixedName)
}
index = nextIndex
}
}
ret = ret + `}`
return ret, err
}
// Unmapify returns a map that is all of the indexes for a string value lookup
func UnmapifyStringEnum(e Enum, lowercase bool) (ret string, err error) {
var builder strings.Builder
_, err = builder.WriteString("map[string]" + e.Name + "{\n")
if err != nil {
return ret, err
}
for _, val := range e.Values {
if val.Name != skipHolder {
_, err = builder.WriteString(fmt.Sprintf("%q:%s,\n", val.ValueStr, val.PrefixedName))
if err != nil {
return ret, err
}
if lowercase && strings.ToLower(val.ValueStr) != val.ValueStr {
_, err = builder.WriteString(fmt.Sprintf("%q:%s,\n", strings.ToLower(val.ValueStr), val.PrefixedName))
if err != nil {
return ret, err
}
}
}
}
builder.WriteByte('}')
ret = builder.String()
return ret, err
}
// Namify returns a slice that is all of the possible names for an enum in a slice
func Namify(e Enum) (ret string, err error) {
if e.Type == "string" {
return namifyStringEnum(e)
}
strName := fmt.Sprintf(`_%sName`, e.Name)
ret = "[]string{\n"
index := 0
for _, val := range e.Values {
if val.Name != skipHolder {
nextIndex := index + len(val.Name)
ret = fmt.Sprintf("%s%s[%d:%d],\n", ret, strName, index, nextIndex)
index = nextIndex
}
}
ret = ret + "}"
return ret, err
}
// Namify returns a slice that is all of the possible names for an enum in a slice
func namifyStringEnum(e Enum) (ret string, err error) {
ret = "[]string{\n"
for _, val := range e.Values {
if val.Name != skipHolder {
ret = fmt.Sprintf("%sstring(%s),\n", ret, val.PrefixedName)
}
}
ret = ret + "}"
return ret, err
}
func Offset(index int, enumType string, val EnumValue) (strResult string) {
if strings.HasPrefix(enumType, "u") {
// Unsigned
return strconv.FormatUint(val.ValueInt.(uint64)-uint64(index), 10)
} else {
// Signed
return strconv.FormatInt(val.ValueInt.(int64)-int64(index), 10)
}
}