cbsheng / echarts-python

Generate Echarts options with Python.

Echarts for Python

An unofficial Echarts options generator with Python.

• Free software: MIT license
• Documentation: http://echarts-python.readthedocs.io/en/stable/ (NOT Ready)
• Online demo: https://yufeiminds.github.io/echarts-python/ (NOT Ready)

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 <[e-mail]> 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 <[e-mail]> now, you can also send a email to me.