skip to navigation
skip to content

Not Logged In

chartkick 0.4.1

Create beautiful Javascript charts with minimal code

https://travis-ci.org/mher/chartkick.py.png?branch=master

Create beautiful Javascript charts with minimal code. Demo!

Supports Google Charts and Highcharts

Works with Django, Flask/Jinja2 and most browsers (including IE 6). Also available in Ruby and pure JavaScript

Usage

Line chart:

{% line_chart data %}

Pie chart:

{% pie_chart data with id='chart-1' height='400px' %}

Column chart:

{% column_chart data with min=400 max=1000 %}

Bar chart:

{% bar_chart data %}

Area chart:

{% area_chart data %}

Data

Data can be a dictionary or a list:

{'Chrome': 52.9, 'Opera': 1.6, 'Firefox': 27.7}

[['Chrome', 52.9], ['Firefox', 27.7], ['Opera', 1.6]]

For multiple series:

[{'data': [['2013-04-01 00:00:00 UTC', 52.9], ['2013-05-01 00:00:00 UTC', 50.7]], 'name': 'Chrome'},
 {'data': [['2013-04-01 00:00:00 UTC', 27.7], ['2013-05-01 00:00:00 UTC', 25.9]], 'name': 'Firefox'}]

Options

Charting library options can be passed through the library variable:

{% column_chart data with library={"title":"Super chart",width:"400px"} %}

Or using chartkick.json file. Chartkick tries to locate chartkick.json file in template path and match options by id.

Installation

Install chartkick:

$ pip install chartkick
  • Django: Add chartkick to INSTALLED_APPS and STATICFILES_DIRS:

    INSTALLED_APPS = (
        'chartkick',
    )
    
    import chartkick
    STATICFILES_DIRS = (
        chartkick.js(),
    )
    
  • Flask: Add chartkick to jinja_env and static_folder:

    app = Flask(__name__, static_folder=chartkick.js(), static_url_path='/static')
    app.jinja_env.add_extension("chartkick.ext.charts")
    

Load JS scripts:

  • Google Charts

    <script src="http://www.google.com/jsapi"></script>
    <script src="static/chartkick.js"></script>
    
  • Highcharts

    <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.8.3/jquery.min.js"></script>
    <script src="http://code.highcharts.com/highcharts.js"></script>
    <script src="static/chartkick.js"></script>
    
Bitdeli badge
 
File Type Py Version Uploaded on Size
chartkick-0.4.1.tar.gz (md5) Source 2013-11-23 9KB
  • Downloads (All Versions):
  • 71 downloads in the last day
  • 406 downloads in the last week
  • 897 downloads in the last month