test: remove unstable test item

release v2.1.20
test: add TestExecCommandWithOption
2026-03-01 00:35:28 +08:00 · 2023-04-26 18:14:27 +08:00 · 2023-04-26 18:03:52 +08:00 · 2023-04-26 17:53:20 +08:00 · 2023-04-26 14:59:45 +08:00 · 2023-04-26 14:31:47 +08:00
27 changed files with 1373 additions and 113 deletions
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
 <br/>

 ![Go version](https://img.shields.io/badge/go-%3E%3Dv1.18-9cf)
-[![Release](https://img.shields.io/badge/release-2.1.19-green.svg)](https://github.com/duke-git/lancet/releases)
+[![Release](https://img.shields.io/badge/release-2.1.20-green.svg)](https://github.com/duke-git/lancet/releases)
 [![GoDoc](https://godoc.org/github.com/duke-git/lancet/v2?status.svg)](https://pkg.go.dev/github.com/duke-git/lancet/v2)
 [![Go Report Card](https://goreportcard.com/badge/github.com/duke-git/lancet/v2)](https://goreportcard.com/report/github.com/duke-git/lancet/v2)
 [![test](https://github.com/duke-git/lancet/actions/workflows/codecov.yml/badge.svg?branch=main&event=push)](https://github.com/duke-git/lancet/actions/workflows/codecov.yml)
@@ -38,7 +38,7 @@ English | [简体中文](./README_zh-CN.md)
 go get github.com/duke-git/lancet/v2 // will install latest version of v2.x.x
 ```

-2. <b>For users who use version below go1.18, you should install v1.x.x. The latest of v1.x.x is v1.3.7. </b>
+2. <b>For users who use version below go1.18, you should install v1.x.x. The latest of v1.x.x is v1.3.8. </b>

 ```go
 go get github.com/duke-git/lancet // below go1.18, install latest version of v1.x.x
@@ -118,7 +118,28 @@ import "github.com/duke-git/lancet/v2/algorithm"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/algorithm.md#LRUCache)]
    [[play](https://go.dev/play/p/-EZjgOURufP)]

-### 2. Concurrency package contain some functions to support concurrent programming. eg, goroutine, channel, async.
+### 2. Compare package provides a lightweight comparison function on any type.
+
+```go
+import "github.com/duke-git/lancet/v2/compare"
+```
+
+#### Function list:
+
+-   **<big>Equal</big>** : Checks if two values are equal or not. (check both type and value)
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/compare.md#Equal)]
+-   **<big>EqualValue</big>** : Checks if two values are equal or not. (check value only)
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/compare.md#EqualValue)]
+-   **<big>LessThan</big>** : Checks if value `left` less than value `right`.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/compare.md#LessThan)]
+-   **<big>GreaterThan</big>** : Checks if value `left` greater than value `right`.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/compare.md#GreaterThan)]
+-   **<big>LessOrEqual</big>** : Checks if value `left` less than or equal than value `right`.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/compare.md#LessOrEqual)]
+-   **<big>GreaterOrEqual</big>** : Checks if value `left` less greater or equal than value `right`.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/compare.md#GreaterOrEqual)]
+
+### 3. Concurrency package contain some functions to support concurrent programming. eg, goroutine, channel, async.

 ```go
 import "github.com/duke-git/lancet/v2/concurrency"
@@ -157,7 +178,7 @@ import "github.com/duke-git/lancet/v2/concurrency"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/concurrency.md#Tee)]
    [[play](https://go.dev/play/p/3TQPKnCirrP)]

-### 3. Condition package contains some functions for conditional judgment. eg. And, Or, TernaryOperator...
+### 4. Condition package contains some functions for conditional judgment. eg. And, Or, TernaryOperator...

 ```go
 import "github.com/duke-git/lancet/v2/condition"
@@ -190,7 +211,7 @@ import "github.com/duke-git/lancet/v2/condition"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/condition.md#TernaryOperator)]
    [[play](https://go.dev/play/p/ElllPZY0guT)]

-### 4. Convertor package contains some functions for data convertion.
+### 5. Convertor package contains some functions for data convertion.

 ```go
 import "github.com/duke-git/lancet/v2/convertor"
@@ -253,7 +274,7 @@ import "github.com/duke-git/lancet/v2/convertor"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/convertor.md#CopyProperties)]
    [[play](https://go.dev/play/p/FOVY3XJL-6B)]

-### 5. Cryptor package is for data encryption and decryption.
+### 6. Cryptor package is for data encryption and decryption.

 ```go
 import "github.com/duke-git/lancet/v2/cryptor"
@@ -357,7 +378,7 @@ import "github.com/duke-git/lancet/v2/cryptor"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/cryptor.md#RsaDecrypt)]
    [[play](https://go.dev/play/p/uef0q1fz53I)]

-### 6. Datetime package supports date and time format and compare.
+### 7. Datetime package supports date and time format and compare.

 ```go
 import "github.com/duke-git/lancet/v2/datetime"
@@ -456,7 +477,7 @@ import "github.com/duke-git/lancet/v2/datetime"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/datetime.md#ToIso8601)]
    [[play](https://go.dev/play/p/mkhOHQkdeA2)]

-### 7. Datastructure package constains some common data structure. eg. list, linklist, stack, queue, set, tree, graph.
+### 8. Datastructure package constains some common data structure. eg. list, linklist, stack, queue, set, tree, graph.

 ```go
 import list "github.com/duke-git/lancet/v2/datastructure/list"
@@ -488,7 +509,7 @@ import hashmap "github.com/duke-git/lancet/v2/datastructure/hashmap"
 -   **<big>Hashmap</big>** : hash map structure.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/datastructure/hashmap.md)]

-### 8. Fileutil package implements some basic functions for file operations.
+### 9. Fileutil package implements some basic functions for file operations.

 ```go
 import "github.com/duke-git/lancet/v2/fileutil"
@@ -544,8 +565,18 @@ import "github.com/duke-git/lancet/v2/fileutil"
 -   **<big>CurrentPath</big>** : return current absolute path.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/fileutil.md#CurrentPath)]
    [[play](https://go.dev/play/p/s74a9iBGcSw)]
+-   **<big>IsZipFile</big>** : checks if file is zip file or not.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/fileutil.md#IsZipFile)]
+-   **<big>FileSize</big>** : return file size in bytes.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/fileutil.md#FileSize)]
+-   **<big>MTime</big>** : return file modified time(unix timestamp).
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/fileutil.md#MTime)]
+-   **<big>Sha</big>** : return file sha value.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/fileutil.md#Sha)]
+-   **<big>ReadCsvFile</big>** : read file content into slice.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/fileutil.md#ReadCsvFile)]

-### 9. Formatter contains some functions for data formatting.
+### 10. Formatter contains some functions for data formatting.

 ```go
 import "github.com/duke-git/lancet/v2/formatter"
@@ -575,7 +606,7 @@ import "github.com/duke-git/lancet/v2/formatter"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/formatter.md#ParseBinaryBytes)]
    [[play](https://go.dev/play/p/69v1tTT62x8)]

-### 10. Function package can control the flow of function execution and support part of functional programming
+### 11. Function package can control the flow of function execution and support part of functional programming

 ```go
 import "github.com/duke-git/lancet/v2/function"
@@ -611,7 +642,7 @@ import "github.com/duke-git/lancet/v2/function"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/function.md#Watcher)]
    [[play](https://go.dev/play/p/l2yrOpCLd1I)]

-### 11. Maputil package includes some functions to manipulate map.
+### 12. Maputil package includes some functions to manipulate map.

 ```go
 import "github.com/duke-git/lancet/v2/maputil"
@@ -683,7 +714,7 @@ import "github.com/duke-git/lancet/v2/maputil"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/maputil.md#IsDisjoint)]
    [[play](https://go.dev/play/p/N9qgYg_Ho6f)]

-### 12. Mathutil package implements some functions for math calculation.
+### 13. Mathutil package implements some functions for math calculation.

 ```go
 import "github.com/duke-git/lancet/v2/mathutil"
@@ -746,7 +777,7 @@ import "github.com/duke-git/lancet/v2/mathutil"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil.md#IsPrime)]
    [[play](https://go.dev/play/p/Rdd8UTHZJ7u)]

-### 13. Netutil package contains functions to get net information and send http request.
+### 14. Netutil package contains functions to get net information and send http request.

 ```go
 import "github.com/duke-git/lancet/v2/netutil"
@@ -808,8 +839,16 @@ import "github.com/duke-git/lancet/v2/netutil"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/netutil.md#HttpPatch)]
 -   **<big>ParseHttpResponse</big>** : decode http response into target object.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/netutil.md#ParseHttpResponse)]
+-   **<big>DownloadFile</big>** : download the file exist in url to a local file.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/netutil.md#DownloadFile)]
+-   **<big>UploadFile</big>** : upload the file to a server.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/netutil.md#UploadFile)]
+-   **<big>IsPingConnected</big>** : checks if can ping the specified host or not.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/netutil.md#IsPingConnected)]
+-   **<big>IsTelnetConnected</big>** : checks if can if can telnet the specified host or not.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/netutil.md#IsTelnetConnected)]

-### 14. Random package implements some basic functions to generate random int and string.
+### 15. Random package implements some basic functions to generate random int and string.

 ```go
 import "github.com/duke-git/lancet/v2/random"
@@ -842,7 +881,7 @@ import "github.com/duke-git/lancet/v2/random"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/random.md#UUIdV4)]
    [[play](https://go.dev/play/p/_Z9SFmr28ft)]

-### 15. Retry package is for executing a function repeatedly until it was successful or canceled by the context.
+### 16. Retry package is for executing a function repeatedly until it was successful or canceled by the context.

 ```go
 import "github.com/duke-git/lancet/v2/retry"
@@ -866,7 +905,7 @@ import "github.com/duke-git/lancet/v2/retry"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/retry.md#RetryTimes)]
    [[play](https://go.dev/play/p/ssfVeU2SwLO)]

-### 16. Slice contains some functions to manipulate slice.
+### 17. Slice contains some functions to manipulate slice.

 ```go
 import "github.com/duke-git/lancet/v2/slice"
@@ -940,12 +979,16 @@ import "github.com/duke-git/lancet/v2/slice"
 -   **<big>FilterMap</big>** : returns a slice which apply both filtering and mapping to the given slice.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice.md#FilterMap)]
    [[play](https://go.dev/play/p/J94SZ_9MiIe)]
-   **<big>Find</big>** : iterates over elements of slice, returning the first one that passes a truth test on predicate function.
+-   **<big>Find<sup>deprecated</sup></big>** : iterates over elements of slice, returning the first one that passes a truth test on predicate function.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice.md#Find)]
    [[play](https://go.dev/play/p/CBKeBoHVLgq)]
-   **<big>FindLast</big>** : return the last item that passes a truth test on predicate function.
+-   **<big>FindBy</big>** : iterates over elements of slice, returning the first one that passes a truth test on predicate function.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice.md#FindBy)]
+-   **<big>FindLast<sup>deprecated</sup></big>** : return the last item that passes a truth test on predicate function.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice.md#FindLast)]
    [[play](https://go.dev/play/p/FFDPV_j7URd)]
+-   **<big>FindLastBy</big>** : iterates over elements of slice, returning the last one that passes a truth test on predicate function.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice.md#FindLastBy)]
 -   **<big>Flatten</big>** : flattens slice one level.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice.md#Flatten)]
    [[play](https://go.dev/play/p/hYa3cBEevtm)]
@@ -1073,7 +1116,7 @@ import "github.com/duke-git/lancet/v2/slice"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice.md#KeyBy)]
    [[play](https://go.dev/play/p/uXod2LWD1Kg)]

-### 17. Stream package implements a sequence of elements supporting sequential and operations. this package is an experiment to explore if stream in go can work as the way java does. its function is very limited.
+### 18. Stream package implements a sequence of elements supporting sequential and operations. this package is an experiment to explore if stream in go can work as the way java does. its function is very limited.

 ```go
 import "github.com/duke-git/lancet/v2/stream"
@@ -1157,7 +1200,7 @@ import "github.com/duke-git/lancet/v2/stream"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/stream.md#ToSlice)]
    [[play](https://go.dev/play/p/jI6_iZZuVFE)]

-### 18. Structs package provides several high level functions to manipulate struct, tag, and field.
+### 19. Structs package provides several high level functions to manipulate struct, tag, and field.

 ```go
 import "github.com/duke-git/lancet/v2/structs"
@@ -1190,7 +1233,7 @@ import "github.com/duke-git/lancet/v2/structs"
 -   **<big>IsSlice</big>** : check if the field is a slice
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/structs/field.md#IsSlice)]

-### 19. Strutil package contains some functions to manipulate string.
+### 20. Strutil package contains some functions to manipulate string.

 ```go
 import "github.com/duke-git/lancet/v2/strutil"
@@ -1269,8 +1312,20 @@ import "github.com/duke-git/lancet/v2/strutil"
 -   **<big>RemoveNonPrintable</big>** : remove non-printable characters from a string.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil.md#RemoveNonPrintable)]
    [[play](https://go.dev/play/p/og47F5x_jTZ)]
+-   **<big>StringToBytes</big>** : converts a string to byte slice without a memory allocation.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil.md#StringToBytes)]
+-   **<big>BytesToString</big>** : converts a byte slice to string without a memory allocation.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil.md#BytesToString)]
+-   **<big>IsBlank</big>** : checks if a string is whitespace or empty.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil.md#IsBlank)]
+-   **<big>HasPrefixAny</big>** : checks if a string starts with any of an array of specified strings.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil.md#HasPrefixAny)]
+-   **<big>HasSuffixAny</big>** : checks if a string ends with any of an array of specified strings.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil.md#HasSuffixAny)]
+-   **<big>IndexOffset</big>** : returns the index of the first instance of substr in string after offsetting the string by `idxFrom`.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil.md#IndexOffset)]

-### 20. System package contain some functions about os, runtime, shell command.
+### 21. System package contain some functions about os, runtime, shell command.

 ```go
 import "github.com/duke-git/lancet/v2/system"
@@ -1306,7 +1361,7 @@ import "github.com/duke-git/lancet/v2/system"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/system.md#GetOsBits)]
    [[play](https://go.dev/play/p/ml-_XH3gJbW)]

-### 21. Validator package contains some functions for data validation.
+### 22. Validator package contains some functions for data validation.

 ```go
 import "github.com/duke-git/lancet/v2/validator"
@@ -1414,7 +1469,7 @@ import "github.com/duke-git/lancet/v2/validator"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/validator.md#IsPrintable)]
    [[play](https://go.dev/play/p/Pe1FE2gdtTP)]

-### 22. xerror package implements helpers for errors.
+### 23. xerror package implements helpers for errors.

 ```go
 import "github.com/duke-git/lancet/v2/xerror"
--- a/README_zh-CN.md
+++ b/README_zh-CN.md
@@ -4,7 +4,7 @@
 <br/>

 ![Go version](https://img.shields.io/badge/go-%3E%3Dv1.18-9cf)
-[![Release](https://img.shields.io/badge/release-2.1.19-green.svg)](https://github.com/duke-git/lancet/releases)
+[![Release](https://img.shields.io/badge/release-2.1.20-green.svg)](https://github.com/duke-git/lancet/releases)
 [![GoDoc](https://godoc.org/github.com/duke-git/lancet/v2?status.svg)](https://pkg.go.dev/github.com/duke-git/lancet/v2)
 [![Go Report Card](https://goreportcard.com/badge/github.com/duke-git/lancet/v2)](https://goreportcard.com/report/github.com/duke-git/lancet/v2)
 [![test](https://github.com/duke-git/lancet/actions/workflows/codecov.yml/badge.svg?branch=main&event=push)](https://github.com/duke-git/lancet/actions/workflows/codecov.yml)
@@ -117,7 +117,28 @@ import "github.com/duke-git/lancet/v2/algorithm"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/algorithm_zh-CN.md#LRUCache)]
    [[play](https://go.dev/play/p/-EZjgOURufP)]

-### 2. concurrency 包含一些支持并发编程的功能。例如：goroutine, channel, async 等。
+### 2. compare 包提供几个轻量级的类型比较函数。
+
+```go
+import "github.com/duke-git/lancet/v2/compare"
+```
+
+#### Function list:
+
+-   **<big>Equal</big>** : 检查两个值是否相等(检查类型和值)。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/compare_zh-CN.md#Equal)]
+-   **<big>EqualValue</big>** : 检查两个值是否相等(只检查值)。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/compare_zh-CN.md#EqualValue)]
+-   **<big>LessThan</big>** : 验证参数`left`的值是否小于参数`right`的值。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/compare_zh-CN.md#LessThan)]
+-   **<big>GreaterThan</big>** : 验证参数`left`的值是否大于参数`right`的值。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/compare_zh-CN.md#GreaterThan)]
+-   **<big>LessOrEqual</big>** : 验证参数`left`的值是否小于或等于参数`right`的值。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/compare_zh-CN.md#LessOrEqual)]
+-   **<big>GreaterOrEqual</big>** : 验证参数`left`的值是否大于或等于参数`right`的值。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/compare_zh-CN.md#GreaterOrEqual)]
+
+### 3. concurrency 包含一些支持并发编程的功能。例如：goroutine, channel, async 等。

 ```go
 import "github.com/duke-git/lancet/v2/concurrency"
@@ -156,7 +177,7 @@ import "github.com/duke-git/lancet/v2/concurrency"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/concurrency_zh-CN.md#Tee)]
    [[play](https://go.dev/play/p/3TQPKnCirrP)]

-### 3. condition 包含一些用于条件判断的函数。
+### 4. condition 包含一些用于条件判断的函数。

 ```go
 import "github.com/duke-git/lancet/v2/condition"
@@ -189,7 +210,7 @@ import "github.com/duke-git/lancet/v2/condition"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/condition_zh-CN.md#TernaryOperator)]
    [[play](https://go.dev/play/p/ElllPZY0guT)]

-### 4. convertor 转换器包支持一些常见的数据类型转换。
+### 5. convertor 转换器包支持一些常见的数据类型转换。

 ```go
 import "github.com/duke-git/lancet/v2/convertor"
@@ -252,7 +273,7 @@ import "github.com/duke-git/lancet/v2/convertor"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/convertor_zh-CN.md#CopyProperties)]
    [[play](https://go.dev/play/p/FOVY3XJL-6B)]

-### 5. cryptor 加密包支持数据加密和解密，获取 md5，hash 值。支持 base64, md5, hmac, aes, des, rsa。
+### 6. cryptor 加密包支持数据加密和解密，获取 md5，hash 值。支持 base64, md5, hmac, aes, des, rsa。

 ```go
 import "github.com/duke-git/lancet/v2/cryptor"
@@ -356,7 +377,7 @@ import "github.com/duke-git/lancet/v2/cryptor"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/cryptor_zh-CN.md#RsaDecrypt)]
    [[play](https://go.dev/play/p/uef0q1fz53I)]

-### 6. datetime 日期时间处理包，格式化日期，比较日期。
+### 7. datetime 日期时间处理包，格式化日期，比较日期。

 ```go
 import "github.com/duke-git/lancet/v2/datetime"
@@ -455,7 +476,7 @@ import "github.com/duke-git/lancet/v2/datetime"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/datetime_zh-CN.md#ToIso8601)]
    [[play](https://go.dev/play/p/mkhOHQkdeA2)]

-### 7. datastructure 包含一些普通的数据结构实现。例如：list, linklist, stack, queue, set, tree, graph.
+### 8. datastructure 包含一些普通的数据结构实现。例如：list, linklist, stack, queue, set, tree, graph.

 ```go
 import list "github.com/duke-git/lancet/v2/datastructure/list"
@@ -487,7 +508,7 @@ import hashmap "github.com/duke-git/lancet/v2/datastructure/hashmap"
 -   **<big>Hashmap</big>** : 哈希映射。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/datastructure/hashmap_zh-CN.md)]

-### 8. fileutil 包含文件基本操作。
+### 9. fileutil 包含文件基本操作。

 ```go
 import "github.com/duke-git/lancet/v2/fileutil"
@@ -543,8 +564,18 @@ import "github.com/duke-git/lancet/v2/fileutil"
 -   **<big>CurrentPath</big>** : 返回当前位置的绝对路径。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/fileutil_zh-CN.md#CurrentPath)]
    [[play](https://go.dev/play/p/s74a9iBGcSw)]
+-   **<big>IsZipFile</big>** : 判断文件是否是zip压缩文件。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/fileutil_zh-CN.md#IsZipFile)]
+-   **<big>FileSize</big>** : 返回文件字节大小。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/fileutil_zh-CN.md#FileSize)]
+-   **<big>MTime</big>** : 返回文件修改时间(unix timestamp)。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/fileutil_zh-CN.md#MTime)]
+-   **<big>Sha</big>** : 返回文件sha值。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/fileutil_zh-CN.md#Sha)]
+-   **<big>ReadCsvFile</big>** : 读取csv文件内容到切片。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/fileutil_zh-CN.md#ReadCsvFile)]

-### 9. formatter 格式化器包含一些数据格式化处理方法。
+### 10. formatter 格式化器包含一些数据格式化处理方法。

 ```go
 import "github.com/duke-git/lancet/v2/formatter"
@@ -574,7 +605,7 @@ import "github.com/duke-git/lancet/v2/formatter"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/formatter_zh-CN.md#ParseBinaryBytes)]
    [[play](https://go.dev/play/p/69v1tTT62x8)]

-### 10. function 函数包控制函数执行流程，包含部分函数式编程。
+### 11. function 函数包控制函数执行流程，包含部分函数式编程。

 ```go
 import "github.com/duke-git/lancet/v2/function"
@@ -610,7 +641,7 @@ import "github.com/duke-git/lancet/v2/function"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/function_zh-CN.md#Watcher)]
    [[play](https://go.dev/play/p/l2yrOpCLd1I)]

-### 11. maputil 包括一些操作 map 的函数.
+### 12. maputil 包括一些操作 map 的函数.

 ```go
 import "github.com/duke-git/lancet/v2/maputil"
@@ -682,7 +713,7 @@ import "github.com/duke-git/lancet/v2/maputil"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/maputil_zh-CN.md#IsDisjoint)]
    [[play](https://go.dev/play/p/N9qgYg_Ho6f)]

-### 12. mathutil 包实现了一些数学计算的函数。
+### 13. mathutil 包实现了一些数学计算的函数。

 ```go
 import "github.com/duke-git/lancet/v2/mathutil"
@@ -745,7 +776,7 @@ import "github.com/duke-git/lancet/v2/mathutil"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil_zh-CN.md#IsPrime)]
    [[play](https://go.dev/play/p/Rdd8UTHZJ7u)]

-### 13. netutil 网络包支持获取 ip 地址，发送 http 请求。
+### 14. netutil 网络包支持获取 ip 地址，发送 http 请求。

 ```go
 import "github.com/duke-git/lancet/v2/netutil"
@@ -805,10 +836,18 @@ import "github.com/duke-git/lancet/v2/netutil"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/netutil_zh-CN.md#HttpPut)]
 -   **<big>HttpPatch<sup>deprecated</sup></big>** : 发送 http patch 请求（已弃用：SendRequest 代替）。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/netutil_zh-CN.md#HttpPatch)]
-   **<big>ParseHttpResponse</big>** : 解析 http 响应体到目标结构体。
+-   **<big>ParseHttpResponse</big>** : 解析http响应体到目标结构体。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/netutil_zh-CN.md#ParseHttpResponse)]
+-   **<big>DownloadFile</big>** : 从指定的server地址下载文件。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/netutil_zh-CN.md#DownloadFile)]
+-   **<big>UploadFile</big>** : 将文件上传指定的server地址。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/netutil_zh-CN.md#UploadFile)]
+-   **<big>IsPingConnected</big>** : 检查能否ping通主机。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/netutil_zh-CN.md#IsPingConnected)]
+-   **<big>IsTelnetConnected</big>** : 检查能否telnet到主机。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/netutil_zh-CN.md#IsTelnetConnected)]

-### 14. random 随机数生成器包，可以生成随机[]bytes, int, string。
+### 15. random 随机数生成器包，可以生成随机[]bytes, int, string。

 ```go
 import "github.com/duke-git/lancet/v2/random"
@@ -841,7 +880,7 @@ import "github.com/duke-git/lancet/v2/random"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/random_zh-CN.md#UUIdV4)]
    [[play](https://go.dev/play/p/_Z9SFmr28ft)]

-### 15. retry 重试执行函数直到函数运行成功或被 context cancel。
+### 16. retry 重试执行函数直到函数运行成功或被 context cancel。

 ```go
 import "github.com/duke-git/lancet/v2/retry"
@@ -865,7 +904,7 @@ import "github.com/duke-git/lancet/v2/retry"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/retry_zh-CN.md#RetryTimes)]
    [[play](https://go.dev/play/p/ssfVeU2SwLO)]

-### 16. slice 包含操作切片的方法集合。
+### 17. slice 包含操作切片的方法集合。

 ```go
 import "github.com/duke-git/lancet/v2/slice"
@@ -939,12 +978,16 @@ import "github.com/duke-git/lancet/v2/slice"
 -   **<big>FilterMap</big>** : 返回一个将 filter 和 map 操作应用于给定切片的切片。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice_zh-CN.md#FilterMap)]
    [[play](https://go.dev/play/p/J94SZ_9MiIe)]
-   **<big>Find</big>** : 遍历切片的元素，返回第一个通过 predicate 函数真值测试的元素。
+-   **<big>Find<sup>deprecated</sup></big>** : 遍历切片的元素，返回第一个通过 predicate 函数真值测试的元素。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice_zh-CN.md#Find)]
    [[play](https://go.dev/play/p/CBKeBoHVLgq)]
-   **<big>FindLast</big>** : 从头到尾遍历 slice 的元素，返回最后一个通过 predicate 函数真值测试的元素。
+-   **<big>FindBy</big>** : 遍历切片的元素，返回第一个通过 predicate 函数真值测试的元素。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice_zh-CN.md#FindBy)]
+-   **<big>FindLast<sup>deprecated</sup></big>** : 从头到尾遍历 slice 的元素，返回最后一个通过 predicate 函数真值测试的元素。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice_zh-CN.md#FindLast)]
    [[play](https://go.dev/play/p/FFDPV_j7URd)]
+-   **<big>FindLastBy</big>** : 从遍历slice的元素，返回最后一个通过predicate函数真值测试的元素。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice_zh-CN.md#FindLastBy)]
 -   **<big>Flatten</big>** : 将多维切片展平一层。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice_zh-CN.md#Flatten)]
    [[play](https://go.dev/play/p/hYa3cBEevtm)]
@@ -1072,7 +1115,7 @@ import "github.com/duke-git/lancet/v2/slice"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice_zh-CN.md#KeyBy)]
    [[play](https://go.dev/play/p/uXod2LWD1Kg)]

-### 17. Stream 流，该包仅验证简单的 stream 实现，功能有限。
+### 18. Stream 流，该包仅验证简单的 stream 实现，功能有限。

 ```go
 import "github.com/duke-git/lancet/v2/stream"
@@ -1156,7 +1199,7 @@ import "github.com/duke-git/lancet/v2/stream"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/stream_zh-CN.md#ToSlice)]
    [[play](https://go.dev/play/p/jI6_iZZuVFE)]

-### 18. structs 提供操作 struct, tag, field 的相关函数。
+### 19. structs 提供操作 struct, tag, field 的相关函数。

 ```go
 import "github.com/duke-git/lancet/v2/structs"
@@ -1191,7 +1234,7 @@ import "github.com/duke-git/lancet/v2/structs"
 -   **<big>IsSlice</big>** : 判断属性是否是切片。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/structs/field_zh-CN.md#IsSlice)]

-### 19. strutil 包含字符串处理的相关函数。
+### 20. strutil 包含字符串处理的相关函数。

 ```go
 import "github.com/duke-git/lancet/v2/strutil"
@@ -1271,8 +1314,20 @@ import "github.com/duke-git/lancet/v2/strutil"
 -   **<big>RemoveNonPrintable</big>** : 删除字符串中不可打印的字符。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil_zh-CN.md#RemoveNonPrintable)]
    [[play](https://go.dev/play/p/og47F5x_jTZ)]
+-   **<big>StringToBytes</big>** : 在不分配内存的情况下将字符串转换为字节片。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil_zh-CN.md#StringToBytes)]
+-   **<big>BytesToString</big>** : 在不分配内存的情况下将字节切片转换为字符串。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil_zh-CN.md#BytesToString)]
+-   **<big>IsBlank</big>** : 检查字符串是否为空格或空。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil_zh-CN.md#IsBlank)]
+-   **<big>HasPrefixAny</big>** : 检查字符串是否以指定字符串数组中的任何一个开头。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil_zh-CN.md#HasPrefixAny)]
+-   **<big>HasSuffixAny</big>** : 检查字符串是否以指定字符串数组中的任何一个结尾。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil_zh-CN.md#HasSuffixAny)]
+-   **<big>IndexOffset</big>** : 将字符串偏移idxFrom后，返回字符串中第一个 substr 实例的索引。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil_zh-CN.md#IndexOffset)]

-### 20. system 包含 os, runtime, shell command 的相关函数。
+### 21. system 包含 os, runtime, shell command 的相关函数。

 ```go
 import "github.com/duke-git/lancet/v2/system"
@@ -1308,7 +1363,7 @@ import "github.com/duke-git/lancet/v2/system"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/system_zh-CN#GetOsBits)]
    [[play](https://go.dev/play/p/ml-_XH3gJbW)]

-### 21. validator 验证器包，包含常用字符串格式验证函数。
+### 22. validator 验证器包，包含常用字符串格式验证函数。

 ```go
 import "github.com/duke-git/lancet/v2/validator"
@@ -1416,7 +1471,7 @@ import "github.com/duke-git/lancet/v2/validator"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/validator_zh-CN.md#IsPrintable)]
    [[play](https://go.dev/play/p/Pe1FE2gdtTP)]

-### 22. xerror 包实现一些错误处理函数
+### 23. xerror 包实现一些错误处理函数

 ```go
 import "github.com/duke-git/lancet/v2/xerror"
--- a/algorithm/sort_test.go
+++ b/algorithm/sort_test.go
@@ -200,7 +200,6 @@ func TestCountSort(t *testing.T) {
 	}
 	comparator := &peopleAgeComparator{}
 	sortedPeopleByAge := CountSort(peoples, comparator)
-	t.Log(sortedPeopleByAge)

 	expected := "[{d 8} {b 10} {c 17} {a 20} {e 28}]"
 	actual := fmt.Sprintf("%v", sortedPeopleByAge)
--- a/compare/compare.go
+++ b/compare/compare.go
@@ -26,11 +26,12 @@ var (
 	bytesType = reflect.TypeOf([]byte{})
 )

-// Equal checks if two values are equal or not
+// Equal checks if two values are equal or not. (check both type and value)
 func Equal(left, right any) bool {
 	return compareValue(equal, left, right)
 }

+// EqualValue checks if two values are equal or not. (check value only)
 func EqualValue(left, right any) bool {
 	ls, rs := convertor.ToString(left), convertor.ToString(right)
 	return ls == rs
@@ -41,17 +42,17 @@ func LessThan(left, right any) bool {
 	return compareValue(lessThan, left, right)
 }

-// GreaterThan checks if value `left` greater than value `right`
+// GreaterThan checks if value `left` greater than value `right`.
 func GreaterThan(left, right any) bool {
 	return compareValue(greaterThan, left, right)
 }

-// LessOrEqual checks if value `left` less than or equal to value `right`
+// LessOrEqual checks if value `left` less than or equal to value `right`.
 func LessOrEqual(left, right any) bool {
 	return compareValue(lessOrEqual, left, right)
 }

-// GreaterOrEqual checks if value `left` greater than or equal to value `right`
+// GreaterOrEqual checks if value `left` greater than or equal to value `right`.
 func GreaterOrEqual(left, right any) bool {
 	return compareValue(greaterOrEqual, left, right)
 }
--- a/compare/compare_example_test.go
+++ b/compare/compare_example_test.go
@@ -0,0 +1,170 @@
+package compare
+
+import (
+	"fmt"
+	"time"
+)
+
+func ExampleEqual() {
+	result1 := Equal(1, 1)
+	result2 := Equal("1", "1")
+	result3 := Equal([]int{1, 2, 3}, []int{1, 2, 3})
+	result4 := Equal(map[int]string{1: "a", 2: "b"}, map[int]string{1: "a", 2: "b"})
+
+	result5 := Equal(1, "1")
+	result6 := Equal(1, int64(1))
+	result7 := Equal([]int{1, 2}, []int{1, 2, 3})
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+	fmt.Println(result4)
+	fmt.Println(result5)
+	fmt.Println(result6)
+	fmt.Println(result7)
+
+	// Output:
+	// true
+	// true
+	// true
+	// true
+	// false
+	// false
+	// false
+}
+
+func ExampleEqualValue() {
+	result1 := EqualValue(1, 1)
+	result2 := EqualValue(int(1), int64(1))
+	result3 := EqualValue(1, "1")
+	result4 := EqualValue(1, "2")
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+	fmt.Println(result4)
+
+	// Output:
+	// true
+	// true
+	// true
+	// false
+}
+
+func ExampleLessThan() {
+	result1 := LessThan(1, 2)
+	result2 := LessThan(1.1, 2.2)
+	result3 := LessThan("a", "b")
+
+	time1 := time.Now()
+	time2 := time1.Add(time.Second)
+	result4 := LessThan(time1, time2)
+
+	result5 := LessThan(2, 1)
+	result6 := LessThan(1, int64(2))
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+	fmt.Println(result4)
+	fmt.Println(result5)
+	fmt.Println(result6)
+
+	// Output:
+	// true
+	// true
+	// true
+	// true
+	// false
+	// false
+}
+
+func ExampleGreaterThan() {
+	result1 := GreaterThan(2, 1)
+	result2 := GreaterThan(2.2, 1.1)
+	result3 := GreaterThan("b", "a")
+
+	time1 := time.Now()
+	time2 := time1.Add(time.Second)
+	result4 := GreaterThan(time2, time1)
+
+	result5 := GreaterThan(1, 2)
+	result6 := GreaterThan(int64(2), 1)
+	result7 := GreaterThan("b", "c")
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+	fmt.Println(result4)
+	fmt.Println(result5)
+	fmt.Println(result6)
+	fmt.Println(result7)
+
+	// Output:
+	// true
+	// true
+	// true
+	// true
+	// false
+	// false
+	// false
+}
+
+func ExampleLessOrEqual() {
+	result1 := LessOrEqual(1, 1)
+	result2 := LessOrEqual(1.1, 2.2)
+	result3 := LessOrEqual("a", "b")
+
+	time1 := time.Now()
+	time2 := time1.Add(time.Second)
+	result4 := LessOrEqual(time1, time2)
+
+	result5 := LessOrEqual(2, 1)
+	result6 := LessOrEqual(1, int64(2))
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+	fmt.Println(result4)
+	fmt.Println(result5)
+	fmt.Println(result6)
+
+	// Output:
+	// true
+	// true
+	// true
+	// true
+	// false
+	// false
+}
+
+func ExampleGreaterOrEqual() {
+	result1 := GreaterOrEqual(1, 1)
+	result2 := GreaterOrEqual(2.2, 1.1)
+	result3 := GreaterOrEqual("b", "b")
+
+	time1 := time.Now()
+	time2 := time1.Add(time.Second)
+	result4 := GreaterOrEqual(time2, time1)
+
+	result5 := GreaterOrEqual(1, 2)
+	result6 := GreaterOrEqual(int64(2), 1)
+	result7 := GreaterOrEqual("b", "c")
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+	fmt.Println(result4)
+	fmt.Println(result5)
+	fmt.Println(result6)
+	fmt.Println(result7)
+
+	// Output:
+	// true
+	// true
+	// true
+	// true
+	// false
+	// false
+	// false
+}
--- a/compare/compare_test.go
+++ b/compare/compare_test.go
@@ -68,3 +68,67 @@ func TestEqualValue(t *testing.T) {

 	assert.Equal(false, EqualValue(1, "2"))
 }
+
+func TestLessThan(t *testing.T) {
+	assert := internal.NewAssert(t, "TestLessThan")
+
+	assert.Equal(true, LessThan(1, 2))
+	assert.Equal(true, LessThan(1.1, 2.2))
+	assert.Equal(true, LessThan("a", "b"))
+
+	time1 := time.Now()
+	time2 := time1.Add(time.Second)
+	assert.Equal(true, LessThan(time1, time2))
+
+	assert.Equal(false, LessThan(1, 1))
+	assert.Equal(false, LessThan(1, int64(1)))
+}
+
+func TestGreaterThan(t *testing.T) {
+	assert := internal.NewAssert(t, "TestGreaterThan")
+
+	assert.Equal(true, GreaterThan(2, 1))
+	assert.Equal(true, GreaterThan(2.2, 1.1))
+	assert.Equal(true, GreaterThan("b", "a"))
+
+	time1 := time.Now()
+	time2 := time1.Add(time.Second)
+	assert.Equal(true, GreaterThan(time2, time1))
+
+	assert.Equal(false, GreaterThan(1, 2))
+	assert.Equal(false, GreaterThan(int64(2), 1))
+	assert.Equal(false, GreaterThan("b", "c"))
+}
+
+func TestLessOrEqual(t *testing.T) {
+	assert := internal.NewAssert(t, "TestLessOrEqual")
+
+	assert.Equal(true, LessOrEqual(1, 2))
+	assert.Equal(true, LessOrEqual(1, 1))
+	assert.Equal(true, LessOrEqual(1.1, 2.2))
+	assert.Equal(true, LessOrEqual("a", "b"))
+
+	time1 := time.Now()
+	time2 := time1.Add(time.Second)
+	assert.Equal(true, LessOrEqual(time1, time2))
+
+	assert.Equal(false, LessOrEqual(2, 1))
+	assert.Equal(false, LessOrEqual(1, int64(2)))
+}
+
+func TestGreaterOrEqual(t *testing.T) {
+	assert := internal.NewAssert(t, "TestGreaterThan")
+
+	assert.Equal(true, GreaterOrEqual(2, 1))
+	assert.Equal(true, GreaterOrEqual(1, 1))
+	assert.Equal(true, GreaterOrEqual(2.2, 1.1))
+	assert.Equal(true, GreaterOrEqual("b", "b"))
+
+	time1 := time.Now()
+	time2 := time1.Add(time.Second)
+	assert.Equal(true, GreaterOrEqual(time2, time1))
+
+	assert.Equal(false, GreaterOrEqual(1, 2))
+	assert.Equal(false, GreaterOrEqual(int64(2), 1))
+	assert.Equal(false, GreaterOrEqual("b", "c"))
+}
--- a/concurrency/channel_test.go
+++ b/concurrency/channel_test.go
@@ -181,7 +181,6 @@ func TestBridge(t *testing.T) {

 	index := 0
 	for val := range c.Bridge(ctx, genVals()) {
-		// t.Logf("%v ", val) //0 1 2 3 4 5 6 7 8 9
 		assert.Equal(index, val)
 		index++
 	}
--- a/convertor/convertor_test.go
+++ b/convertor/convertor_test.go
@@ -306,7 +306,6 @@ func TestDeepClone(t *testing.T) {
 	for i, item := range cases {
 		cloned := DeepClone(item)

-		t.Log(cloned)
 		if &cloned == &item {
 			t.Fatalf("[TestDeepClone case #%d failed]: equal pointer", i)
 		}
--- a/datastructure/hashmap/hashmap_test.go
+++ b/datastructure/hashmap/hashmap_test.go
@@ -64,7 +64,6 @@ func TestHashMap_KeysValues(t *testing.T) {

 	keys := hm.Keys()
 	values := hm.Values()
-	t.Log(keys, values)

 	assert.Equal(3, len(values))
 	assert.Equal(3, len(keys))
--- a/datastructure/tree/bstree_test.go
+++ b/datastructure/tree/bstree_test.go
@@ -40,7 +40,6 @@ func TestBSTree_PreOrderTraverse(t *testing.T) {
 	bstree.Insert(4)

 	acturl := bstree.PreOrderTraverse()
-	t.Log(acturl)
 	assert.Equal([]int{6, 5, 2, 4, 7}, acturl)
 }

@@ -55,7 +54,6 @@ func TestBSTree_PostOrderTraverse(t *testing.T) {
 	bstree.Insert(4)

 	acturl := bstree.PostOrderTraverse()
-	t.Log(acturl)
 	assert.Equal([]int{5, 2, 4, 7, 6}, acturl)
 }

@@ -70,7 +68,6 @@ func TestBSTree_InOrderTraverse(t *testing.T) {
 	bstree.Insert(4)

 	acturl := bstree.InOrderTraverse()
-	t.Log(acturl)
 	assert.Equal([]int{2, 4, 5, 6, 7}, acturl)
 }

@@ -85,7 +82,6 @@ func TestBSTree_LevelOrderTraverse(t *testing.T) {
 	bstree.Insert(4)

 	acturl := bstree.LevelOrderTraverse()
-	t.Log(acturl)
 	assert.Equal([]int{6, 5, 7, 2, 4}, acturl)
 }

@@ -102,14 +98,12 @@ func TestBSTree_Delete(t *testing.T) {
 	bstree.Delete(4)

 	acturl1 := bstree.InOrderTraverse()
-	t.Log(acturl1)
 	assert.Equal([]int{2, 5, 6, 7}, acturl1)

 	//todo
 	// bstree.DeletetNode(6, comparator)
 	// bstree.Print()
 	// acturl2 := bstree.InOrderTraverse()
-	// t.Log(acturl2)
 	// assert.Equal([]int{2, 5, 7}, acturl2)
 }

--- a/datetime/conversion_test.go
+++ b/datetime/conversion_test.go
@@ -20,9 +20,8 @@ func TestToFormat(t *testing.T) {
 	assert := internal.NewAssert(t, "TestToFormat")

 	tm, err := NewFormat("2022-03-18 17:04:05")
+	t.Log("TestToFormat", tm.ToFormat())
 	assert.IsNil(err)
-
-	t.Log("ToFormat -> ", tm.ToFormat())
 }

 func TestToFormatForTpl(t *testing.T) {
@@ -32,9 +31,9 @@ func TestToFormatForTpl(t *testing.T) {
 	assert.IsNotNil(err)

 	tm, err := NewFormat("2022-03-18 17:04:05")
+	// assert.Equal("2022/03/18 17:04:05", tm.ToFormatForTpl("2006/01/02 15:04:05"))
+	t.Log("TestToFormatForTpl", tm.ToFormatForTpl("2006/01/02 15:04:05"))
 	assert.IsNil(err)
-
-	t.Log("ToFormatForTpl -> ", tm.ToFormatForTpl("2006/01/02 15:04:05"))
 }

 func TestToIso8601(t *testing.T) {
@@ -44,7 +43,7 @@ func TestToIso8601(t *testing.T) {
 	assert.IsNotNil(err)

 	tm, err := NewISO8601("2006-01-02T15:04:05.999Z")
+	t.Log("TestToIso8601", tm.ToIso8601())
+	// assert.Equal("2006-01-02T23:04:05+08:00", tm.ToIso8601())
 	assert.IsNil(err)
-
-	t.Log("ToIso8601 -> ", tm.ToIso8601())
 }
--- a/docs/compare.md
+++ b/docs/compare.md
@@ -0,0 +1,326 @@
+# Compare
+
+Package compare provides a lightweight comparison function on any type.
+
+<div STYLE="page-break-after: always;"></div>
+
+## Source:
+
+-   [https://github.com/duke-git/lancet/blob/main/compare/compare.go](https://github.com/duke-git/lancet/blob/main/compare/compare.go)
+
+-   [https://github.com/duke-git/lancet/blob/main/compare/compare_internal.go](https://github.com/duke-git/lancet/blob/main/compare/compare_internal.go)
+
+<div STYLE="page-break-after: always;"></div>
+
+## Usage:
+
+```go
+import (
+    "github.com/duke-git/lancet/v2/condition"
+)
+```
+
+<div STYLE="page-break-after: always;"></div>
+
+## Index
+
+-   [Equal](#Equal)
+-   [EqualValue](#EqualValue)
+-   [LessThan](#LessThan)
+-   [GreaterThan](#GreaterThan)
+-   [LessOrEqual](#LessOrEqual)
+-   [GreaterOrEqual](#GreaterOrEqual)
+
+<div STYLE="page-break-after: always;"></div>
+
+## Documentation
+
+### <span id="Equal">Equal</span>
+
+<p>Checks if two values are equal or not. (check both type and value)</p>
+
+<b>Signature:</b>
+
+```go
+func Equal(left, right any) bool
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/compare"
+)
+
+func main() {
+    result1 := compare.Equal(1, 1)
+    result2 := compare.Equal("1", "1")
+    result3 := compare.Equal([]int{1, 2, 3}, []int{1, 2, 3})
+    result4 := compare.Equal(map[int]string{1: "a", 2: "b"}, map[int]string{1: "a", 2: "b"})
+
+    result5 := compare.Equal(1, "1")
+    result6 := compare.Equal(1, int64(1))
+    result7 := compare.Equal([]int{1, 2}, []int{1, 2, 3})
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+    fmt.Println(result6)
+    fmt.Println(result7)
+
+    // Output:
+    // true
+    // true
+    // true
+    // true
+    // false
+    // false
+    // false
+}
+```
+
+### <span id="EqualValue">EqualValue</span>
+
+<p>Checks if two values are equal or not. (check value only)</p>
+
+<b>Signature:</b>
+
+```go
+func EqualValue(left, right any) bool
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/compare"
+)
+
+func main() {
+    result1 := compare.EqualValue(1, 1)
+    result2 := compare.EqualValue(int(1), int64(1))
+    result3 := compare.EqualValue(1, "1")
+    result4 := compare.EqualValue(1, "2")
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+
+    // Output:
+    // true
+    // true
+    // true
+    // false
+}
+```
+
+### <span id="LessThan">LessThan</span>
+
+<p>Checks if value `left` less than value `right`.</p>
+
+<b>Signature:</b>
+
+```go
+func LessThan(left, right any) bool
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/compare"
+)
+
+func main() {
+    result1 := compare.LessThan(1, 2)
+    result2 := compare.LessThan(1.1, 2.2)
+    result3 := compare.LessThan("a", "b")
+
+    time1 := time.Now()
+    time2 := time1.Add(time.Second)
+    result4 := compare.LessThan(time1, time2)
+
+    result5 := compare.LessThan(2, 1)
+    result6 := compare.LessThan(1, int64(2))
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+    fmt.Println(result6)
+
+    // Output:
+    // true
+    // true
+    // true
+    // true
+    // false
+    // false
+}
+```
+
+### <span id="GreaterThan">GreaterThan</span>
+
+<p>Checks if value `left` greater than value `right`.</p>
+
+<b>Signature:</b>
+
+```go
+func GreaterThan(left, right any) bool
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/compare"
+)
+
+func main() {
+    result1 := compare.GreaterThan(2, 1)
+    result2 := compare.GreaterThan(2.2, 1.1)
+    result3 := compare.GreaterThan("b", "a")
+
+    time1 := time.Now()
+    time2 := time1.Add(time.Second)
+    result4 := compare.GreaterThan(time2, time1)
+
+    result5 := compare.GreaterThan(1, 2)
+    result6 := compare.GreaterThan(int64(2), 1)
+    result7 := compare.GreaterThan("b", "c")
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+    fmt.Println(result6)
+    fmt.Println(result7)
+
+    // Output:
+    // true
+    // true
+    // true
+    // true
+    // false
+    // false
+    // false
+}
+```
+
+### <span id="LessOrEqual">LessOrEqual</span>
+
+<p>Checks if value `left` less than or equal than value `right`.</p>
+
+<b>Signature:</b>
+
+```go
+func LessOrEqual(left, right any) bool
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/compare"
+)
+
+func main() {
+    result1 := compare.LessOrEqual(1, 1)
+    result2 := compare.LessOrEqual(1.1, 2.2)
+    result3 := compare.LessOrEqual("a", "b")
+
+    time1 := time.Now()
+    time2 := time1.Add(time.Second)
+    result4 := compare.LessOrEqual(time1, time2)
+
+    result5 := compare.LessOrEqual(2, 1)
+    result6 := compare.LessOrEqual(1, int64(2))
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+    fmt.Println(result6)
+
+    // Output:
+    // true
+    // true
+    // true
+    // true
+    // false
+    // false
+}
+```
+
+### <span id="GreaterOrEqual">GreaterOrEqual</span>
+
+<p>Checks if value `left` less greater or equal than value `right`.</p>
+
+<b>Signature:</b>
+
+```go
+func GreaterOrEqual(left, right any) bool
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/compare"
+)
+
+func main() {
+    result1 := compare.GreaterOrEqual(1, 1)
+    result2 := compare.GreaterOrEqual(2.2, 1.1)
+    result3 := compare.GreaterOrEqual("b", "b")
+
+    time1 := time.Now()
+    time2 := time1.Add(time.Second)
+    result4 := compare.GreaterOrEqual(time2, time1)
+
+    result5 := compare.GreaterOrEqual(1, 2)
+    result6 := compare.GreaterOrEqual(int64(2), 1)
+    result7 := compare.GreaterOrEqual("b", "c")
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+    fmt.Println(result6)
+    fmt.Println(result7)
+
+    // Output:
+    // true
+    // true
+    // true
+    // true
+    // false
+    // false
+    // false
+}
+```
--- a/docs/compare_zh-CN.md
+++ b/docs/compare_zh-CN.md
@@ -0,0 +1,326 @@
+# Compare
+
+compare包提供几个轻量级的类型比较函数。
+
+<div STYLE="page-break-after: always;"></div>
+
+## 源码:
+
+-   [https://github.com/duke-git/lancet/blob/main/compare/compare.go](https://github.com/duke-git/lancet/blob/main/compare/compare.go)
+
+-   [https://github.com/duke-git/lancet/blob/main/compare/compare_internal.go](https://github.com/duke-git/lancet/blob/main/compare/compare_internal.go)
+
+<div STYLE="page-break-after: always;"></div>
+
+## 用法:
+
+```go
+import (
+    "github.com/duke-git/lancet/v2/condition"
+)
+```
+
+<div STYLE="page-break-after: always;"></div>
+
+## 目录
+
+-   [Equal](#Equal)
+-   [EqualValue](#EqualValue)
+-   [LessThan](#LessThan)
+-   [GreaterThan](#GreaterThan)
+-   [LessOrEqual](#LessOrEqual)
+-   [GreaterOrEqual](#GreaterOrEqual)
+
+<div STYLE="page-break-after: always;"></div>
+
+## Documentation
+
+### <span id="Equal">Equal</span>
+
+<p>检查两个值是否相等(检查类型和值)</p>
+
+<b>函数签名:</b>
+
+```go
+func Equal(left, right any) bool
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/compare"
+)
+
+func main() {
+    result1 := compare.Equal(1, 1)
+    result2 := compare.Equal("1", "1")
+    result3 := compare.Equal([]int{1, 2, 3}, []int{1, 2, 3})
+    result4 := compare.Equal(map[int]string{1: "a", 2: "b"}, map[int]string{1: "a", 2: "b"})
+
+    result5 := compare.Equal(1, "1")
+    result6 := compare.Equal(1, int64(1))
+    result7 := compare.Equal([]int{1, 2}, []int{1, 2, 3})
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+    fmt.Println(result6)
+    fmt.Println(result7)
+
+    // Output:
+    // true
+    // true
+    // true
+    // true
+    // false
+    // false
+    // false
+}
+```
+
+### <span id="EqualValue">EqualValue</span>
+
+<p>检查两个值是否相等(只检查值)</p>
+
+<b>函数签名:</b>
+
+```go
+func EqualValue(left, right any) bool
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/compare"
+)
+
+func main() {
+    result1 := compare.EqualValue(1, 1)
+    result2 := compare.EqualValue(int(1), int64(1))
+    result3 := compare.EqualValue(1, "1")
+    result4 := compare.EqualValue(1, "2")
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+
+    // Output:
+    // true
+    // true
+    // true
+    // false
+}
+```
+
+### <span id="LessThan">LessThan</span>
+
+<p>验证参数`left`的值是否小于参数`right`的值。</p>
+
+<b>函数签名:</b>
+
+```go
+func LessThan(left, right any) bool
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/compare"
+)
+
+func main() {
+    result1 := compare.LessThan(1, 2)
+    result2 := compare.LessThan(1.1, 2.2)
+    result3 := compare.LessThan("a", "b")
+
+    time1 := time.Now()
+    time2 := time1.Add(time.Second)
+    result4 := compare.LessThan(time1, time2)
+
+    result5 := compare.LessThan(2, 1)
+    result6 := compare.LessThan(1, int64(2))
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+    fmt.Println(result6)
+
+    // Output:
+    // true
+    // true
+    // true
+    // true
+    // false
+    // false
+}
+```
+
+### <span id="GreaterThan">GreaterThan</span>
+
+<p>验证参数`left`的值是否大于参数`right`的值。</p>
+
+<b>函数签名:</b>
+
+```go
+func GreaterThan(left, right any) bool
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/compare"
+)
+
+func main() {
+    result1 := compare.GreaterThan(2, 1)
+    result2 := compare.GreaterThan(2.2, 1.1)
+    result3 := compare.GreaterThan("b", "a")
+
+    time1 := time.Now()
+    time2 := time1.Add(time.Second)
+    result4 := compare.GreaterThan(time2, time1)
+
+    result5 := compare.GreaterThan(1, 2)
+    result6 := compare.GreaterThan(int64(2), 1)
+    result7 := compare.GreaterThan("b", "c")
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+    fmt.Println(result6)
+    fmt.Println(result7)
+
+    // Output:
+    // true
+    // true
+    // true
+    // true
+    // false
+    // false
+    // false
+}
+```
+
+### <span id="LessOrEqual">LessOrEqual</span>
+
+<p>验证参数`left`的值是否小于或等于参数`right`的值。</p>
+
+<b>函数签名:</b>
+
+```go
+func LessOrEqual(left, right any) bool
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/compare"
+)
+
+func main() {
+    result1 := compare.LessOrEqual(1, 1)
+    result2 := compare.LessOrEqual(1.1, 2.2)
+    result3 := compare.LessOrEqual("a", "b")
+
+    time1 := time.Now()
+    time2 := time1.Add(time.Second)
+    result4 := compare.LessOrEqual(time1, time2)
+
+    result5 := compare.LessOrEqual(2, 1)
+    result6 := compare.LessOrEqual(1, int64(2))
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+    fmt.Println(result6)
+
+    // Output:
+    // true
+    // true
+    // true
+    // true
+    // false
+    // false
+}
+```
+
+### <span id="GreaterOrEqual">GreaterOrEqual</span>
+
+<p>验证参数`left`的值是否大于或参数`right`的值。</p>
+
+<b>函数签名:</b>
+
+```go
+func GreaterOrEqual(left, right any) bool
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/compare"
+)
+
+func main() {
+    result1 := compare.GreaterOrEqual(1, 1)
+    result2 := compare.GreaterOrEqual(2.2, 1.1)
+    result3 := compare.GreaterOrEqual("b", "b")
+
+    time1 := time.Now()
+    time2 := time1.Add(time.Second)
+    result4 := compare.GreaterOrEqual(time2, time1)
+
+    result5 := compare.GreaterOrEqual(1, 2)
+    result6 := compare.GreaterOrEqual(int64(2), 1)
+    result7 := compare.GreaterOrEqual("b", "c")
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+    fmt.Println(result6)
+    fmt.Println(result7)
+
+    // Output:
+    // true
+    // true
+    // true
+    // true
+    // false
+    // false
+    // false
+}
+```
--- a/docs/fileutil.md
+++ b/docs/fileutil.md
@@ -39,6 +39,10 @@ import (
 -   [Zip](#Zip)
 -   [UnZip](#UnZip)
 -   [IsZipFile](#IsZipFile)
+-   [FileSize](#FileSize)
+-   [MTime](#MTime)
+-   [Sha](#Sha)
+-   [ReadCsvFile](#ReadCsvFile)

 <div STYLE="page-break-after: always;"></div>

@@ -497,7 +501,6 @@ func main() {
 }
 ```

-
 ### <span id="IsZipFile">IsZipFile</span>

 <p>Checks if file is zip file or not.</p>
@@ -522,4 +525,138 @@ func main() {
    isZip := IsZipFile("./zipfile.zip")
    fmt.Println(isZip)
 }
-```
+```
+
+### <span id="FileSize">FileSize</span>
+
+<p>Returns file size in bytes.</p>
+
+<b>Signature:</b>
+
+```go
+func FileSize(path string) (int64, error)
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/fileutil"
+)
+
+func main() {
+    size, err := fileutil.FileSize("./testdata/test.txt")
+
+    fmt.Println(size)
+    fmt.Println(err)
+
+    // Output:
+    // 20
+    // <nil>
+}
+```
+
+### <span id="MTime">MTime</span>
+
+<p>Returns file modified time(unix timestamp).</p>
+
+<b>Signature:</b>
+
+```go
+func MTime(filepath string) (int64, error)
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/fileutil"
+)
+
+func main() {
+    mtime, err := fileutil.MTime("./testdata/test.txt")
+
+    fmt.Println(mtime)
+    fmt.Println(err)
+
+    // Output:
+    // 1682391110
+    // <nil>
+}
+```
+
+### <span id="Sha">Sha</span>
+
+<p>returns file sha value, param `shaType` should be 1, 256 or 512.</p>
+
+<b>Signature:</b>
+
+```go
+func Sha(filepath string, shaType ...int) (string, error)
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/fileutil"
+)
+
+func main() {
+    sha1, err := fileutil.Sha("./testdata/test.txt", 1)
+    sha256, _ := fileutil.Sha("./testdata/test.txt", 256)
+    sha512, _ := fileutil.Sha("./testdata/test.txt", 512)
+
+    fmt.Println(sha1)
+    fmt.Println(sha256)
+    fmt.Println(sha512)
+    fmt.Println(err)
+
+    // Output:
+    // dda3cf10c5a6ff6c6659a497bf7261b287af2bc7
+    // aa6d0a3fbc3442c228d606da09e0c1dc98c69a1cac3da1909199e0266171df35
+    // d22aba2a1b7a2e2f512756255cc1c3708905646920cb1eb95e45b531ba74774dbbb89baebf1f716220eb9cf4908f1cfc5b2a01267704d9a59f59d77cab609870
+    // <nil>
+}
+```
+
+### <span id="ReadCsvFile">ReadCsvFile</span>
+
+<p>Reads file content into slice.</p>
+
+<b>Signature:</b>
+
+```go
+func ReadCsvFile(filepath string) ([][]string, error)
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/fileutil"
+)
+
+func main() {
+    content, err := fileutil.ReadCsvFile("./testdata/test.csv")
+
+    fmt.Println(content)
+    fmt.Println(err)
+
+    // Output:
+    // [[Bob  12  male] [Duke  14  male] [Lucy  16  female]]
+    // <nil>
+}
+```
--- a/docs/fileutil_zh-CN.md
+++ b/docs/fileutil_zh-CN.md
@@ -39,6 +39,10 @@ import (
 -   [Zip](#Zip)
 -   [UnZip](#UnZip)
 -   [IsZipFile](#IsZipFile)
+-   [FileSize](#FileSize)
+-   [MTime](#MTime)
+-   [Sha](#Sha)
+-   [ReadCsvFile](#ReadCsvFile)

 <div STYLE="page-break-after: always;"></div>

@@ -108,7 +112,7 @@ func main() {
 func CreateDir(absPath string) error
 ```

-<b>Example:</b>
+<b>示例:</b>

 ```go
 package main
@@ -522,3 +526,137 @@ func main() {
    fmt.Println(isZip)
 }
 ```
+
+### <span id="FileSize">FileSize</span>
+
+<p>返回文件字节大小。</p>
+
+<b>函数签名:</b>
+
+```go
+func FileSize(path string) (int64, error)
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/fileutil"
+)
+
+func main() {
+    size, err := fileutil.FileSize("./testdata/test.txt")
+
+    fmt.Println(size)
+    fmt.Println(err)
+
+    // Output:
+    // 20
+    // <nil>
+}
+```
+
+### <span id="MTime">MTime</span>
+
+<p>返回文件修改时间(unix timestamp).</p>
+
+<b>函数签名:</b>
+
+```go
+func MTime(filepath string) (int64, error)
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/fileutil"
+)
+
+func main() {
+    mtime, err := fileutil.MTime("./testdata/test.txt")
+
+    fmt.Println(mtime)
+    fmt.Println(err)
+
+    // Output:
+    // 1682391110
+    // <nil>
+}
+```
+
+### <span id="Sha">Sha</span>
+
+<p>返回文件sha值，参数`shaType` 应传值为: 1, 256，512.</p>
+
+<b>函数签名:</b>
+
+```go
+func Sha(filepath string, shaType ...int) (string, error)
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/fileutil"
+)
+
+func main() {
+    sha1, err := fileutil.Sha("./testdata/test.txt", 1)
+    sha256, _ := fileutil.Sha("./testdata/test.txt", 256)
+    sha512, _ := fileutil.Sha("./testdata/test.txt", 512)
+
+    fmt.Println(sha1)
+    fmt.Println(sha256)
+    fmt.Println(sha512)
+    fmt.Println(err)
+
+    // Output:
+    // dda3cf10c5a6ff6c6659a497bf7261b287af2bc7
+    // aa6d0a3fbc3442c228d606da09e0c1dc98c69a1cac3da1909199e0266171df35
+    // d22aba2a1b7a2e2f512756255cc1c3708905646920cb1eb95e45b531ba74774dbbb89baebf1f716220eb9cf4908f1cfc5b2a01267704d9a59f59d77cab609870
+    // <nil>
+}
+```
+
+### <span id="ReadCsvFile">ReadCsvFile</span>
+
+<p>读取csv文件内容到切片</p>
+
+<b>函数签名:</b>
+
+```go
+func ReadCsvFile(filepath string) ([][]string, error)
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/fileutil"
+)
+
+func main() {
+    content, err := fileutil.ReadCsvFile("./testdata/test.csv")
+
+    fmt.Println(content)
+    fmt.Println(err)
+
+    // Output:
+    // [[Bob  12  male] [Duke  14  male] [Lucy  16  female]]
+    // <nil>
+}
+```
--- a/fileutil/file.go
+++ b/fileutil/file.go
@@ -402,7 +402,7 @@ func MTime(filepath string) (int64, error) {
 	return f.ModTime().Unix(), nil
 }

-// MTime returns file modified time, param `shaType` should be 1, 256 or 512.
+// MTime returns file sha value, param `shaType` should be 1, 256 or 512.
 // Play: todo
 func Sha(filepath string, shaType ...int) (string, error) {
 	file, err := os.Open(filepath)
@@ -436,7 +436,7 @@ func Sha(filepath string, shaType ...int) (string, error) {

 }

-// MTime returns file modified time.
+// ReadCsvFile read file content into slice.
 // Play: todo
 func ReadCsvFile(filepath string) ([][]string, error) {
 	f, err := os.Open(filepath)
--- a/fileutil/file_example_test.go
+++ b/fileutil/file_example_test.go
@@ -247,16 +247,16 @@ func ExampleFileSize() {
 	// <nil>
 }

-func ExampleMTime() {
-	mtime, err := MTime("./testdata/test.txt")
+// func ExampleMTime() {
+// 	mtime, err := MTime("./testdata/test.txt")

-	fmt.Println(mtime)
-	fmt.Println(err)
+// 	fmt.Println(mtime) // 1682478195 (unix timestamp)
+// 	fmt.Println(err)

-	// Output:
-	// 1682391110
-	// <nil>
-}
+// 	// Output:
+// 	// 1682478195
+// 	// <nil>
+// }

 func ExampleSha() {
 	sha1, err := Sha("./testdata/test.txt", 1)
--- a/fileutil/file_test.go
+++ b/fileutil/file_test.go
@@ -107,7 +107,7 @@ func TestReadFileToString(t *testing.T) {

 	_, err := f.WriteString("hello world")
 	if err != nil {
-		t.Log(err)
+		t.Error(err)
 	}

 	content, _ := ReadFileToString(path)
@@ -127,7 +127,7 @@ func TestClearFile(t *testing.T) {

 	_, err := f.WriteString("hello world")
 	if err != nil {
-		t.Log(err)
+		t.Error(err)
 	}

 	err = ClearFile(path)
@@ -151,7 +151,7 @@ func TestReadFileByLine(t *testing.T) {

 	_, err := f.WriteString("hello\nworld")
 	if err != nil {
-		t.Log(err)
+		t.Error(err)
 	}

 	expected := []string{"hello", "world"}
@@ -198,9 +198,9 @@ func TestFileMode(t *testing.T) {
 	CreateFile(srcFile)

 	mode, err := FileMode(srcFile)
-	assert.IsNil(err)

-	t.Log(mode)
+	assert.IsNotNil(mode)
+	assert.IsNil(err)

 	os.Remove(srcFile)
 }
@@ -267,9 +267,9 @@ func TestMTime(t *testing.T) {
 	assert := internal.NewAssert(t, "TestMTime")

 	mtime, err := MTime("./testdata/test.txt")
-
+	t.Log("TestMTime", mtime)
 	assert.IsNil(err)
-	assert.Equal(int64(1682391110), mtime)
+	// assert.Equal(int64(1682478195), mtime)
 }

 func TestSha(t *testing.T) {
@@ -289,7 +289,6 @@ func TestReadCsvFile(t *testing.T) {
 	assert := internal.NewAssert(t, "TestReadCsvFile")

 	content, err := ReadCsvFile("./testdata/test.csv")
-	t.Log(content)

 	assert.IsNil(err)

--- a/formatter/formatter_test.go
+++ b/formatter/formatter_test.go
@@ -55,8 +55,6 @@ func TestPretty(t *testing.T) {
 		result, err := Pretty(v)

 		assert.IsNil(err)
-
-		t.Log("result -> ", result)
 		assert.Equal(expects[i], result)
 	}
 }
--- a/mathutil/mathutil_test.go
+++ b/mathutil/mathutil_test.go
@@ -78,7 +78,6 @@ func TestAverage(t *testing.T) {
 	assert.Equal(Average(0, 0), 0)
 	assert.Equal(Average(1, 1), 1)
 	avg := Average(1.2, 1.4)
-	t.Log(avg)
 	assert.Equal(1.3, RoundToFloat(avg, 1))
 }

--- a/netutil/http_test.go
+++ b/netutil/http_test.go
@@ -182,7 +182,7 @@ func TestHttpClient_Get(t *testing.T) {
 	var todo Todo
 	err = httpClient.DecodeResponse(resp, &todo)
 	if err != nil {
-		t.Log(err)
+		t.FailNow()
 	}

 	assert.Equal(1, todo.Id)
--- a/netutil/net_test.go
+++ b/netutil/net_test.go
@@ -103,7 +103,7 @@ func TestEncodeUrl(t *testing.T) {
 	urlAddr := "http://www.lancet.com?a=1&b=[2]"
 	encodedUrl, err := EncodeUrl(urlAddr)
 	if err != nil {
-		t.Log(err)
+		t.Fail()
 	}

 	expected := "http://www.lancet.com?a=1&b=%5B2%5D"
--- a/random/random_test.go
+++ b/random/random_test.go
@@ -57,7 +57,6 @@ func TestRandNumeralOrLetter(t *testing.T) {
 	reg := regexp.MustCompile(pattern)

 	randStr := RandNumeralOrLetter(10)
-	t.Log(randStr)

 	assert := internal.NewAssert(t, "TestRandNumeralOrLetter")
 	assert.Equal(10, len(randStr))
@@ -68,7 +67,6 @@ func TestRandInt(t *testing.T) {
 	assert := internal.NewAssert(t, "TestRandInt")

 	r1 := RandInt(1, 10)
-	t.Log(r1)
 	assert.GreaterOrEqual(r1, 1)
 	assert.Less(r1, 10)

@@ -99,7 +97,6 @@ func TestUUIdV4(t *testing.T) {

 	uuid, err := UUIdV4()
 	if err != nil {
-		t.Log(err)
 		t.Fail()
 	}

--- a/slice/slice_test.go
+++ b/slice/slice_test.go
@@ -594,7 +594,6 @@ func TestInsertAt(t *testing.T) {
 	assert.Equal([]string{"a", "b", "c", "1"}, InsertAt(strs, 3, "1"))
 	assert.Equal([]string{"1", "2", "3", "a", "b", "c"}, InsertAt(strs, 0, []string{"1", "2", "3"}))
 	assert.Equal([]string{"a", "b", "c", "1", "2", "3"}, InsertAt(strs, 3, []string{"1", "2", "3"}))
-	t.Log(strs)
 }

 func TestUpdateAt(t *testing.T) {
@@ -821,10 +820,9 @@ func TestSortBy(t *testing.T) {
 		return a.Age < b.Age
 	})

-	t.Logf("sort users by age: %v", users)
-
-	// output
-	// [{b 15} {a 21} {c 100}]
+	assert.EqualValues(15, users[0].Age)
+	assert.EqualValues(21, users[1].Age)
+	assert.EqualValues(100, users[2].Age)
 }

 func TestSortByFielDesc(t *testing.T) {
@@ -890,7 +888,6 @@ func TestShuffle(t *testing.T) {

 	s := []int{1, 2, 3, 4, 5}
 	res := Shuffle(s)
-	t.Log("Shuffle result: ", res)

 	assert.Equal(5, len(res))
 }
--- a/system/os_darwin.go
+++ b/system/os_darwin.go
@@ -4,18 +4,11 @@ package system

 import (
 	"os/exec"
-	"syscall"
 )

 func WithForeground() Option {
 	return func(c *exec.Cmd) {
-		if c.SysProcAttr == nil {
-			c.SysProcAttr = &syscall.SysProcAttr{
-				Foreground: true,
-			}
-		} else {
-			c.SysProcAttr.Foreground = true
-		}
+
 	}
 }

--- a/system/os_test.go
+++ b/system/os_test.go
@@ -68,6 +68,16 @@ func TestExecCommand(t *testing.T) {
 	assert.IsNotNil(err)
 }

+// func TestExecCommandWithOption(t *testing.T) {
+// 	assert := internal.NewAssert(t, "TestExecCommandWithOption")
+
+// 	stdout, stderr, err := ExecCommand("ls", WithForeground())
+// 	t.Log("std out: ", stdout)
+// 	t.Log("std err: ", stderr)
+// 	assert.Equal("", stderr)
+// 	assert.IsNil(err)
+// }
+
 func TestGetOsBits(t *testing.T) {
 	osBits := GetOsBits()
 	switch osBits {
--- a/system/os_windows.go
+++ b/system/os_windows.go
@@ -18,3 +18,9 @@ func WithWinHide() Option {
 		}
 	}
 }
+
+func WithForeground() Option {
+	return func(c *exec.Cmd) {
+
+	}
+}
Author	SHA1	Message	Date
dudaodong	99cb1b13a3	test: remove unstable test item	2023-04-26 18:14:27 +08:00
dudaodong	42ec189995	release v2.1.20	2023-04-26 18:03:52 +08:00
dudaodong	424c291813	test: add TestExecCommandWithOption	2023-04-26 17:53:20 +08:00
dudaodong	4311b9ac66	test: remove t.Log()	2023-04-26 14:59:45 +08:00
dudaodong	581e338889	doc: add new function to readme file	2023-04-26 14:31:47 +08:00
dudaodong	f399425c2a	doc: add document for compare package	2023-04-26 11:02:11 +08:00
dudaodong	dcdb29334d	doc: update fileutils package document	2023-04-26 10:44:12 +08:00
dudaodong	4859f3ca23	test: add examples for compare package	2023-04-26 10:19:42 +08:00
dudaodong	9f2528842e	feat: add unit test for compare package	2023-04-26 10:05:09 +08:00