protoc-runner 35.1__py3-none-win_amd64.whl

protoc/__init__.py

@@ -0,0 +1,28 @@
+# Copyright (c) 2025-2026 Buf Technologies, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Package providing convenience access to protoc and conformance test runner."""
+
+from __future__ import annotations
+
+__all__ = [
+    "get_conformance_test_runner_path",
+    "get_include_protos_path",
+    "get_protoc_path",
+]
+
+from ._paths import (
+    get_conformance_test_runner_path,
+    get_include_protos_path,
+    get_protoc_path,
+)

protoc/_main.py

@@ -0,0 +1,27 @@
+# Copyright (c) 2025-2026 Buf Technologies, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from __future__ import annotations
+
+import os
+import sys
+
+from ._paths import get_conformance_test_runner_path, get_protoc_path
+
+
+def conformance_test_runner() -> None:
+    os.execv(get_conformance_test_runner_path(), sys.argv)  # noqa: S606
+
+
+def protoc() -> None:
+    os.execv(get_protoc_path(), sys.argv)  # noqa: S606

protoc/_paths.py

@@ -0,0 +1,36 @@
+# Copyright (c) 2025-2026 Buf Technologies, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+
+def get_conformance_test_runner_path() -> Path:
+    """Returns the path to the conformance test runner."""
+    if sys.platform == "win32":
+        msg = "conformance test runner is not supported on Windows"
+        raise RuntimeError(msg)
+    return Path(__file__).parent / "_bin" / "conformance_test_runner"
+
+
+def get_protoc_path() -> Path:
+    """Returns the path to the protoc binary."""
+    protoc_exe = "protoc.exe" if sys.platform == "win32" else "protoc"
+    return Path(__file__).parent / "_bin" / protoc_exe
+
+
+def get_include_protos_path() -> Path:
+    """Returns the path to the included protos."""
+    return Path(__file__).parent / "include"

protoc/include/conformance/conformance.proto

@@ -0,0 +1,173 @@
+// Protocol Buffers - Google's data interchange format
+// Copyright 2008 Google Inc.  All rights reserved.
+//
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file or at
+// https://developers.google.com/open-source/licenses/bsd
+
+syntax = "proto3";
+
+package conformance;
+
+option java_package = "com.google.protobuf.conformance";
+option objc_class_prefix = "Conformance";
+
+// This defines the conformance testing protocol.  This protocol exists between
+// the conformance test suite itself and the code being tested.  For each test,
+// the suite will send a ConformanceRequest message and expect a
+// ConformanceResponse message.
+//
+// You can either run the tests in two different ways:
+//
+//   1. in-process (using the interface in conformance_test.h).
+//
+//   2. as a sub-process communicating over a pipe.  Information about how to
+//      do this is in conformance_test_runner.cc.
+//
+// Pros/cons of the two approaches:
+//
+//   - running as a sub-process is much simpler for languages other than C/C++.
+//
+//   - running as a sub-process may be more tricky in unusual environments like
+//     iOS apps, where fork/stdin/stdout are not available.
+
+enum WireFormat {
+  UNSPECIFIED = 0;
+  PROTOBUF = 1;
+  JSON = 2;
+  JSPB = 3;  // Only used inside Google. Opensource testees just skip it.
+  TEXT_FORMAT = 4;
+}
+
+enum TestCategory {
+  UNSPECIFIED_TEST = 0;
+  BINARY_TEST = 1;  // Test binary wire format.
+  JSON_TEST = 2;    // Test json wire format.
+  // Similar to JSON_TEST. However, during parsing json, testee should ignore
+  // unknown fields. This feature is optional. Each implementation can decide
+  // whether to support it.  See
+  // https://developers.google.com/protocol-buffers/docs/proto3#json_options
+  // for more detail.
+  JSON_IGNORE_UNKNOWN_PARSING_TEST = 3;
+  // Test jspb wire format. Only used inside Google. Opensource testees just
+  // skip it.
+  JSPB_TEST = 4;
+  // Test text format. For cpp, java and python, testees can already deal with
+  // this type. Testees of other languages can simply skip it.
+  TEXT_FORMAT_TEST = 5;
+}
+
+// Meant to encapsulate all types of tests: successes, skips, failures, etc.
+// Therefore, this may or may not have a failure message. Failure messages
+// may be truncated for our failure lists.
+message TestStatus {
+  string name = 1;
+  string failure_message = 2;
+  // What an actual test name matched to in a failure list. Can be wildcarded or
+  // an exact match without wildcards.
+  string matched_name = 3;
+}
+
+// The conformance runner will request a list of failures as the first request.
+// This will be known by message_type == "conformance.FailureSet", a conformance
+// test should return a serialized FailureSet in protobuf_payload.
+message FailureSet {
+  repeated TestStatus test = 2;
+  reserved 1;
+}
+
+// Represents a single test case's input.  The testee should:
+//
+//   1. parse this proto (which should always succeed)
+//   2. parse the protobuf or JSON payload in "payload" (which may fail)
+//   3. if the parse succeeded, serialize the message in the requested format.
+message ConformanceRequest {
+  // The payload (whether protobuf of JSON) is always for a
+  // protobuf_test_messages.proto3.TestAllTypes proto (as defined in
+  // src/google/protobuf/proto3_test_messages.proto).
+  oneof payload {
+    bytes protobuf_payload = 1;
+    string json_payload = 2;
+    // Only used inside Google.  Opensource testees just skip it.
+    string jspb_payload = 7;
+    string text_payload = 8;
+  }
+
+  // Which format should the testee serialize its message to?
+  WireFormat requested_output_format = 3;
+
+  // The full name for the test message to use; for the moment, either:
+  // protobuf_test_messages.proto3.TestAllTypesProto3 or
+  // protobuf_test_messages.proto2.TestAllTypesProto2 or
+  // protobuf_test_messages.editions.proto2.TestAllTypesProto2 or
+  // protobuf_test_messages.editions.proto3.TestAllTypesProto3 or
+  // protobuf_test_messages.editions.TestAllTypesEdition2023 or
+  // protobuf_test_messages.edition_unstable.TestAllTypesEditionUnstable.
+  string message_type = 4;
+
+  // Each test is given a specific test category. Some category may need
+  // specific support in testee programs. Refer to the definition of
+  // TestCategory for more information.
+  TestCategory test_category = 5;
+
+  // Specify details for how to encode jspb.
+  JspbEncodingConfig jspb_encoding_options = 6;
+
+  // This can be used in json and text format. If true, testee should print
+  // unknown fields instead of ignore. This feature is optional.
+  bool print_unknown_fields = 9;
+}
+
+// Represents a single test case's output.
+message ConformanceResponse {
+  oneof result {
+    // This string should be set to indicate parsing failed.  The string can
+    // provide more information about the parse error if it is available.
+    //
+    // Setting this string does not necessarily mean the testee failed the
+    // test.  Some of the test cases are intentionally invalid input.
+    string parse_error = 1;
+
+    // If the input was successfully parsed but errors occurred when
+    // serializing it to the requested output format, set the error message in
+    // this field.
+    string serialize_error = 6;
+
+    // This should be set if the test program timed out.  The string should
+    // provide more information about what the child process was doing when it
+    // was killed.
+    string timeout_error = 9;
+
+    // This should be set if some other error occurred.  This will always
+    // indicate that the test failed.  The string can provide more information
+    // about the failure.
+    string runtime_error = 2;
+
+    // If the input was successfully parsed and the requested output was
+    // protobuf, serialize it to protobuf and set it in this field.
+    bytes protobuf_payload = 3;
+
+    // If the input was successfully parsed and the requested output was JSON,
+    // serialize to JSON and set it in this field.
+    string json_payload = 4;
+
+    // For when the testee skipped the test, likely because a certain feature
+    // wasn't supported, like JSON input/output.
+    string skipped = 5;
+
+    // If the input was successfully parsed and the requested output was JSPB,
+    // serialize to JSPB and set it in this field. JSPB is only used inside
+    // Google. Opensource testees can just skip it.
+    string jspb_payload = 7;
+
+    // If the input was successfully parsed and the requested output was
+    // TEXT_FORMAT, serialize to TEXT_FORMAT and set it in this field.
+    string text_payload = 8;
+  }
+}
+
+// Encoding options for jspb format.
+message JspbEncodingConfig {
+  // Encode the value field of Any as jspb array if true, otherwise binary.
+  bool use_jspb_array_any_format = 1;
+}

protoc/include/conformance/messages/test_messages_edition2023.proto

@@ -0,0 +1,222 @@
+// Protocol Buffers - Google's data interchange format
+// Copyright 2024 Google Inc.  All rights reserved.
+//
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file or at
+// https://developers.google.com/open-source/licenses/bsd
+
+edition = "2023";
+
+package protobuf_test_messages.editions;
+
+option features.message_encoding = DELIMITED;
+option java_package = "com.google.protobuf_test_messages.edition2023";
+option java_multiple_files = true;
+option objc_class_prefix = "Editions";
+
+message ComplexMessage {
+  int32 d = 1;
+}
+
+message TestAllTypesEdition2023 {
+  message NestedMessage {
+    int32 a = 1;
+    TestAllTypesEdition2023 corecursive = 2
+        [features.message_encoding = LENGTH_PREFIXED];
+  }
+
+  enum NestedEnum {
+    FOO = 0;
+    BAR = 1;
+    BAZ = 2;
+    NEG = -1;  // Intentionally negative.
+  }
+
+  // Singular
+  int32 optional_int32 = 1;
+  int64 optional_int64 = 2;
+  uint32 optional_uint32 = 3;
+  uint64 optional_uint64 = 4;
+  sint32 optional_sint32 = 5;
+  sint64 optional_sint64 = 6;
+  fixed32 optional_fixed32 = 7;
+  fixed64 optional_fixed64 = 8;
+  sfixed32 optional_sfixed32 = 9;
+  sfixed64 optional_sfixed64 = 10;
+  float optional_float = 11;
+  double optional_double = 12;
+  bool optional_bool = 13;
+  string optional_string = 14;
+  bytes optional_bytes = 15;
+
+  NestedMessage optional_nested_message = 18
+      [features.message_encoding = LENGTH_PREFIXED];
+  ForeignMessageEdition2023 optional_foreign_message = 19
+      [features.message_encoding = LENGTH_PREFIXED];
+
+  NestedEnum optional_nested_enum = 21;
+  ForeignEnumEdition2023 optional_foreign_enum = 22;
+
+  string optional_string_piece = 24 [ctype = STRING_PIECE];
+  string optional_cord = 25 [ctype = CORD];
+
+  TestAllTypesEdition2023 recursive_message = 27
+      [features.message_encoding = LENGTH_PREFIXED];
+
+  // Repeated
+  repeated int32 repeated_int32 = 31;
+  repeated int64 repeated_int64 = 32;
+  repeated uint32 repeated_uint32 = 33;
+  repeated uint64 repeated_uint64 = 34;
+  repeated sint32 repeated_sint32 = 35;
+  repeated sint64 repeated_sint64 = 36;
+  repeated fixed32 repeated_fixed32 = 37;
+  repeated fixed64 repeated_fixed64 = 38;
+  repeated sfixed32 repeated_sfixed32 = 39;
+  repeated sfixed64 repeated_sfixed64 = 40;
+  repeated float repeated_float = 41;
+  repeated double repeated_double = 42;
+  repeated bool repeated_bool = 43;
+  repeated string repeated_string = 44;
+  repeated bytes repeated_bytes = 45;
+
+  repeated NestedMessage repeated_nested_message = 48
+      [features.message_encoding = LENGTH_PREFIXED];
+  repeated ForeignMessageEdition2023 repeated_foreign_message = 49
+      [features.message_encoding = LENGTH_PREFIXED];
+
+  repeated NestedEnum repeated_nested_enum = 51;
+  repeated ForeignEnumEdition2023 repeated_foreign_enum = 52;
+
+  repeated string repeated_string_piece = 54 [ctype = STRING_PIECE];
+  repeated string repeated_cord = 55 [ctype = CORD];
+
+  // Packed
+  repeated int32 packed_int32 = 75 [features.repeated_field_encoding = PACKED];
+  repeated int64 packed_int64 = 76 [features.repeated_field_encoding = PACKED];
+  repeated uint32 packed_uint32 = 77
+      [features.repeated_field_encoding = PACKED];
+  repeated uint64 packed_uint64 = 78
+      [features.repeated_field_encoding = PACKED];
+  repeated sint32 packed_sint32 = 79
+      [features.repeated_field_encoding = PACKED];
+  repeated sint64 packed_sint64 = 80
+      [features.repeated_field_encoding = PACKED];
+  repeated fixed32 packed_fixed32 = 81
+      [features.repeated_field_encoding = PACKED];
+  repeated fixed64 packed_fixed64 = 82
+      [features.repeated_field_encoding = PACKED];
+  repeated sfixed32 packed_sfixed32 = 83
+      [features.repeated_field_encoding = PACKED];
+  repeated sfixed64 packed_sfixed64 = 84
+      [features.repeated_field_encoding = PACKED];
+  repeated float packed_float = 85 [features.repeated_field_encoding = PACKED];
+  repeated double packed_double = 86
+      [features.repeated_field_encoding = PACKED];
+  repeated bool packed_bool = 87 [features.repeated_field_encoding = PACKED];
+  repeated NestedEnum packed_nested_enum = 88
+      [features.repeated_field_encoding = PACKED];
+
+  // Unpacked
+  repeated int32 unpacked_int32 = 89
+      [features.repeated_field_encoding = EXPANDED];
+  repeated int64 unpacked_int64 = 90
+      [features.repeated_field_encoding = EXPANDED];
+  repeated uint32 unpacked_uint32 = 91
+      [features.repeated_field_encoding = EXPANDED];
+  repeated uint64 unpacked_uint64 = 92
+      [features.repeated_field_encoding = EXPANDED];
+  repeated sint32 unpacked_sint32 = 93
+      [features.repeated_field_encoding = EXPANDED];
+  repeated sint64 unpacked_sint64 = 94
+      [features.repeated_field_encoding = EXPANDED];
+  repeated fixed32 unpacked_fixed32 = 95
+      [features.repeated_field_encoding = EXPANDED];
+  repeated fixed64 unpacked_fixed64 = 96
+      [features.repeated_field_encoding = EXPANDED];
+  repeated sfixed32 unpacked_sfixed32 = 97
+      [features.repeated_field_encoding = EXPANDED];
+  repeated sfixed64 unpacked_sfixed64 = 98
+      [features.repeated_field_encoding = EXPANDED];
+  repeated float unpacked_float = 99
+      [features.repeated_field_encoding = EXPANDED];
+  repeated double unpacked_double = 100
+      [features.repeated_field_encoding = EXPANDED];
+  repeated bool unpacked_bool = 101
+      [features.repeated_field_encoding = EXPANDED];
+  repeated NestedEnum unpacked_nested_enum = 102
+      [features.repeated_field_encoding = EXPANDED];
+
+  // Map
+  map<int32, int32> map_int32_int32 = 56;
+  map<int64, int64> map_int64_int64 = 57;
+  map<uint32, uint32> map_uint32_uint32 = 58;
+  map<uint64, uint64> map_uint64_uint64 = 59;
+  map<sint32, sint32> map_sint32_sint32 = 60;
+  map<sint64, sint64> map_sint64_sint64 = 61;
+  map<fixed32, fixed32> map_fixed32_fixed32 = 62;
+  map<fixed64, fixed64> map_fixed64_fixed64 = 63;
+  map<sfixed32, sfixed32> map_sfixed32_sfixed32 = 64;
+  map<sfixed64, sfixed64> map_sfixed64_sfixed64 = 65;
+  map<int32, float> map_int32_float = 66;
+  map<int32, double> map_int32_double = 67;
+  map<bool, bool> map_bool_bool = 68;
+  map<string, string> map_string_string = 69;
+  map<string, bytes> map_string_bytes = 70;
+  map<string, NestedMessage> map_string_nested_message = 71;
+  map<string, ForeignMessageEdition2023> map_string_foreign_message = 72;
+  map<string, NestedEnum> map_string_nested_enum = 73;
+  map<string, ForeignEnumEdition2023> map_string_foreign_enum = 74;
+
+  oneof oneof_field {
+    uint32 oneof_uint32 = 111;
+    NestedMessage oneof_nested_message = 112
+        [features.message_encoding = LENGTH_PREFIXED];
+    string oneof_string = 113;
+    bytes oneof_bytes = 114;
+    bool oneof_bool = 115;
+    uint64 oneof_uint64 = 116;
+    float oneof_float = 117;
+    double oneof_double = 118;
+    NestedEnum oneof_enum = 119;
+  }
+
+  // extensions
+  extensions 120 to 200;
+
+  // groups
+  message GroupLikeType {
+    int32 group_int32 = 202;
+    uint32 group_uint32 = 203;
+  }
+  GroupLikeType groupliketype = 201;
+  GroupLikeType delimited_field = 202;
+
+  // recursive
+  map<int32, TestAllTypesEdition2023> map_recursive = 301;
+}
+
+message ForeignMessageEdition2023 {
+  int32 c = 1;
+}
+
+enum ForeignEnumEdition2023 {
+  FOREIGN_FOO = 0;
+  FOREIGN_BAR = 1;
+  FOREIGN_BAZ = 2;
+}
+
+extend TestAllTypesEdition2023 {
+  int32 extension_int32 = 120;
+  string extension_string = 133;
+  bytes extension_bytes = 134;
+}
+
+message GroupLikeType {
+  int32 c = 1;
+}
+
+extend TestAllTypesEdition2023 {
+  GroupLikeType groupliketype = 121;
+  GroupLikeType delimited_ext = 122;
+}

protoc/include/conformance/messages/test_messages_edition_unstable.proto

@@ -0,0 +1,66 @@
+// Protocol Buffers - Google's data interchange format
+// Copyright 2024 Google Inc.  All rights reserved.
+//
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file or at
+// https://developers.google.com/open-source/licenses/bsd
+
+edition = "UNSTABLE";
+
+package protobuf_test_messages.edition_unstable;
+
+option features.message_encoding = DELIMITED;
+option java_package = "com.google.protobuf_test_messages.edition_unstable";
+option objc_class_prefix = "EditionUnstable";
+
+message ComplexMessage {
+  int32 d = 1;
+}
+
+message TestAllTypesEditionUnstable {
+  // Singular
+  int32 optional_int32 = 1;
+
+  ForeignMessageEditionUnstable optional_foreign_message = 2
+      [features.message_encoding = LENGTH_PREFIXED];
+
+  ForeignEnumEditionUnstable optional_foreign_enum = 3;
+
+  TestAllTypesEditionUnstable recursive_message = 4
+      [features.message_encoding = LENGTH_PREFIXED];
+
+  // Repeated
+  repeated int32 repeated_int32 = 5;
+  repeated ForeignMessageEditionUnstable repeated_foreign_message = 6
+      [features.message_encoding = LENGTH_PREFIXED];
+  repeated ForeignEnumEditionUnstable repeated_foreign_enum = 7;
+
+  // Map
+  map<int32, int32> map_int32_int32 = 8;
+  map<bool, bool> map_bool_bool = 9;
+  map<string, string> map_string_string = 10;
+  map<string, ForeignMessageEditionUnstable> map_string_foreign_message = 11;
+  map<string, ForeignEnumEditionUnstable> map_string_foreign_enum = 12;
+
+  // bytes
+  bytes optional_bytes = 13;
+  repeated bytes repeated_bytes = 14;
+  map<string, bytes> map_string_bytes = 15;
+
+  // extensions
+  extensions 120 to 200;
+}
+
+message ForeignMessageEditionUnstable {
+  int32 c = 1;
+}
+
+enum ForeignEnumEditionUnstable {
+  FOREIGN_FOO = 0;
+  FOREIGN_BAR = 1;
+  FOREIGN_BAZ = 2;
+}
+
+extend TestAllTypesEditionUnstable {
+  int32 extension_int32 = 120;
+}