修改包路徑
This commit is contained in:
		
							
								
								
									
										18
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										18
									
								
								README.md
									
									
									
									
									
								
							@@ -3,15 +3,17 @@
 | 
				
			|||||||
### 1. 编译goctl-swagger插件
 | 
					### 1. 编译goctl-swagger插件
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
$ GO111MODULE=on GOPROXY=https://goproxy.cn/,direct go get -u github.com/zeromicro/goctl-swagger
 | 
					GO111MODULE=on GOPROXY=https://goproxy.cn/,direct go get -u github.com/fachebot/goctl-swagger
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### 2. 配置环境
 | 
					### 2. 配置环境
 | 
				
			||||||
 | 
					
 | 
				
			||||||
将$GOPATH/bin中的goctl-swagger添加到环境变量
 | 
					将$GOPATH/bin中的goctl-swagger添加到环境变量
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### 3. 使用姿势
 | 
					### 3. 使用姿势
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* 创建api文件
 | 
					* 创建api文件
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    ```go
 | 
					    ```go
 | 
				
			||||||
    info(
 | 
					    info(
 | 
				
			||||||
     title: "type title here"
 | 
					     title: "type title here"
 | 
				
			||||||
@@ -77,19 +79,27 @@ $ GO111MODULE=on GOPROXY=https://goproxy.cn/,direct go get -u github.com/zeromic
 | 
				
			|||||||
     get /api/user/search (UserSearchReq) returns (UserInfoReply)
 | 
					     get /api/user/search (UserSearchReq) returns (UserInfoReply)
 | 
				
			||||||
    }
 | 
					    }
 | 
				
			||||||
    ```
 | 
					    ```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* 生成swagger.json 文件
 | 
					* 生成swagger.json 文件
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    ```shell script
 | 
					    ```shell script
 | 
				
			||||||
    $ goctl api plugin -plugin goctl-swagger="swagger -filename user.json" -api user.api -dir .
 | 
					    goctl api plugin -plugin goctl-swagger="swagger -filename user.json" -api user.api -dir .
 | 
				
			||||||
    ```
 | 
					    ```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* 指定Host,basePath [api-host-and-base-path](https://swagger.io/docs/specification/2-0/api-host-and-base-path/)
 | 
					* 指定Host,basePath [api-host-and-base-path](https://swagger.io/docs/specification/2-0/api-host-and-base-path/)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    ```shell script
 | 
					    ```shell script
 | 
				
			||||||
    $ goctl api plugin -plugin goctl-swagger="swagger -filename user.json -host 127.0.0.2 -basepath /api" -api user.api -dir .
 | 
					    goctl api plugin -plugin goctl-swagger="swagger -filename user.json -host 127.0.0.2 -basepath /api" -api user.api -dir .
 | 
				
			||||||
    ```
 | 
					    ```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* swagger ui 查看生成的文档
 | 
					* swagger ui 查看生成的文档
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    ```shell script
 | 
					    ```shell script
 | 
				
			||||||
     $ docker run --rm -p 8083:8080 -e SWAGGER_JSON=/foo/user.json -v $PWD:/foo swaggerapi/swagger-ui
 | 
					     docker run --rm -p 8083:8080 -e SWAGGER_JSON=/foo/user.json -v $PWD:/foo swaggerapi/swagger-ui
 | 
				
			||||||
   ```
 | 
					   ```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* Swagger Codegen 生成客户端调用代码(go,javascript,php)
 | 
					* Swagger Codegen 生成客户端调用代码(go,javascript,php)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  ```shell script
 | 
					  ```shell script
 | 
				
			||||||
  for l in go javascript php; do
 | 
					  for l in go javascript php; do
 | 
				
			||||||
    docker run --rm -v "$(pwd):/go-work" swaggerapi/swagger-codegen-cli generate \
 | 
					    docker run --rm -v "$(pwd):/go-work" swaggerapi/swagger-codegen-cli generate \
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -1,9 +1,9 @@
 | 
				
			|||||||
package action
 | 
					package action
 | 
				
			||||||
 | 
					
 | 
				
			||||||
import (
 | 
					import (
 | 
				
			||||||
 | 
						"github.com/fachebot/goctl-swagger/generate"
 | 
				
			||||||
	"github.com/urfave/cli/v2"
 | 
						"github.com/urfave/cli/v2"
 | 
				
			||||||
	"github.com/zeromicro/go-zero/tools/goctl/plugin"
 | 
						"github.com/zeromicro/go-zero/tools/goctl/plugin"
 | 
				
			||||||
	"github.com/zeromicro/goctl-swagger/generate"
 | 
					 | 
				
			||||||
)
 | 
					)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
func Generator(ctx *cli.Context) error {
 | 
					func Generator(ctx *cli.Context) error {
 | 
				
			||||||
 
 | 
				
			|||||||
							
								
								
									
										2
									
								
								go.mod
									
									
									
									
									
								
							
							
						
						
									
										2
									
								
								go.mod
									
									
									
									
									
								
							@@ -1,4 +1,4 @@
 | 
				
			|||||||
module github.com/zeromicro/goctl-swagger
 | 
					module github.com/fachebot/goctl-swagger
 | 
				
			||||||
 | 
					
 | 
				
			||||||
go 1.16
 | 
					go 1.16
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user