This document summarizes a conference presentation about Go tools and libraries. It discusses swaggo for generating Swagger documentation from Go code comments, scaneo for scanning Go code to find database queries, and go-openapi/spec for generating OpenAPI/Swagger specifications from Go code. It also provides an overview of using the Go AST and code generation tools.

1. Go Conference 2018 Spring @pei0804

4. • twitter/github @pei0804
• Hatena tikasan
• VOYAGE GROUP
2018
• OSS
swaggo: GoDoc Swagger

6. •
•
•

11. database/sql Scan

12. github.com/variadico/scaneo

13. $ scaneo hoge.go
scans.go

15. Scan

17. github.com/variadico/scaneo

19. •
func ScanCategory
func ScanCategories
•
func ScanCategory
func ScanCategorys

20.
Category
Categorys

22. tmpl.go
PR

27. OSS

28.
Fork

29. Fork
&&

30. OSS

34. github.com/swaggo/swag

35. github.com/swaggo/swag
Go
Swagger
Swagger API
※Go

37. Getting started

38. $ go get -u github.com/swaggo/swag/cmd/swag

40. API

42. $ swag init

44. docs/swagger/swagger.json

45. Swagger UI
swaggo Middleware

47. http://localhost:8080/swagger/index.html

53. •
•
• API
•
• Swagger spec

54. •
•
• API
•
• Swagger spec

55.
※
• @title
• @version
• @basepath URI
• @host
•

58. parser.go

59. parser.go

60. AST go/parser
• : abstract syntax tree AST
wikipedia

61. • Go AST Hello,
World #golang
https://qiita.com/tenntenn/items/
0cbc6f1f00dc579fcd8c
• Go Go
https://motemen.github.io/go-for-go-book/

62. ParseFile
• Go
•
fset *token.FileSet, filename string, src
interface{}, mode Mode
•
*ast.File, error

63. ast.File

64. ast.File

66. parser.go

67. •
•
• API
•
• Swagger spec

68. API ( )
※
• @param
• @success
• @failure
• @router
• @accept, @produce MimeType

71. parser.go

72. parser.go

73. parser.go

74. parser.go

75. parser.go

76. parser.go

77. parser.go

78. OK

81.
// @Success 200 {array} model.Account "User"
@Success {param }

83. α

85.
// @Param default query string false "string
default" default(A)
Swagger

86.
// @Param default query string false "string default"
Enums(A, B ,C) default(A)

87. 🤔

88. // @Param default query string false "string
default" Enums(A, B ,C) default(A)
// @Param default query string false "string
default" Enums(A, B ,C) default(A)

89.
😇

91. Model

92. @Param account body model.Account ~~
model Account
Model

93. AST
TypeDefinitions map[string]map[string]*ast.TypeSpec
map[ ][ ] AST
model
TypeDefinitions["model"]["Account"] model
Account AST

96. •
•
•

97. •
•
•

99. parser.go

100. parser.go

101. parser.go

102. parser.go

103. parser.go

104. •
•
•

106. parser.go

107. parser.go

112.
😇

118. User Family
User
Family User
Family
User
Family User
panic

119. •
•
•

120. 🤔

121. •
•
•

123. parser.go

124. parser.go

125. User Family
User
Family User
Family
User
Family User
panic

126. User Family
User
Family User
Family
User
Family User
panic

127. 😂

128. •
•
• API
•
• Swagger spec

129. github.com/go-openapi/spec

130. github.com/go-openapi/spec
Swagger2.0 spec
go-swagger/go-swagger
Swagger

131. 3.0
github.com/go-openapi/spec3

132.
Swagger

135. •
•

136. •

141.
OSS
swaggo welcome

142. • github.com/mercari/go-httpdoc
• github.com/goadesign/goa
DSL Swagger
• github.com/cheekybits/genny
Go

143. • Go
https://www.slideshare.net/lestrrat/go-86436442
• go generate go/ast
https://speakerdeck.com/masashisalvador57f/ast-falsezatukuritositahua
• go generate
http://agtn.hatenablog.com/entry/2017/08/06/015813