mirror/protobuf-go
1
0
Fork 0
mirror of https://github.com/protocolbuffers/protobuf-go.git synced 2024-12-29 12:17:48 +00:00
Code Issues Packages Projects Releases Wiki Activity
fc9592f7ac
protobuf-go/cmd/protoc-gen-go/testdata/comments/comments.proto

62 lines
1.4 KiB
Protocol Buffer
Raw Normal View History

protogen: include source comments in generated code Add initial handling of location paths (arrays of integers identifying an entity in a .proto source file). Expose path info in protogen; each descriptor has a Path field containing its location path. Format comments in protoc-gen-go. This contains one change from github.com/golang/protobuf: Package comments are now included before the package statement (but not attached to it) and use // comment syntax instead of /* */. e.g., Before: package test /* This package contains interesting messages. */ After: // This package contains interesting messages. package test Change-Id: Ieee13ae77b3584f7562183100554d3df732348aa Reviewed-on: https://go-review.googlesource.com/133915 Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2018-09-06 21:51:28 +00:00
// Copyright 2018 The Go Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.
syntax = "proto2";
cmd/protoc-gen-go: generate deprecation comments Generate deprecation comments on packages, enums, enum values, messages, and fields. Change-Id: I8a94aff535078d33d1cc6104cff17e062cbfe94f Reviewed-on: https://go-review.googlesource.com/136355 Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2018-09-17 22:11:24 +00:00
// COMMENT: package goproto.protoc.comments;
package goproto.protoc.comments;
protogen: include source comments in generated code Add initial handling of location paths (arrays of integers identifying an entity in a .proto source file). Expose path info in protogen; each descriptor has a Path field containing its location path. Format comments in protoc-gen-go. This contains one change from github.com/golang/protobuf: Package comments are now included before the package statement (but not attached to it) and use // comment syntax instead of /* */. e.g., Before: package test /* This package contains interesting messages. */ After: // This package contains interesting messages. package test Change-Id: Ieee13ae77b3584f7562183100554d3df732348aa Reviewed-on: https://go-review.googlesource.com/133915 Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2018-09-06 21:51:28 +00:00
all: change module to google.golang.org/protobuf Temporarily remove go.mod, since we can't generate an accurate one until the corresponding v1 change is submitted. Change-Id: I1e1ad97f2b455e33f61ffaeb8676289795e47e72 Reviewed-on: https://go-review.googlesource.com/c/protobuf/+/177000 Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2019-05-14 06:55:40 +00:00
option go_package = "google.golang.org/protobuf/cmd/protoc-gen-go/testdata/comments";
protogen: include source comments in generated code Add initial handling of location paths (arrays of integers identifying an entity in a .proto source file). Expose path info in protogen; each descriptor has a Path field containing its location path. Format comments in protoc-gen-go. This contains one change from github.com/golang/protobuf: Package comments are now included before the package statement (but not attached to it) and use // comment syntax instead of /* */. e.g., Before: package test /* This package contains interesting messages. */ After: // This package contains interesting messages. package test Change-Id: Ieee13ae77b3584f7562183100554d3df732348aa Reviewed-on: https://go-review.googlesource.com/133915 Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2018-09-06 21:51:28 +00:00
cmd/protoc-gen-go: improve generation of comments The following improvements were made: * All standalone comments above the "syntax" marker are preserved similar to Java and some other generators. * All standalone comments above the "package" marker are preserved to be consistent with our former behavior. * Leading comments are now generated for enums and extension fields. * Single-line trailing comments are now generated for enum values, message fields, and extension fields. * The leading comments for each field that is part of a oneof are now generated with the wrapper types rather than being shoved into the comment for the oneof itself in an unreadable way. * The deprecation marker is always generated as being above the declaration rather than sometimes being an inlined comment. * The deprecation marker is now properly generated for weak field setters. Updates golang/protobuf#666 Change-Id: I7fd832dd4f86d15bfff70d7c22c6ba4934c05fcf Reviewed-on: https://go-review.googlesource.com/c/protobuf/+/189238 Reviewed-by: Damien Neil <dneil@google.com>
2019-08-06 08:15:48 +00:00
// COMMENT: Enum1.Leading
enum Enum1 {
// COMMENT: FOO.Leading
FOO = 0; // COMMENT: FOO.InlineTrailing
// COMMENT: BAR.Leading
BAR = 1;
// COMMENT: BAR.Trailing1
// COMMENT: BAR.Trailing2
// COMMENT: Enum1.EndBody
}
// COMMENT: Message1.Leading
protogen: include source comments in generated code Add initial handling of location paths (arrays of integers identifying an entity in a .proto source file). Expose path info in protogen; each descriptor has a Path field containing its location path. Format comments in protoc-gen-go. This contains one change from github.com/golang/protobuf: Package comments are now included before the package statement (but not attached to it) and use // comment syntax instead of /* */. e.g., Before: package test /* This package contains interesting messages. */ After: // This package contains interesting messages. package test Change-Id: Ieee13ae77b3584f7562183100554d3df732348aa Reviewed-on: https://go-review.googlesource.com/133915 Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2018-09-06 21:51:28 +00:00
message Message1 {
cmd/protoc-gen-go: improve generation of comments The following improvements were made: * All standalone comments above the "syntax" marker are preserved similar to Java and some other generators. * All standalone comments above the "package" marker are preserved to be consistent with our former behavior. * Leading comments are now generated for enums and extension fields. * Single-line trailing comments are now generated for enum values, message fields, and extension fields. * The leading comments for each field that is part of a oneof are now generated with the wrapper types rather than being shoved into the comment for the oneof itself in an unreadable way. * The deprecation marker is always generated as being above the declaration rather than sometimes being an inlined comment. * The deprecation marker is now properly generated for weak field setters. Updates golang/protobuf#666 Change-Id: I7fd832dd4f86d15bfff70d7c22c6ba4934c05fcf Reviewed-on: https://go-review.googlesource.com/c/protobuf/+/189238 Reviewed-by: Damien Neil <dneil@google.com>
2019-08-06 08:15:48 +00:00
// COMMENT: Message1A.Leading
protogen: include source comments in generated code Add initial handling of location paths (arrays of integers identifying an entity in a .proto source file). Expose path info in protogen; each descriptor has a Path field containing its location path. Format comments in protoc-gen-go. This contains one change from github.com/golang/protobuf: Package comments are now included before the package statement (but not attached to it) and use // comment syntax instead of /* */. e.g., Before: package test /* This package contains interesting messages. */ After: // This package contains interesting messages. package test Change-Id: Ieee13ae77b3584f7562183100554d3df732348aa Reviewed-on: https://go-review.googlesource.com/133915 Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2018-09-06 21:51:28 +00:00
message Message1A {
cmd/protoc-gen-go: improve generation of comments The following improvements were made: * All standalone comments above the "syntax" marker are preserved similar to Java and some other generators. * All standalone comments above the "package" marker are preserved to be consistent with our former behavior. * Leading comments are now generated for enums and extension fields. * Single-line trailing comments are now generated for enum values, message fields, and extension fields. * The leading comments for each field that is part of a oneof are now generated with the wrapper types rather than being shoved into the comment for the oneof itself in an unreadable way. * The deprecation marker is always generated as being above the declaration rather than sometimes being an inlined comment. * The deprecation marker is now properly generated for weak field setters. Updates golang/protobuf#666 Change-Id: I7fd832dd4f86d15bfff70d7c22c6ba4934c05fcf Reviewed-on: https://go-review.googlesource.com/c/protobuf/+/189238 Reviewed-by: Damien Neil <dneil@google.com>
2019-08-06 08:15:48 +00:00
} // COMMENT: Message1A.Trailing
protogen: include source comments in generated code Add initial handling of location paths (arrays of integers identifying an entity in a .proto source file). Expose path info in protogen; each descriptor has a Path field containing its location path. Format comments in protoc-gen-go. This contains one change from github.com/golang/protobuf: Package comments are now included before the package statement (but not attached to it) and use // comment syntax instead of /* */. e.g., Before: package test /* This package contains interesting messages. */ After: // This package contains interesting messages. package test Change-Id: Ieee13ae77b3584f7562183100554d3df732348aa Reviewed-on: https://go-review.googlesource.com/133915 Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2018-09-06 21:51:28 +00:00
// COMMENT: Message1B
message Message1B {
}
protoc-gen-go: generate per-field comments for oneofs Comment location and formatting matches previous generator. Change-Id: Id51489bb8ca6e6bbd2c7bc2129a7bc170e56ed44 Reviewed-on: https://go-review.googlesource.com/c/140617 Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2018-10-08 18:18:15 +00:00
cmd/protoc-gen-go: improve generation of comments The following improvements were made: * All standalone comments above the "syntax" marker are preserved similar to Java and some other generators. * All standalone comments above the "package" marker are preserved to be consistent with our former behavior. * Leading comments are now generated for enums and extension fields. * Single-line trailing comments are now generated for enum values, message fields, and extension fields. * The leading comments for each field that is part of a oneof are now generated with the wrapper types rather than being shoved into the comment for the oneof itself in an unreadable way. * The deprecation marker is always generated as being above the declaration rather than sometimes being an inlined comment. * The deprecation marker is now properly generated for weak field setters. Updates golang/protobuf#666 Change-Id: I7fd832dd4f86d15bfff70d7c22c6ba4934c05fcf Reviewed-on: https://go-review.googlesource.com/c/protobuf/+/189238 Reviewed-by: Damien Neil <dneil@google.com>
2019-08-06 08:15:48 +00:00
// COMMENT: Field1A.Leading
optional string Field1A = 1; // COMMENT: Field1A.Trailing
protoc-gen-go: generate per-field comments for oneofs Comment location and formatting matches previous generator. Change-Id: Id51489bb8ca6e6bbd2c7bc2129a7bc170e56ed44 Reviewed-on: https://go-review.googlesource.com/c/140617 Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2018-10-08 18:18:15 +00:00
cmd/protoc-gen-go: improve generation of comments The following improvements were made: * All standalone comments above the "syntax" marker are preserved similar to Java and some other generators. * All standalone comments above the "package" marker are preserved to be consistent with our former behavior. * Leading comments are now generated for enums and extension fields. * Single-line trailing comments are now generated for enum values, message fields, and extension fields. * The leading comments for each field that is part of a oneof are now generated with the wrapper types rather than being shoved into the comment for the oneof itself in an unreadable way. * The deprecation marker is always generated as being above the declaration rather than sometimes being an inlined comment. * The deprecation marker is now properly generated for weak field setters. Updates golang/protobuf#666 Change-Id: I7fd832dd4f86d15bfff70d7c22c6ba4934c05fcf Reviewed-on: https://go-review.googlesource.com/c/protobuf/+/189238 Reviewed-by: Damien Neil <dneil@google.com>
2019-08-06 08:15:48 +00:00
// COMMENT: Oneof1A.Leading
protoc-gen-go: generate per-field comments for oneofs Comment location and formatting matches previous generator. Change-Id: Id51489bb8ca6e6bbd2c7bc2129a7bc170e56ed44 Reviewed-on: https://go-review.googlesource.com/c/140617 Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2018-10-08 18:18:15 +00:00
oneof Oneof1a {
cmd/protoc-gen-go: improve generation of comments The following improvements were made: * All standalone comments above the "syntax" marker are preserved similar to Java and some other generators. * All standalone comments above the "package" marker are preserved to be consistent with our former behavior. * Leading comments are now generated for enums and extension fields. * Single-line trailing comments are now generated for enum values, message fields, and extension fields. * The leading comments for each field that is part of a oneof are now generated with the wrapper types rather than being shoved into the comment for the oneof itself in an unreadable way. * The deprecation marker is always generated as being above the declaration rather than sometimes being an inlined comment. * The deprecation marker is now properly generated for weak field setters. Updates golang/protobuf#666 Change-Id: I7fd832dd4f86d15bfff70d7c22c6ba4934c05fcf Reviewed-on: https://go-review.googlesource.com/c/protobuf/+/189238 Reviewed-by: Damien Neil <dneil@google.com>
2019-08-06 08:15:48 +00:00
// COMMENT: Oneof1AField1.Leading
string Oneof1AField1 = 2; // COMMENT: Oneof1AField1.Trailing
} // COMMENT: Oneof1A.Trailing
extensions 100 to max;
} // COMMENT: Message1.Trailing
// COMMENT: Extend
extend Message1 {
// COMMENT: Extension.Leading
optional Message1 extension = 100; // COMMENT: Extension.Trailing
protogen: include source comments in generated code Add initial handling of location paths (arrays of integers identifying an entity in a .proto source file). Expose path info in protogen; each descriptor has a Path field containing its location path. Format comments in protoc-gen-go. This contains one change from github.com/golang/protobuf: Package comments are now included before the package statement (but not attached to it) and use // comment syntax instead of /* */. e.g., Before: package test /* This package contains interesting messages. */ After: // This package contains interesting messages. package test Change-Id: Ieee13ae77b3584f7562183100554d3df732348aa Reviewed-on: https://go-review.googlesource.com/133915 Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2018-09-06 21:51:28 +00:00
}
// COMMENT: Message2
message Message2 {
// COMMENT: Message2A
message Message2A {
}
// COMMENT: Message2B
message Message2B {
}
}
Reference in New Issue Copy Permalink