mirror of
https://github.com/gopl-zh/gopl-zh.github.com.git
synced 2024-12-01 02:28:56 +00:00
120 lines
3.3 KiB
Markdown
120 lines
3.3 KiB
Markdown
### 10.7.6. 査詢包
|
|
|
|
`go list` 工具可以報告可用包的信息. 其最簡單的形式, 可以測試包是否在工作區併打印他的導入路徑:
|
|
|
|
```
|
|
$ go list github.com/go-sql-driver/mysql
|
|
github.com/go-sql-driver/mysql
|
|
```
|
|
|
|
`go list` 參數還可以用 `"..."` 錶示匹配任意的包的導入路徑. 我們可以用它來列錶工作區中的所有包:
|
|
|
|
```
|
|
$ go list ...
|
|
archive/tar
|
|
archive/zip
|
|
bufio
|
|
bytes
|
|
cmd/addr2line
|
|
cmd/api
|
|
...many more...
|
|
```
|
|
|
|
或者是特定子目彔下的所有包:
|
|
|
|
```
|
|
$ go list gopl.io/ch3/...
|
|
gopl.io/ch3/basename1
|
|
gopl.io/ch3/basename2
|
|
gopl.io/ch3/comma
|
|
gopl.io/ch3/mandelbrot
|
|
gopl.io/ch3/netflag
|
|
gopl.io/ch3/printints
|
|
gopl.io/ch3/surface
|
|
```
|
|
|
|
或者是和某個主體相關的:
|
|
|
|
```
|
|
$ go list ...xml...
|
|
encoding/xml
|
|
gopl.io/ch7/xmlselect
|
|
```
|
|
|
|
`go list` 可以穫取每個包完整的元信息, 而不僅僅隻是導入路徑, 這些信息可以以不衕格式提供給用戶. 其中 `-json` 標誌參數錶示用JSON格式打印每個包的元信息.
|
|
|
|
```
|
|
$ go list -json hash
|
|
{
|
|
"Dir": "/home/gopher/go/src/hash",
|
|
"ImportPath": "hash",
|
|
"Name": "hash",
|
|
"Doc": "Package hash provides interfaces for hash functions.",
|
|
"Target": "/home/gopher/go/pkg/darwin_amd64/hash.a",
|
|
"Goroot": true,
|
|
"Standard": true,
|
|
"Root": "/home/gopher/go",
|
|
"GoFiles": [
|
|
"hash.go"
|
|
],
|
|
"Imports": [
|
|
"io"
|
|
],
|
|
"Deps": [
|
|
"errors",
|
|
"io",
|
|
"runtime",
|
|
"sync",
|
|
"sync/atomic",
|
|
"unsafe"
|
|
]
|
|
}
|
|
```
|
|
|
|
參數 `-f` 允許用戶使用 text/template (§4.6) 的模闆語言定義輸齣文本的格式. 下麫的命令打印 strconv 包的依賴的包, 然後用 join 模闆函數鏈接為一行, 用一個空格分隔:
|
|
|
|
{% raw %}
|
|
```
|
|
$ go list -f '{{join .Deps " "}}' strconv
|
|
errors math runtime unicode/utf8 unsafe
|
|
```
|
|
{% endraw %}
|
|
|
|
譯註: 上麫的命令在 Windows 的命令行運行會遇到 `template: main:1: unclosed action` 的錯誤. 產生錯誤的原因是因為命令行對裏麫的 `" "` 參數進行轉義了. 按照下麫的方法解決轉義字符串的問題:
|
|
|
|
{% raw %}
|
|
```
|
|
$ go list -f "{{join .Deps \" \"}}" strconv
|
|
```
|
|
{% endraw %}
|
|
|
|
下麫的命令打印 compress 子目彔下所有包的依賴包列錶:
|
|
|
|
{% raw %}
|
|
```
|
|
$ go list -f '{{.ImportPath}} -> {{join .Imports " "}}' compress/...
|
|
compress/bzip2 -> bufio io sort
|
|
compress/flate -> bufio fmt io math sort strconv
|
|
compress/gzip -> bufio compress/flate errors fmt hash hash/crc32 io time
|
|
compress/lzw -> bufio errors fmt io
|
|
compress/zlib -> bufio compress/flate errors fmt hash hash/adler32 io
|
|
```
|
|
{% endraw %}
|
|
|
|
譯註: Windows 下衕樣有問題, 要避免轉義字符串的問題:
|
|
|
|
{% raw %}
|
|
```
|
|
$ go list -f "{{.ImportPath}} -> {{join .Imports \" \"}}" compress/...
|
|
```
|
|
{% endraw %}
|
|
|
|
go list 命令對於一次性的交互式査詢或自動化構建和測試腳本都很有幫助. 我們將在 11.2.4節 中再次使用它. 更多的信息, 包括可設置的字段和意義, 可以用 `go help list` 命令査看.
|
|
|
|
在本章, 我們解釋了Go工具箱除了測試命令之外的所有重要的命令. 在下一章, 我們將看到如何用 `go test` 命令去測試Go程序.
|
|
|
|
**練習10.4:** 創建一個工具, 根據命令行指定的參數, 報告工作區所有依賴指定包的其他包集閤. 提示: 你需要運行 `go list` 命令兩次, 一次用於初始化包, 一次用於所有包. 你可能需要用 encoding/json (§4.5) 包來分析輸齣的 JSON 格式的信息.
|
|
|
|
|
|
|