7x31/the-way-to-go_ZH_CN
1
0
Fork 0
mirror of https://github.com/unknwon/the-way-to-go_ZH_CN.git synced 2025-08-12 07:02:11 +08:00
Code Issues Packages Projects Releases Wiki Activity

9.8

Browse Source
This commit is contained in:
Unknwon
2015-03-06 00:55:06 -05:00
parent 5ec2c25387
commit 8a934e940d
4 changed files with 89 additions and 74 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
README.md
View File

@@ -9,7 +9,7 @@
## 翻译进度 ## 翻译进度
9.7 [使用 go install 安装自定义包](eBook/09.7.md) 9.8 [自定义包的目录结构、go install 和 go test](eBook/09.8.md)
## 支持本书 ## 支持本书

144
eBook/09.8.md
View File

@@ -1,50 +1,57 @@
# 9.8 自定义包的目录结构、go install 和 go test # 9.8 自定义包的目录结构、go install 和 go test
212 为了示范，我们创建了一个名为 uc 的简单包,它含有一个 UpperCase 函数将字符串的所有字母转换为大写。当然这并不值得创建一个自己包，同样的功能已被包含在 "strings" 包里，但是同样的技术也可以应用在更复杂的包中。
为了示范，我们创建了一个名为uc的简单包,它含有一个UpperCase函数将字符串的所有字母转换为大写。当然这并不值得创建一个自己包，同样的功能已被包含在"strings"包里，但是同样的技术也可以应用在更复杂的包中。
##9.8.1 自定义包的目录结构 ## 9.8.1 自定义包的目录结构
下面的结构给了你一个好的示范(uc代表通用包名, 名字为粗体的代表目录，斜体代表可执行文件):
下面的结构给了你一个好的示范(uc 代表通用包名, 名字为粗体的代表目录，斜体代表可执行文件):
/home/user/goprograms /home/user/goprograms
ucmain.go (uc包主程序) ucmain.go (uc包主程序)
Makefile (ucmain的2-makefile) Makefile (ucmain的2-makefile)
ucmain ucmain
src/uc (包含uc包的go源码) src/uc (包含uc包的go源码)
uc.go uc.go
uc_test.go
Makefile (包的1-makefile) Makefile (包的1-makefile)
Makefile (包的1-makefile) uc.a
uc.a _obj
_obj uc.a
_test
_test uc.a
bin (包含最终的执行文件) bin (包含最终的执行文件)
ucmain ucmain
pkg/linux_amd64 pkg/linux_amd64
ucmain uc.a (包的目标文件)
pkg/linux_amd64
将你的项目放在 goprograms 目录下(你可以创建一个环境变量 GOPATH，详见第 2.2/3 章节：在 .profile 和 .bashrc 文件中添加 `export GOPATH=/home/user/goprograms`)，而你的项目将作为 src 的子目录。uc 包　中的功能在 uc.go 中实现。 将你的项目放在 goprograms 目录下(你可以创建一个环境变量 GOPATH，详见第 2.2/3 章节：在 .profile 和 .bashrc 文件中添加 `export GOPATH=/home/user/goprograms`)，而你的项目将作为 src 的子目录。uc 包　中的功能在 uc.go 中实现。
示例 9.6 [uc.go](examples/chapter_9/uc.go)：
将你的项目放在goprograms目录下(你可以创建一个环境变量GOPATH,参考2.2/3章节:在.profile和.bashrc文件中添加export GOPATH=/home/user/goprograms)，而你的项目将作为src的子目录。uc包　中的功能在uc.go中实现。
```go ```go
示例 9.6 [uc.go](examples/chapter_9/uc.go) package uc
import "strings"
package uc
import "strings" func UpperCase(str string) string {
return strings.ToUpper(str)
} }
return strings.ToUpper(str) ```
}
包通常附带一个或多个测试文件，在这我们创建了一个 uc_test.go 文件，如第 9.8 节所述。
包通常附带一个或多个测试文件，在这我们创建了一个uc_test.go文件，如9.8章节所述
示例 9.7 [test.go](examples/chapter_9/uc.go)
示例 9.7 [test.go](examples/chapter_9/uc.go)
```go ```go
package uc package uc
import "testing"
type ucTest struct {
type ucTest struct {
in, out string
}
var ucTests = []ucTest { var ucTests = []ucTest {
ucTest{"abc", "ABC"}, ucTest{"abc", "ABC"},
ucTest{"cvo-az", "CVO-AZ"}, ucTest{"cvo-az", "CVO-AZ"},
@@ -53,37 +60,39 @@
func TestUC(t *testing.T) { func TestUC(t *testing.T) {
for _, ut := range ucTests { for _, ut := range ucTests {
uc := UpperCase(ut.in)
if uc != ut.out { if uc != ut.out {
t.Errorf("UpperCase(%s) = %s, must be %s", ut.in, uc, t.Errorf("UpperCase(%s) = %s, must be %s", ut.in, uc,
for _, ut := range ucTests { ut.out)
} }
if uc != ut.out { }
} }
ut.out) ```
} 通过指令编译并安装包到本地：`go install src/uc`, 这会将 uc.a 复制到 pkg/linux_amd64 下面。
通过指令编译并安装包到本地：go install src/uc, 这会将uc.a复制到pkg/linux_amd64下面 另外，使用 make,通过以下内容创建一个包的 Makefile(1) 在 src/uc 目录下:
include $GOROOT/src/Make.inc
TARG=uc
GOFILES=\ GOFILES=\
GOFILES=\ uc.go\
uc.go\
include $(GOROOT)/scr/Make.pkg
include $(GOROOT)/scr/Make.pkg
在该目录下的命令行调用: gomake 在该目录下的命令行调用: gomake
这将创建一个 _obj 目录并将包编译生成的存档uc.a放在该目录下 这将创建一个 _obj 目录并将包编译生成的存档uc.a放在该目录下
这将创建一个_obj目录并将包编译生成的存档uc.a放在该目录下
这个包可以通过 go test 测试
这个包可以通过go test测试
创建一个 ud.a 的测试文件在目录下，输出为 PASS 时测试通过
在第 13.8 节我们将给出另外一个测试例子并进行深入研究。 在第 13.8 节我们将给出另外一个测试例子并进行深入研究。
备注：有可能你当前的用户不具有足够的资格使用 go　install(没有权限)。这种情况下，选择 root 用户 su。确保 Go 环境变量和 Go 源码路径也设置给 su，同样也适用你的普通用户(详见第 2.3 节)。 备注：有可能你当前的用户不具有足够的资格使用 go　install(没有权限)。这种情况下，选择 root 用户 su。确保 Go 环境变量和 Go 源码路径也设置给 su，同样也适用你的普通用户(详见第 2.3 节)。
备注：有可能你当前的用户不具有足够的资格使用go　install(没有权限)。这种情况下，选择root用户su。确保Go环境变量和Go源码路径也设置给su，同样也适用你的普通用户(详见2.3章节)
接下来我们创建主程序 ucmain.go: 接下来我们创建主程序 ucmain.go:
示例 9.8 [ucmain.go](/examples/chapter_9/ucmain.go)： 示例 9.8 [ucmain.go](/examples/chapter_9/ucmain.go)：
@@ -91,25 +100,24 @@
```go ```go
package main package main
import ( import (
"fmt" "fmt"
"./uc/uc" "./uc/uc"
) )
func main() { func main() {
str1 := "USING package uc" str1 := "USING package uc"
fmt.Println(uc.UpperCase(str1)) fmt.Println(uc.UpperCase(str1))
} }
``` ```
然后在这个目录下输入go install
然后在这个目录下输入 `go install`。
另外复制uc.a到uc目录并创建一个Makefile(2)并写入文本：
另外复制 uc.a 到 uc 目录并创建一个 Makefile(2) 并写入文本包含在 $GOROOT/src/Make.inc： 另外复制 uc.a 到 uc 目录并创建一个 Makefile(2) 并写入文本包含在 $GOROOT/src/Make.inc：
TARG=ucmain TARG=ucmain
GOFILES=\ GOFILES=\
ucmain.go\
ucmain.go\ ucmain.go\
include $GOROOT/src/Make.cmd include $GOROOT/src/Make.cmd
执行 gomake 编译 ucmain.go 到 ucmain 目录 执行 gomake 编译 ucmain.go 到 ucmain 目录
@@ -118,8 +126,12 @@ uc包可以通过"import uc"在任何Go程序中被引用。
## 9.8.2 本地安装包 ## 9.8.2 本地安装包
本地包在用户目录下，使用给出的目录结构，以下命令用来从源码安装本地包：
go install /home/user/goprograms/src/uc # 编译安装uc
cd /home/user/goprograms/uc go install /home/user/goprograms/src/uc # 编译安装uc
go install ./uc # 编译安装uc（和之前的指令一样） cd /home/user/goprograms/uc
cd .. go install ./uc # 编译安装uc（和之前的指令一样）
cd ..
go install . # 编译安装ucmain
安装到 $GOROOT 下：

4
eBook/09.9.md
View File

@@ -1,4 +1,6 @@
#9.9 通过git打包和安装 # 9.9 通过 git 打包和安装
216
##9.9.1 安装到github ##9.9.1 安装到github
以上的方式对于本地包来说是可以的，但是我们如何打包代码到开发者圈子呢？那么我们需要一个云端的源码的版本控制系统，比如著名的git。 以上的方式对于本地包来说是可以的，但是我们如何打包代码到开发者圈子呢？那么我们需要一个云端的源码的版本控制系统，比如著名的git。

1
eBook/directory.md
View File

@@ -81,6 +81,7 @@
- 9.6 [为自定义包使用 godoc](09.6.md) - 9.6 [为自定义包使用 godoc](09.6.md)
- 9.7 [使用 go install 安装自定义包](09.7.md) - 9.7 [使用 go install 安装自定义包](09.7.md)
- 9.8 [自定义包的目录结构、go install 和 go test](09.8.md) - 9.8 [自定义包的目录结构、go install 和 go test](09.8.md)
- 9.9 [通过 git 打包和安装](09.9.md)
- 第10章：结构（struct）与方法（method） - 第10章：结构（struct）与方法（method）
- 第11章：接口（interface）与反射（reflection） - 第11章：接口（interface）与反射（reflection）