0.3.3
Very basic gRPC implementation for Deno
Repository
Current version released
4 years ago
/x/grpc_basic
⚠️ You probably should wait for more mature and standard aligned implementation beacuse:
- This lib doesn’t use Deno’s 1.9 HTTP/2 native bindings, but relies on JS implementation roughly ported from node-http2
- I’m not an expert in gRPC or HTTP/2, I just moved HTTP/2 frames around until it worked
- It was never meant for production use, only for fun and some integration tests and scripts
- I have no plans on implementing full gRPC spec
goals - keep it simple
- load proto files
-
server
unary calls -
client
unary calls - errors
-
server
server streams -
client
server streams - context deadlines
- multiplex calls
- calls metadata
- logging
non goals - gRPC bloat
- no TLS
- no client streams
- no bidirectional streams
- no load balancers (maybe simple helper for proxy lb)
- no interceptors (revisit this later)
todo
- remove all deno/node compatibility (Buffer, stream.Transform, etc)
hello world
greeter.proto
syntax = "proto3";
package prohazko;
service Greeter {
rpc SayHello (HelloRequest) returns (HelloReply) {}
}
message HelloRequest {
string name = 1;
}
message HelloReply {
string message = 1;
}
greeter.d.ts
$ deno run --allow-read https://deno.land/x/grpc_basic@0.3.3/gen/dts.ts ./greeter.proto > ./greeter.d.ts
export interface Greeter {
SayHello(request: HelloRequest): Promise<HelloReply>;
}
export interface HelloRequest {
name?: string;
}
export interface HelloReply {
message?: string;
}
server.ts
import { GrpcServer } from "https://deno.land/x/grpc_basic@0.3.3/server.ts";
import { Greeter } from "./greeter.d.ts";
const port = 15070;
const root = await Deno.readTextFile("./greeter.proto");
const server = new GrpcServer();
server.addService<Greeter>(root, {
async SayHello({ name }) {
const message = `hello ${name || "stranger"}`;
return { message };
}
});
console.log(`gonna listen on ${port} port`);
for await (const conn of Deno.listen({ port })) {
server.handle(conn);
}
client.ts
import { getClient } from "https://deno.land/x/grpc_basic@0.3.3/client.ts";
import { Greeter } from "./greeter.d.ts";
const port = 15070;
const root = await Deno.readTextFile("./greeter.proto");
const client = getClient<Greeter>({ port, root, serviceName: "Greeter" });
const resp = await client.SayHello({ name: "oleg" });
console.log(resp);