pydantic-rpc 0.2.2__tar.gz → 0.3.0__tar.gz

{pydantic_rpc-0.2.2 → pydantic_rpc-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pydantic-rpc
-Version: 0.2.2
+Version: 0.3.0
 Summary: A Python library for building gRPC/ConnectRPC services with Pydantic models.
 Author: Yasushi Itoh
 Requires-Python: >=3.11
@@ -14,7 +14,7 @@ Description-Content-Type: text/markdown
 
 # 🚀 PydanticRPC
 
-**PydanticRPC** is a Python library that enables you to rapidly expose [Pydantic](https://docs.pydantic.dev/) models via [gRPC](https://grpc.io/)/[ConnectRPC](https://connectrpc.com/docs/protocol/) services without writing any protobuf files. Instead, it automatically generates protobuf files on the fly from the method signatures of your Python objects and the type signatures of your Pydantic models.
+**PydanticRPC** is a Python library that enables you to rapidly expose [Pydantic](https://docs.pydantic.dev/) models via [gRPC](https://grpc.io/)/[Connect RPC](https://connectrpc.com/docs/protocol/) services without writing any protobuf files. Instead, it automatically generates protobuf files on the fly from the method signatures of your Python objects and the type signatures of your Pydantic models.
 
 
 Below is an example of a simple gRPC service that exposes a [PydanticAI](https://ai.pydantic.dev/) agent:
@@ -54,7 +54,7 @@ if __name__ == "__main__":
     loop.run_until_complete(s.run(OlympicsLocationAgent()))
 ```
 
-And here is an example of a simple ConnectRPC service that exposes the same agent as an ASGI application:
+And here is an example of a simple Connect RPC service that exposes the same agent as an ASGI application:
 
 ```python
 import asyncio
@@ -254,6 +254,88 @@ When this variable is set to "true", PydanticRPC will load existing pre-generate
 
 ## 💎 Advanced Features
 
+### 🌊 Response Streaming
+PydanticRPC supports streaming for responses in asynchronous gRPC and gRPC-Web services only.
+
+Please see the sample code below:
+
+```python
+import asyncio
+from typing import AsyncIterator
+
+from pydantic import field_validator
+from pydantic_ai import Agent
+from pydantic_rpc import AsyncIOServer, Message
+
+
+# `Message` is just a pydantic BaseModel alias
+class CityLocation(Message):
+    city: str
+    country: str
+
+
+class OlympicsQuery(Message):
+    year: int
+
+    def prompt(self):
+        return f"Where were the Olympics held in {self.year}?"
+
+    @field_validator("year")
+    def validate_year(cls, value):
+        if value < 1896:
+            raise ValueError("The first modern Olympics was held in 1896.")
+
+        return value
+
+
+class OlympicsDurationQuery(Message):
+    start: int
+    end: int
+
+    def prompt(self):
+        return f"From {self.start} to {self.end}, how many Olympics were held? Please provide the list of countries and cities."
+
+    @field_validator("start")
+    def validate_start(cls, value):
+        if value < 1896:
+            raise ValueError("The first modern Olympics was held in 1896.")
+
+        return value
+
+    @field_validator("end")
+    def validate_end(cls, value):
+        if value < 1896:
+            raise ValueError("The first modern Olympics was held in 1896.")
+
+        return value
+
+
+class StreamingResult(Message):
+    answer: str
+
+
+class OlympicsAgent:
+    def __init__(self):
+        self._agent = Agent("ollama:llama3.2")
+
+    async def ask(self, req: OlympicsQuery) -> CityLocation:
+        result = await self._agent.run(req.prompt(), result_type=CityLocation)
+        return result.data
+
+    async def ask_stream(
+        self, req: OlympicsDurationQuery
+    ) -> AsyncIterator[StreamingResult]:
+        async with self._agent.run_stream(req.prompt(), result_type=str) as result:
+            async for data in result.stream_text(delta=True):
+                yield StreamingResult(answer=data)
+
+
+if __name__ == "__main__":
+    s = AsyncIOServer()
+    loop = asyncio.get_event_loop()
+    loop.run_until_complete(s.run(OlympicsAgent()))
+```
+
 ### 🔗 Multiple Services with Custom Interceptors
 
 PydanticRPC supports defining and running multiple services in a single server:
@@ -349,6 +431,17 @@ python core.py a_module.py aClass
 
 Using this generated proto file and tools as `protoc`, `buf` and `BSR`, you could generate code for any desired language other than Python.
 
+## 📖 Data Type Mapping
+
+| Python Type        | Protobuf Type   |
+|--------------------|-----------------|
+| str                | string          |
+| bool               | bool            |
+| int                | int32, int64    |
+| float              | float, double   |
+| list[T], tuple[T]  | repeated T      |
+| dict[K, V]         | map<K, V>       |
+
 
 ## TODO
 - [ ] Streaming Support

{pydantic_rpc-0.2.2 → pydantic_rpc-0.3.0}/README.md

@@ -1,6 +1,6 @@
 # 🚀 PydanticRPC
 
-**PydanticRPC** is a Python library that enables you to rapidly expose [Pydantic](https://docs.pydantic.dev/) models via [gRPC](https://grpc.io/)/[ConnectRPC](https://connectrpc.com/docs/protocol/) services without writing any protobuf files. Instead, it automatically generates protobuf files on the fly from the method signatures of your Python objects and the type signatures of your Pydantic models.
+**PydanticRPC** is a Python library that enables you to rapidly expose [Pydantic](https://docs.pydantic.dev/) models via [gRPC](https://grpc.io/)/[Connect RPC](https://connectrpc.com/docs/protocol/) services without writing any protobuf files. Instead, it automatically generates protobuf files on the fly from the method signatures of your Python objects and the type signatures of your Pydantic models.
 
 
 Below is an example of a simple gRPC service that exposes a [PydanticAI](https://ai.pydantic.dev/) agent:
@@ -40,7 +40,7 @@ if __name__ == "__main__":
     loop.run_until_complete(s.run(OlympicsLocationAgent()))
 ```
 
-And here is an example of a simple ConnectRPC service that exposes the same agent as an ASGI application:
+And here is an example of a simple Connect RPC service that exposes the same agent as an ASGI application:
 
 ```python
 import asyncio
@@ -240,6 +240,88 @@ When this variable is set to "true", PydanticRPC will load existing pre-generate
 
 ## 💎 Advanced Features
 
+### 🌊 Response Streaming
+PydanticRPC supports streaming for responses in asynchronous gRPC and gRPC-Web services only.
+
+Please see the sample code below:
+
+```python
+import asyncio
+from typing import AsyncIterator
+
+from pydantic import field_validator
+from pydantic_ai import Agent
+from pydantic_rpc import AsyncIOServer, Message
+
+
+# `Message` is just a pydantic BaseModel alias
+class CityLocation(Message):
+    city: str
+    country: str
+
+
+class OlympicsQuery(Message):
+    year: int
+
+    def prompt(self):
+        return f"Where were the Olympics held in {self.year}?"
+
+    @field_validator("year")
+    def validate_year(cls, value):
+        if value < 1896:
+            raise ValueError("The first modern Olympics was held in 1896.")
+
+        return value
+
+
+class OlympicsDurationQuery(Message):
+    start: int
+    end: int
+
+    def prompt(self):
+        return f"From {self.start} to {self.end}, how many Olympics were held? Please provide the list of countries and cities."
+
+    @field_validator("start")
+    def validate_start(cls, value):
+        if value < 1896:
+            raise ValueError("The first modern Olympics was held in 1896.")
+
+        return value
+
+    @field_validator("end")
+    def validate_end(cls, value):
+        if value < 1896:
+            raise ValueError("The first modern Olympics was held in 1896.")
+
+        return value
+
+
+class StreamingResult(Message):
+    answer: str
+
+
+class OlympicsAgent:
+    def __init__(self):
+        self._agent = Agent("ollama:llama3.2")
+
+    async def ask(self, req: OlympicsQuery) -> CityLocation:
+        result = await self._agent.run(req.prompt(), result_type=CityLocation)
+        return result.data
+
+    async def ask_stream(
+        self, req: OlympicsDurationQuery
+    ) -> AsyncIterator[StreamingResult]:
+        async with self._agent.run_stream(req.prompt(), result_type=str) as result:
+            async for data in result.stream_text(delta=True):
+                yield StreamingResult(answer=data)
+
+
+if __name__ == "__main__":
+    s = AsyncIOServer()
+    loop = asyncio.get_event_loop()
+    loop.run_until_complete(s.run(OlympicsAgent()))
+```
+
 ### 🔗 Multiple Services with Custom Interceptors
 
 PydanticRPC supports defining and running multiple services in a single server:
@@ -335,6 +417,17 @@ python core.py a_module.py aClass
 
 Using this generated proto file and tools as `protoc`, `buf` and `BSR`, you could generate code for any desired language other than Python.
 
+## 📖 Data Type Mapping
+
+| Python Type        | Protobuf Type   |
+|--------------------|-----------------|
+| str                | string          |
+| bool               | bool            |
+| int                | int32, int64    |
+| float              | float, double   |
+| list[T], tuple[T]  | repeated T      |
+| dict[K, V]         | map<K, V>       |
+
 
 ## TODO
 - [ ] Streaming Support

pydantic_rpc-0.3.0/examples/agent_aio_grpc.py

@@ -0,0 +1,74 @@
+import asyncio
+from typing import AsyncIterator
+
+from pydantic import field_validator
+from pydantic_ai import Agent
+from pydantic_rpc import AsyncIOServer, Message
+
+
+# `Message` is just a pydantic BaseModel alias
+class CityLocation(Message):
+    city: str
+    country: str
+
+
+class OlympicsQuery(Message):
+    year: int
+
+    def prompt(self):
+        return f"Where were the Olympics held in {self.year}?"
+
+    @field_validator("year")
+    def validate_year(cls, value):
+        if value < 1896:
+            raise ValueError("The first modern Olympics was held in 1896.")
+
+        return value
+
+
+class OlympicsDurationQuery(Message):
+    start: int
+    end: int
+
+    def prompt(self):
+        return f"From {self.start} to {self.end}, how many Olympics were held? Please provide the list of countries and cities."
+
+    @field_validator("start")
+    def validate_start(cls, value):
+        if value < 1896:
+            raise ValueError("The first modern Olympics was held in 1896.")
+
+        return value
+
+    @field_validator("end")
+    def validate_end(cls, value):
+        if value < 1896:
+            raise ValueError("The first modern Olympics was held in 1896.")
+
+        return value
+
+
+class StreamingResult(Message):
+    answer: str
+
+
+class OlympicsAgent:
+    def __init__(self):
+        self._agent = Agent("ollama:llama3.2")
+
+    async def ask(self, req: OlympicsQuery) -> CityLocation:
+        result = await self._agent.run(req.prompt(), result_type=CityLocation)
+        return result.data
+
+    async def ask_stream(
+        self, req: OlympicsDurationQuery
+    ) -> AsyncIterator[StreamingResult]:
+        async with self._agent.run_stream(req.prompt(), result_type=str) as result:
+            async for data in result.stream_text(delta=True):
+                yield StreamingResult(answer=data)
+
+
+if __name__ == "__main__":
+    s = AsyncIOServer()
+    loop = asyncio.get_event_loop()
+    loop.run_until_complete(s.run(OlympicsAgent()))

pydantic_rpc-0.3.0/examples/barservice.proto

@@ -0,0 +1,75 @@
+syntax = "proto3";
+
+package bar.v1;
+
+
+service BarService {
+    rpc Bar (BarRequest) returns (BarResponse);
+}
+
+// Usage docs: https://docs.pydantic.dev/2.10/concepts/models/
+//
+// A base class for creating Pydantic models.
+//
+// Attributes:
+//     __class_vars__: The names of the class variables defined on the model.
+//     __private_attributes__: Metadata about the private attributes of the model.
+//     __signature__: The synthesized `__init__` [`Signature`][inspect.Signature] of the model.
+//
+//     __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
+//     __pydantic_core_schema__: The core schema of the model.
+//     __pydantic_custom_init__: Whether the model has a custom `__init__` function.
+//     __pydantic_decorators__: Metadata containing the decorators defined on the model.
+//         This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
+//     __pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to
+//         __args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these.
+//     __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
+//     __pydantic_post_init__: The name of the post-init method for the model, if defined.
+//     __pydantic_root_model__: Whether the model is a [`RootModel`][pydantic.root_model.RootModel].
+//     __pydantic_serializer__: The `pydantic-core` `SchemaSerializer` used to dump instances of the model.
+//     __pydantic_validator__: The `pydantic-core` `SchemaValidator` used to validate instances of the model.
+//
+//     __pydantic_fields__: A dictionary of field names and their corresponding [`FieldInfo`][pydantic.fields.FieldInfo] objects.
+//     __pydantic_computed_fields__: A dictionary of computed field names and their corresponding [`ComputedFieldInfo`][pydantic.fields.ComputedFieldInfo] objects.
+//
+//     __pydantic_extra__: A dictionary containing extra values, if [`extra`][pydantic.config.ConfigDict.extra]
+//         is set to `'allow'`.
+//     __pydantic_fields_set__: The names of fields explicitly set during instantiation.
+//     __pydantic_private__: Values of private attributes set on the model instance.
+message BarResponse {
+    repeated string names = 1;
+}
+
+// Usage docs: https://docs.pydantic.dev/2.10/concepts/models/
+//
+// A base class for creating Pydantic models.
+//
+// Attributes:
+//     __class_vars__: The names of the class variables defined on the model.
+//     __private_attributes__: Metadata about the private attributes of the model.
+//     __signature__: The synthesized `__init__` [`Signature`][inspect.Signature] of the model.
+//
+//     __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
+//     __pydantic_core_schema__: The core schema of the model.
+//     __pydantic_custom_init__: Whether the model has a custom `__init__` function.
+//     __pydantic_decorators__: Metadata containing the decorators defined on the model.
+//         This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
+//     __pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to
+//         __args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these.
+//     __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
+//     __pydantic_post_init__: The name of the post-init method for the model, if defined.
+//     __pydantic_root_model__: Whether the model is a [`RootModel`][pydantic.root_model.RootModel].
+//     __pydantic_serializer__: The `pydantic-core` `SchemaSerializer` used to dump instances of the model.
+//     __pydantic_validator__: The `pydantic-core` `SchemaValidator` used to validate instances of the model.
+//
+//     __pydantic_fields__: A dictionary of field names and their corresponding [`FieldInfo`][pydantic.fields.FieldInfo] objects.
+//     __pydantic_computed_fields__: A dictionary of computed field names and their corresponding [`ComputedFieldInfo`][pydantic.fields.ComputedFieldInfo] objects.
+//
+//     __pydantic_extra__: A dictionary containing extra values, if [`extra`][pydantic.config.ConfigDict.extra]
+//         is set to `'allow'`.
+//     __pydantic_fields_set__: The names of fields explicitly set during instantiation.
+//     __pydantic_private__: Values of private attributes set on the model instance.
+message BarRequest {
+    repeated string names = 1;
+}
+

pydantic_rpc-0.3.0/examples/fooservice.proto

@@ -0,0 +1,79 @@
+syntax = "proto3";
+
+package foo.v1;
+
+
+service FooService {
+    rpc Foo (FooRequest) returns (FooResponse);
+}
+
+// Usage docs: https://docs.pydantic.dev/2.10/concepts/models/
+//
+// A base class for creating Pydantic models.
+//
+// Attributes:
+//     __class_vars__: The names of the class variables defined on the model.
+//     __private_attributes__: Metadata about the private attributes of the model.
+//     __signature__: The synthesized `__init__` [`Signature`][inspect.Signature] of the model.
+//
+//     __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
+//     __pydantic_core_schema__: The core schema of the model.
+//     __pydantic_custom_init__: Whether the model has a custom `__init__` function.
+//     __pydantic_decorators__: Metadata containing the decorators defined on the model.
+//         This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
+//     __pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to
+//         __args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these.
+//     __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
+//     __pydantic_post_init__: The name of the post-init method for the model, if defined.
+//     __pydantic_root_model__: Whether the model is a [`RootModel`][pydantic.root_model.RootModel].
+//     __pydantic_serializer__: The `pydantic-core` `SchemaSerializer` used to dump instances of the model.
+//     __pydantic_validator__: The `pydantic-core` `SchemaValidator` used to validate instances of the model.
+//
+//     __pydantic_fields__: A dictionary of field names and their corresponding [`FieldInfo`][pydantic.fields.FieldInfo] objects.
+//     __pydantic_computed_fields__: A dictionary of computed field names and their corresponding [`ComputedFieldInfo`][pydantic.fields.ComputedFieldInfo] objects.
+//
+//     __pydantic_extra__: A dictionary containing extra values, if [`extra`][pydantic.config.ConfigDict.extra]
+//         is set to `'allow'`.
+//     __pydantic_fields_set__: The names of fields explicitly set during instantiation.
+//     __pydantic_private__: Values of private attributes set on the model instance.
+message FooResponse {
+    string name = 1;
+    int32 age = 2;
+    map<string, string> d = 3;
+}
+
+// Usage docs: https://docs.pydantic.dev/2.10/concepts/models/
+//
+// A base class for creating Pydantic models.
+//
+// Attributes:
+//     __class_vars__: The names of the class variables defined on the model.
+//     __private_attributes__: Metadata about the private attributes of the model.
+//     __signature__: The synthesized `__init__` [`Signature`][inspect.Signature] of the model.
+//
+//     __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
+//     __pydantic_core_schema__: The core schema of the model.
+//     __pydantic_custom_init__: Whether the model has a custom `__init__` function.
+//     __pydantic_decorators__: Metadata containing the decorators defined on the model.
+//         This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
+//     __pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to
+//         __args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these.
+//     __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
+//     __pydantic_post_init__: The name of the post-init method for the model, if defined.
+//     __pydantic_root_model__: Whether the model is a [`RootModel`][pydantic.root_model.RootModel].
+//     __pydantic_serializer__: The `pydantic-core` `SchemaSerializer` used to dump instances of the model.
+//     __pydantic_validator__: The `pydantic-core` `SchemaValidator` used to validate instances of the model.
+//
+//     __pydantic_fields__: A dictionary of field names and their corresponding [`FieldInfo`][pydantic.fields.FieldInfo] objects.
+//     __pydantic_computed_fields__: A dictionary of computed field names and their corresponding [`ComputedFieldInfo`][pydantic.fields.ComputedFieldInfo] objects.
+//
+//     __pydantic_extra__: A dictionary containing extra values, if [`extra`][pydantic.config.ConfigDict.extra]
+//         is set to `'allow'`.
+//     __pydantic_fields_set__: The names of fields explicitly set during instantiation.
+//     __pydantic_private__: Values of private attributes set on the model instance.
+message FooRequest {
+    string name = 1;
+    int32 age = 2;
+    map<string, string> d = 3;
+}
+

pydantic_rpc-0.3.0/examples/olympicsagent.proto

@@ -0,0 +1,144 @@
+syntax = "proto3";
+
+package olympicsagent.v1;
+
+
+service OlympicsAgent {
+    rpc Ask (OlympicsQuery) returns (CityLocation);
+    rpc AskStream (OlympicsDurationQuery) returns (stream StreamingResult);
+}
+
+// Usage docs: https://docs.pydantic.dev/2.10/concepts/models/
+//
+// A base class for creating Pydantic models.
+//
+// Attributes:
+//     __class_vars__: The names of the class variables defined on the model.
+//     __private_attributes__: Metadata about the private attributes of the model.
+//     __signature__: The synthesized `__init__` [`Signature`][inspect.Signature] of the model.
+//
+//     __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
+//     __pydantic_core_schema__: The core schema of the model.
+//     __pydantic_custom_init__: Whether the model has a custom `__init__` function.
+//     __pydantic_decorators__: Metadata containing the decorators defined on the model.
+//         This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
+//     __pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to
+//         __args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these.
+//     __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
+//     __pydantic_post_init__: The name of the post-init method for the model, if defined.
+//     __pydantic_root_model__: Whether the model is a [`RootModel`][pydantic.root_model.RootModel].
+//     __pydantic_serializer__: The `pydantic-core` `SchemaSerializer` used to dump instances of the model.
+//     __pydantic_validator__: The `pydantic-core` `SchemaValidator` used to validate instances of the model.
+//
+//     __pydantic_fields__: A dictionary of field names and their corresponding [`FieldInfo`][pydantic.fields.FieldInfo] objects.
+//     __pydantic_computed_fields__: A dictionary of computed field names and their corresponding [`ComputedFieldInfo`][pydantic.fields.ComputedFieldInfo] objects.
+//
+//     __pydantic_extra__: A dictionary containing extra values, if [`extra`][pydantic.config.ConfigDict.extra]
+//         is set to `'allow'`.
+//     __pydantic_fields_set__: The names of fields explicitly set during instantiation.
+//     __pydantic_private__: Values of private attributes set on the model instance.
+message CityLocation {
+    string city = 1;
+    string country = 2;
+}
+
+// Usage docs: https://docs.pydantic.dev/2.10/concepts/models/
+//
+// A base class for creating Pydantic models.
+//
+// Attributes:
+//     __class_vars__: The names of the class variables defined on the model.
+//     __private_attributes__: Metadata about the private attributes of the model.
+//     __signature__: The synthesized `__init__` [`Signature`][inspect.Signature] of the model.
+//
+//     __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
+//     __pydantic_core_schema__: The core schema of the model.
+//     __pydantic_custom_init__: Whether the model has a custom `__init__` function.
+//     __pydantic_decorators__: Metadata containing the decorators defined on the model.
+//         This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
+//     __pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to
+//         __args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these.
+//     __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
+//     __pydantic_post_init__: The name of the post-init method for the model, if defined.
+//     __pydantic_root_model__: Whether the model is a [`RootModel`][pydantic.root_model.RootModel].
+//     __pydantic_serializer__: The `pydantic-core` `SchemaSerializer` used to dump instances of the model.
+//     __pydantic_validator__: The `pydantic-core` `SchemaValidator` used to validate instances of the model.
+//
+//     __pydantic_fields__: A dictionary of field names and their corresponding [`FieldInfo`][pydantic.fields.FieldInfo] objects.
+//     __pydantic_computed_fields__: A dictionary of computed field names and their corresponding [`ComputedFieldInfo`][pydantic.fields.ComputedFieldInfo] objects.
+//
+//     __pydantic_extra__: A dictionary containing extra values, if [`extra`][pydantic.config.ConfigDict.extra]
+//         is set to `'allow'`.
+//     __pydantic_fields_set__: The names of fields explicitly set during instantiation.
+//     __pydantic_private__: Values of private attributes set on the model instance.
+message OlympicsQuery {
+    int32 year = 1;
+}
+
+// Usage docs: https://docs.pydantic.dev/2.10/concepts/models/
+//
+// A base class for creating Pydantic models.
+//
+// Attributes:
+//     __class_vars__: The names of the class variables defined on the model.
+//     __private_attributes__: Metadata about the private attributes of the model.
+//     __signature__: The synthesized `__init__` [`Signature`][inspect.Signature] of the model.
+//
+//     __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
+//     __pydantic_core_schema__: The core schema of the model.
+//     __pydantic_custom_init__: Whether the model has a custom `__init__` function.
+//     __pydantic_decorators__: Metadata containing the decorators defined on the model.
+//         This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
+//     __pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to
+//         __args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these.
+//     __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
+//     __pydantic_post_init__: The name of the post-init method for the model, if defined.
+//     __pydantic_root_model__: Whether the model is a [`RootModel`][pydantic.root_model.RootModel].
+//     __pydantic_serializer__: The `pydantic-core` `SchemaSerializer` used to dump instances of the model.
+//     __pydantic_validator__: The `pydantic-core` `SchemaValidator` used to validate instances of the model.
+//
+//     __pydantic_fields__: A dictionary of field names and their corresponding [`FieldInfo`][pydantic.fields.FieldInfo] objects.
+//     __pydantic_computed_fields__: A dictionary of computed field names and their corresponding [`ComputedFieldInfo`][pydantic.fields.ComputedFieldInfo] objects.
+//
+//     __pydantic_extra__: A dictionary containing extra values, if [`extra`][pydantic.config.ConfigDict.extra]
+//         is set to `'allow'`.
+//     __pydantic_fields_set__: The names of fields explicitly set during instantiation.
+//     __pydantic_private__: Values of private attributes set on the model instance.
+message StreamingResult {
+    string answer = 1;
+}
+
+// Usage docs: https://docs.pydantic.dev/2.10/concepts/models/
+//
+// A base class for creating Pydantic models.
+//
+// Attributes:
+//     __class_vars__: The names of the class variables defined on the model.
+//     __private_attributes__: Metadata about the private attributes of the model.
+//     __signature__: The synthesized `__init__` [`Signature`][inspect.Signature] of the model.
+//
+//     __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
+//     __pydantic_core_schema__: The core schema of the model.
+//     __pydantic_custom_init__: Whether the model has a custom `__init__` function.
+//     __pydantic_decorators__: Metadata containing the decorators defined on the model.
+//         This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
+//     __pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to
+//         __args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these.
+//     __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
+//     __pydantic_post_init__: The name of the post-init method for the model, if defined.
+//     __pydantic_root_model__: Whether the model is a [`RootModel`][pydantic.root_model.RootModel].
+//     __pydantic_serializer__: The `pydantic-core` `SchemaSerializer` used to dump instances of the model.
+//     __pydantic_validator__: The `pydantic-core` `SchemaValidator` used to validate instances of the model.
+//
+//     __pydantic_fields__: A dictionary of field names and their corresponding [`FieldInfo`][pydantic.fields.FieldInfo] objects.
+//     __pydantic_computed_fields__: A dictionary of computed field names and their corresponding [`ComputedFieldInfo`][pydantic.fields.ComputedFieldInfo] objects.
+//
+//     __pydantic_extra__: A dictionary containing extra values, if [`extra`][pydantic.config.ConfigDict.extra]
+//         is set to `'allow'`.
+//     __pydantic_fields_set__: The names of fields explicitly set during instantiation.
+//     __pydantic_private__: Values of private attributes set on the model instance.
+message OlympicsDurationQuery {
+    int32 start = 1;
+    int32 end = 2;
+}
+

pydantic_rpc-0.3.0/examples/olympicsagent_pb2.py

@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: olympicsagent.proto
+"""Generated protocol buffer code."""
+
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(
+    b'\n\x13olympicsagent.proto\x12\x10olympicsagent.v1"-\n\x0c\x43ityLocation\x12\x0c\n\x04\x63ity\x18\x01 \x01(\t\x12\x0f\n\x07\x63ountry\x18\x02 \x01(\t"\x1d\n\rOlympicsQuery\x12\x0c\n\x04year\x18\x01 \x01(\x05"!\n\x0fStreamingResult\x12\x0e\n\x06\x61nswer\x18\x01 \x01(\t"3\n\x15OlympicsDurationQuery\x12\r\n\x05start\x18\x01 \x01(\x05\x12\x0b\n\x03\x65nd\x18\x02 \x01(\x05\x32\xb2\x01\n\rOlympicsAgent\x12\x46\n\x03\x41sk\x12\x1f.olympicsagent.v1.OlympicsQuery\x1a\x1e.olympicsagent.v1.CityLocation\x12Y\n\tAskStream\x12\'.olympicsagent.v1.OlympicsDurationQuery\x1a!.olympicsagent.v1.StreamingResult0\x01\x62\x06proto3'
+)
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, "olympicsagent_pb2", _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+    DESCRIPTOR._options = None
+    _globals["_CITYLOCATION"]._serialized_start = 41
+    _globals["_CITYLOCATION"]._serialized_end = 86
+    _globals["_OLYMPICSQUERY"]._serialized_start = 88
+    _globals["_OLYMPICSQUERY"]._serialized_end = 117
+    _globals["_STREAMINGRESULT"]._serialized_start = 119
+    _globals["_STREAMINGRESULT"]._serialized_end = 152
+    _globals["_OLYMPICSDURATIONQUERY"]._serialized_start = 154
+    _globals["_OLYMPICSDURATIONQUERY"]._serialized_end = 205
+    _globals["_OLYMPICSAGENT"]._serialized_start = 208
+    _globals["_OLYMPICSAGENT"]._serialized_end = 386
+# @@protoc_insertion_point(module_scope)