Merge pull request #219 from qiniu/develop

add comment to exported symbol

Author: tonycai653

CHANGELOG.md

@@ -1,5 +1,6 @@
 # 2.3.6
 1. 修复m3u8replace 上传的问题
+2. 加入reportCard检测代码质量
 
 # 2.3.5
 1. 增加token命令，创建Qbox token, qiniuToken, uploadToken

cmd/account.go

@@ -28,6 +28,7 @@ var cmdAccount = &cobra.Command{
 	Run: Account,
 }
 
+// 【account】获取本地保存的用户的AK/AK/Name信息； 设置保存用户AK/SK信息到本地
 func Account(cmd *cobra.Command, params []string) {
 	if len(params) == 0 {
 		account, gErr := iqshell.GetAccount()

cmd/alilistbucket.go

@@ -17,6 +17,7 @@ func init() {
 	RootCmd.AddCommand(aliCmd)
 }
 
+// 【alilistbucket】列举阿里空间中的文件列表
 func AliListBucket(cmd *cobra.Command, params []string) {
 	dataCenter := params[0]
 	bucket := params[1]

cmd/bucket.go

@@ -31,6 +31,7 @@ func init() {
 	RootCmd.AddCommand(bucketsCmd, domainsCmd)
 }
 
+// 【buckets】获取一个用户的所有的存储空间
 func GetBuckets(cmd *cobra.Command, params []string) {
 
 	bm := iqshell.GetBucketManager()
@@ -49,6 +50,7 @@ func GetBuckets(cmd *cobra.Command, params []string) {
 	}
 }
 
+// 【domains】获取一个空间绑定的CDN域名
 func GetDomainsOfBucket(cmd *cobra.Command, params []string) {
 	bucket := params[0]
 	bm := iqshell.GetBucketManager()

cmd/cdn.go

@@ -12,9 +12,14 @@ import (
 )
 
 const (
+	// CDN刷新一次性最大的刷新文件列表
 	BATCH_CDN_REFRESH_URLS_ALLOW_MAX = 100
+
+	// CDN目录刷新一次性最大的刷新目录数
 	BATCH_CDN_REFRESH_DIRS_ALLOW_MAX = 10
-	BATCH_CDN_PREFETCH_ALLOW_MAX     = 100
+
+	// 预取一次最大的预取数目
+	BATCH_CDN_PREFETCH_ALLOW_MAX = 100
 )
 
 var (
@@ -46,7 +51,7 @@ func init() {
 	RootCmd.AddCommand(cdnPreCmd, cdnRefreshCmd)
 }
 
-// 刷新CDN
+// 【cdnrefresh】刷新所有CDN节点
 func CdnRefresh(cmd *cobra.Command, params []string) {
 	var urlListFile string
 
@@ -123,7 +128,7 @@ func cdnRefresh(cm *cdn.CdnManager, urls []string, dirs []string) {
 	}
 }
 
-//  CDN 文件预取
+//  【cdnprefetch】CDN 文件预取
 func CdnPrefetch(cmd *cobra.Command, params []string) {
 	var urlListFile string
 

cmd/fop.go

@@ -30,6 +30,7 @@ func init() {
 	RootCmd.AddCommand(prefopCmd, fopCmd)
 }
 
+// 【prefop】根据persistentId查询异步处理的进度, 处理结果
 func Prefop(cmd *cobra.Command, params []string) {
 	persistentId := params[0]
 
@@ -42,6 +43,7 @@ func Prefop(cmd *cobra.Command, params []string) {
 	}
 }
 
+// 【pfop】 提交异步处理请求
 func Fop(cmd *cobra.Command, params []string) {
 	bucket, key, fops := params[0], params[1], params[2]
 

cmd/ip.go

@@ -10,9 +10,11 @@ import (
 )
 
 const (
+	// IP信息查询接口地址
 	TAOBAO_IP_QUERY = "http://ip.taobao.com/service/getIpInfo.php"
 )
 
+// 接口返回的IP信息
 type IpInfo struct {
 	Code int    `json:"code"`
 	Data IpData `json:"data"`
@@ -22,6 +24,7 @@ func (this IpInfo) String() string {
 	return fmt.Sprintf("%s", this.Data)
 }
 
+// ip 具体的信息
 type IpData struct {
 	Country   string `json:"country"`
 	CountryId string `json:"country_id"`
@@ -54,6 +57,7 @@ func init() {
 	RootCmd.AddCommand(ipQueryCmd)
 }
 
+// 【ip】查询ip的相关信息
 func IpQuery(cmd *cobra.Command, params []string) {
 	for _, ip := range params {
 		url := fmt.Sprintf("%s?ip=%s", TAOBAO_IP_QUERY, ip)

cmd/putfile.go

@@ -62,13 +62,15 @@ func init() {
 	RootCmd.AddCommand(formPutCmd, RePutCmd)
 }
 
+// 上传接口返回的文件信息
 type PutRet struct {
 	Key      string `json:"key"`
 	Hash     string `json:"hash"`
 	MimeType string `json:"mimeType"`
 	Fsize    int64  `json:"fsize"`
 }
 
+// 【fput】使用表单上传本地文件到七牛存储空间
 func FormPut(cmd *cobra.Command, params []string) {
 	bucket := params[0]
 	key := params[1]
@@ -183,6 +185,8 @@ func FormPut(cmd *cobra.Command, params []string) {
 	}
 }
 
+// 使用分片上传本地文件到七牛存储空间, 一般用于较大文件的上传
+// 文件会被分割成4M大小的块， 一块一块地上传文件
 func ResumablePut(cmd *cobra.Command, params []string) {
 	bucket := params[0]
 	key := params[1]

cmd/qdownload.go

@@ -12,7 +12,7 @@ import (
 )
 
 var qDownloadCmd = &cobra.Command{
-	Use:   "qdownload [<ThreadCount>] <LocalDownloadConfig>",
+	Use:   "qdownload [-c <ThreadCount>] <LocalDownloadConfig>",
 	Short: "Batch download files from the qiniu bucket",
 	Long:  "By default qdownload use 5 goroutines to download, it can be customized use -c <count> flag",
 	Args:  cobra.ExactArgs(1),
@@ -29,6 +29,9 @@ func init() {
 	RootCmd.AddCommand(qDownloadCmd)
 }
 
+// 【qdownload】下载七牛存储空间中的文件
+// 可以根据文件前缀下载符合要求的所有文件，也可以用户给到要下载的文件名字列表下载文件
+// 根据文件列表下载文件功能在文档中还没有公开，遇到有这个需求的客户比较少
 func QiniuDownload(cmd *cobra.Command, params []string) {
 
 	var downloadConfig iqshell.DownloadConfig

cmd/qupload.go

@@ -66,7 +66,8 @@ func parseUploadConfigFile(uploadConfigFile string, uploadConfig *iqshell.Upload
 	return
 }
 
-// upload cmd
+// [qupload]命令， 上传本地文件到七牛存储中
+// 该命令会读取配置文件， 上传本地文件系统的文件到七牛存储中; 可以设置多线程上传，默认的线程区间在[iqshell.MIN_UPLOAD_THREAD_COUNT, iqshell.MAX_UPLOAD_THREAD_COUNT]
 func QiniuUpload(cmd *cobra.Command, params []string) {
 
 	configFile := params[0]