protobuf-protoc-bin 33.3__py2.py3-none-win_amd64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (22) hide show
  1. protobuf_protoc_bin/__init__.py +9 -0
  2. protobuf_protoc_bin/_version.py +34 -0
  3. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/any.proto +162 -0
  4. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/api.proto +229 -0
  5. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/compiler/plugin.proto +180 -0
  6. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/cpp_features.proto +67 -0
  7. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/descriptor.proto +1434 -0
  8. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/duration.proto +115 -0
  9. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/empty.proto +51 -0
  10. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/field_mask.proto +245 -0
  11. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/go_features.proto +83 -0
  12. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/java_features.proto +132 -0
  13. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/source_context.proto +48 -0
  14. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/struct.proto +95 -0
  15. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/timestamp.proto +145 -0
  16. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/type.proto +217 -0
  17. protobuf_protoc_bin-33.3.data/data/include/google/protobuf/wrappers.proto +157 -0
  18. protobuf_protoc_bin-33.3.data/scripts/protoc.exe +0 -0
  19. protobuf_protoc_bin-33.3.dist-info/METADATA +92 -0
  20. protobuf_protoc_bin-33.3.dist-info/RECORD +22 -0
  21. protobuf_protoc_bin-33.3.dist-info/WHEEL +6 -0
  22. protobuf_protoc_bin-33.3.dist-info/top_level.txt +1 -0
@@ -0,0 +1,9 @@
1
+ """
2
+ This is a package placeholder for the `protoc` executable.
3
+
4
+ No actual Python code is included.
5
+ """
6
+
7
+ from ._version import __version__, __version_tuple__
8
+
9
+ # `_version.py` will be generated by "setuptools_scm"
@@ -0,0 +1,34 @@
1
+ # file generated by setuptools-scm
2
+ # don't change, don't track in version control
3
+
4
+ __all__ = [
5
+ "__version__",
6
+ "__version_tuple__",
7
+ "version",
8
+ "version_tuple",
9
+ "__commit_id__",
10
+ "commit_id",
11
+ ]
12
+
13
+ TYPE_CHECKING = False
14
+ if TYPE_CHECKING:
15
+ from typing import Tuple
16
+ from typing import Union
17
+
18
+ VERSION_TUPLE = Tuple[Union[int, str], ...]
19
+ COMMIT_ID = Union[str, None]
20
+ else:
21
+ VERSION_TUPLE = object
22
+ COMMIT_ID = object
23
+
24
+ version: str
25
+ __version__: str
26
+ __version_tuple__: VERSION_TUPLE
27
+ version_tuple: VERSION_TUPLE
28
+ commit_id: COMMIT_ID
29
+ __commit_id__: COMMIT_ID
30
+
31
+ __version__ = version = '33.3'
32
+ __version_tuple__ = version_tuple = (33, 3)
33
+
34
+ __commit_id__ = commit_id = 'g33f102640'
@@ -0,0 +1,162 @@
1
+ // Protocol Buffers - Google's data interchange format
2
+ // Copyright 2008 Google Inc. All rights reserved.
3
+ // https://developers.google.com/protocol-buffers/
4
+ //
5
+ // Redistribution and use in source and binary forms, with or without
6
+ // modification, are permitted provided that the following conditions are
7
+ // met:
8
+ //
9
+ // * Redistributions of source code must retain the above copyright
10
+ // notice, this list of conditions and the following disclaimer.
11
+ // * Redistributions in binary form must reproduce the above
12
+ // copyright notice, this list of conditions and the following disclaimer
13
+ // in the documentation and/or other materials provided with the
14
+ // distribution.
15
+ // * Neither the name of Google Inc. nor the names of its
16
+ // contributors may be used to endorse or promote products derived from
17
+ // this software without specific prior written permission.
18
+ //
19
+ // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20
+ // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21
+ // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22
+ // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23
+ // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24
+ // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25
+ // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26
+ // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27
+ // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28
+ // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29
+ // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30
+
31
+ syntax = "proto3";
32
+
33
+ package google.protobuf;
34
+
35
+ option go_package = "google.golang.org/protobuf/types/known/anypb";
36
+ option java_package = "com.google.protobuf";
37
+ option java_outer_classname = "AnyProto";
38
+ option java_multiple_files = true;
39
+ option objc_class_prefix = "GPB";
40
+ option csharp_namespace = "Google.Protobuf.WellKnownTypes";
41
+
42
+ // `Any` contains an arbitrary serialized protocol buffer message along with a
43
+ // URL that describes the type of the serialized message.
44
+ //
45
+ // Protobuf library provides support to pack/unpack Any values in the form
46
+ // of utility functions or additional generated methods of the Any type.
47
+ //
48
+ // Example 1: Pack and unpack a message in C++.
49
+ //
50
+ // Foo foo = ...;
51
+ // Any any;
52
+ // any.PackFrom(foo);
53
+ // ...
54
+ // if (any.UnpackTo(&foo)) {
55
+ // ...
56
+ // }
57
+ //
58
+ // Example 2: Pack and unpack a message in Java.
59
+ //
60
+ // Foo foo = ...;
61
+ // Any any = Any.pack(foo);
62
+ // ...
63
+ // if (any.is(Foo.class)) {
64
+ // foo = any.unpack(Foo.class);
65
+ // }
66
+ // // or ...
67
+ // if (any.isSameTypeAs(Foo.getDefaultInstance())) {
68
+ // foo = any.unpack(Foo.getDefaultInstance());
69
+ // }
70
+ //
71
+ // Example 3: Pack and unpack a message in Python.
72
+ //
73
+ // foo = Foo(...)
74
+ // any = Any()
75
+ // any.Pack(foo)
76
+ // ...
77
+ // if any.Is(Foo.DESCRIPTOR):
78
+ // any.Unpack(foo)
79
+ // ...
80
+ //
81
+ // Example 4: Pack and unpack a message in Go
82
+ //
83
+ // foo := &pb.Foo{...}
84
+ // any, err := anypb.New(foo)
85
+ // if err != nil {
86
+ // ...
87
+ // }
88
+ // ...
89
+ // foo := &pb.Foo{}
90
+ // if err := any.UnmarshalTo(foo); err != nil {
91
+ // ...
92
+ // }
93
+ //
94
+ // The pack methods provided by protobuf library will by default use
95
+ // 'type.googleapis.com/full.type.name' as the type URL and the unpack
96
+ // methods only use the fully qualified type name after the last '/'
97
+ // in the type URL, for example "foo.bar.com/x/y.z" will yield type
98
+ // name "y.z".
99
+ //
100
+ // JSON
101
+ // ====
102
+ // The JSON representation of an `Any` value uses the regular
103
+ // representation of the deserialized, embedded message, with an
104
+ // additional field `@type` which contains the type URL. Example:
105
+ //
106
+ // package google.profile;
107
+ // message Person {
108
+ // string first_name = 1;
109
+ // string last_name = 2;
110
+ // }
111
+ //
112
+ // {
113
+ // "@type": "type.googleapis.com/google.profile.Person",
114
+ // "firstName": <string>,
115
+ // "lastName": <string>
116
+ // }
117
+ //
118
+ // If the embedded message type is well-known and has a custom JSON
119
+ // representation, that representation will be embedded adding a field
120
+ // `value` which holds the custom JSON in addition to the `@type`
121
+ // field. Example (for message [google.protobuf.Duration][]):
122
+ //
123
+ // {
124
+ // "@type": "type.googleapis.com/google.protobuf.Duration",
125
+ // "value": "1.212s"
126
+ // }
127
+ //
128
+ message Any {
129
+ // A URL/resource name that uniquely identifies the type of the serialized
130
+ // protocol buffer message. This string must contain at least
131
+ // one "/" character. The last segment of the URL's path must represent
132
+ // the fully qualified name of the type (as in
133
+ // `path/google.protobuf.Duration`). The name should be in a canonical form
134
+ // (e.g., leading "." is not accepted).
135
+ //
136
+ // In practice, teams usually precompile into the binary all types that they
137
+ // expect it to use in the context of Any. However, for URLs which use the
138
+ // scheme `http`, `https`, or no scheme, one can optionally set up a type
139
+ // server that maps type URLs to message definitions as follows:
140
+ //
141
+ // * If no scheme is provided, `https` is assumed.
142
+ // * An HTTP GET on the URL must yield a [google.protobuf.Type][]
143
+ // value in binary format, or produce an error.
144
+ // * Applications are allowed to cache lookup results based on the
145
+ // URL, or have them precompiled into a binary to avoid any
146
+ // lookup. Therefore, binary compatibility needs to be preserved
147
+ // on changes to types. (Use versioned type names to manage
148
+ // breaking changes.)
149
+ //
150
+ // Note: this functionality is not currently available in the official
151
+ // protobuf release, and it is not used for type URLs beginning with
152
+ // type.googleapis.com. As of May 2023, there are no widely used type server
153
+ // implementations and no plans to implement one.
154
+ //
155
+ // Schemes other than `http`, `https` (or the empty scheme) might be
156
+ // used with implementation specific semantics.
157
+ //
158
+ string type_url = 1;
159
+
160
+ // Must be a valid serialized protocol buffer of the above specified type.
161
+ bytes value = 2;
162
+ }
@@ -0,0 +1,229 @@
1
+ // Protocol Buffers - Google's data interchange format
2
+ // Copyright 2008 Google Inc. All rights reserved.
3
+ // https://developers.google.com/protocol-buffers/
4
+ //
5
+ // Redistribution and use in source and binary forms, with or without
6
+ // modification, are permitted provided that the following conditions are
7
+ // met:
8
+ //
9
+ // * Redistributions of source code must retain the above copyright
10
+ // notice, this list of conditions and the following disclaimer.
11
+ // * Redistributions in binary form must reproduce the above
12
+ // copyright notice, this list of conditions and the following disclaimer
13
+ // in the documentation and/or other materials provided with the
14
+ // distribution.
15
+ // * Neither the name of Google Inc. nor the names of its
16
+ // contributors may be used to endorse or promote products derived from
17
+ // this software without specific prior written permission.
18
+ //
19
+ // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20
+ // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21
+ // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22
+ // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23
+ // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24
+ // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25
+ // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26
+ // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27
+ // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28
+ // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29
+ // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30
+
31
+ syntax = "proto3";
32
+
33
+ package google.protobuf;
34
+
35
+ import "google/protobuf/source_context.proto";
36
+ import "google/protobuf/type.proto";
37
+
38
+ option java_package = "com.google.protobuf";
39
+ option java_outer_classname = "ApiProto";
40
+ option java_multiple_files = true;
41
+ option objc_class_prefix = "GPB";
42
+ option csharp_namespace = "Google.Protobuf.WellKnownTypes";
43
+ option go_package = "google.golang.org/protobuf/types/known/apipb";
44
+
45
+ // Api is a light-weight descriptor for an API Interface.
46
+ //
47
+ // Interfaces are also described as "protocol buffer services" in some contexts,
48
+ // such as by the "service" keyword in a .proto file, but they are different
49
+ // from API Services, which represent a concrete implementation of an interface
50
+ // as opposed to simply a description of methods and bindings. They are also
51
+ // sometimes simply referred to as "APIs" in other contexts, such as the name of
52
+ // this message itself. See https://cloud.google.com/apis/design/glossary for
53
+ // detailed terminology.
54
+ //
55
+ // New usages of this message as an alternative to ServiceDescriptorProto are
56
+ // strongly discouraged. This message does not reliability preserve all
57
+ // information necessary to model the schema and preserve semantics. Instead
58
+ // make use of FileDescriptorSet which preserves the necessary information.
59
+ message Api {
60
+ // The fully qualified name of this interface, including package name
61
+ // followed by the interface's simple name.
62
+ string name = 1;
63
+
64
+ // The methods of this interface, in unspecified order.
65
+ repeated Method methods = 2;
66
+
67
+ // Any metadata attached to the interface.
68
+ repeated Option options = 3;
69
+
70
+ // A version string for this interface. If specified, must have the form
71
+ // `major-version.minor-version`, as in `1.10`. If the minor version is
72
+ // omitted, it defaults to zero. If the entire version field is empty, the
73
+ // major version is derived from the package name, as outlined below. If the
74
+ // field is not empty, the version in the package name will be verified to be
75
+ // consistent with what is provided here.
76
+ //
77
+ // The versioning schema uses [semantic
78
+ // versioning](http://semver.org) where the major version number
79
+ // indicates a breaking change and the minor version an additive,
80
+ // non-breaking change. Both version numbers are signals to users
81
+ // what to expect from different versions, and should be carefully
82
+ // chosen based on the product plan.
83
+ //
84
+ // The major version is also reflected in the package name of the
85
+ // interface, which must end in `v<major-version>`, as in
86
+ // `google.feature.v1`. For major versions 0 and 1, the suffix can
87
+ // be omitted. Zero major versions must only be used for
88
+ // experimental, non-GA interfaces.
89
+ //
90
+ string version = 4;
91
+
92
+ // Source context for the protocol buffer service represented by this
93
+ // message.
94
+ SourceContext source_context = 5;
95
+
96
+ // Included interfaces. See [Mixin][].
97
+ repeated Mixin mixins = 6;
98
+
99
+ // The source syntax of the service.
100
+ Syntax syntax = 7;
101
+
102
+ // The source edition string, only valid when syntax is SYNTAX_EDITIONS.
103
+ string edition = 8;
104
+ }
105
+
106
+ // Method represents a method of an API interface.
107
+ //
108
+ // New usages of this message as an alternative to MethodDescriptorProto are
109
+ // strongly discouraged. This message does not reliability preserve all
110
+ // information necessary to model the schema and preserve semantics. Instead
111
+ // make use of FileDescriptorSet which preserves the necessary information.
112
+ message Method {
113
+ // The simple name of this method.
114
+ string name = 1;
115
+
116
+ // A URL of the input message type.
117
+ string request_type_url = 2;
118
+
119
+ // If true, the request is streamed.
120
+ bool request_streaming = 3;
121
+
122
+ // The URL of the output message type.
123
+ string response_type_url = 4;
124
+
125
+ // If true, the response is streamed.
126
+ bool response_streaming = 5;
127
+
128
+ // Any metadata attached to the method.
129
+ repeated Option options = 6;
130
+
131
+ // The source syntax of this method.
132
+ //
133
+ // This field should be ignored, instead the syntax should be inherited from
134
+ // Api. This is similar to Field and EnumValue.
135
+ Syntax syntax = 7 [deprecated = true];
136
+
137
+ // The source edition string, only valid when syntax is SYNTAX_EDITIONS.
138
+ //
139
+ // This field should be ignored, instead the edition should be inherited from
140
+ // Api. This is similar to Field and EnumValue.
141
+ string edition = 8 [deprecated = true];
142
+ }
143
+
144
+ // Declares an API Interface to be included in this interface. The including
145
+ // interface must redeclare all the methods from the included interface, but
146
+ // documentation and options are inherited as follows:
147
+ //
148
+ // - If after comment and whitespace stripping, the documentation
149
+ // string of the redeclared method is empty, it will be inherited
150
+ // from the original method.
151
+ //
152
+ // - Each annotation belonging to the service config (http,
153
+ // visibility) which is not set in the redeclared method will be
154
+ // inherited.
155
+ //
156
+ // - If an http annotation is inherited, the path pattern will be
157
+ // modified as follows. Any version prefix will be replaced by the
158
+ // version of the including interface plus the [root][] path if
159
+ // specified.
160
+ //
161
+ // Example of a simple mixin:
162
+ //
163
+ // package google.acl.v1;
164
+ // service AccessControl {
165
+ // // Get the underlying ACL object.
166
+ // rpc GetAcl(GetAclRequest) returns (Acl) {
167
+ // option (google.api.http).get = "/v1/{resource=**}:getAcl";
168
+ // }
169
+ // }
170
+ //
171
+ // package google.storage.v2;
172
+ // service Storage {
173
+ // rpc GetAcl(GetAclRequest) returns (Acl);
174
+ //
175
+ // // Get a data record.
176
+ // rpc GetData(GetDataRequest) returns (Data) {
177
+ // option (google.api.http).get = "/v2/{resource=**}";
178
+ // }
179
+ // }
180
+ //
181
+ // Example of a mixin configuration:
182
+ //
183
+ // apis:
184
+ // - name: google.storage.v2.Storage
185
+ // mixins:
186
+ // - name: google.acl.v1.AccessControl
187
+ //
188
+ // The mixin construct implies that all methods in `AccessControl` are
189
+ // also declared with same name and request/response types in
190
+ // `Storage`. A documentation generator or annotation processor will
191
+ // see the effective `Storage.GetAcl` method after inheriting
192
+ // documentation and annotations as follows:
193
+ //
194
+ // service Storage {
195
+ // // Get the underlying ACL object.
196
+ // rpc GetAcl(GetAclRequest) returns (Acl) {
197
+ // option (google.api.http).get = "/v2/{resource=**}:getAcl";
198
+ // }
199
+ // ...
200
+ // }
201
+ //
202
+ // Note how the version in the path pattern changed from `v1` to `v2`.
203
+ //
204
+ // If the `root` field in the mixin is specified, it should be a
205
+ // relative path under which inherited HTTP paths are placed. Example:
206
+ //
207
+ // apis:
208
+ // - name: google.storage.v2.Storage
209
+ // mixins:
210
+ // - name: google.acl.v1.AccessControl
211
+ // root: acls
212
+ //
213
+ // This implies the following inherited HTTP annotation:
214
+ //
215
+ // service Storage {
216
+ // // Get the underlying ACL object.
217
+ // rpc GetAcl(GetAclRequest) returns (Acl) {
218
+ // option (google.api.http).get = "/v2/acls/{resource=**}:getAcl";
219
+ // }
220
+ // ...
221
+ // }
222
+ message Mixin {
223
+ // The fully qualified name of the interface which is included.
224
+ string name = 1;
225
+
226
+ // If non-empty specifies a path under which inherited HTTP paths
227
+ // are rooted.
228
+ string root = 2;
229
+ }
@@ -0,0 +1,180 @@
1
+ // Protocol Buffers - Google's data interchange format
2
+ // Copyright 2008 Google Inc. All rights reserved.
3
+ //
4
+ // Use of this source code is governed by a BSD-style
5
+ // license that can be found in the LICENSE file or at
6
+ // https://developers.google.com/open-source/licenses/bsd
7
+
8
+ // Author: kenton@google.com (Kenton Varda)
9
+ //
10
+ // protoc (aka the Protocol Compiler) can be extended via plugins. A plugin is
11
+ // just a program that reads a CodeGeneratorRequest from stdin and writes a
12
+ // CodeGeneratorResponse to stdout.
13
+ //
14
+ // Plugins written using C++ can use google/protobuf/compiler/plugin.h instead
15
+ // of dealing with the raw protocol defined here.
16
+ //
17
+ // A plugin executable needs only to be placed somewhere in the path. The
18
+ // plugin should be named "protoc-gen-$NAME", and will then be used when the
19
+ // flag "--${NAME}_out" is passed to protoc.
20
+
21
+ syntax = "proto2";
22
+
23
+ package google.protobuf.compiler;
24
+ option java_package = "com.google.protobuf.compiler";
25
+ option java_outer_classname = "PluginProtos";
26
+
27
+ import "google/protobuf/descriptor.proto";
28
+
29
+ option csharp_namespace = "Google.Protobuf.Compiler";
30
+ option go_package = "google.golang.org/protobuf/types/pluginpb";
31
+
32
+ // The version number of protocol compiler.
33
+ message Version {
34
+ optional int32 major = 1;
35
+ optional int32 minor = 2;
36
+ optional int32 patch = 3;
37
+ // A suffix for alpha, beta or rc release, e.g., "alpha-1", "rc2". It should
38
+ // be empty for mainline stable releases.
39
+ optional string suffix = 4;
40
+ }
41
+
42
+ // An encoded CodeGeneratorRequest is written to the plugin's stdin.
43
+ message CodeGeneratorRequest {
44
+ // The .proto files that were explicitly listed on the command-line. The
45
+ // code generator should generate code only for these files. Each file's
46
+ // descriptor will be included in proto_file, below.
47
+ repeated string file_to_generate = 1;
48
+
49
+ // The generator parameter passed on the command-line.
50
+ optional string parameter = 2;
51
+
52
+ // FileDescriptorProtos for all files in files_to_generate and everything
53
+ // they import. The files will appear in topological order, so each file
54
+ // appears before any file that imports it.
55
+ //
56
+ // Note: the files listed in files_to_generate will include runtime-retention
57
+ // options only, but all other files will include source-retention options.
58
+ // The source_file_descriptors field below is available in case you need
59
+ // source-retention options for files_to_generate.
60
+ //
61
+ // protoc guarantees that all proto_files will be written after
62
+ // the fields above, even though this is not technically guaranteed by the
63
+ // protobuf wire format. This theoretically could allow a plugin to stream
64
+ // in the FileDescriptorProtos and handle them one by one rather than read
65
+ // the entire set into memory at once. However, as of this writing, this
66
+ // is not similarly optimized on protoc's end -- it will store all fields in
67
+ // memory at once before sending them to the plugin.
68
+ //
69
+ // Type names of fields and extensions in the FileDescriptorProto are always
70
+ // fully qualified.
71
+ repeated FileDescriptorProto proto_file = 15;
72
+
73
+ // File descriptors with all options, including source-retention options.
74
+ // These descriptors are only provided for the files listed in
75
+ // files_to_generate.
76
+ repeated FileDescriptorProto source_file_descriptors = 17;
77
+
78
+ // The version number of protocol compiler.
79
+ optional Version compiler_version = 3;
80
+ }
81
+
82
+ // The plugin writes an encoded CodeGeneratorResponse to stdout.
83
+ message CodeGeneratorResponse {
84
+ // Error message. If non-empty, code generation failed. The plugin process
85
+ // should exit with status code zero even if it reports an error in this way.
86
+ //
87
+ // This should be used to indicate errors in .proto files which prevent the
88
+ // code generator from generating correct code. Errors which indicate a
89
+ // problem in protoc itself -- such as the input CodeGeneratorRequest being
90
+ // unparseable -- should be reported by writing a message to stderr and
91
+ // exiting with a non-zero status code.
92
+ optional string error = 1;
93
+
94
+ // A bitmask of supported features that the code generator supports.
95
+ // This is a bitwise "or" of values from the Feature enum.
96
+ optional uint64 supported_features = 2;
97
+
98
+ // Sync with code_generator.h.
99
+ enum Feature {
100
+ FEATURE_NONE = 0;
101
+ FEATURE_PROTO3_OPTIONAL = 1;
102
+ FEATURE_SUPPORTS_EDITIONS = 2;
103
+ }
104
+
105
+ // The minimum edition this plugin supports. This will be treated as an
106
+ // Edition enum, but we want to allow unknown values. It should be specified
107
+ // according the edition enum value, *not* the edition number. Only takes
108
+ // effect for plugins that have FEATURE_SUPPORTS_EDITIONS set.
109
+ optional int32 minimum_edition = 3;
110
+
111
+ // The maximum edition this plugin supports. This will be treated as an
112
+ // Edition enum, but we want to allow unknown values. It should be specified
113
+ // according the edition enum value, *not* the edition number. Only takes
114
+ // effect for plugins that have FEATURE_SUPPORTS_EDITIONS set.
115
+ optional int32 maximum_edition = 4;
116
+
117
+ // Represents a single generated file.
118
+ message File {
119
+ // The file name, relative to the output directory. The name must not
120
+ // contain "." or ".." components and must be relative, not be absolute (so,
121
+ // the file cannot lie outside the output directory). "/" must be used as
122
+ // the path separator, not "\".
123
+ //
124
+ // If the name is omitted, the content will be appended to the previous
125
+ // file. This allows the generator to break large files into small chunks,
126
+ // and allows the generated text to be streamed back to protoc so that large
127
+ // files need not reside completely in memory at one time. Note that as of
128
+ // this writing protoc does not optimize for this -- it will read the entire
129
+ // CodeGeneratorResponse before writing files to disk.
130
+ optional string name = 1;
131
+
132
+ // If non-empty, indicates that the named file should already exist, and the
133
+ // content here is to be inserted into that file at a defined insertion
134
+ // point. This feature allows a code generator to extend the output
135
+ // produced by another code generator. The original generator may provide
136
+ // insertion points by placing special annotations in the file that look
137
+ // like:
138
+ // @@protoc_insertion_point(NAME)
139
+ // The annotation can have arbitrary text before and after it on the line,
140
+ // which allows it to be placed in a comment. NAME should be replaced with
141
+ // an identifier naming the point -- this is what other generators will use
142
+ // as the insertion_point. Code inserted at this point will be placed
143
+ // immediately above the line containing the insertion point (thus multiple
144
+ // insertions to the same point will come out in the order they were added).
145
+ // The double-@ is intended to make it unlikely that the generated code
146
+ // could contain things that look like insertion points by accident.
147
+ //
148
+ // For example, the C++ code generator places the following line in the
149
+ // .pb.h files that it generates:
150
+ // // @@protoc_insertion_point(namespace_scope)
151
+ // This line appears within the scope of the file's package namespace, but
152
+ // outside of any particular class. Another plugin can then specify the
153
+ // insertion_point "namespace_scope" to generate additional classes or
154
+ // other declarations that should be placed in this scope.
155
+ //
156
+ // Note that if the line containing the insertion point begins with
157
+ // whitespace, the same whitespace will be added to every line of the
158
+ // inserted text. This is useful for languages like Python, where
159
+ // indentation matters. In these languages, the insertion point comment
160
+ // should be indented the same amount as any inserted code will need to be
161
+ // in order to work correctly in that context.
162
+ //
163
+ // The code generator that generates the initial file and the one which
164
+ // inserts into it must both run as part of a single invocation of protoc.
165
+ // Code generators are executed in the order in which they appear on the
166
+ // command line.
167
+ //
168
+ // If |insertion_point| is present, |name| must also be present.
169
+ optional string insertion_point = 2;
170
+
171
+ // The file contents.
172
+ optional string content = 15;
173
+
174
+ // Information describing the file content being inserted. If an insertion
175
+ // point is used, this information will be appropriately offset and inserted
176
+ // into the code generation metadata for the generated files.
177
+ optional GeneratedCodeInfo generated_code_info = 16;
178
+ }
179
+ repeated File file = 15;
180
+ }
@@ -0,0 +1,67 @@
1
+ // Protocol Buffers - Google's data interchange format
2
+ // Copyright 2023 Google Inc. All rights reserved.
3
+ //
4
+ // Use of this source code is governed by a BSD-style
5
+ // license that can be found in the LICENSE file or at
6
+ // https://developers.google.com/open-source/licenses/bsd
7
+
8
+ syntax = "proto2";
9
+
10
+ package pb;
11
+
12
+ import "google/protobuf/descriptor.proto";
13
+
14
+ extend google.protobuf.FeatureSet {
15
+ optional CppFeatures cpp = 1000;
16
+ }
17
+
18
+ message CppFeatures {
19
+ // Whether or not to treat an enum field as closed. This option is only
20
+ // applicable to enum fields, and will be removed in the future. It is
21
+ // consistent with the legacy behavior of using proto3 enum types for proto2
22
+ // fields.
23
+ optional bool legacy_closed_enum = 1 [
24
+ retention = RETENTION_RUNTIME,
25
+ targets = TARGET_TYPE_FIELD,
26
+ targets = TARGET_TYPE_FILE,
27
+ feature_support = {
28
+ edition_introduced: EDITION_2023,
29
+ edition_deprecated: EDITION_2023,
30
+ deprecation_warning: "The legacy closed enum behavior in C++ is "
31
+ "deprecated and is scheduled to be removed in "
32
+ "edition 2025. See http://protobuf.dev/programming-guides/enum/#cpp for "
33
+ "more information",
34
+ },
35
+ edition_defaults = { edition: EDITION_LEGACY, value: "true" },
36
+ edition_defaults = { edition: EDITION_PROTO3, value: "false" }
37
+ ];
38
+
39
+ enum StringType {
40
+ STRING_TYPE_UNKNOWN = 0;
41
+ VIEW = 1;
42
+ CORD = 2;
43
+ STRING = 3;
44
+ }
45
+
46
+ optional StringType string_type = 2 [
47
+ retention = RETENTION_RUNTIME,
48
+ targets = TARGET_TYPE_FIELD,
49
+ targets = TARGET_TYPE_FILE,
50
+ feature_support = {
51
+ edition_introduced: EDITION_2023,
52
+ },
53
+ edition_defaults = { edition: EDITION_LEGACY, value: "STRING" },
54
+ edition_defaults = { edition: EDITION_2024, value: "VIEW" }
55
+ ];
56
+
57
+ optional bool enum_name_uses_string_view = 3 [
58
+ retention = RETENTION_RUNTIME,
59
+ targets = TARGET_TYPE_ENUM,
60
+ targets = TARGET_TYPE_FILE,
61
+ feature_support = {
62
+ edition_introduced: EDITION_2024,
63
+ },
64
+ edition_defaults = { edition: EDITION_LEGACY, value: "false" },
65
+ edition_defaults = { edition: EDITION_2024, value: "true" }
66
+ ];
67
+ }