[dev] Go语言查看doc与生成API doc
类似与javadoc,go也可以自动生成doc文档。
方法有两个:
1. 使用go doc工具
可以查看它的详细文档:
go help doc
示例:
在这个目录下,我创建一个api包
╰─>$ pwd
/home/tong/Src/go/src/local/test/api/api.go
代码是这样的:
package api import "fmt" type TestApi struct {
var1 int
var2 int
var3 string
Var4 int
Var5 string
} func (p *TestApi) internalFunc() {
fmt.Println("I am Test.")
} func (p *TestApi) Func1() {
p.internalFunc()
} func (p *TestApi) Func2() {
p.internalFunc()
}
可以使用如下命令查看API:
package api import "fmt" type TestApi struct {
var1 int
var2 int
var3 string
Var4 int
Var5 string
} func (p *TestApi) internalFunc() {
fmt.Println("I am Test.")
} func (p *TestApi) Func1() {
p.internalFunc()
} func (p *TestApi) Func2() {
p.internalFunc()
}
2 使用godoc工具
还有一个工具,叫godoc,需要单独安装 https://godoc.org/golang.org/x/tools/cmd/godoc
go get golang.org/x/tools/cmd/godoc
build之后,会生成在GOPATH/bin下。
然后,运行这个工具,他会开启一个http服务在6060端口
┬─[tong@T7:~/Src/go/src/local/test/api]─[:: PM]
╰─>$ $GOPATH/bin/godoc
你的所有go工程下代码的api都能根据包的树结构进行查看。访问如下url,可以查看前文目标包的所有API
http://127.0.0.1:6060/pkg/local/test/api/
如图:
3. 把API文档保存出来的话,可以这样
$GOPATH/bin/godoc -url "http://localhost:6060/pkg/container/heap/" > page.html
但是,网页外链太多的话,其实并不好用。
[dev] Go语言查看doc与生成API doc的更多相关文章
- java基础学习总结五(递归算法、冒泡排序、查看生成API)
一:递归算法 概念:自己调用自己的方法 示例代码如下: @Test /** * 递归求和 * 5+4+3+2+1=15 */ public void getSum() { long sum = sum ...
- 利用sphinx为python项目生成API文档
sphinx可以根据python的注释生成可以查找的api文档,简单记录了下步骤 1:安装 pip install -U Sphinx 2:在需要生成文档的.py文件目录下执行sphinx-apido ...
- 使用sphinx快速为你python注释生成API文档
sphinx简介sphinx是一种基于Python的文档工具,它可以令人轻松的撰写出清晰且优美的文档,由Georg Brandl在BSD许可证下开发.新版的Python3文档就是由sphinx生成的, ...
- eclipse 中为 java 项目生成 API 文档、JavaDoc
当我们的项目很大,编写了很多代码的时候,就需要生成一个标准的 API 文档,让后续的开发人员,或者合作者可以清晰的了解您方法的使用. 1.点击 eclipse 的 Project 菜单,选择 Gene ...
- .NET Core 3.0 使用Nswag生成Api文档和客户端代码
摘要 在前后端分离.Restful API盛行的年代,完美的接口文档,成了交流的纽带.在项目中引入Swagger (也称为OpenAPI),是种不错的选择,它可以让接口数据可视化.下文将会演示 利用N ...
- Codeigniter项目使用phpDocumentor生成api文档
前言 运行环境: vagrant 2.2.4 virtualbox 6.0 box bento/ubuntu-16.04 (Apache 2.4.18 + Mysql 5.7.26 + PHP 5.6 ...
- Laravel(PHP)使用Swagger生成API文档不完全指南 - 基本概念和环境搭建 - 简书
在PHPer中,很多人听说过Swagger,部分人知道Swagger是用来做API文档的,然而只有少数人真正知道怎么正确使用Swagger,因为PHP界和Swagger相关的资料实在是太少了.所以鄙人 ...
- 注释生成Api文档
1.开发背景 最近一直在写dubbo接口,以前总是用word文档写接口描述然后发给别人.现在太多了,而且跟别人对接联调的人家急着用,根本没时间去写word文档.那就想想怎么用doc文档注释自动生成接口 ...
- 如何生成JavaAPI doc
1 准备工作 1.1 填写完整的注释 对需要生成API的类,填写完整的注释,包括类注释,方法注释,具体格式如下: 类注释: 原先可能author是作者,需要修改成author英文 ...
随机推荐
- vim简单使用教程【转】
vim的学习曲线相当的大(参看各种文本编辑器的学习曲线),所以,如果你一开始看到的是一大堆VIM的命令分类,你一定会对这个编辑器失去兴趣的.下面的文章翻译自<Learn Vim Progress ...
- jarvisoj level5爬坑
本着纸上得来终觉浅,绝知此事要躬行的原则,把一个简单的ROP做了一下.漏洞很明显,libc有给出:唯一的限制就是不允许调用system或execve,而是用mprotect或者mmap 脚本调了半天, ...
- 51nod--1079 中国剩余定理
题目: 1079 中国剩余定理 基准时间限制:1 秒 空间限制:131072 KB 分值: 0 难度:基础题 收藏 关注 一个正整数K,给出K Mod 一些质数的结果,求符合条件的最小的K.例如,K ...
- 【原创】运维基础之Docker(3)搭建私有仓库
下载并启动registry $ docker pull registry$ docker run --name my_registry -d -p 5000:5000 -v /var/lib/regi ...
- select获取选中的option(包含value和text,重点是text怎么获取)
简单描述:后台需要获取到select标签选择的内容,也就是text,该怎么取呢?很简单. 代码: //hml代码<div class="col-md-6"> <l ...
- ES6 语法学习(二)
1.类的建立与继承 constructor方法是类的构造函数是默认方法,通过new命令生成对象实例时,自动调用该方法.一个类必须有constructor方法,如果没有显式定义,一个默认的constru ...
- Storm介绍及安装部署
本节内容: Apache Storm是什么 Apache Storm核心概念 Storm原理架构 Storm集群安装部署 启动storm ui.Nimbus和Supervisor 一.Apache S ...
- getOrderValue 排序 sql server
GO -- =============================================-- Author: <Author,,rx.tang>-- Creat ...
- html_头部<meta>设置
<!DOCTYPE html> : 定义HTML的规则类型:浏览器兼容性最好 <!DOCTYPE html><html> <head> <!--编 ...
- 1002-谈谈ELK日志分析平台的性能优化理念
在生产环境中,我们为了更好的服务于业务,通常会通过优化的手段来实现服务对外的性能最大化,节省系统性能开支:关注我的朋友们都知道,前段时间一直在搞ELK,同时也记录在了个人的博客篇章中,从部署到各个服务 ...