go-echarts

go-echarts

The adorable charts library for Golang.

> If a language can be used to build web scrapers, it definitely needs to provide a graceful data visualization > library. --- by dongdong. In the Golang ecosystem, there are not many choices for data visualization libraries. The development of [go-echarts](https://github.com/go-echarts/go-echarts) aims to provide a simple yet powerful data visualization library for Golang. [Apache ECharts](https://echarts.apache.org/) is an awesome charting and visualization library, it supports adorable chart types and various interactive features. and there have many program languages interactive with Echarts, such as [pyecharts](https://github.com/pyecharts/pyecharts), which `go-echarts` learns and has evolved a lot from, and the [echarts4j](https://github.com/Koooooo-7/echarts4j) either. [中文 README](README_CN.md) ### Installation Classic way to get go-echarts ```shell # this may be not a good choice to use v2 go-echarts without gomod(GO111MODULE=off), the # next generation version management system # Technically, you could use go-echarts in the way below, if you have a better workaround, please let us know.... $ go get -u github.com/go-echarts/go-echarts/... $ cd $go-echarts-project $ mkdir v2 && mv charts components datasets opts render templates types v2 ``` Use gomod style ```shell $ go get -u github.com/go-echarts/go-echarts/v2/... ``` OR ```shell # go.mod require github.com/go-echarts/go-echarts/v2 ``` ### ⏳ Version The go-echarts project is being developed under v2 version and the active codebase is on the master branch. v1 and v2 are incompatible which means that you cannot upgrade go-echarts from v1 to v2 smoothly. But I think it is worth trying that new version. Especially, when there contains mino changes (usually in enhancement), we will release the `rc` version before a standard release. So, if you upgrade your projects cross the `rc` versions, maybe need little adjust, and I believe it is worthy to do. ### ✨ Features * Clean and comprehensive API. * Visualize your data in 25+ different ways. * Highly configurable chart options. * Detailed documentation and a rich collection of examples. * Visualize your geographical data with 400+ maps. ### Usage It's easy to get started with go-echarts with the [handbook](https://go-echarts.github.io/go-echarts), [go-echarts/examples](https://github.com/go-echarts/examples) and [GoDocs](https://pkg.go.dev/github.com/go-echarts/go-echarts/v2). In this example, we create a simple bar chart with only a few lines of code. ``` … ``` And the generated bar.html is rendered as below. Isn't that cool！ Of course we can also start a listening web server with net/http. ``` … ``` ### Gallery For more information, please refer to [handbook](https://go-echarts.github.io/go-echarts/), [go-echarts/examples](https://github.com/go-echarts/examples) and the [GoDoc](https://pkg.go.dev/github.com/go-echarts/go-echarts/v2). ### Contribution go-echarts is an open source project and built on the top of other open-source projects. Welcome all the kinds of contributions. No matter it is for typo fix, bug fix or big new features. Please do not hesitate to ask a question or send a pull request. We strongly value documentation and integration with other projects, so we are very glad to accept improvements for these aspects. ### ❤️ Contributors ### License MIT [©go-echarts](https://github.com/go-echarts/go-echarts/blob/master/LICENSE)