Skip to content
/ cwgo Public
generated from cloudwego/.github

An all-in-one code generation tool for CloudWeGo

License

Notifications You must be signed in to change notification settings

cloudwego/cwgo

Repository files navigation

cwgo

中文 | English

cwgo is an all-in-one code generation tool for CloudWeGo. It integrates the advantages of the kitex and hz tools to improve the development efficiency and experience. The main features of cwgo tool are as follows:

Tool Characteristics

  • Support for generating engineering templates

    The cwgo tool supports the generation of MVC project layout. Users only need to complete their own business code in the corresponding position according to the functions of different directories, focusing on business logic.

  • Support generating Server and Client code

    The cwgo tool supports generating Server and Client codes of Kitex and Hertz, and provides an encapsulation of Client. Users can call downstream out of the box, eliminating the cumbersome steps of encapsulating the Client.

  • Support for generating relational database code

    The cwgo tool supports generating relational database CURD code. Users no longer need to encapsulate the cumbersome CURD code by themselves, which improves the user's work efficiency.

  • Support for generating document database code

    The cwgo tool supports generating document database CURD code based on IDL (Thrift/protobuf), and currently supports MongoDB. Users no longer need to encapsulate the cumbersome CURD code by themselves, which improves the user's work efficiency.

  • Support for generating command line automatic completion scripts

    The cwgo tool supports generating command line completion scripts to improve the efficiency of user command line writing.

  • Support analysis of the relationship between Hertz project routing and (routing registration) code

    Cwgo supports analyzing Hertz project code to obtain the relationship between routing and (routing registration) code.

  • Support fallback to kitex, Hz tools

    If you were a kitex or Hz user before, you can still use the cwgo tool. The cwgo tool supports the fallback function and can be used as kitex and Hz, truly realizing a tool to generate all.

Install cwgo Tool

# Go 1.15 and earlier version
GO111MODULE=on GOPROXY=https://goproxy.cn/,direct go get github.com/cloudwego/cwgo@latest

# Go 1.16 and later version
GOPROXY=https://goproxy.cn/,direct go install github.com/cloudwego/cwgo@latest

Detailed Documentation

Command Line Tool

Contains detailed documentation on how cwgo CLI works, see this document

Template Extension

Instructions on how to customize templates can be found in the document.

Layout

This documents explains Layouts generation and introduction, see this document.

Client

The document details on how generated clients that have been encapsulated can be used, see this document

DB

Details information containing how to use cwgo tool to generate relational CURD codes, see this document

Doc

Including how to use the cwgo tool to generate document database CURD code, see this document.

Api-list

supports getting the relationship between routes and (route registration) code by analyzing Hertz project code, see this document

Server

Including how to generate RPC Server and HTTP Server code, see this document.

auto-completion

Including how to enable command line auto-completion function, see this document.

Open Source License

cwgo is based on Apache License 2.0, Apache License. See Licenses for the open source licenses of the three party components on which it depends.

Contact Us