README
¶
go-grpc
Description
go-grpc is a sample Go project that implements gRPC services using ConnectRPC for CRUD operations and streaming functionalities. This project includes a complete server implementation, with various interceptors for logging, authentication, and recovery, as well as a simple client CLI application to run all functionalities implemented.
This repository and the code in it is meant as a source of good practices and an example for any implementations of this kind, to help anyone trying to build similar applications.
Features
- CRUD Service: Create, Read, Update, and Delete operations.
- Stream Service: Uploading files and sending direct messages (bidi).
- Interceptors: Logging, Authentication, and Recovery.
Installation
To install the project dependencies, run:
go mod download
Usage
Running the Server
To start the gRPC server, use:
go run server/cmd/server/main.go
Client Commands
Run the following command to see the capabilities and usage of the client CLI:
go run client/main.go -h
Unit/integration testing the Server implementation
A number of sample tests are part of the project for the server implementation. These can be run with the following command:
go test -v ./...
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Directories