deploy: 1e51d8c

Author: Logofile

getting-started/pythontutorial/index.html

@@ -127,7 +127,7 @@
 application’s source code lives – the current directory is used if you
 don’t provide a value), the destination directory (where you want the
 generated code to go; often the same as <code>$SRC_DIR</code>), and the path to your
-<code>.proto</code>. In this case, you&mldr;:</p><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-shell data-lang=shell><span style=display:flex><span>protoc -I<span style=color:#ce5c00;font-weight:700>=</span><span style=color:#000>$SRC_DIR</span> --python_out<span style=color:#ce5c00;font-weight:700>=</span><span style=color:#000>$DST_DIR</span> <span style=color:#000>$SRC_DIR</span>/addressbook.proto
+<code>.proto</code>. In this case, you&mldr;:</p><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-shell data-lang=shell><span style=display:flex><span>protoc --proto_path<span style=color:#ce5c00;font-weight:700>=</span><span style=color:#000>$SRC_DIR</span> --python_out<span style=color:#ce5c00;font-weight:700>=</span><span style=color:#000>$DST_DIR</span> <span style=color:#000>$SRC_DIR</span>/addressbook.proto
 </span></span></code></pre></div><p>Because you want Python classes, you use the <code>--python_out</code> option &ndash;
 similar options are provided for other supported languages.</p><p>Protoc is also able to generate python stubs (<code>.pyi</code>) with <code>--pyi_out</code>.</p></li></ol><p>This generates <code>addressbook_pb2.py</code> (or <code>addressbook_pb2.pyi</code>) in your specified
 destination directory.</p><h2 id=protobuf-api>The Protocol Buffer API</h2><p>Unlike when you generate Java and C++ protocol buffer code, the Python protocol

programming-guides/enum/index.html

@@ -13,7 +13,9 @@
 specs.</p><h2 id=enum>Number of Values in an Enum</h2><p>The lowest limit is ~1700 values, in Java (fix available
 go/java-large-enum-support). Other languages have different limits.</p><h2 id=total>Total Size of the Message</h2><p>Any proto in serialized form must be &lt;2GiB, as that is the maximum size
 supported by all implementations. It&rsquo;s recommended to bound request and response
-sizes.</p><h2 id=depth>Depth Limit for Proto Unmarshaling</h2><ul><li>Java: 100</li><li>C++: 100</li><li>Go:
+sizes.</p><h2 id=depth>Depth Limit for Proto Unmarshaling</h2><ul><li>Java:
+100</li><li>C++:
+100</li><li>Go:
 10000
 (there is a plan to reduce this to 100)</li></ul><p>If you try to unmarshal a message that is nested deeper than the depth limit,
 the unmarshaling will fail.</p></div></main></div></div><footer class="bg-dark py-5 row d-print-none"><div class="container-fluid mx-sm-5"><div class=row><div class="col-6 col-sm-4 text-xs-center order-sm-2"><ul class="list-inline mb-0"><li class="list-inline-item mx-2 h3" data-toggle=tooltip data-placement=top title="Stack Overflow" aria-label="Stack Overflow"><a class=text-white target=_blank rel=noopener href=https://stackoverflow.com/questions/tagged/protocol-buffers aria-label="Stack Overflow"><i class="fab fa-stack-overflow"></i></a></li></ul><script type=text/javascript id=cookiebanner src=https://cdn.jsdelivr.net/gh/dobarkod/[email protected]/dist/cookiebanner.min.js data-height=50px data-message="Protobuf.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic." data-bg=#ffb data-fg=#000 data-position=bottom data-padding="10px 16px" data-close-text="OK, got it" data-font-size=18px data-moreinfo=https://policies.google.com/technologies/cookies></script></div><div class="col-6 col-sm-4 text-right text-xs-center order-sm-3"><ul class="list-inline mb-0"><li class="list-inline-item mx-2 h3" data-toggle=tooltip data-placement=top title=GitHub aria-label=GitHub><a class=text-white target=_blank rel=noopener href=https://github.com/protocolbuffers/protobuf aria-label=GitHub><i class="fab fa-github"></i></a></li><li class="list-inline-item mx-2 h3" data-toggle=tooltip data-placement=top title="Developer mailing list" aria-label="Developer mailing list"><a class=text-white target=_blank rel=noopener href=https://groups.google.com/g/protobuf aria-label="Developer mailing list"><i class="fa fa-envelope"></i></a></li></ul><script type=text/javascript id=cookiebanner src=https://cdn.jsdelivr.net/gh/dobarkod/[email protected]/dist/cookiebanner.min.js data-height=50px data-message="Protobuf.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic." data-bg=#ffb data-fg=#000 data-position=bottom data-padding="10px 16px" data-close-text="OK, got it" data-font-size=18px data-moreinfo=https://policies.google.com/technologies/cookies></script></div><div class="col-12 col-sm-4 text-center py-2 order-sm-2"><small class=text-white>&copy; 2024 Google LLC All Rights Reserved</small>

programming-guides/proto-limits/index.html

@@ -240,8 +240,8 @@
 special <code>EnumDescriptor</code> class for Python that&rsquo;s used to create a set of
 symbolic constants with integer values in the runtime-generated class.</p><div class="alert alert-warning" role=alert><h4 class=alert-heading>Important</h4>The
 generated code may be subject to language-specific limitations on the number of
-enumerators (low thousands for one language). Review the limitations for the
-languages you plan to use.</div><div class="alert alert-warning" role=alert><h4 class=alert-heading>Important</h4>For
+enumerators (low thousands for one language). Review the
+limitations for the languages you plan to use.</div><div class="alert alert-warning" role=alert><h4 class=alert-heading>Important</h4>For
 information on how enums should work contrasted with how they currently work in
 different languages, see
 <a href=/programming-guides/enum>Enum Behavior</a>.</div><p>Removing enum values is a breaking change for persisted protos. Instead of

programming-guides/proto2/index.html

@@ -255,8 +255,8 @@
 special <code>EnumDescriptor</code> class for Python that&rsquo;s used to create a set of
 symbolic constants with integer values in the runtime-generated class.</p><div class="alert alert-warning" role=alert><h4 class=alert-heading>Important</h4>The
 generated code may be subject to language-specific limitations on the number of
-enumerators (low thousands for one language). Review the limitations for the
-languages you plan to use.</div><p>During deserialization, unrecognized enum values will be preserved in the
+enumerators (low thousands for one language). Review the
+limitations for the languages you plan to use.</div><p>During deserialization, unrecognized enum values will be preserved in the
 message, though how this is represented when the message is deserialized is
 language-dependent. In languages that support open enum types with values
 outside the range of specified symbols, such as C++ and Go, the unknown enum

programming-guides/proto3/index.html

@@ -147,7 +147,8 @@ implements the <code>Message.Builder</code> interface. It extends the
 <code>GeneratedMessage.Builder</code> class, but, again, this should be considered an
 implementation detail. Like <code>Foo</code>, <code>Foo.Builder</code> may rely on generic method
 implementations in <code>GeneratedMessage.Builder</code> or, when the <code>optimize_for</code> option
-is used, generated custom code that is much faster.</p>
+is used, generated custom code that is much faster. You can get a <code>Foo.Builder</code>
+by calling the static method <code>Foo.newBuilder()</code>.</p>
 <p><code>Foo.Builder</code> does not define any static methods. Its interface is exactly as
 defined by the <code>Message.Builder</code> interface, with the exception that return types
 are more specific: methods of <code>Foo.Builder</code> that modify the builder return type

reference/java/index.xml

@@ -261,12 +261,12 @@ to an enum field, even if it was not defined in the enum.</p>
 </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">end</span>
 </span></span></code></pre></div><p>An enum module also defines the following utility methods:</p>
 <ul>
-<li><code>Enum#lookup(number)</code>: Looks up the given number and returns its name, or
-<code>nil</code> if none was found. If more than one name has this number, returns the
-first that was defined.</li>
-<li><code>Enum#resolve(symbol)</code>: Returns the number for this enum name, or <code>nil</code> if
-none was found.</li>
-<li><code>Enum#descriptor</code>: Returns the descriptor for this enum.</li>
+<li><code>Foo::SomeEnum.lookup(number)</code>: Looks up the given number and returns its
+name, or <code>nil</code> if none was found. If more than one name has this number,
+returns the first that was defined.</li>
+<li><code>Foo::SomeEnum.resolve(symbol)</code>: Returns the number for this enum name, or
+<code>nil</code> if none was found.</li>
+<li><code>Foo::SomeEnum.descriptor</code>: Returns the descriptor for this enum.</li>
 </ul>
 <h2 id="oneof">Oneof</h2>
 <p>Given a message with a oneof:</p>

reference/java/java-generated/index.html

@@ -193,10 +193,10 @@
 </span></span><span style=display:flex><span><span style=color:#204a87;font-weight:700>else</span>
 </span></span><span style=display:flex><span>  <span style=color:#8f5902;font-style:italic># ...</span>
 </span></span><span style=display:flex><span><span style=color:#204a87;font-weight:700>end</span>
-</span></span></code></pre></div><p>An enum module also defines the following utility methods:</p><ul><li><code>Enum#lookup(number)</code>: Looks up the given number and returns its name, or
-<code>nil</code> if none was found. If more than one name has this number, returns the
-first that was defined.</li><li><code>Enum#resolve(symbol)</code>: Returns the number for this enum name, or <code>nil</code> if
-none was found.</li><li><code>Enum#descriptor</code>: Returns the descriptor for this enum.</li></ul><h2 id=oneof>Oneof</h2><p>Given a message with a oneof:</p><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-proto data-lang=proto><span style=display:flex><span><span style=color:#204a87;font-weight:700>message</span> <span style=color:#000>Foo</span> <span style=color:#000;font-weight:700>{</span><span style=color:#a40000>
+</span></span></code></pre></div><p>An enum module also defines the following utility methods:</p><ul><li><code>Foo::SomeEnum.lookup(number)</code>: Looks up the given number and returns its
+name, or <code>nil</code> if none was found. If more than one name has this number,
+returns the first that was defined.</li><li><code>Foo::SomeEnum.resolve(symbol)</code>: Returns the number for this enum name, or
+<code>nil</code> if none was found.</li><li><code>Foo::SomeEnum.descriptor</code>: Returns the descriptor for this enum.</li></ul><h2 id=oneof>Oneof</h2><p>Given a message with a oneof:</p><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-proto data-lang=proto><span style=display:flex><span><span style=color:#204a87;font-weight:700>message</span> <span style=color:#000>Foo</span> <span style=color:#000;font-weight:700>{</span><span style=color:#a40000>
 </span></span></span><span style=display:flex><span><span style=color:#a40000></span>  <span style=color:#204a87;font-weight:700>oneof</span> <span style=color:#000>test_oneof</span> <span style=color:#000;font-weight:700>{</span><span style=color:#a40000>
 </span></span></span><span style=display:flex><span><span style=color:#a40000></span>     <span style=color:#204a87;font-weight:700>string</span> <span style=color:#000>name</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#0000cf;font-weight:700>1</span><span style=color:#000;font-weight:700>;</span><span style=color:#a40000>
 </span></span></span><span style=display:flex><span><span style=color:#a40000></span>     <span style=color:#204a87;font-weight:700>int32</span> <span style=color:#000>serial_number</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#0000cf;font-weight:700>2</span><span style=color:#000;font-weight:700>;</span><span style=color:#a40000>