github/ttrpc
4
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
167 Commits 1 Branch 1 Tag 508 KiB
Go 94.2%
Makefile 4.3%
Shell 1.5%
8fe1bd5ef2
Go to file
Kazuyoshi Kato 8fe1bd5ef2 Use CR+LF instead of LF regardless of OS 
Git by default uses CR+LF on Windows, whereas gofmt always
uses LF even on Windows.

This commit lets Git uses LF on Windows.

Signed-off-by: Kazuyoshi Kato <katokazu@amazon.com>
2022-02-21 23:47:19 +00:00
.github/workflows Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
cmd Add protoc-gen-go-ttrpc 2021-10-26 10:03:23 -07:00
example Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
internal Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
plugin Add apache license to files 2018-06-27 17:49:06 -04:00
proto Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
.gitattributes Use CR+LF instead of LF regardless of OS 2022-02-21 23:47:19 +00:00
.gitignore removing glide from ignore 2021-05-06 14:04:24 -05:00
.golangci.yml Fix lint issues 2022-01-21 12:04:30 -08:00
channel_test.go replace pkg/errors from vendor 2021-09-25 22:46:36 +08:00
channel.go replace pkg/errors from vendor 2021-09-25 22:46:36 +08:00
client_test.go Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
client.go Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
codec.go Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
config.go replace pkg/errors from vendor 2021-09-25 22:46:36 +08:00
go.mod Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
go.sum Add protoc-gen-go-ttrpc 2021-10-26 10:03:23 -07:00
handshake.go Fix lint issues 2022-01-21 12:04:30 -08:00
interceptor.go Fix lint issues 2022-01-21 12:04:30 -08:00
LICENSE Initial commit 2017-11-13 14:12:46 -08:00
metadata_test.go metadata as KeyValue type 2019-06-13 18:06:27 +00:00
metadata.go metadata as KeyValue type 2019-06-13 18:06:27 +00:00
Protobuild.toml Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
README.md Merge pull request #86 from dmcgowan/branch-rename 2021-06-19 14:57:08 +08:00
request.pb.go Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
request.proto Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
server_linux_test.go Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
server_test.go Merge pull request #104 from kzys/windows-wsarecv 2022-02-21 14:00:17 -08:00
server.go replace pkg/errors from vendor 2021-09-25 22:46:36 +08:00
services_test.go Fix method full name generation 2019-08-23 13:28:19 -07:00
services.go Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
test.proto Use google.golang.org/protobuf instead of github.com/gogo/protobuf 2022-02-16 23:11:27 +00:00
unixcreds_linux.go Merge pull request #100 from tklauser/ucred-wrap-err 2022-01-21 15:00:05 -08:00

README.md

ttrpc

Build Status codecov

GRPC for low-memory environments.

The existing grpc-go project requires a lot of memory overhead for importing packages and at runtime. While this is great for many services with low density requirements, this can be a problem when running a large number of services on a single machine or on a machine with a small amount of memory.

Using the same GRPC definitions, this project reduces the binary size and protocol overhead required. We do this by eliding the net/http, net/http2 and grpc package used by grpc replacing it with a lightweight framing protocol. The result are smaller binaries that use less resident memory with the same ease of use as GRPC.

Please note that while this project supports generating either end of the protocol, the generated service definitions will be incompatible with regular GRPC services, as they do not speak the same protocol.

Usage

Create a gogo vanity binary (see cmd/protoc-gen-gogottrpc/main.go for an example with the ttrpc plugin enabled.

It's recommended to use protobuild to build the protobufs for this project, but this will work with protoc directly, if required.

Differences from GRPC

  • The protocol stack has been replaced with a lighter protocol that doesn't require http, http2 and tls.
  • The client and server interface are identical whereas in GRPC there is a client and server interface that are different.
  • The Go stdlib context package is used instead.
  • No support for streams yet.

Status

TODO:

  • Document protocol layout
  • Add testing under concurrent load to ensure
  • Verify connection error handling

Project details

ttrpc is a containerd sub-project, licensed under the Apache 2.0 license. As a containerd sub-project, you will find the:

information in our containerd/project repository.