chore(*): update plugin default options && add examples

Signed-off-by: storyicon <yuanchao@bilibili.com>

examples/greeter/README.md

@@ -0,0 +1,26 @@
+# Greeter
+
+This is the simplest grpc example, which does not reference any external grpc libraries.
+
+The following plug-ins are used:
+* [protoc-gen-go](google.golang.org/protobuf/cmd/protoc-gen-go)
+* [protoc-gen-go-grpc](google.golang.org/grpc/cmd/protoc-gen-go-grpc)
+
+You can compile the proto file in this directory by executing the following command:
+```
+powerproto build -r ./apis
+```
+
+Not surprisingly, you will get the following output:
+```
+➜ tree
+.
+├── README.md
+├── apis
+│   ├── greeter.pb.go
+│   ├── greeter.proto
+│   └── greeter_grpc.pb.go
+└── powerproto.yaml
+
+1 directory, 5 files
+```

examples/greeter/apis/greeter.proto

@@ -0,0 +1,16 @@
+syntax = "proto3";
+
+package powerproto.examples.greeter;
+option go_package = "github.com/storyicon/powerproto/examples/greeter/apis;apis";
+
+service Greeter {
+    rpc SayHello (HelloRequest) returns (HelloReply);
+}
+
+message HelloRequest {
+    string name = 1;
+}
+
+message HelloReply {
+    string message = 1;
+}

examples/greeter/powerproto.yaml

@@ -0,0 +1,22 @@
+scopes:
+    - ./
+protoc: v3.17.3
+protocWorkDir: ""
+plugins:
+    protoc-gen-go: google.golang.org/protobuf/cmd/protoc-gen-go@v1.27.1
+    protoc-gen-go-grpc: google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.1.0
+repositories:
+    GOOGLE_APIS: https://github.com/googleapis/googleapis@75e9812478607db997376ccea247dd6928f70f45
+options:
+    - --go_out=.
+    - --go_opt=paths=source_relative
+    - --go-grpc_out=.
+    - --go-grpc_opt=paths=source_relative
+importPaths:
+    - .
+    - $GOPATH
+    - $POWERPROTO_INCLUDE
+    - $SOURCE_RELATIVE
+    - $GOOGLE_APIS/github.com/googleapis/googleapis
+postActions: []
+postShell: ""

examples/using-gogo/README.md

@@ -0,0 +1,28 @@
+# Using GoGo
+
+This example uses the following public libraries:
+* [googleapis](https://github.com/googleapis/googleapis)
+* [gogoproto](https://github.com/gogo/protobuf/tree/master/gogoproto)
+
+The following plug-ins are used:
+* [protoc-gen-gogo](github.com/gogo/protobuf/protoc-gen-gogo)
+* [protoc-gen-grpc-gateway](github.com/grpc-ecosystem/grpc-gateway)
+
+You can compile the proto file in this directory by executing the following command:
+```
+powerproto build -r ./apis
+```
+
+Not surprisingly, you will get the following output:
+```
+➜ tree
+.
+├── README.md
+├── apis
+│   ├── service.pb.go
+│   ├── service.pb.gw.go
+│   └── service.proto
+└── powerproto.yaml
+
+1 directory, 5 files
+```

examples/using-gogo/apis/service.proto

@@ -0,0 +1,40 @@
+syntax = "proto3";
+
+import "github.com/gogo/protobuf/gogoproto/gogo.proto";
+import "google/api/annotations.proto";
+
+package powerproto.examples.using_gogo;
+option go_package = "github.com/storyicon/powerproto/examples/using_gogo/apis;apis";
+
+option java_multiple_files = true;
+option java_package = "com.powerproto.examples.using_gogo";
+option objc_class_prefix = "BAPIMetadata";
+
+option (gogoproto.goproto_enum_prefix_all) = false;
+option (gogoproto.goproto_getters_all) = false;
+option (gogoproto.unmarshaler_all) = true;
+option (gogoproto.marshaler_all) = true;
+option (gogoproto.sizer_all) = true;
+option (gogoproto.goproto_registration) = true;
+
+service Mocker {
+    rpc Echo (EchoRequest) returns (EchoResponse) {
+        option (google.api.http) = {
+            post: "/echo"
+            body: "*"
+        };
+    };
+}
+
+message EchoRequest {
+    string message = 1;
+    int64 timestamp = 2;
+    uint32 code = 3;
+    uint32 delay = 4;
+}
+
+message EchoResponse {
+    string message = 1;
+    int64 timestamp = 2;
+    string server = 3;
+}

examples/using-gogo/powerproto.yaml

@@ -0,0 +1,24 @@
+scopes:
+    - ./
+protoc: v3.17.3
+protocWorkDir: ""
+plugins:
+    protoc-gen-gogo: github.com/gogo/protobuf/protoc-gen-gogo@v1.3.2
+    protoc-gen-grpc-gateway: github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.5.0
+repositories:
+    GOGO_PROTOBUF: https://github.com/gogo/protobuf@226206f39bd7276e88ec684ea0028c18ec2c91ae
+    GOOGLE_APIS: https://github.com/googleapis/googleapis@75e9812478607db997376ccea247dd6928f70f45
+options:
+    - --grpc-gateway_out=.
+    - --grpc-gateway_opt=paths=source_relative
+    - --gogo_out=plugins=grpc:.
+    - --gogo_opt=paths=source_relative
+importPaths:
+    - .
+    - $GOPATH
+    - $POWERPROTO_INCLUDE
+    - $SOURCE_RELATIVE
+    - $GOOGLE_APIS/github.com/googleapis/googleapis
+    - $GOGO_PROTOBUF
+postActions: []
+postShell: ""

examples/using-gogofast/README.md

@@ -0,0 +1,28 @@
+# Using GoGoFast
+
+This example uses the following public libraries:
+* [googleapis](https://github.com/googleapis/googleapis)
+* [gogoproto](https://github.com/gogo/protobuf/tree/master/gogoproto)
+
+The following plug-ins are used:
+* [protoc-gen-gofast](github.com/gogo/protobuf/protoc-gen-gofast)
+* [protoc-gen-grpc-gateway](github.com/grpc-ecosystem/grpc-gateway)
+
+You can compile the proto file in this directory by executing the following command:
+```
+powerproto build -r ./apis
+```
+
+Not surprisingly, you will get the following output:
+```
+➜ tree
+.
+├── README.md
+├── apis
+│   ├── service.pb.go
+│   ├── service.pb.gw.go
+│   └── service.proto
+└── powerproto.yaml
+
+1 directory, 5 files
+```

examples/using-gogofast/apis/service.proto

@@ -0,0 +1,40 @@
+syntax = "proto3";
+
+import "github.com/gogo/protobuf/gogoproto/gogo.proto";
+import "google/api/annotations.proto";
+
+package powerproto.examples.using_gogo;
+option go_package = "github.com/storyicon/powerproto/examples/using_gogo/apis;apis";
+
+option java_multiple_files = true;
+option java_package = "com.powerproto.examples.using_gogo";
+option objc_class_prefix = "BAPIMetadata";
+
+option (gogoproto.goproto_enum_prefix_all) = false;
+option (gogoproto.goproto_getters_all) = false;
+option (gogoproto.unmarshaler_all) = true;
+option (gogoproto.marshaler_all) = true;
+option (gogoproto.sizer_all) = true;
+option (gogoproto.goproto_registration) = true;
+
+service Mocker {
+    rpc Echo (EchoRequest) returns (EchoResponse) {
+        option (google.api.http) = {
+            post: "/echo"
+            body: "*"
+        };
+    };
+}
+
+message EchoRequest {
+    string message = 1;
+    int64 timestamp = 2;
+    uint32 code = 3;
+    uint32 delay = 4;
+}
+
+message EchoResponse {
+    string message = 1;
+    int64 timestamp = 2;
+    string server = 3;
+}

examples/using-gogofast/powerproto.yaml

@@ -0,0 +1,24 @@
+scopes:
+    - ./
+protoc: v3.17.3
+protocWorkDir: ""
+plugins:
+    protoc-gen-gofast: github.com/gogo/protobuf/protoc-gen-gofast@v1.3.2
+    protoc-gen-grpc-gateway: github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.5.0
+repositories:
+    GOGO_PROTOBUF: https://github.com/gogo/protobuf@226206f39bd7276e88ec684ea0028c18ec2c91ae
+    GOOGLE_APIS: https://github.com/googleapis/googleapis@75e9812478607db997376ccea247dd6928f70f45
+options:
+    - --grpc-gateway_out=.
+    - --grpc-gateway_opt=paths=source_relative
+    - --gofast_out=plugins=grpc:.
+    - --gofast_opt=paths=source_relative
+importPaths:
+    - .
+    - $GOPATH
+    - $POWERPROTO_INCLUDE
+    - $SOURCE_RELATIVE
+    - $GOOGLE_APIS/github.com/googleapis/googleapis
+    - $GOGO_PROTOBUF
+postActions: []
+postShell: ""

examples/using-googleapis/README.md

@@ -0,0 +1,29 @@
+# Using Googleapis
+
+This example uses the following public libraries:
+* [googleapis](https://github.com/googleapis/googleapis)
+
+The following plug-ins are used:
+* [protoc-gen-go](google.golang.org/protobuf/cmd/protoc-gen-go)
+* [protoc-gen-go-grpc](google.golang.org/grpc/cmd/protoc-gen-go-grpc)
+* [protoc-gen-grpc-gateway](github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway)
+
+You can compile the proto file in this directory by executing the following command:
+```
+powerproto build -r ./apis
+```
+
+Not surprisingly, you will get the following output:
+```
+➜ tree
+.
+├── README.md
+├── apis
+│   ├── service.pb.go
+│   ├── service.pb.gw.go
+│   ├── service.proto
+│   └── service_grpc.pb.go
+└── powerproto.yaml
+
+1 directory, 6 files
+```

examples/using-googleapis/apis/service.proto

@@ -0,0 +1,28 @@
+syntax = "proto3";
+
+package powerproto.examples.using_googleapis;
+option go_package = "github.com/storyicon/powerproto/examples/using_googleapis/apis;apis";
+
+import "google/api/annotations.proto";
+
+service Mocker {
+    rpc Echo (EchoRequest) returns (EchoResponse) {
+        option (google.api.http) = {
+            post: "/echo"
+            body: "*"
+        };
+    };
+}
+
+message EchoRequest {
+    string message = 1;
+    int64 timestamp = 2;
+    uint32 code = 3;
+    uint32 delay = 4;
+}
+
+message EchoResponse {
+    string message = 1;
+    int64 timestamp = 2;
+    string server = 3;
+}

examples/using-googleapis/powerproto.yaml

@@ -0,0 +1,25 @@
+scopes:
+    - ./
+protoc: v3.17.3
+protocWorkDir: ""
+plugins:
+    protoc-gen-go: google.golang.org/protobuf/cmd/protoc-gen-go@v1.27.1
+    protoc-gen-go-grpc: google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.1.0
+    protoc-gen-grpc-gateway: github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@v2.5.0
+repositories:
+    GOOGLE_APIS: https://github.com/googleapis/googleapis@75e9812478607db997376ccea247dd6928f70f45
+options:
+    - --go_out=.
+    - --go_opt=paths=source_relative
+    - --go-grpc_out=.
+    - --go-grpc_opt=paths=source_relative
+    - --grpc-gateway_out=.
+    - --grpc-gateway_opt=paths=source_relative
+importPaths:
+    - .
+    - $GOPATH
+    - $POWERPROTO_INCLUDE
+    - $SOURCE_RELATIVE
+    - $GOOGLE_APIS/github.com/googleapis/googleapis
+postActions: []
+postShell: ""