The Python micro framework for building gPRC application.
Project description
gRPCAlchemy
The Python micro framework for building gPRC application based on official gRPC project.
Free software: MIT license
Documentation: https://grpcalchemy.readthedocs.io.
Installation
$ pipenv install grpcalchemy
✨🍰✨
Only Python 3.6+ is supported.
Example
Server
from grpcalchemy.orm import Message, StringField
from grpcalchemy import Server, Context, grpcmethod
class HelloMessage(Message):
text: str
class HelloService(Server):
@grpcmethod
def Hello(self, request: HelloMessage, context: Context) -> HelloMessage:
return HelloMessage(text=f'Hello {request.text}')
if __name__ == '__main__':
HelloService.run()
Then Using gRPC channel to connect the server:
from grpc import insecure_channel
from protos.helloservice_pb2_grpc import HelloServiceStub
from protos.hellomessage_pb2 import HelloMessage
with insecure_channel("localhost:50051") as channel:
response = HelloServiceStub(channel).Hello(
HelloMessage(text="world")
)
Features
gPRC Service Support
- gRPC Message Support
Scalar Value Types
Message Types
Repeated Field
Maps
Define Message With Type Hint
Middleware
App Context Manger
Error Handler Support
Streaming Method Support
gRPC-Health Checking and Reflection Support (Alpha)
Multiple Processor Support
TODO
Test Client Support
Async Server Support
History
0.7.*(2021-03-20)
Improve initialize function of message
Remove default feature in message
Refactor composite message Type
Support gRPC with xDS
Add PROTO_AUTO_GENERATED setting to make runtime proto generation optional
0.6.*(2020-10-27)
fix [#36] compatibility in windows
fix [#34] compatibility in windows
gRPC-Health Checking and Reflection Support (Alpha)
Multiple Processor Support
0.5.0(2020-04-27)
Support Streaming Method
Deprecate request parameter in app context and handle exception
0.4.0(2019-09-24)
Support related directory path to generate protocol buffer files
Enable use type hint to define message
Add error handle to handle Exception
Add get_blueprints to get blueprints need to register
0.3.0(2019-08-19)
0.2.7-10(2019-04-16)
Support SSL
Improve Implement of Server with grpc.server
Support YAML file in Config Module
Improve Config Module
Add context in current rpc
0.2.5-6(2019-03-06)
Implement Rpc Context
Improve Config Module
0.2.4(2019-03-01)
Implement Globals Variable
Implement APP Context
0.2.2-3 (2019-02-26)
Improve Config module
Improve rpc_call_wrap
0.2.1 (2019-02-14)
Implement Own gRPC Server
Implement gRPC Server Test Client
0.2.0 (2019-01-30)
Change gRPCAlchemy Server register to register_blueprint
Make gRPCAlchemy Server inherit from Blueprint
Support Json Format
Support Inheritance Message
0.1.6 (2019-01-21)
Various bug-fixes
Improve tests
Change Client API
Add PreProcess And PostProcess
Import Config Object
Add Event Listener
Change Field Object Into Descriptor
0.1.5 (2018-12-14)
Various bug-fixes
Improve tests
Add client
0.1.4 (2018-12-11)
First release on PyPI.
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
Built Distribution
Hashes for grpcalchemy-0.7.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 253637f9909654728aee9522b65743cad6cb9e098e3f76c4733ce92b590f6230 |
|
MD5 | 5bcee02c424f5b83bca3adfd60d64565 |
|
BLAKE2b-256 | 7f9867e6312a5f4317118102125ac4d674e3b69813b45087dfb6f528df5553cc |