feat: 添加本地化错误信息

Author: caixw

.github/workflows/go.yml

@@ -10,7 +10,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macOS-latest, windows-latest]
-        go: ['1.21.x', '1.24.x']
+        go: ['1.23.x', '1.24.x']
 
     steps:
 

go.mod

@@ -2,7 +2,10 @@ module github.com/issue9/upload/v3
 
 require (
 	github.com/issue9/assert/v4 v4.3.1
+	github.com/issue9/localeutil v0.29.4
 	github.com/issue9/watermark v1.2.5
 )
 
-go 1.21
+require golang.org/x/text v0.24.0 // indirect
+
+go 1.23.0

go.sum

@@ -1,4 +1,8 @@
 github.com/issue9/assert/v4 v4.3.1 h1:dHYODk1yV7j/1baIB6K6UggI4r1Hfuljqic7PaDbwLg=
 github.com/issue9/assert/v4 v4.3.1/go.mod h1:v7qDRXi7AsaZZNh8eAK2rkLJg5/clztqQGA1DRv9Lv4=
+github.com/issue9/localeutil v0.29.4 h1:VT8t64q1d7Ui1yCF6rfSI6Uibo/4v4HMtyT3n2yp6XI=
+github.com/issue9/localeutil v0.29.4/go.mod h1:k5nHeIIwmuQDil8ZF1dCCKn7pKEZmqe/6wCvBiunJis=
 github.com/issue9/watermark v1.2.5 h1:mdZp+eSpj6ezyv+v36j1jDmQVbwaOcDPtv4657CPgak=
 github.com/issue9/watermark v1.2.5/go.mod h1:RRhdNANxa6cmEMOZjEoaH7C5aChuBGBBrG/MCbPv8R8=
+golang.org/x/text v0.24.0 h1:dd5Bzh4yt5KYA8f9CJHCP4FB4D51c2c6JvN37xJJkJ0=
+golang.org/x/text v0.24.0/go.mod h1:L8rBsPeo2pSS+xqN0d5u2ikmjtmoJbDBT1b7nHvFCdU=

locales/und.yaml

@@ -0,0 +1,12 @@
+languages:
+    - und
+messages:
+    - key: no upload file
+      message:
+        msg: no upload file
+    - key: not allow extension
+      message:
+        msg: not allow extension
+    - key: the upload file is too large
+      message:
+        msg: the upload file is too large

locales/zh.yaml

@@ -0,0 +1,14 @@
+languages:
+    - cmn-Hans
+    - zh-Hans
+    - zh-CN
+messages:
+    - key: no upload file
+      message:
+        msg: 没有上传文件
+    - key: not allow extension
+      message:
+        msg: 不允许的上传文件类型
+    - key: the upload file is too large
+      message:
+        msg: 上传的文件过大

save.go

@@ -53,7 +53,7 @@ const (
 
 type localSaver struct {
 	fs        fs.FS
-	dir       string
+	dir       string // TODO: 采用 [os.Root]，需要 os.Root 实现 MkdirAll。
 	baseURL   string
 	format    string
 	filenames func(dir, filename, ext string) string

upload.go

@@ -2,10 +2,12 @@
 //
 // SPDX-License-Identifier: MIT
 
+//go:generate web locale -l=und -m -f=yaml ./
+//go:generate web update-locale -src=./locales/und.yaml -dest=./locales/zh.yaml
+
 package upload
 
 import (
-	"errors"
 	"io"
 	"io/fs"
 	"mime/multipart"
@@ -15,14 +17,15 @@ import (
 	"strings"
 	"sync"
 
+	"github.com/issue9/localeutil"
 	"github.com/issue9/watermark"
 )
 
 // 常用错误类型
 var (
-	errNotAllowExt  = errors.New("不允许的文件上传类型")
-	errNotAllowSize = errors.New("文件上传大小超过最大设定值")
-	errNoUploadFile = errors.New("客户端没有上传文件")
+	errNotAllowExt  = localeutil.Error("not allow extension")
+	errNotAllowSize = localeutil.Error("the upload file is too large")
+	errNoUploadFile = localeutil.Error("no upload file")
 )
 
 // Upload 用于处理文件上传