增加 encoding 包

Author: FishGoddess

internal/encoding/base64.go

@@ -0,0 +1,31 @@
+// Copyright 2025 FishGoddess. All rights reserved.
+// Use of this source code is governed by a MIT style
+// license that can be found in the LICENSE file.
+
+package encoding
+
+import "encoding/base64"
+
+type encodingBase64 struct{}
+
+func (encodingBase64) Encode(bs []byte) []byte {
+	enc := base64.StdEncoding
+	n := enc.EncodedLen(len(bs))
+	buffer := make([]byte, n)
+	enc.Encode(buffer, bs)
+
+	return buffer[:n]
+}
+
+func (encodingBase64) Decode(bs []byte) ([]byte, error) {
+	enc := base64.StdEncoding
+	n := enc.DecodedLen(len(bs))
+	buffer := make([]byte, n)
+
+	n, err := enc.Decode(buffer, bs)
+	if err != nil {
+		return nil, err
+	}
+
+	return buffer[:n], nil
+}

internal/encoding/base64_test.go

@@ -0,0 +1,18 @@
+// Copyright 2025 FishGoddess. All rights reserved.
+// Use of this source code is governed by a MIT style
+// license that can be found in the LICENSE file.
+
+package encoding
+
+import "testing"
+
+// go test -v -cover -run=^TestBase64$
+func TestBase64(t *testing.T) {
+	testCases := []testCase{
+		{Data: []byte{}, EncodingData: []byte{}},
+		{Data: []byte("Hello World"), EncodingData: []byte("SGVsbG8gV29ybGQ=")},
+		{Data: []byte("你好，世界"), EncodingData: []byte("5L2g5aW977yM5LiW55WM")},
+	}
+
+	testEncoding(t, Base64, testCases)
+}

internal/encoding/encoding.go

@@ -0,0 +1,20 @@
+// Copyright 2025 FishGoddess. All rights reserved.
+// Use of this source code is governed by a MIT style
+// license that can be found in the LICENSE file.
+
+package encoding
+
+var (
+	None   Encoding = encodingNone{}
+	Hex    Encoding = encodingHex{}
+	Base64 Encoding = encodingBase64{}
+)
+
+// Encoding encodes a byte slice to another byte slice in some way and decodes it from the byte slice.
+type Encoding interface {
+	// Encode encodes the byte slice.
+	Encode(bs []byte) []byte
+
+	// Decode decodes the byte slice.
+	Decode(bs []byte) ([]byte, error)
+}

internal/encoding/encoding_test.go

@@ -0,0 +1,36 @@
+// Copyright 2025 FishGoddess. All rights reserved.
+// Use of this source code is governed by a MIT style
+// license that can be found in the LICENSE file.
+
+package encoding
+
+import (
+	"slices"
+	"testing"
+)
+
+type testCase struct {
+	Data         []byte
+	EncodingData []byte
+}
+
+func testEncoding(t *testing.T, encoding Encoding, testCases []testCase) {
+	for _, testCase := range testCases {
+		got := encoding.Encode(testCase.Data)
+		want := testCase.EncodingData
+
+		if !slices.Equal(got, want) {
+			t.Fatalf("got %+v != want %+v", got, want)
+		}
+
+		got, err := encoding.Decode(got)
+		if err != nil {
+			t.Fatal(err)
+		}
+
+		want = testCase.Data
+		if !slices.Equal(got, want) {
+			t.Fatalf("got %+v != want %+v", got, want)
+		}
+	}
+}

internal/encoding/hex.go

@@ -0,0 +1,29 @@
+// Copyright 2025 FishGoddess. All rights reserved.
+// Use of this source code is governed by a MIT style
+// license that can be found in the LICENSE file.
+
+package encoding
+
+import "encoding/hex"
+
+type encodingHex struct{}
+
+func (encodingHex) Encode(bs []byte) []byte {
+	n := hex.EncodedLen(len(bs))
+	buffer := make([]byte, n)
+
+	n = hex.Encode(buffer, bs)
+	return buffer[:n]
+}
+
+func (encodingHex) Decode(bs []byte) ([]byte, error) {
+	n := hex.DecodedLen(len(bs))
+	buffer := make([]byte, n)
+
+	n, err := hex.Decode(buffer, bs)
+	if err != nil {
+		return nil, err
+	}
+
+	return buffer[:n], nil
+}

internal/encoding/hex_test.go

@@ -0,0 +1,18 @@
+// Copyright 2025 FishGoddess. All rights reserved.
+// Use of this source code is governed by a MIT style
+// license that can be found in the LICENSE file.
+
+package encoding
+
+import "testing"
+
+// go test -v -cover -run=^TestHex$
+func TestHex(t *testing.T) {
+	testCases := []testCase{
+		{Data: []byte{}, EncodingData: []byte{}},
+		{Data: []byte("Hello World"), EncodingData: []byte("48656c6c6f20576f726c64")},
+		{Data: []byte("你好，世界"), EncodingData: []byte("e4bda0e5a5bdefbc8ce4b896e7958c")},
+	}
+
+	testEncoding(t, Hex, testCases)
+}

internal/encoding/none.go

@@ -0,0 +1,15 @@
+// Copyright 2025 FishGoddess. All rights reserved.
+// Use of this source code is governed by a MIT style
+// license that can be found in the LICENSE file.
+
+package encoding
+
+type encodingNone struct{}
+
+func (encodingNone) Encode(bs []byte) []byte {
+	return bs
+}
+
+func (encodingNone) Decode(bs []byte) ([]byte, error) {
+	return bs, nil
+}

internal/encoding/none_test.go

@@ -0,0 +1,18 @@
+// Copyright 2025 FishGoddess. All rights reserved.
+// Use of this source code is governed by a MIT style
+// license that can be found in the LICENSE file.
+
+package encoding
+
+import "testing"
+
+// go test -v -cover -run=^TestNone$
+func TestNone(t *testing.T) {
+	testCases := []testCase{
+		{Data: []byte{}, EncodingData: []byte{}},
+		{Data: []byte("Hello World"), EncodingData: []byte("Hello World")},
+		{Data: []byte("你好，世界"), EncodingData: []byte("你好，世界")},
+	}
+
+	testEncoding(t, None, testCases)
+}

internal/padding/padding.go

@@ -11,11 +11,11 @@ var (
 	PKCS7 Padding = paddingPKCS7{}
 )
 
-// Padding will pad a byte slice with some []byte and unpad them with the same []byte.
+// Padding will pad a byte slice with some bytes and unpad them with the same bytes.
 type Padding interface {
-	// Pad pads some []byte to the byte slice.
+	// Pad pads some bytes to the byte slice.
 	Pad(bs []byte, blockSize int) []byte
 
-	// Unpad unpads the []byte from the byte slice.
+	// Unpad unpads the bytes from the byte slice.
 	Unpad(bs []byte, blockSize int) ([]byte, error)
 }