https://github.com/cloudwego/dynamicgo

Dynamically and efficiently operate RPC data for Go
https://github.com/cloudwego/dynamicgo

dynamic-programming reflection serdes thrift

Last synced: 1 day ago
JSON representation

Dynamically and efficiently operate RPC data for Go

• Host: GitHub
• URL: https://github.com/cloudwego/dynamicgo
• Owner: cloudwego
• License: apache-2.0
• Created: 2023-01-04T02:22:58.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-08-26T09:20:06.000Z (4 months ago)
• Last Synced: 2024-08-26T11:41:43.387Z (4 months ago)
• Topics: dynamic-programming, reflection, serdes, thrift
• Language: Go
• Homepage:
• Size: 6.15 MB
• Stars: 145
• Watchers: 13
• Forks: 26
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# Dynamic-Go

Dynamically operating data for Go. Aiming at reducing serialization/deserializtion process thus it can be fast as much as possible.

## Introduction

Dynamic-Go for Thrift protocol: [introduction.md](introduction.md).

Dynamic-Go for Protobuf protocol: [introduction.md](./proto/INTRODUCTION.md)

## Usage

[![GoDoc](https://godoc.org/github.com/cloudwego/dynamicgo?status.svg)](https://pkg.go.dev/github.com/cloudwego/dynamicgo?tab=doc)

### thrift

Thrift IDL parser and message operators. It can parse thrift IDL in runtime and handle thrift data in generic way.

[DOC](thrift/README.md)

#### thrift/generic

Reflection APIs to search, modify, deserialize, serialize thrift value **with or without** runtime type descriptor.

[DOC](thrift/generic/README.md)

#### thrift/base 

The meta data about message transportation, including caller, address, log-id, etc. It is mainly used for `conv` (protocol convertion) modules.

#### thrift/annotation 

Built-in implementation of thrid-party annotations, see [thrift_idl_annotation_standards](https://www.cloudwego.io/docs/kitex/tutorials/advanced-feature/generic-call/thrift_idl_annotation_standards/). They are mainly used for `conv` (protocol convertion) modules. 

### proto

Protobuf IDL parser and message operators. It can parse protobuf IDL in runtime and handle protobuf data in generic way.

[DOC](proto/README.md)

#### proto/generic

Reflection APIs to search, modify, deserialize, serialize protobuf value **with or without** runtime descriptor.

[DOC](proto/generic/README.md)

#### proto/protowire

Protobuf data encode and decode APIs. It parses and formats the low-level raw wire encoding. It is modified from Protobuf official code [`encoding/protowire`](https://pkg.go.dev/google.golang.org/protobuf/encoding/protowire).

[DOC](proto/protowire/README.md)

#### proto/binary

BinaryProtocol tool for Protobuf Protocol. It can read, wirte and skip fields directly on binary data of protobuf message.

[DOC](proto/binary/README.md)

### http

Http request/response wrapper interfaces. They are mainly used to pass http values on `http<>thrift` conversion. 

[DOC](http/README.md)

### conv

Protocol convertors. Based on reflecting ability of `thrift`, `json` and `protobuf` modules, it can convert message from one protocol into another. 

#### conv/j2t

Convert JSON value or JSON-body HTTP request into thrift message.

[DOC](conv/j2t/README.md)

#### conv/t2j

Convert thrift message to JSON value or JSON-body HTTP response.

[DOC](conv/t2j/README.md)

#### conv/j2p

Convert JSON value into protobuf message.

[DOC](conv/j2p/README.md)

#### conv/p2j

Convert protobuf message into JSON value.

[DOC](conv/p2j/README.md)