nfo

gRPC Service

High-performance gRPC logging server and client — alternative to the HTTP service for latency-sensitive environments.

What it shows

server.py — Python gRPC server implementing all 4 RPCs:
- LogCall — log a single entry
- BatchLog — log multiple entries in one round-trip
- StreamLog — bidirectional streaming for high-throughput logging
- QueryLogs — query stored logs with filters
client.py — Python gRPC client demo exercising all RPCs
nfo.proto — service definition (generate clients for Go, Rust, Java, C++, etc.)

Setup

pip install nfo[grpc]
# or: pip install grpcio grpcio-tools

Regenerate stubs (if proto changes)

cd examples/grpc-service
python -m grpc_tools.protoc -I. --python_out=. --grpc_python_out=. nfo.proto

Run

# Start server
python examples/grpc-service/server.py
python examples/grpc-service/server.py --port 50052 --db custom.db

# Run client demo
python examples/grpc-service/client.py
python examples/grpc-service/client.py --host localhost:50052

Files

File	Description
`server.py`	gRPC server with nfo SQLite backend
`client.py`	Python client demo (all 4 RPCs)
`nfo.proto`	Protobuf service definition
`nfo_pb2.py`	Generated message classes
`nfo_pb2_grpc.py`	Generated service stubs

Environment

Variable	Default	Description
`NFO_GRPC_PORT`	`50051`	gRPC server port
`NFO_LOG_DIR`	`./logs`	Log directory
`NFO_DB`	`logs/nfo_grpc.db`	SQLite database path

Generate clients for other languages

# Go
protoc --go_out=. --go-grpc_out=. nfo.proto

# C++ / Java / etc.
protoc --cpp_out=. --grpc_out=. --plugin=protoc-gen-grpc=grpc_cpp_plugin nfo.proto

This site is open source. Improve this page.