refactor(internal/locale): 复用 looaleutil 中的部分对象

Author: caixw

core/errors.go

@@ -3,6 +3,7 @@
 package core
 
 import (
+	"github.com/issue9/localeutil"
 	"github.com/issue9/sliceutil"
 	"golang.org/x/text/message"
 
@@ -11,7 +12,7 @@ import (
 
 // HTTPError 表示 HTTP 状态码的错误
 type HTTPError struct {
-	locale.Err
+	error
 	Code int
 }
 
@@ -48,8 +49,8 @@ const (
 // NewHTTPError 声明 HTTPError 实例
 func NewHTTPError(code int, key message.Reference, v ...any) *HTTPError {
 	return &HTTPError{
-		Err:  locale.Err{Key: key, Values: v},
-		Code: code,
+		error: localeutil.Error(key, v...),
+		Code:  code,
 	}
 }
 

docs/example/index.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 
 <?xml-stylesheet type="text/xsl" href="../v6/apidoc.xsl"?>
-<apidoc apidoc="6.1.0" created="2022-08-29T22:44:25+08:00" version="1.1.1">
+<apidoc apidoc="6.1.0" created="2022-08-30T00:29:49+08:00" version="1.1.1">
 	<title>示例文档</title>
 	<description type="html"><![CDATA[
        <p>这是一个用于测试的文档用例</p>

internal/ast/ast.go

@@ -151,9 +151,7 @@ func trimLeftSpace(v string) string {
 	ret := make([]byte, 0, buf.Size())
 	for {
 		line, err := buf.ReadBytes('\n')
-		if bytes.HasPrefix(line, min) {
-			line = line[len(min):]
-		}
+		line = bytes.TrimPrefix(line, min)
 		ret = append(ret, line...)
 
 		if errors.Is(err, io.EOF) {

internal/ast/elements.go

@@ -2,9 +2,7 @@
 
 package ast
 
-import (
-	"github.com/caixw/apidoc/v7/internal/xmlenc"
-)
+import "github.com/caixw/apidoc/v7/internal/xmlenc"
 
 type (
 	// APIDoc 对应 apidoc 元素

internal/ast/elements_test.go

@@ -3,7 +3,7 @@
 package ast
 
 import (
-	"io/ioutil"
+	"os"
 	"strings"
 	"testing"
 
@@ -22,7 +22,7 @@ var (
 )
 
 func loadAPIDoc(a *assert.Assertion) *APIDoc {
-	data, err := ioutil.ReadFile("./testdata/doc.xml")
+	data, err := os.ReadFile("./testdata/doc.xml")
 	a.NotError(err).NotNil(data)
 
 	doc := &APIDoc{}
@@ -311,7 +311,7 @@ func TestAPIDoc(t *testing.T) {
 func TestAPIDoc_all(t *testing.T) {
 	a := assert.New(t, false)
 
-	data, err := ioutil.ReadFile("./testdata/all.xml")
+	data, err := os.ReadFile("./testdata/all.xml")
 	a.NotError(err).NotNil(data)
 	rslt := messagetest.NewMessageHandler()
 	doc := &APIDoc{}
@@ -354,7 +354,7 @@ func TestAPIDoc_all(t *testing.T) {
 func loadAPI(a *assert.Assertion) *API {
 	doc := loadAPIDoc(a)
 
-	data, err := ioutil.ReadFile("./testdata/api.xml")
+	data, err := os.ReadFile("./testdata/api.xml")
 	a.NotError(err).NotNil(data)
 
 	rslt := messagetest.NewMessageHandler()

internal/docs/docs.go

@@ -166,9 +166,8 @@ func errStatus(w http.ResponseWriter, status int) {
 }
 
 func errStatusWithError(w http.ResponseWriter, err error, l *log.Logger) {
-	herr, ok := err.(*core.HTTPError)
-	if ok {
-		http.Error(w, herr.Err.Error(), herr.Code)
+	if herr, ok := err.(*core.HTTPError); ok {
+		http.Error(w, herr.Error(), herr.Code)
 		return
 	}
 

internal/locale/locale.go

@@ -4,6 +4,7 @@
 package locale
 
 import (
+	"github.com/issue9/localeutil"
 	"golang.org/x/text/language"
 	"golang.org/x/text/message"
 )
@@ -22,21 +23,10 @@ var (
 	tags = []language.Tag{}
 )
 
-// Locale 提供缓存本地化信息
-type Locale struct {
-	Key    message.Reference
-	Values []any
-}
-
-// Err 为错误信息提供本地化的缓存机制
-type Err Locale
-
-func (l *Locale) String() string {
-	return Sprintf(l.Key, l.Values...)
-}
+type LocaleStringer = localeutil.LocaleStringer
 
-func (err *Err) Error() string {
-	return (*Locale)(err).String()
+type Error struct {
+	l LocaleStringer
 }
 
 func setMessages(id string, messages map[string]string) {
@@ -57,6 +47,8 @@ func setMessages(id string, messages map[string]string) {
 	}
 }
 
+func (err *Error) Error() string { return err.l.LocaleString(localePrinter) }
+
 // SetTag 切换本地化环境
 func SetTag(tag language.Tag) {
 	tag, _, _ = language.NewMatcher(tags).Match(tag)
@@ -80,14 +72,10 @@ func Sprintf(key message.Reference, v ...any) string {
 }
 
 // New 声明新的 Locale 对象
-func New(key message.Reference, v ...any) *Locale {
-	return &Locale{Key: key, Values: v}
-}
+func New(key message.Reference, v ...any) LocaleStringer { return localeutil.Phrase(key, v...) }
 
 // NewError 返回本地化的错误对象
-func NewError(key message.Reference, v ...any) error {
-	return (*Err)(New(key, v...))
-}
+func NewError(key message.Reference, v ...any) error { return &Error{l: localeutil.Phrase(key, v...)} }
 
 // Translate 功能与 Sprintf 类似，但是可以指定本地化 ID 值。
 func Translate(localeID string, key message.Reference, v ...any) string {

internal/locale/locale_test.go

@@ -9,8 +9,6 @@ import (
 	"golang.org/x/text/language"
 )
 
-var _ error = &Err{}
-
 func TestVarsDefaultLocaleID(t *testing.T) {
 	a := assert.New(t, false)