pydantic-rpc 0.3.1__py3-none-any.whl → 0.4.0__py3-none-any.whl

{pydantic_rpc-0.3.1.dist-info → pydantic_rpc-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pydantic-rpc
-Version: 0.3.1
+Version: 0.4.0
 Summary: A Python library for building gRPC/ConnectRPC services with Pydantic models.
 Author: Yasushi Itoh
 Requires-Python: >=3.11
@@ -94,6 +94,7 @@ app.mount(OlympicsLocationAgent())
 - 🔄 **Automatic Protobuf Generation:** Automatically creates protobuf files matching the method signatures of your Python objects.
 - ⚙️ **Dynamic Code Generation:** Generates server and client stubs using `grpcio-tools`.
 - ✅ **Pydantic Integration:** Uses `pydantic` for robust type validation and serialization.
+- 📄 **Pprotobuf File Export:** Exports the generated protobuf files for use in other languages.
 - **For gRPC:**
   - 💚 **Health Checking:** Built-in support for gRPC health checks using `grpc_health.v1`.
   - 🔎 **Server Reflection:** Built-in support for gRPC server reflection.
@@ -261,57 +262,38 @@ Please see the sample code below:
 
 ```python
 import asyncio
-from typing import AsyncIterator
+from typing import Annotated, AsyncIterator
 
-from pydantic import field_validator
+from pydantic import Field
 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
+    city: Annotated[str, Field(description="The city where the Olympics were held")]
+    country: Annotated[
+        str, Field(description="The country where the Olympics were held")
+    ]
 
 
 class OlympicsQuery(Message):
-    year: int
+    year: Annotated[int, Field(description="The year of the Olympics", ge=1896)]
 
     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
+    start: Annotated[int, Field(description="The start year of the Olympics", ge=1896)]
+    end: Annotated[int, Field(description="The end year of the Olympics", ge=1896)]
 
     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
+    answer: Annotated[str, Field(description="The answer to the query")]
 
 
 class OlympicsAgent:
@@ -433,18 +415,27 @@ Using this generated proto file and tools as `protoc`, `buf` and `BSR`, you coul
 
 ## 📖 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>       |
+| Python Type                    | Protobuf Type             |
+|--------------------------------|---------------------------|
+| str                            | string                    |
+| bytes                          | bytes                     |
+| bool                           | bool                      |
+| int                            | int32                     |
+| float                          | float, double             |
+| list[T], tuple[T]              | repeated T                |
+| dict[K, V]                     | map<K, V>                 |
+| datetime.datetime              | google.protobuf.Timestamp |
+| datetime.timedelta             | google.protobuf.Duration  |
+| typing.Union[A, B]             | oneof A, B                |
+| subclass of enum.Enum          | enum                      |
+| subclass of pydantic.BaseModel | message                   |
 
 
 ## TODO
 - [ ] Streaming Support
+  - [x] unary-stream
+  - [ ] stream-unary
+  - [ ] stream-stream
 - [ ] Betterproto Support
 - [ ] Sonora-connect Support
 - [ ] Custom Health Check Support

pydantic_rpc-0.4.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+pydantic_rpc/__init__.py,sha256=AWYjSmYQcMqsqGmGK4k-pQQhX6RBBgkTvNcQtCtsctU,113
+pydantic_rpc/core.py,sha256=6NMTtS8cKNjPN5cBvd_XLU6h1oMZ6EqAHz-HGLnJpD0,47939
+pydantic_rpc/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pydantic_rpc-0.4.0.dist-info/METADATA,sha256=FOVo-T-PCD0Sxh__B9cVaZpXb6XfUBOPmFIW0hP1v58,11993
+pydantic_rpc-0.4.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+pydantic_rpc-0.4.0.dist-info/licenses/LICENSE,sha256=Y6jkAm2VqPqoGIGQ-mEQCecNfteQ2LwdpYhC5XiH_cA,1069
+pydantic_rpc-0.4.0.dist-info/RECORD,,

pydantic_rpc-0.3.1.dist-info/RECORD

@@ -1,7 +0,0 @@
-pydantic_rpc/__init__.py,sha256=AWYjSmYQcMqsqGmGK4k-pQQhX6RBBgkTvNcQtCtsctU,113
-pydantic_rpc/core.py,sha256=FbSEiSnm9oOh0vFr4jcv7_5ZWyMvRDnMwzlFN5M9g4U,47417
-pydantic_rpc/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pydantic_rpc-0.3.1.dist-info/METADATA,sha256=xfYTVEKisOvkxozu9nbdJ_nPR3rcaufARQfqZubWFDs,11412
-pydantic_rpc-0.3.1.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-pydantic_rpc-0.3.1.dist-info/licenses/LICENSE,sha256=Y6jkAm2VqPqoGIGQ-mEQCecNfteQ2LwdpYhC5XiH_cA,1069
-pydantic_rpc-0.3.1.dist-info/RECORD,,