gpgc

README

gpgc

[toc]

介绍

基于proto自动生成pb、swagger、controller等，以及处理pb的tags。 类库列表：

• cobra
• inject_tag

目录

.
├── Makefile
├── README.md
├── cmd
│   ├── gen.go
│   ├── gen_test.go
│   └── root.go
├── example
│   ├── controller
│   ├── pb
│   ├── proto
│   ├── swagger
│   └── third_party
├── gen
│   ├── controller.go
│   ├── controller_test.go
│   ├── generator.go
│   └── proto.go
├── go.mod
├── go.sum
├── main.go
└── util
    ├── file.go
    ├── util.go
    └── util_test.go

安装教程

1. 安装 Makefile
2. 安装 protoc 二进制安装: https://github.com/protocolbuffers/protobuf/releases 下载,

   mac: protoc-3.17.3-osx-x86_64.zip 解压后进入目录，拷贝相关文件到环境变量中:

    mv bin/protoc /usr/local/bin/   
    mv include/google /usr/local/include/  
   

   windows: protoc-3.17.3-win64.zip 解压复制 bin/protoc.exe 到GOBIN目录.

3. 安装 pb(golang)、swagger、tag 插件

go get -u google.golang.org/protobuf/cmd/protoc-gen-go go get -u github.com/grpc-ecosystem/grpc-gateway/protoc-gen-swagger go get -u github.com/favadi/protoc-go-inject-tag go get -u gitee.com/krio/gpgc

github.com/golang/protobuf 旧版本，具体详见： https://www.136.la/shida/show-157324.html

flags参数介绍

-p, --proto proto目录: example/proto/v1 -b, --pb pb目录: example/pb/v1 -w, --swagger swagger目录: example/swagger/v1 -t, --third_party third_party目录: example/third_party -c, --controller controller目录: example/controller

如何使用

• 如何定义一个proto

syntax = "proto3";

package dto.proto.v1; # proto路径(重要)
option go_package = "dto/pb/v1"; # pb路径(重要)

import "google.golang.org/api/annotations.proto";

// v1/controller.go  # controller文件路径(重要)
service TestService { # 必须带上 Service(重要)
    // test # 备注
    rpc Test(TestReq) returns (TestResp) {
        option (google.api.http) = {
            post: "/api/v1/test"
            body: "*"
        };
    }
}

message TestReq {
    int32 id = 1;
}

message TestResp {
    string name = 1;
    int32 age = 2;
}

• 自定义 Tag

form      请求request绑定对应结构体，推荐加上
example   swagger的字段描述  
validate  入参验证（规则参考：github.com/go-playground/validator/v10） 
label     验证字段对应描述
json      如想去掉protoc默认生成的omitempty（忽略类型）属性，重新定义即可
 
message UserAddReq {
    // @inject_tag: form:"phone_number" validate:"required" example:"180xxxx2021" label:"手机号"
    string phone_number = 1;
    // @inject_tag: form:"email" example:"emai@163.com" label:"邮箱"
    string email = 2;
    // @inject_tag: form:"phone_area_code" validate:"required" example:"+86" label:"手机区号"
    string phone_area_code = 3;
    // @inject_tag: form:"password" validate:"required"
    string password = 4;
}

Documentation

Overview

Copyright © 2021 NAME HERE <EMAIL ADDRESS>

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.