protoc 1.0.0 → 1.0.4

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "protoc",
3
- "version": "1.0.0",
3
+ "version": "1.0.4",
4
4
  "description": "A tool for converting proto buffers (.proto) files into javascript files usable in Closure Compiler with Closure Library.",
5
5
  "main": "index.js",
6
6
  "scripts": {
@@ -10,12 +10,12 @@
10
10
  "author": "Jeppe Rune Mortensen <jepperm@gmail.com>",
11
11
  "license": "MIT",
12
12
  "dependencies": {
13
- "glob": "^7.1.1",
13
+ "glob": "^7.1.6",
14
14
  "mkdirp": "^0.5.1",
15
- "node-uuid": "^1.4.7",
16
- "request": "^2.79.0",
17
- "rimraf": "^2.5.4",
18
- "unzip": "^0.1.11",
19
- "vinyl": "^2.0.1"
15
+ "node-uuid": "^1.4.8",
16
+ "request": "^2.88.0",
17
+ "rimraf": "^3.0.0",
18
+ "unzipper": "^0.10.5",
19
+ "vinyl": "^2.2.0"
20
20
  }
21
21
  }
@@ -1,17 +1,19 @@
1
1
  var request = require('request');
2
2
  var fs = require("fs");
3
3
  var path = require("path");
4
- var unzip = require("unzip");
4
+ var unzip = require("unzipper");
5
5
  var mkdirp = require("mkdirp");
6
6
  var protoc = require("../protoc.js");
7
7
 
8
+ const protoVersion = "3.11.2";
9
+
8
10
  var releases = {
9
- "win32_x86_32": "https://github.com/google/protobuf/releases/download/v3.2.0/protoc-3.2.0-win32.zip",
10
- "win32_x86_64": "https://github.com/google/protobuf/releases/download/v3.2.0/protoc-3.2.0-win32.zip",
11
- "linux_x86_32": "https://github.com/google/protobuf/releases/download/v3.2.0/protoc-3.2.0-linux-x86_32.zip",
12
- "linux_x86_64": "https://github.com/google/protobuf/releases/download/v3.2.0/protoc-3.2.0-linux-x86_64.zip",
13
- "darwin_x86_32": "https://github.com/google/protobuf/releases/download/v3.2.0/protoc-3.2.0-osx-x86_32.zip",
14
- "darwin_x86_64": "https://github.com/google/protobuf/releases/download/v3.2.0/protoc-3.2.0-osx-x86_64.zip"
11
+ "win32_x86_32": `https://github.com/google/protobuf/releases/download/v${protoVersion}/protoc-${protoVersion}-win32.zip`,
12
+ "win32_x86_64": `https://github.com/google/protobuf/releases/download/v${protoVersion}/protoc-${protoVersion}-win32.zip`,
13
+ "linux_x86_32": `https://github.com/google/protobuf/releases/download/v${protoVersion}/protoc-${protoVersion}-linux-x86_32.zip`,
14
+ "linux_x86_64": `https://github.com/google/protobuf/releases/download/v${protoVersion}/protoc-${protoVersion}-linux-x86_64.zip`,
15
+ "darwin_x86_32": `https://github.com/google/protobuf/releases/download/v${protoVersion}/protoc-${protoVersion}-osx-x86_32.zip`,
16
+ "darwin_x86_64": `https://github.com/google/protobuf/releases/download/v${protoVersion}/protoc-${protoVersion}-osx-x86_64.zip`
15
17
  };
16
18
 
17
19
  var platform = process.platform;
@@ -33,7 +35,7 @@ if (releases[release]) {
33
35
  entry.pipe(fs.createWriteStream(fullpath))
34
36
  .on("finish", function() {
35
37
  if (protoc === fullpath) {
36
- fs.chmod(fullpath, 0755, function(err) {
38
+ fs.chmod(fullpath, 0o755, function(err) {
37
39
  if (err) throw err;
38
40
  });
39
41
  }
package/protoc/bin/protoc DELETED
Binary file
@@ -1,139 +0,0 @@
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 csharp_namespace = "Google.Protobuf.WellKnownTypes";
36
- option go_package = "github.com/golang/protobuf/ptypes/any";
37
- option java_package = "com.google.protobuf";
38
- option java_outer_classname = "AnyProto";
39
- option java_multiple_files = true;
40
- option objc_class_prefix = "GPB";
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
- //
67
- // Example 3: Pack and unpack a message in Python.
68
- //
69
- // foo = Foo(...)
70
- // any = Any()
71
- // any.Pack(foo)
72
- // ...
73
- // if any.Is(Foo.DESCRIPTOR):
74
- // any.Unpack(foo)
75
- // ...
76
- //
77
- // The pack methods provided by protobuf library will by default use
78
- // 'type.googleapis.com/full.type.name' as the type URL and the unpack
79
- // methods only use the fully qualified type name after the last '/'
80
- // in the type URL, for example "foo.bar.com/x/y.z" will yield type
81
- // name "y.z".
82
- //
83
- //
84
- // JSON
85
- // ====
86
- // The JSON representation of an `Any` value uses the regular
87
- // representation of the deserialized, embedded message, with an
88
- // additional field `@type` which contains the type URL. Example:
89
- //
90
- // package google.profile;
91
- // message Person {
92
- // string first_name = 1;
93
- // string last_name = 2;
94
- // }
95
- //
96
- // {
97
- // "@type": "type.googleapis.com/google.profile.Person",
98
- // "firstName": <string>,
99
- // "lastName": <string>
100
- // }
101
- //
102
- // If the embedded message type is well-known and has a custom JSON
103
- // representation, that representation will be embedded adding a field
104
- // `value` which holds the custom JSON in addition to the `@type`
105
- // field. Example (for message [google.protobuf.Duration][]):
106
- //
107
- // {
108
- // "@type": "type.googleapis.com/google.protobuf.Duration",
109
- // "value": "1.212s"
110
- // }
111
- //
112
- message Any {
113
- // A URL/resource name whose content describes the type of the
114
- // serialized protocol buffer message.
115
- //
116
- // For URLs which use the scheme `http`, `https`, or no scheme, the
117
- // following restrictions and interpretations apply:
118
- //
119
- // * If no scheme is provided, `https` is assumed.
120
- // * The last segment of the URL's path must represent the fully
121
- // qualified name of the type (as in `path/google.protobuf.Duration`).
122
- // The name should be in a canonical form (e.g., leading "." is
123
- // not accepted).
124
- // * An HTTP GET on the URL must yield a [google.protobuf.Type][]
125
- // value in binary format, or produce an error.
126
- // * Applications are allowed to cache lookup results based on the
127
- // URL, or have them precompiled into a binary to avoid any
128
- // lookup. Therefore, binary compatibility needs to be preserved
129
- // on changes to types. (Use versioned type names to manage
130
- // breaking changes.)
131
- //
132
- // Schemes other than `http`, `https` (or the empty scheme) might be
133
- // used with implementation specific semantics.
134
- //
135
- string type_url = 1;
136
-
137
- // Must be a valid serialized protocol buffer of the above specified type.
138
- bytes value = 2;
139
- }
@@ -1,202 +0,0 @@
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 csharp_namespace = "Google.Protobuf.WellKnownTypes";
39
- option java_package = "com.google.protobuf";
40
- option java_outer_classname = "ApiProto";
41
- option java_multiple_files = true;
42
- option objc_class_prefix = "GPB";
43
- option go_package = "google.golang.org/genproto/protobuf/api;api";
44
-
45
- // Api is a light-weight descriptor for a protocol buffer service.
46
- message Api {
47
-
48
- // The fully qualified name of this api, including package name
49
- // followed by the api's simple name.
50
- string name = 1;
51
-
52
- // The methods of this api, in unspecified order.
53
- repeated Method methods = 2;
54
-
55
- // Any metadata attached to the API.
56
- repeated Option options = 3;
57
-
58
- // A version string for this api. If specified, must have the form
59
- // `major-version.minor-version`, as in `1.10`. If the minor version
60
- // is omitted, it defaults to zero. If the entire version field is
61
- // empty, the major version is derived from the package name, as
62
- // outlined below. If the field is not empty, the version in the
63
- // package name will be verified to be consistent with what is
64
- // provided here.
65
- //
66
- // The versioning schema uses [semantic
67
- // versioning](http://semver.org) where the major version number
68
- // indicates a breaking change and the minor version an additive,
69
- // non-breaking change. Both version numbers are signals to users
70
- // what to expect from different versions, and should be carefully
71
- // chosen based on the product plan.
72
- //
73
- // The major version is also reflected in the package name of the
74
- // API, which must end in `v<major-version>`, as in
75
- // `google.feature.v1`. For major versions 0 and 1, the suffix can
76
- // be omitted. Zero major versions must only be used for
77
- // experimental, none-GA apis.
78
- //
79
- //
80
- string version = 4;
81
-
82
- // Source context for the protocol buffer service represented by this
83
- // message.
84
- SourceContext source_context = 5;
85
-
86
- // Included APIs. See [Mixin][].
87
- repeated Mixin mixins = 6;
88
-
89
- // The source syntax of the service.
90
- Syntax syntax = 7;
91
- }
92
-
93
- // Method represents a method of an api.
94
- message Method {
95
-
96
- // The simple name of this method.
97
- string name = 1;
98
-
99
- // A URL of the input message type.
100
- string request_type_url = 2;
101
-
102
- // If true, the request is streamed.
103
- bool request_streaming = 3;
104
-
105
- // The URL of the output message type.
106
- string response_type_url = 4;
107
-
108
- // If true, the response is streamed.
109
- bool response_streaming = 5;
110
-
111
- // Any metadata attached to the method.
112
- repeated Option options = 6;
113
-
114
- // The source syntax of this method.
115
- Syntax syntax = 7;
116
- }
117
-
118
- // Declares an API to be included in this API. The including API must
119
- // redeclare all the methods from the included API, but documentation
120
- // and options are inherited as follows:
121
- //
122
- // - If after comment and whitespace stripping, the documentation
123
- // string of the redeclared method is empty, it will be inherited
124
- // from the original method.
125
- //
126
- // - Each annotation belonging to the service config (http,
127
- // visibility) which is not set in the redeclared method will be
128
- // inherited.
129
- //
130
- // - If an http annotation is inherited, the path pattern will be
131
- // modified as follows. Any version prefix will be replaced by the
132
- // version of the including API plus the [root][] path if specified.
133
- //
134
- // Example of a simple mixin:
135
- //
136
- // package google.acl.v1;
137
- // service AccessControl {
138
- // // Get the underlying ACL object.
139
- // rpc GetAcl(GetAclRequest) returns (Acl) {
140
- // option (google.api.http).get = "/v1/{resource=**}:getAcl";
141
- // }
142
- // }
143
- //
144
- // package google.storage.v2;
145
- // service Storage {
146
- // rpc GetAcl(GetAclRequest) returns (Acl);
147
- //
148
- // // Get a data record.
149
- // rpc GetData(GetDataRequest) returns (Data) {
150
- // option (google.api.http).get = "/v2/{resource=**}";
151
- // }
152
- // }
153
- //
154
- // Example of a mixin configuration:
155
- //
156
- // apis:
157
- // - name: google.storage.v2.Storage
158
- // mixins:
159
- // - name: google.acl.v1.AccessControl
160
- //
161
- // The mixin construct implies that all methods in `AccessControl` are
162
- // also declared with same name and request/response types in
163
- // `Storage`. A documentation generator or annotation processor will
164
- // see the effective `Storage.GetAcl` method after inherting
165
- // documentation and annotations as follows:
166
- //
167
- // service Storage {
168
- // // Get the underlying ACL object.
169
- // rpc GetAcl(GetAclRequest) returns (Acl) {
170
- // option (google.api.http).get = "/v2/{resource=**}:getAcl";
171
- // }
172
- // ...
173
- // }
174
- //
175
- // Note how the version in the path pattern changed from `v1` to `v2`.
176
- //
177
- // If the `root` field in the mixin is specified, it should be a
178
- // relative path under which inherited HTTP paths are placed. Example:
179
- //
180
- // apis:
181
- // - name: google.storage.v2.Storage
182
- // mixins:
183
- // - name: google.acl.v1.AccessControl
184
- // root: acls
185
- //
186
- // This implies the following inherited HTTP annotation:
187
- //
188
- // service Storage {
189
- // // Get the underlying ACL object.
190
- // rpc GetAcl(GetAclRequest) returns (Acl) {
191
- // option (google.api.http).get = "/v2/acls/{resource=**}:getAcl";
192
- // }
193
- // ...
194
- // }
195
- message Mixin {
196
- // The fully qualified name of the API which is included.
197
- string name = 1;
198
-
199
- // If non-empty specifies a path under which inherited HTTP paths
200
- // are rooted.
201
- string root = 2;
202
- }
@@ -1,163 +0,0 @@
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
- // Author: kenton@google.com (Kenton Varda)
32
- //
33
- // WARNING: The plugin interface is currently EXPERIMENTAL and is subject to
34
- // change.
35
- //
36
- // protoc (aka the Protocol Compiler) can be extended via plugins. A plugin is
37
- // just a program that reads a CodeGeneratorRequest from stdin and writes a
38
- // CodeGeneratorResponse to stdout.
39
- //
40
- // Plugins written using C++ can use google/protobuf/compiler/plugin.h instead
41
- // of dealing with the raw protocol defined here.
42
- //
43
- // A plugin executable needs only to be placed somewhere in the path. The
44
- // plugin should be named "protoc-gen-$NAME", and will then be used when the
45
- // flag "--${NAME}_out" is passed to protoc.
46
-
47
- syntax = "proto2";
48
- package google.protobuf.compiler;
49
- option java_package = "com.google.protobuf.compiler";
50
- option java_outer_classname = "PluginProtos";
51
-
52
- option go_package = "plugin_go";
53
-
54
- import "google/protobuf/descriptor.proto";
55
-
56
- // The version number of protocol compiler.
57
- message Version {
58
- optional int32 major = 1;
59
- optional int32 minor = 2;
60
- optional int32 patch = 3;
61
- // A suffix for alpha, beta or rc release, e.g., "alpha-1", "rc2". It should
62
- // be empty for mainline stable releases.
63
- optional string suffix = 4;
64
- }
65
-
66
- // An encoded CodeGeneratorRequest is written to the plugin's stdin.
67
- message CodeGeneratorRequest {
68
- // The .proto files that were explicitly listed on the command-line. The
69
- // code generator should generate code only for these files. Each file's
70
- // descriptor will be included in proto_file, below.
71
- repeated string file_to_generate = 1;
72
-
73
- // The generator parameter passed on the command-line.
74
- optional string parameter = 2;
75
-
76
- // FileDescriptorProtos for all files in files_to_generate and everything
77
- // they import. The files will appear in topological order, so each file
78
- // appears before any file that imports it.
79
- //
80
- // protoc guarantees that all proto_files will be written after
81
- // the fields above, even though this is not technically guaranteed by the
82
- // protobuf wire format. This theoretically could allow a plugin to stream
83
- // in the FileDescriptorProtos and handle them one by one rather than read
84
- // the entire set into memory at once. However, as of this writing, this
85
- // is not similarly optimized on protoc's end -- it will store all fields in
86
- // memory at once before sending them to the plugin.
87
- repeated FileDescriptorProto proto_file = 15;
88
-
89
- // The version number of protocol compiler.
90
- optional Version compiler_version = 3;
91
- }
92
-
93
- // The plugin writes an encoded CodeGeneratorResponse to stdout.
94
- message CodeGeneratorResponse {
95
- // Error message. If non-empty, code generation failed. The plugin process
96
- // should exit with status code zero even if it reports an error in this way.
97
- //
98
- // This should be used to indicate errors in .proto files which prevent the
99
- // code generator from generating correct code. Errors which indicate a
100
- // problem in protoc itself -- such as the input CodeGeneratorRequest being
101
- // unparseable -- should be reported by writing a message to stderr and
102
- // exiting with a non-zero status code.
103
- optional string error = 1;
104
-
105
- // Represents a single generated file.
106
- message File {
107
- // The file name, relative to the output directory. The name must not
108
- // contain "." or ".." components and must be relative, not be absolute (so,
109
- // the file cannot lie outside the output directory). "/" must be used as
110
- // the path separator, not "\".
111
- //
112
- // If the name is omitted, the content will be appended to the previous
113
- // file. This allows the generator to break large files into small chunks,
114
- // and allows the generated text to be streamed back to protoc so that large
115
- // files need not reside completely in memory at one time. Note that as of
116
- // this writing protoc does not optimize for this -- it will read the entire
117
- // CodeGeneratorResponse before writing files to disk.
118
- optional string name = 1;
119
-
120
- // If non-empty, indicates that the named file should already exist, and the
121
- // content here is to be inserted into that file at a defined insertion
122
- // point. This feature allows a code generator to extend the output
123
- // produced by another code generator. The original generator may provide
124
- // insertion points by placing special annotations in the file that look
125
- // like:
126
- // @@protoc_insertion_point(NAME)
127
- // The annotation can have arbitrary text before and after it on the line,
128
- // which allows it to be placed in a comment. NAME should be replaced with
129
- // an identifier naming the point -- this is what other generators will use
130
- // as the insertion_point. Code inserted at this point will be placed
131
- // immediately above the line containing the insertion point (thus multiple
132
- // insertions to the same point will come out in the order they were added).
133
- // The double-@ is intended to make it unlikely that the generated code
134
- // could contain things that look like insertion points by accident.
135
- //
136
- // For example, the C++ code generator places the following line in the
137
- // .pb.h files that it generates:
138
- // // @@protoc_insertion_point(namespace_scope)
139
- // This line appears within the scope of the file's package namespace, but
140
- // outside of any particular class. Another plugin can then specify the
141
- // insertion_point "namespace_scope" to generate additional classes or
142
- // other declarations that should be placed in this scope.
143
- //
144
- // Note that if the line containing the insertion point begins with
145
- // whitespace, the same whitespace will be added to every line of the
146
- // inserted text. This is useful for languages like Python, where
147
- // indentation matters. In these languages, the insertion point comment
148
- // should be indented the same amount as any inserted code will need to be
149
- // in order to work correctly in that context.
150
- //
151
- // The code generator that generates the initial file and the one which
152
- // inserts into it must both run as part of a single invocation of protoc.
153
- // Code generators are executed in the order in which they appear on the
154
- // command line.
155
- //
156
- // If |insertion_point| is present, |name| must also be present.
157
- optional string insertion_point = 2;
158
-
159
- // The file contents.
160
- optional string content = 15;
161
- }
162
- repeated File file = 15;
163
- }