/echarts-python

Generate Echarts options with Python.

Primary LanguagePython

Echarts for Python

An unofficial Echarts options generator with Python.

Latest Version Travis CI Status Codecov Status Doc Status

This repo still on developing (ALPHA), DON'T USE IT IN PRODUCTION.

Installation

Installing echarts-python with pip

$ pip install echarts-python

Current version for Echarts 3.1.6

Basic Usage

from echarts import Echart, Legend, Bar, Axis

chart = Echart('GDP', 'This is a fake chart')
chart.use(Bar('China', [2, 3, 4, 5]))
chart.use(Legend(['GDP']))
chart.use(Axis('category', 'bottom', data=['Nov', 'Dec', 'Jan', 'Feb']))

The chart.json property will be

{
    "title": {
        "text": "GDP",
        "subtext": "This is a fake chart"
    },
    "series": [
        {
            "type": "bar",
            "data": [
                2,
                3,
                4,
                5
            ],
            "name": "China"
        }
    ],
    "legend": {
        "y": "top",
        "x": "center",
        "data": [
            "GDP"
        ],
        "orient": "horizontal"
    },
    "xAxis": [
        {
            "position": "bottom",
            "data": [
                "Nov",
                "Dec",
                "Jan",
                "Feb"
            ],
            "type": "category"
        }
    ],
    "yAxis": {}
}

on Mac OSX, you also can execute

chart.plot()

and invoke a browser to display the chart.

Contribution

This package authored by Hsiaoming Yang <me@lepture.com> in 2014.

If you have any question or want to improve this repository, welcome to create an issue or pull requests .

This repo is maintained by Yufei Li <yufeiminds@gmail.com> now, you can also send a email to me.