Protocol Buffers using Python type annotations
Project description
pure-protobuf
Wow! Such annotated! Very buffers!
⚠️ Note |
---|
This README describes the upcoming major version update. For 2.x please refer to: https://github.com/eigenein/protobuf/tree/2.2.3 |
Documentation
Quick examples
.proto
definition
syntax = "proto3";
message SearchRequest {
string query = 1;
int32 page_number = 2;
int32 result_per_page = 3;
}
With dataclasses
from dataclasses import dataclass
from io import BytesIO
from pure_protobuf.annotations import Field, uint
from pure_protobuf.message import BaseMessage
from typing_extensions import Annotated
@dataclass
class SearchRequest(BaseMessage):
query: Annotated[str, Field(1)] = ""
page_number: Annotated[uint, Field(2)] = 0
result_per_page: Annotated[uint, Field(3)] = 0
request = SearchRequest(query="hello", page_number=uint(1), result_per_page=uint(10))
buffer = bytes(request)
assert buffer == b"\x0A\x05hello\x10\x01\x18\x0A"
assert SearchRequest.read_from(BytesIO(buffer)) == request
With pydantic
from io import BytesIO
from pure_protobuf.annotations import Field, uint
from pure_protobuf.message import BaseMessage
from pydantic import BaseModel
from typing_extensions import Annotated
class SearchRequest(BaseMessage, BaseModel):
query: Annotated[str, Field(1)] = ""
page_number: Annotated[uint, Field(2)] = 0
result_per_page: Annotated[uint, Field(3)] = 0
request = SearchRequest(query="hello", page_number=uint(1), result_per_page=uint(10))
buffer = bytes(request)
assert buffer == b"\x0A\x05hello\x10\x01\x18\x0A"
assert SearchRequest.read_from(BytesIO(buffer)) == request
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pure_protobuf-3.0.0a2.tar.gz
(18.4 kB
view hashes)
Built Distribution
Close
Hashes for pure_protobuf-3.0.0a2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5d9e214a4b5d25d1a2d4c78d9cc1688ece487a870727e9c4d5bd7a268bd36a46 |
|
MD5 | 135d2cdb5f9f7241052bb4d9306b53ae |
|
BLAKE2b-256 | 65d2051f2764cdcc550c4c3098ee3bb7a8b906a694181592dec144bbddd7d773 |