Skip to main content

The Python micro framework for building gPRC application.

Project description

gRPCAlchemy Documentation Status

The Python micro framework for building gPRC application based on official gRPC project.


$ pipenv install grpcalchemy

Only Python 3.6+ is supported.



from grpcalchemy.orm import Message, StringField
from grpcalchemy import Server, Context, grpcmethod

class HelloMessage(Message):
    text: str

class HelloService(Server):
    def Hello(self, request: HelloMessage, context: Context) -> HelloMessage:
        return HelloMessage(text=f'Hello {request.text}')

if __name__ == '__main__':

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(


  • 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


  • Test Client Support
  • Async Server Support



  • fix [#36] compatibility in windows
  • fix [#34] compatibility in windows
  • gRPC-Health Checking and Reflection Support (Alpha)
  • Multiple Processor Support


  • Support Streaming Method
  • Deprecate request parameter in app context and handle exception


  • 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


  • Support SSL
  • Improve Implement of Server with grpc.server
  • Support YAML file in Config Module
  • Improve Config Module
  • Add context in current rpc


  • Implement Rpc Context
  • Improve Config Module


  • 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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for grpcalchemy, version 0.6.2
Filename, size File type Python version Upload date Hashes
Filename, size grpcalchemy-0.6.2-py2.py3-none-any.whl (18.9 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size grpcalchemy-0.6.2.tar.gz (30.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page