Multi-Language gRPC Code Generator

A unified build tool that generates gRPC server and client code for multiple programming languages from a single set of Protocol Buffer definitions.

Supported Languages

• Go - Server and client code generation
• Python - Server and client code generation
• TypeScript/NestJS - Both general TypeScript and NestJS-specific code
• Rust - Server and client code using Tonic

Features

• ✅ Centralized .proto file management
• ✅ One command to generate code for all languages
• ✅ Language-specific optimizations and configurations
• ✅ Automatic dependency management
• ✅ Clean, organized output structure
• ✅ Support for all gRPC features (unary, streaming, bidirectional)

Quick Start

1. Install dependencies:

   npm install

2. Generate code for all languages:

   npm run build

3. Generate code for specific language:

   npm run build:go
   npm run build:python
   npm run build:typescript
   npm run build:rust

Directory Structure

├── proto/ # Protocol Buffer definitions
│ ├── hero.proto
│ └── calculator.proto
├── generated/ # Generated code output
│ ├── go/ # Go generated files
│ ├── python/ # Python generated files
│ ├── typescript/ # TypeScript generated files
│ │ └── nestjs/ # NestJS-specific files
│ └── rust/ # Rust generated files
├── codegen.js # Main build tool
├── package.json # Build tool dependencies
├── BUILD.md # Build tool documentation
└── EXAMPLES.md # Usage examples

Example Proto File

syntax="proto3";
packagehero;
optiongo_package="./hero";
messageHeroById { int32id=1; }
messageHero {
int32id=1;
stringname=2;
}
serviceHeroesService {
rpcFindOne(HeroById) returns (Hero) {}
rpcServerStream(ServerStreamRequest) returns (streamServerStreamResponse) {}
rpcClientStream(streamClientStreamRequest) returns (ClientStreamResponse) {}
rpcTwoWayStream(streamTwoWayStreamRequest) returns (streamTwoWayStreamResponse) {}
}

Introduction to gRPC

gRPC is a high-performance, open-source framework for building remote procedure call (RPC) APIs. It uses the Protocol Buffers data serialization format and allows for the communication between services in a variety of programming languages. gRPC is designed to be fast, efficient, and scalable, making it a popular choice for building microservices and other distributed systems.

Introduction to Protocol Buffers

Protocol Buffers is a data serialization format that allows for the encoding and decoding of structured data. It is a language-neutral, platform-neutral, extensible mechanism for serializing structured data. Protocol Buffers are used by gRPC to define the structure of messages that are exchanged between services.

Repository Contents

• Multi-language examples - Complete working examples in Go, Python, TypeScript/NestJS, and Rust
• Build tool - Unified code generation for all languages
• Documentation - Comprehensive guides and examples
• Proto definitions - Centralized Protocol Buffer definitions