Update contrib/python/mypy-protobuf to 3.5.0

commit_hash:bfda51486cc75a7834db8b71f122c4f26dde8b37

Author: robot-piglet

contrib/python/mypy-protobuf/.dist-info/METADATA

@@ -1,15 +1,15 @@
 Metadata-Version: 2.1
 Name: mypy-protobuf
-Version: 3.3.0
+Version: 3.5.0
 Summary: Generate mypy stub files from protobuf specs
 Home-page: https://github.com/nipunn1313/mypy-protobuf
 Download-URL: https://github.com/nipunn1313/mypy-protobuf/releases
 Author: Nipunn Koorapati
 Author-email: nipunn1313@gmail.com
 License: Apache License 2.0
 Keywords: mypy proto dropbox
-Requires-Python: >=3.7
+Requires-Python: >=3.8
 License-File: LICENSE
-Requires-Dist: protobuf (>=3.19.4)
-Requires-Dist: types-protobuf (>=3.19.12)
+Requires-Dist: protobuf (>=4.23.4)
+Requires-Dist: types-protobuf (>=4.23.0.2)
 

contrib/python/mypy-protobuf/README.md

@@ -12,33 +12,42 @@ Built originally with love at [Dropbox](https://github.com/dropbox)
 See [Changelog](CHANGELOG.md) for recent changes.
 
 ## Requirements to run mypy-protobuf
+
 Earlier releases might work, but aren't tested
-- [protoc >= 3.19.4](https://github.com/protocolbuffers/protobuf/releases)
-- [python-protobuf >= 3.19.4](https://pypi.org/project/protobuf/) - matching protoc release
-- [python >= 3.7](https://www.python.org/downloads/source/) - for running mypy-protobuf plugin.
+
+- [protoc >= 23.4](https://github.com/protocolbuffers/protobuf/releases)
+- [python-protobuf >= 4.23.4](https://pypi.org/project/protobuf/) - matching protoc release
+- [python >= 3.8](https://www.python.org/downloads/source/) - for running mypy-protobuf plugin.
 
 ## Requirements to run typecheckers on stubs generated by mypy-protobuf
+
 Earlier releases might work, but aren't tested
-- [mypy >= v0.941](https://pypi.org/project/mypy) or [pyright >= 1.1.206](https://github.com/microsoft/pyright)
-- [python-protobuf >= 3.19.4](https://pypi.org/project/protobuf/) - matching protoc release
-- [types-protobuf >= 3.19.12](https://pypi.org/project/types-protobuf/) - for stubs from the google.protobuf library
+
+- [mypy >= v1.4.1](https://pypi.org/project/mypy) or [pyright >= 1.1.206](https://github.com/microsoft/pyright)
+- [python-protobuf >= 4.23.4](https://pypi.org/project/protobuf/) - matching protoc release
+- [types-protobuf >= 4.23.0.2](https://pypi.org/project/types-protobuf/) - for stubs from the google.protobuf library
 
 ### To run typecheckers on code generated with grpc plugin - you'll additionally need
+
 Earlier releases might work, but aren't tested
-- [grpcio>=1.47.0](https://pypi.org/project/grpcio/)
-- [grpcio-tools>=1.47.0](https://pypi.org/project/grpcio-tools/)
-- [grpc-stubs>=1.24.9](https://pypi.org/project/grpc-stubs/)
+
+- [grpcio>=1.56.2](https://pypi.org/project/grpcio/)
+- [grpcio-tools>=1.56.2](https://pypi.org/project/grpcio-tools/)
+- [grpc-stubs>=1.53.0.2](https://pypi.org/project/grpc-stubs/)
 
 Other configurations may work, but are not continuously tested currently.
 We would be open to expanding this list - file an issue on the issue tracker.
 
 ## Installation
 
 The plugin can be installed with
+
 ```
 pip3 install mypy-protobuf
 ```
+
 To install unreleased
+
 ```
 REV=main  # or whichever unreleased git rev you'd like
 pip3 install git+https://github.com/nipunn1313/mypy-protobuf.git@$REV
@@ -48,6 +57,7 @@ pip3 install git+https://github.com/nipunn1313/mypy-protobuf.git@$REV#subdirecto
 ```
 
 In order to run mypy on the generated code, you'll need to install
+
 ```
 pip3 install mypy>=0.910 types-protobuf>=0.1.14
 ```
@@ -56,14 +66,19 @@ pip3 install mypy>=0.910 types-protobuf>=0.1.14
 
 On posix, protoc-gen-mypy is installed to python's executable bin. Assuming that's
 on your $PATH, you can run
+
 ```
 protoc --python_out=output/location --mypy_out=output/location
 ```
+
 Alternately, you can explicitly provide the path:
+
 ```
 protoc --plugin=protoc-gen-mypy=path/to/protoc-gen-mypy --python_out=output/location --mypy_out=output/location
 ```
+
 Check the version number with
+
 ```
 > protoc-gen-mypy --version
 ```
@@ -85,18 +100,21 @@ will appear as docstrings in .pyi files. Useful in IDEs for showing completions
 ### Types enum int values more strongly
 
 Enum int values produce stubs which wrap the int values in NewType
+
 ```proto
 enum MyEnum {
   HELLO = 0;
   WORLD = 1;
 }
 ```
+
 Will yield an [enum type wrapper](https://github.com/python/typeshed/blob/16ae4c61201cd8b96b8b22cdfb2ab9e89ba5bcf2/stubs/protobuf/google/protobuf/internal/enum_type_wrapper.pyi) whose methods type to `MyEnum.ValueType` (a `NewType(int)` rather than `int`.
 This allows mypy to catch bugs where the wrong enum value is being used.
 
 Calling code may be typed as follows.
 
 In python >= 3.7
+
 ```python
 # May need [PEP 563](https://www.python.org/dev/peps/pep-0563/) to postpone evaluation of annotations
 # from __future__ import annotations  # Not needed with python>=3.11 or protobuf>=3.20.0
@@ -108,11 +126,13 @@ f(MyEnum.Value("HELLO"))
 With protobuf <= 3.20.0, for usages of cast, the type of `x` must be quoted
 After protobuf >= 3.20.0 - `ValueType` exists in the python code and quotes aren't needed
 until [upstream protobuf](https://github.com/protocolbuffers/protobuf/pull/8182) includes `ValueType`
+
 ```python
 cast('MyEnum.ValueType', x)
 ```
 
 Similarly, for type aliases with protobuf < 3.20.0, you must either quote the type or hide it behind `TYPE_CHECKING`
+
 ```python
 from typing import Tuple, TYPE_CHECKING
 HELLO = Tuple['MyEnum.ValueType', 'MyEnum.ValueType']
@@ -122,7 +142,7 @@ if TYPE_CHECKING:
 
 #### Enum int impl details
 
-mypy-protobuf  autogenerates an instance of the EnumTypeWrapper as follows.
+mypy-protobuf autogenerates an instance of the EnumTypeWrapper as follows.
 
 ```python
 class _MyEnum:
@@ -141,14 +161,14 @@ WORLD: MyEnum.ValueType  # 1
 
 `_MyEnumEnumTypeWrapper` extends the EnumTypeWrapper to take/return MyEnum.ValueType rather than int
 `MyEnum` is an instance of the `EnumTypeWrapper`.
+
 - Use `_MyEnum` and of metaclass is an implementation detail to make MyEnum.ValueType a valid type w/o a circular dependency
 - `V` is supported as an alias of `ValueType` for backward compatibility
 
-
-
 ### Supports generating type wrappers for fields and maps
 
 M.proto
+
 ```proto
 message M {
   uint32 user_id = 1 [(mypy_protobuf.options).casttype="mymod.UserId"];
@@ -158,24 +178,29 @@ message M {
   ];
 }
 ```
+
 mymod.py
+
 ```python
 UserId = NewType("UserId", int)
 Email = NewType("Email", Text)
 ```
 
 ### `py_generic_services`
+
 If `py_generic_services` is set in your proto file, then mypy-protobuf will
 generate service stubs. If you want GRPC stubs instead - use the GRPC instructions.
 
 ### `readable_stubs`
+
 If `readable_stubs` is set, mypy-protobuf will generate easier-to-read stubs. The downside
 to this approach - is that it's possible to generate stubs which do not pass mypy - particularly
 in the case of name collisions. mypy-protobuf defaults to generating stubs with fully qualified
 imports and mangled global-level identifiers to defend against name collisions between global
 identifiers and field names.
 
 If you're ok with this risk, try it out!
+
 ```
 protoc --python_out=output/location --mypy_out=readable_stubs:output/location
 ```
@@ -195,14 +220,17 @@ protoc --python_out=output/location --mypy_out=relax_strict_optional_primitives:
 ```
 
 ### Output suppression
+
 To suppress output, you can run
+
 ```
 protoc --python_out=output/location --mypy_out=quiet:output/location
 ```
 
 ### GRPC
 
 This plugin provides stubs generation for grpcio generated code.
+
 ```
 protoc \
     --python_out=output/location \
@@ -212,21 +240,23 @@ protoc \
 ```
 
 Note that generated code for grpc will work only together with code for python and locations should be the same.
-If you need stubs for grpc internal code we suggest using this package https://github.com/shabbyrobe/grpc-stubs 
+If you need stubs for grpc internal code we suggest using this package https://github.com/shabbyrobe/grpc-stubs
 
 ### Targeting python2 support
 
 mypy-protobuf's drops support for targeting python2 with version 3.0. If you still need python2 support -
+
 ```
 python3 -m pip install mypy_protobuf==2.10
 protoc --python_out=output/location --mypy_out=output/location
 mypy --target-version=2.7 {files}
 ```
 
-
 ## Contributing
+
 Contributions to the implementation are welcome. Please run tests using `./run_test.sh`.
 Ensure code is formatted using black.
+
 ```
 pip3 install black
 black .
@@ -271,9 +301,9 @@ black .
 - [@miaachan](https://github.com/miaachan)
 - [@Alphadelta14](https://github.com/Alphadelta14)
 - [@fergyfresh](https://github.com/fergyfresh)
+- [@AlexWaygood](https://github.com/AlexWaygood)
 
-Licence etc.
-------------
+## Licence etc.
 
 1. License: Apache 2.0.
-2. Copyright attribution: Copyright (c) 2017 Dropbox, Inc.
+2. Copyright attribution: Copyright (c) 2022 Nipunn Koorapati