rpcgen: JSON-RPC 2.0 Client Generator Implementation for zenrpc

rpcgen is a JSON-RPC 2.0 client library generator for zenrpc. It supports client generation for following languages:

• Dart
• Golang
• PHP
• TypeScript
• Swift
• OpenRPC schema

Examples

Basic usage

package main
import (
"fmt""log""github.com/vmkteam/rpcgen/v2""github.com/vmkteam/zenrpc/v2"
)
funcmain() {
rpc:=zenrpc.NewServer(zenrpc.Options{})
generated, err:=rpcgen.FromSMD(rpc.SMD()).GoClient().Generate()
iferr!=nil {
log.Fatal(err)
}
fmt.Printf("%s", generated)
}

Generate in HTTP handler

package main
import (
"net/http""github.com/vmkteam/rpcgen/v2""github.com/vmkteam/rpcgen/v2/dart""github.com/vmkteam/rpcgen/v2/golang""github.com/vmkteam/rpcgen/v2/swift""github.com/vmkteam/zenrpc/v2"
)
funcmain() {
rpc:=zenrpc.NewServer(zenrpc.Options{})
gen:=rpcgen.FromSMD(rpc.SMD())
http.HandleFunc("/client.go", rpcgen.Handler(gen.GoClient(golang.Settings{})))
http.HandleFunc("/client.ts", rpcgen.Handler(gen.TSClient(nil)))
http.HandleFunc("/RpcClient.php", rpcgen.Handler(gen.PHPClient("")))
http.HandleFunc("/client.swift", rpcgen.Handler(gen.SwiftClient(swift.Settings{})))
http.HandleFunc("/client.dart", rpcgen.Handler(gen.DartClient(dart.Settings{ Part: "client"})))
}

Add custom TypeScript type mapper

package main
import (
"fmt""net/http""github.com/vmkteam/rpcgen/v2""github.com/vmkteam/rpcgen/v2/typescript""github.com/vmkteam/zenrpc/v2""github.com/vmkteam/zenrpc/v2/smd"
)
funcmain() {
rpc:=zenrpc.NewServer(zenrpc.Options{})
gen:=rpcgen.FromSMD(rpc.SMD())
typeMapper:=func(in smd.JSONSchema, tsType typescript.Type) typescript.Type {
ifin.Type=="object" {
ifin.Description=="Group"&&in.Name=="groups" {
tsType.Type=fmt.Sprintf("Record<number, I%s>", in.Description)
}
}
returntsType
}
http.HandleFunc("/client.ts", rpcgen.Handler(gen.TSClient(typeMapper)))
}

Add custom Swift type mapper

package main
import (
"fmt""net/http""github.com/vmkteam/rpcgen/v2""github.com/vmkteam/rpcgen/v2/swift""github.com/vmkteam/zenrpc/v2""github.com/vmkteam/zenrpc/v2/smd"
)
funcmain() {
rpc:=zenrpc.NewServer(zenrpc.Options{})
gen:=rpcgen.FromSMD(rpc.SMD())
typeMapper:=func(typeNamestring, in smd.Property, param swift.Parameter) swift.Parameter {
switchtypeName {
case"Group":
switchin.Name {
case"groups":
param.Type=fmt.Sprintf("[Int: %s]", param.Type)
param.DecodableDefault=swift.DefaultMap
}
}
returnparam
}
http.HandleFunc("/client.swift", rpcgen.Handler(gen.SwiftClient(swift.Settings{"", typeMapper})))
}

Add custom Dart type mapper

package main
import (
"net/http""github.com/vmkteam/rpcgen/v2""github.com/vmkteam/rpcgen/v2/dart""github.com/vmkteam/zenrpc/v2""github.com/vmkteam/zenrpc/v2/smd"
)
funcmain() {
rpc:=zenrpc.NewServer(zenrpc.Options{})
gen:=rpcgen.FromSMD(rpc.SMD())
typeMapper:=func(in smd.JSONSchema, param dart.Parameter) dart.Parameter {
ifin.Type==smd.Object {
switchin.TypeName {
case"Time", "Date":
param.Type="String"
}
}
ifin.Type==smd.Array {
switchin.TypeName {
case"[]Date", "[]Time":
param.Type="List<String>"param.ReturnType="List<String>"
}
}
returnparam
}
http.HandleFunc("/client.dart", rpcgen.Handler(gen.DartClient(dart.Settings{Part: "client", TypeMapper: typeMapper})))
}