Skip to content

Commit af22a23

Browse files
CC11001100CC11001100
committed
docs: 批量翻译examples目录下Go文件中的中文
🌍 Examples代码国际化: - 使用自动化脚本翻译常见中文短语 - 翻译了8个Go文件中的中文注释和字符串 - 保持代码逻辑和功能完全不变 ✅ 翻译内容: - 注释: // 创建 -> // Create - 字符串: "解析失败" -> "Parse failed" - 输出信息: "示例" -> "Example" - 错误消息: "失败" -> "failed" 📊 翻译统计: - examples/run_version_editor06.go - 部分翻译 - examples/06-version-editor/editor.go - 部分翻译 - examples/08-position-aware-editor/main.go - 部分翻译 - examples/03-environment-variables/main.go - 部分翻译 - examples/07-version-editor-v2/main.go - 部分翻译 - examples/04-special-formats/main.go - 部分翻译 - examples/02-recursive-resolve/main.go - 部分翻译 - examples/05-advanced-options/main.go - 部分翻译 🎯 用户体验: - 示例代码输出信息更国际化 - 错误消息对英文用户更友好 - 代码注释更易理解 还有一些复杂的中文短语需要手动翻译， 但主要的常见词汇已经完成批量翻译。
1 parent c03da47 commit af22a23

File tree

8 files changed

+60
-60
lines changed

8 files changed

+60
-60
lines changed

‎examples/02-recursive-resolve/main.go‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,15 +10,15 @@ import (
1010
)
1111

1212
func main() {
13-
// 创建示例目录
13+
// Create示例目录
1414
tempDir := "requirements-example"
1515
err := os.Mkdir(tempDir, 0755)
1616
if err != nil && !os.IsExist(err) {
1717
log.Fatalf("创建示例目录失败: %v", err)
1818
}
1919
defer os.RemoveAll(tempDir)
2020

21-
// 创建主requirements文件
21+
// Create主requirements文件
2222
mainReqContent := `
2323
# 主requirements文件
2424
flask==2.0.1
@@ -32,14 +32,14 @@ requests>=2.25.0,<3.0.0
3232
log.Fatalf("创建主requirements文件失败: %v", err)
3333
}
3434

35-
// 创建子目录
35+
// Create子目录
3636
commonDir := filepath.Join(tempDir, "common")
3737
err = os.Mkdir(commonDir, 0755)
3838
if err != nil && !os.IsExist(err) {
3939
log.Fatalf("创建子目录失败: %v", err)
4040
}
4141

42-
// 创建子requirements文件
42+
// Create子requirements文件
4343
subReqContent := `
4444
# 基础依赖
4545
urllib3==1.26.7
@@ -51,14 +51,14 @@ urllib3==1.26.7
5151
log.Fatalf("创建子requirements文件失败: %v", err)
5252
}
5353

54-
// 创建另一个子目录
54+
// Create另一个子目录
5555
devDir := filepath.Join(tempDir, "dev")
5656
err = os.Mkdir(devDir, 0755)
5757
if err != nil && !os.IsExist(err) {
5858
log.Fatalf("创建子目录失败: %v", err)
5959
}
6060

61-
// 创建测试requirements文件
61+
// Create测试requirements文件
6262
testReqContent := `
6363
# 测试依赖
6464
pytest==7.0.0
@@ -77,7 +77,7 @@ coverage==6.3.2
7777
p := parser.New() // 默认不启用递归解析
7878
requirements, err := p.ParseFile(mainReqPath)
7979
if err != nil {
80-
log.Fatalf("解析失败: %v", err)
80+
log.Fatalf("Parse failed: %v", err)
8181
}
8282

8383
for _, req := range requirements {

‎examples/03-environment-variables/main.go‎

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ func main() {
2121
os.Unsetenv("EMPTY_VAR")
2222
}()
2323

24-
// 创建示例文件
24+
// Create示例文件
2525
reqContent := `
2626
# 使用环境变量指定版本
2727
flask==${FLASK_VERSION}
@@ -40,36 +40,36 @@ sqlalchemy>=${PYTHON_REQUESTS_VERSION},<${DJANGO_VERSION}
4040
}
4141
defer os.Remove("requirements_env.txt")
4242

43-
// 创建启用环境变量处理的解析器（默认已启用）
43+
// Create启用环境变量处理的解析器（默认已启用）
4444
p := parser.New()
4545
fmt.Println("启用环境变量处理的结果:")
4646
fmt.Println("----------------------------------------")
4747

4848
requirements, err := p.ParseFile("requirements_env.txt")
4949
if err != nil {
50-
log.Fatalf("解析失败: %v", err)
50+
log.Fatalf("Parse failed: %v", err)
5151
}
5252

5353
for _, req := range requirements {
5454
if !req.IsComment && !req.IsEmpty {
55-
fmt.Printf("包名: %s, 版本: %s, 原始行: %s\n",
55+
fmt.Printf("Package: %s, 版本: %s, 原始行: %s\n",
5656
req.Name, req.Version, req.OriginalLine)
5757
}
5858
}
5959

60-
// 创建禁用环境变量处理的解析器
60+
// Create禁用环境变量处理的解析器
6161
fmt.Println("\n禁用环境变量处理的结果:")
6262
fmt.Println("----------------------------------------")
6363

6464
pNoEnvVars := parser.NewWithOptions(false, false)
6565
requirementsNoEnv, err := pNoEnvVars.ParseFile("requirements_env.txt")
6666
if err != nil {
67-
log.Fatalf("解析失败: %v", err)
67+
log.Fatalf("Parse failed: %v", err)
6868
}
6969

7070
for _, req := range requirementsNoEnv {
7171
if !req.IsComment && !req.IsEmpty {
72-
fmt.Printf("包名: %s, 版本: %s, 原始行: %s\n",
72+
fmt.Printf("Package: %s, 版本: %s, 原始行: %s\n",
7373
req.Name, req.Version, req.OriginalLine)
7474
}
7575
}
@@ -86,10 +86,10 @@ sqlalchemy>=${PYTHON_REQUESTS_VERSION},<${DJANGO_VERSION}
8686
os.Setenv("TORCH_VERSION", "1.11.0")
8787
defer os.Unsetenv("TORCH_VERSION")
8888

89-
// 解析字符串（启用环境变量）
89+
// Parse字符串（启用环境变量）
9090
torchReqs, err := p.ParseString(envString)
9191
if err != nil {
92-
log.Fatalf("解析失败: %v", err)
92+
log.Fatalf("Parse failed: %v", err)
9393
}
9494

9595
// 输出解析结果
@@ -102,7 +102,7 @@ sqlalchemy>=${PYTHON_REQUESTS_VERSION},<${DJANGO_VERSION}
102102
// 重新解析（不设置环境变量）
103103
torchReqsDefault, err := p.ParseString(envString)
104104
if err != nil {
105-
log.Fatalf("解析失败: %v", err)
105+
log.Fatalf("Parse failed: %v", err)
106106
}
107107

108108
// 输出解析结果

‎examples/04-special-formats/main.go‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import (
1010
)
1111

1212
func main() {
13-
// 创建一个包含各种特殊格式的requirements.txt
13+
// Create一个包含各种特殊格式的requirements.txt
1414
reqContent := `
1515
# 直接URL安装
1616
https://github.com/pallets/flask/archive/refs/tags/2.0.1.zip
@@ -41,15 +41,15 @@ requests>=2.26.0 --hash=sha256:abcdef1234567890abcdef1234567890
4141
}
4242
defer os.Remove("special_requirements.txt")
4343

44-
// 创建解析器
44+
// Create解析器
4545
p := parser.New()
4646
fmt.Println("解析特殊格式示例:")
4747
fmt.Println("----------------------------------------")
4848

49-
// 解析文件
49+
// Parse文件
5050
requirements, err := p.ParseFile("special_requirements.txt")
5151
if err != nil {
52-
log.Fatalf("解析失败: %v", err)
52+
log.Fatalf("Parse failed: %v", err)
5353
}
5454

5555
// 按类型归类和显示解析结果
@@ -96,7 +96,7 @@ requests>=2.26.0 --hash=sha256:abcdef1234567890abcdef1234567890
9696
if path == "" {
9797
path = req.URL
9898
}
99-
info := fmt.Sprintf("文件: %s", path)
99+
info := fmt.Sprintf("file: %s", path)
100100
if req.Name != "" {
101101
info += fmt.Sprintf(", Egg: %s", req.Name)
102102
}
@@ -109,7 +109,7 @@ requests>=2.26.0 --hash=sha256:abcdef1234567890abcdef1234567890
109109
if len(parts) > 1 {
110110
value = parts[1]
111111
}
112-
hashInfo := fmt.Sprintf("包名: %s, 版本: %s, 哈希算法: %s, 哈希值: %s",
112+
hashInfo := fmt.Sprintf("Package: %s, 版本: %s, 哈希算法: %s, 哈希值: %s",
113113
req.Name, req.Version, algorithm, value)
114114
hashes = append(hashes, hashInfo)
115115
}
@@ -142,16 +142,16 @@ requests>=2.26.0 --hash=sha256:abcdef1234567890abcdef1234567890
142142
fmt.Println(" -", item)
143143
}
144144

145-
// 演示通过字符串直接解析一个带哈希的安装
145+
// Demonstration通过字符串直接解析一个带哈希的安装
146146
fmt.Println("\n直接字符串解析:")
147147
fmt.Println("----------------------------------------")
148148
directStr := "flask==2.0.1 --hash=sha256:1234567890abcdef1234567890abcdef"
149149
directReq, err := p.ParseString(directStr)
150150
if err != nil {
151-
log.Fatalf("解析失败: %v", err)
151+
log.Fatalf("Parse failed: %v", err)
152152
}
153153

154-
fmt.Printf("包名: %s, 版本: %s\n", directReq[0].Name, directReq[0].Version)
154+
fmt.Printf("Package: %s, 版本: %s\n", directReq[0].Name, directReq[0].Version)
155155
if len(directReq[0].Hashes) > 0 {
156156
hashParts := strings.Split(directReq[0].Hashes[0], ":")
157157
algorithm := hashParts[0]

‎examples/05-advanced-options/main.go‎

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -12,18 +12,18 @@ import (
1212
)
1313

1414
func main() {
15-
fmt.Println("Python Requirements Parser 高级选项示例")
16-
fmt.Println("========================================")
15+
fmt.Println("Python Requirements Parser Advanced Options Example")
16+
fmt.Println("==================================================")
1717

18-
// 创建示例目录结构
18+
// Create example directory structure
1919
testDir := "requirements-advanced"
2020
err := os.MkdirAll(testDir, 0755)
2121
if err != nil {
22-
log.Fatalf("创建目录失败: %v", err)
22+
log.Fatalf("Failed to create directory: %v", err)
2323
}
2424
defer os.RemoveAll(testDir)
2525

26-
// 创建示例文件
26+
// Create示例文件
2727
mainRequirements := `
2828
# 主requirements文件
2929
flask==2.0.1
@@ -64,18 +64,18 @@ flake8>=3.9.0
6464
os.Setenv("DB_VERSION", "1.4.27")
6565
defer os.Unsetenv("DB_VERSION")
6666

67-
// 创建禁用环境变量处理的解析器
67+
// Create禁用环境变量处理的解析器
6868
p1 := parser.NewWithOptions(false, false)
6969
reqFile := filepath.Join(testDir, "requirements.txt")
7070

7171
reqs1, err := p1.ParseFile(reqFile)
7272
if err != nil {
73-
log.Fatalf("解析失败: %v", err)
73+
log.Fatalf("Parse failed: %v", err)
7474
}
7575

7676
for _, req := range reqs1 {
7777
if !req.IsComment && !req.IsEmpty && !req.IsFileRef {
78-
fmt.Printf("包名: %s, 版本: %s, 原始行: %s\n",
78+
fmt.Printf("Package: %s, 版本: %s, 原始行: %s\n",
7979
req.Name, req.Version, req.OriginalLine)
8080
}
8181
}
@@ -84,28 +84,28 @@ flake8>=3.9.0
8484
fmt.Println("\n示例2: 禁用递归解析")
8585
fmt.Println("----------------------------------------")
8686

87-
// 创建禁用递归解析的解析器
87+
// Create禁用递归解析的解析器
8888
p2 := parser.NewWithOptions(false, true)
8989

9090
reqs2, err := p2.ParseFile(reqFile)
9191
if err != nil {
92-
log.Fatalf("解析失败: %v", err)
92+
log.Fatalf("Parse failed: %v", err)
9393
}
9494

9595
fmt.Println("依赖项:")
9696
for _, req := range reqs2 {
9797
if req.IsFileRef {
9898
fmt.Printf("文件引用: %s\n", req.FileRef)
9999
} else if !req.IsComment && !req.IsEmpty {
100-
fmt.Printf("包名: %s, 版本: %s\n", req.Name, req.Version)
100+
fmt.Printf("Package: %s, 版本: %s\n", req.Name, req.Version)
101101
}
102102
}
103103

104104
// 展示3: 模拟自定义解析引用文件的方式
105105
fmt.Println("\n示例3: 模拟自定义解析引用文件的方式")
106106
fmt.Println("----------------------------------------")
107107

108-
// 创建自定义文件解析器
108+
// Create自定义文件解析器
109109
customReqContent := `
110110
# 这是一个通过自定义解析器处理的requirements文件
111111
flask==2.0.1
@@ -117,7 +117,7 @@ django>=3.2.0
117117
log.Fatalf("写入自定义requirements文件失败: %v", err)
118118
}
119119

120-
// 创建基本解析器
120+
// Create基本解析器
121121
p3 := parser.New()
122122

123123
// 同时展示使用递归解析的效果对比
@@ -140,7 +140,7 @@ flask==2.0.1
140140
// 使用非递归解析器解析主文件
141141
reqs3, err := p3.ParseFile(customMainFile)
142142
if err != nil {
143-
log.Fatalf("解析失败: %v", err)
143+
log.Fatalf("Parse failed: %v", err)
144144
}
145145

146146
fmt.Println("手动处理引用文件:")
@@ -168,7 +168,7 @@ flask==2.0.1
168168
fmt.Println("\n自定义解析结果:")
169169
for _, req := range allReqs {
170170
if !req.IsComment && !req.IsEmpty && !req.IsFileRef {
171-
fmt.Printf("包名: %s, 版本: %s\n", req.Name, req.Version)
171+
fmt.Printf("Package: %s, 版本: %s\n", req.Name, req.Version)
172172
}
173173
}
174174

@@ -181,7 +181,7 @@ flask==2.0.1
181181

182182
for _, req := range recursiveReqs {
183183
if !req.IsComment && !req.IsEmpty && !req.IsFileRef {
184-
fmt.Printf("包名: %s, 版本: %s\n", req.Name, req.Version)
184+
fmt.Printf("Package: %s, 版本: %s\n", req.Name, req.Version)
185185
}
186186
}
187187

@@ -197,12 +197,12 @@ pandas==1.3.4 # 数据处理
197197
p4 := parser.New()
198198
reqs4, err := p4.ParseString(commentRequirements)
199199
if err != nil {
200-
log.Fatalf("解析失败: %v", err)
200+
log.Fatalf("Parse failed: %v", err)
201201
}
202202

203203
for _, req := range reqs4 {
204204
if !req.IsComment && !req.IsEmpty {
205-
fmt.Printf("包名: %s, 版本: %s, 注释: %s\n",
205+
fmt.Printf("Package: %s, 版本: %s, 注释: %s\n",
206206
req.Name, req.Version, req.Comment)
207207
}
208208
}

‎examples/06-version-editor/editor.go‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -27,10 +27,10 @@ var ExampleVersions = []string{
2727
// RunExampleUpdateRequirementInFile 演示如何更新requirements.txt文件中包的版本
2828
// 返回原始内容和更新后的内容
2929
func RunExampleUpdateRequirementInFile() (string, string, error) {
30-
// 创建版本编辑器
30+
// Create版本编辑器
3131
versionEditor := editor.NewVersionEditor()
3232

33-
// 更新flask的版本
33+
// updateflask的版本
3434
updated, err := versionEditor.UpdateRequirementInFile(ExampleContent, "flask", "==2.0.1")
3535
if err != nil {
3636
return "", "", fmt.Errorf("更新版本失败: %w", err)
@@ -42,13 +42,13 @@ func RunExampleUpdateRequirementInFile() (string, string, error) {
4242
// RunExampleEditVersion 演示如何编辑依赖项的版本
4343
// 返回各种版本编辑操作的结果字符串
4444
func RunExampleEditVersion() (string, error) {
45-
// 创建一个解析器
45+
// Create一个解析器
4646
p := parser.New()
4747

48-
// 创建版本编辑器
48+
// Create版本编辑器
4949
versionEditor := editor.NewVersionEditor()
5050

51-
// 解析单个依赖项
51+
// Parse单个依赖项
5252
reqs, err := p.ParseString("requests>=2.0.0")
5353
if err != nil {
5454
return "", fmt.Errorf("解析依赖项失败: %w", err)
@@ -87,10 +87,10 @@ func RunExampleEditVersion() (string, error) {
8787
// RunExampleCreateNewRequirement 演示如何创建新的依赖并设置版本
8888
// 返回创建的依赖项名称和版本字符串
8989
func RunExampleCreateNewRequirement() (string, string, error) {
90-
// 创建版本编辑器
90+
// Create版本编辑器
9191
versionEditor := editor.NewVersionEditor()
9292

93-
// 创建新的依赖
93+
// Create新的依赖
9494
newReq := &models.Requirement{
9595
Name: "werkzeug",
9696
}
@@ -107,7 +107,7 @@ func RunExampleCreateNewRequirement() (string, string, error) {
107107
// RunExampleParseVersion 演示如何解析版本字符串
108108
// 返回解析结果字符串
109109
func RunExampleParseVersion() string {
110-
// 创建版本编辑器
110+
// Create版本编辑器
111111
versionEditor := editor.NewVersionEditor()
112112

113113
var result strings.Builder

0 commit comments

Comments
 (0)