Cadey Ratio
d2cb12201e
|
||
|---|---|---|
| .. | ||
| ctxsetters | ||
| internal | ||
| .gitignore | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
| context.go | ||
| errors.go | ||
| errors_test.go | ||
| hooks.go | ||
| hooks_test.go | ||
| install_proto.bash | ||
| logo.png | ||
| requirements.txt | ||
| tools.json | ||
README.md
Twirp is a framework for service-to-service communication emphasizing simplicity and minimalism. It generates routing and serialization from API definition files and lets you focus on your application's logic instead of thinking about folderol like HTTP methods and paths and JSON.
Define your service in a
Protobuf file and
then Twirp autogenerates Go code with a server interface and fully functional
clients. It's similar to gRPC, but without the custom
HTTP server and transport implementations: it runs on the standard library's
extremely-well-tested-and-high-performance net/http Server. It can run on HTTP
1.1, not just http/2, and supports JSON clients for easy integrations across
languages
Twirp handles routing and serialization for you in a well-tested, standardized, thoughtful way so you don't have to. Serialization and deserialization code is error-prone and tricky, and you shouldn't be wasting your time deciding whether it should be "POST /friends/:id/new" or "POST /:id/friend" or whatever. Just get to the real work of building services!
Along the way, you get an autogenerated client and a simple, smart framework for passing error messages. Nice!
Releases
Twirp follows semantic versioning through git tags, and uses Github Releases for release notes and upgrade guides: Twirp Releases
Contributing
Check out CONTRIBUTING.md for notes on making contributions.