Fix x_labels y_labels XY DateLine TimeLine and a lot things + write doc

demo/moulinrouge/tests.py

@@ -26,7 +26,7 @@ from pygal.style import styles, Style, RotateStyle
 from pygal.colors import rotate
 from pygal.graph.horizontal import HorizontalGraph
 from random import randint, choice
-from datetime import datetime
+from datetime import datetime, date, time
 
 
 def get_test_routes(app):
@@ -94,7 +94,8 @@ def get_test_routes(app):
             'label': 'Thirty',
             'xlink': 'http://google.com?q=30'
         }, (20, 10), (10, 21)])
-        xy.x_labels = map(str, range(1, 5))
+        xy.x_labels = list(range(1, 50))
+        xy.y_labels = list(range(1, 50))
         return xy.render_response()
 
     @app.route('/test/long_title')
@@ -390,29 +391,37 @@ def get_test_routes(app):
 
     @app.route('/test/dateline')
     def test_dateline():
-        datey = DateLine(show_dots=False)
-        datey.add('1', [
-            (datetime(2013, 1, 2), 300),
-            (datetime(2013, 1, 12), 412),
-            (datetime(2013, 2, 2), 823),
-            (datetime(2013, 2, 22), 672)
+        dateline = DateLine(show_dots=False)
+        dateline.x_labels = [
+            date(2013, 1, 1),
+            date(2013, 7, 1),
+            date(2014, 1, 1),
+            date(2014, 7, 1),
+            date(2015, 1, 1),
+            date(2015, 7, 1)
+        ]
+        dateline.add('1', [
+            (date(2013, 1, 2), 300),
+            (date(2014, 1, 12), 412),
+            (date(2015, 2, 2), 823),
+            (date(2013, 2, 22), 672)
         ])
-        datey.x_label_rotation = 25
-        return datey.render_response()
+        dateline.x_label_rotation = 25
+        return dateline.render_response()
 
     @app.route('/test/timeline')
     def test_timexy():
         from datetime import time
-        datey = TimeLine()
-        datey.add('1', [
+        timeline = TimeLine()
+        timeline.add('1', [
             (time(1, 12, 29), 2),
             (time(21, 2, 29), 10),
             (time(12, 30, 59), 7)
         ])
-        datey.add(
+        timeline.add(
             '2', [(time(12, 12, 12), 4), (time(), 8), (time(23, 59, 59), 6)])
-        datey.x_label_rotation = 25
-        return datey.render_response()
+        timeline.x_label_rotation = 25
+        return timeline.render_response()
 
     @app.route('/test/worldmap')
     def test_worldmap():

docs/contributing.rst

@@ -9,6 +9,12 @@ Github
 Submit your bug reports and feature requests to the `github bug tracker <http://github.com/Kozea/pygal/issues>`_.
 
 
+Code style
+==========
+
+The pygal code tries to respect the `pep8 <https://www.python.org/dev/peps/pep-0008/>`_ please keep that in mind when writing code for pygal.
+
+
 Testing
 =======
 

docs/documentation/chart_types.rst

@@ -1,814 +0,0 @@
-Chart types
-===========
-
-pygal provides various kinds of charts:
-
-
-Line charts
------------
-
-Basic
-~~~~~
-
-Basic simple line graph:
-
-.. pygal-code::
-
-  line_chart = pygal.Line()
-  line_chart.title = 'Browser usage evolution (in %)'
-  line_chart.x_labels = map(str, range(2002, 2013))
-  line_chart.add('Firefox', [None, None,    0, 16.6,   25,   31, 36.4, 45.5, 46.3, 42.8, 37.1])
-  line_chart.add('Chrome',  [None, None, None, None, None, None,    0,  3.9, 10.8, 23.8, 35.3])
-  line_chart.add('IE',      [85.8, 84.6, 84.7, 74.5,   66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1])
-  line_chart.add('Others',  [14.2, 15.4, 15.3,  8.9,    9, 10.4,  8.9,  5.8,  6.7,  6.8,  7.5])
-
-Stacked
-~~~~~~~
-
-Same graph but with stacked values and filled rendering:
-
-.. pygal-code::
-
-  line_chart = pygal.StackedLine(fill=True)
-  line_chart.title = 'Browser usage evolution (in %)'
-  line_chart.x_labels = map(str, range(2002, 2013))
-  line_chart.add('Firefox', [None, None, 0, 16.6,   25,   31, 36.4, 45.5, 46.3, 42.8, 37.1])
-  line_chart.add('Chrome',  [None, None, None, None, None, None,    0,  3.9, 10.8, 23.8, 35.3])
-  line_chart.add('IE',      [85.8, 84.6, 84.7, 74.5,   66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1])
-  line_chart.add('Others',  [14.2, 15.4, 15.3,  8.9,    9, 10.4,  8.9,  5.8,  6.7,  6.8,  7.5])
-
-
-Bar charts / Histograms
------------------------
-
-Basic
-~~~~~
-
-Basic simple bar graph:
-
-.. pygal-code::
-
-  line_chart = pygal.Bar()
-  line_chart.title = 'Browser usage evolution (in %)'
-  line_chart.x_labels = map(str, range(2002, 2013))
-  line_chart.add('Firefox', [None, None, 0, 16.6,   25,   31, 36.4, 45.5, 46.3, 42.8, 37.1])
-  line_chart.add('Chrome',  [None, None, None, None, None, None,    0,  3.9, 10.8, 23.8, 35.3])
-  line_chart.add('IE',      [85.8, 84.6, 84.7, 74.5,   66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1])
-  line_chart.add('Others',  [14.2, 15.4, 15.3,  8.9,    9, 10.4,  8.9,  5.8,  6.7,  6.8,  7.5])
-
-
-Stacked
-~~~~~~~
-
-Same graph but with stacked values:
-
-.. pygal-code::
-
-  line_chart = pygal.StackedBar()
-  line_chart.title = 'Browser usage evolution (in %)'
-  line_chart.x_labels = map(str, range(2002, 2013))
-  line_chart.add('Firefox', [None, None, 0, 16.6,   25,   31, 36.4, 45.5, 46.3, 42.8, 37.1])
-  line_chart.add('Chrome',  [None, None, None, None, None, None,    0,  3.9, 10.8, 23.8, 35.3])
-  line_chart.add('IE',      [85.8, 84.6, 84.7, 74.5,   66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1])
-  line_chart.add('Others',  [14.2, 15.4, 15.3,  8.9,    9, 10.4,  8.9,  5.8,  6.7,  6.8,  7.5])
-
-
-Horizontal
-~~~~~~~~~~
-
-Horizontal bar diagram:
-
-.. pygal-code::
-
-  line_chart = pygal.HorizontalBar()
-  line_chart.title = 'Browser usage in February 2012 (in %)'
-  line_chart.add('IE', 19.5)
-  line_chart.add('Firefox', 36.6)
-  line_chart.add('Chrome', 36.3)
-  line_chart.add('Safari', 4.5)
-  line_chart.add('Opera', 2.3)
-
-
-XY charts
----------
-
-Basic
-~~~~~
-
-Basic XY lines, drawing cosinus:
-
-.. pygal-code::
-
-  from math import cos
-  xy_chart = pygal.XY()
-  xy_chart.title = 'XY Cosinus'
-  xy_chart.add('x = cos(y)', [(cos(x / 10.), x / 10.) for x in range(-50, 50, 5)])
-  xy_chart.add('y = cos(x)', [(x / 10., cos(x / 10.)) for x in range(-50, 50, 5)])
-  xy_chart.add('x = 1',  [(1, -5), (1, 5)])
-  xy_chart.add('x = -1', [(-1, -5), (-1, 5)])
-  xy_chart.add('y = 1',  [(-5, 1), (5, 1)])
-  xy_chart.add('y = -1', [(-5, -1), (5, -1)])
-
-
-Scatter Plot
-~~~~~~~~~~~~
-
-Disabling stroke make a good scatter plot
-
-.. pygal-code::
-
-  xy_chart = pygal.XY(stroke=False)
-  xy_chart.title = 'Correlation'
-  xy_chart.add('A', [(0, 0), (.1, .2), (.3, .1), (.5, 1), (.8, .6), (1, 1.08), (1.3, 1.1), (2, 3.23), (2.43, 2)])
-  xy_chart.add('B', [(.1, .15), (.12, .23), (.4, .3), (.6, .4), (.21, .21), (.5, .3), (.6, .8), (.7, .8)])
-  xy_chart.add('C', [(.05, .01), (.13, .02), (1.5, 1.7), (1.52, 1.6), (1.8, 1.63), (1.5, 1.82), (1.7, 1.23), (2.1, 2.23), (2.3, 1.98)])
-
-
-DateY
-~~~~~
-You can index values by dates (Thanks to `Snarkturne <https://github.com/snarkturne>`_)
-
-.. pygal-code::
-
-  from datetime import datetime, timedelta
-  datey = pygal.DateY(x_label_rotation=20)
-  datey.add("Visits", [
-      (datetime(2013, 1, 2), 300),
-      (datetime(2013, 1, 12), 412),
-      (datetime(2013, 2, 2), 823),
-      (datetime(2013, 2, 22), 672)
-  ])
-
-The x axis and tool tip x labels can be specified using `x_label_format`. This uses the formatting string for strftime from `here <http://docs.python.org/2/library/time.html#time.strftime>`_
-
-The x labels can also be specified, using an array of datetime objects.
-
-.. pygal-code::
-
-  from datetime import datetime, timedelta
-  datey = pygal.DateY(x_label_rotation=20)
-  datey.add("Visits", [
-      (datetime(2013, 1, 2), 300),
-      (datetime(2013, 1, 12), 412),
-      (datetime(2013, 2, 2), 823),
-      (datetime(2013, 2, 22), 672)
-  ])
-  datey.x_label_format = "%Y-%m-%d"
-  datey.x_labels = [
-	datetime(2013, 1, 1),
-	datetime(2013, 2, 1),
-	datetime(2013, 3, 1)
-  ]
-
-Pies
-----
-
-Basic
-~~~~~
-
-Simple pie:
-
-
-.. pygal-code::
-
-  pie_chart = pygal.Pie()
-  pie_chart.title = 'Browser usage in February 2012 (in %)'
-  pie_chart.add('IE', 19.5)
-  pie_chart.add('Firefox', 36.6)
-  pie_chart.add('Chrome', 36.3)
-  pie_chart.add('Safari', 4.5)
-  pie_chart.add('Opera', 2.3)
-
-
-Multi-series pie
-~~~~~~~~~~~~~~~~
-
-Same pie but divided in sub category:
-
-.. pygal-code::
-
-  pie_chart = pygal.Pie()
-  pie_chart.title = 'Browser usage by version in February 2012 (in %)'
-  pie_chart.add('IE', [5.7, 10.2, 2.6, 1])
-  pie_chart.add('Firefox', [.6, 16.8, 7.4, 2.2, 1.2, 1, 1, 1.1, 4.3, 1])
-  pie_chart.add('Chrome', [.3, .9, 17.1, 15.3, .6, .5, 1.6])
-  pie_chart.add('Safari', [4.4, .1])
-  pie_chart.add('Opera', [.1, 1.6, .1, .5])
-
-
-Radar charts
-------------
-
-Basic
-~~~~~
-
-Simple Kiviat diagram:
-
-.. pygal-code::
-
-  radar_chart = pygal.Radar()
-  radar_chart.title = 'V8 benchmark results'
-  radar_chart.x_labels = ['Richards', 'DeltaBlue', 'Crypto', 'RayTrace', 'EarleyBoyer', 'RegExp', 'Splay', 'NavierStokes']
-  radar_chart.add('Chrome', [6395, 8212, 7520, 7218, 12464, 1660, 2123, 8607])
-  radar_chart.add('Firefox', [7473, 8099, 11700, 2651, 6361, 1044, 3797, 9450])
-  radar_chart.add('Opera', [3472, 2933, 4203, 5229, 5810, 1828, 9013, 4669])
-  radar_chart.add('IE', [43, 41, 59, 79, 144, 136, 34, 102])
-
-
-Box plot
---------
-
-Basic
-~~~~~
-
-Here's some whiskers:
-
-.. pygal-code::
-
-  box_plot = pygal.Box()
-  box_plot.title = 'V8 benchmark results'
-  box_plot.add('Chrome', [6395, 8212, 7520, 7218, 12464, 1660, 2123, 8607])
-  box_plot.add('Firefox', [7473, 8099, 11700, 2651, 6361, 1044, 3797, 9450])
-  box_plot.add('Opera', [3472, 2933, 4203, 5229, 5810, 1828, 9013, 4669])
-  box_plot.add('IE', [43, 41, 59, 79, 144, 136, 34, 102])
-
-
-Dot charts
-----------
-
-Basic
-~~~~~
-
-Punch card like chart:
-
-.. pygal-code::
-
-  dot_chart = pygal.Dot(x_label_rotation=30)
-  dot_chart.title = 'V8 benchmark results'
-  dot_chart.x_labels = ['Richards', 'DeltaBlue', 'Crypto', 'RayTrace', 'EarleyBoyer', 'RegExp', 'Splay', 'NavierStokes']
-  dot_chart.add('Chrome', [6395, 8212, 7520, 7218, 12464, 1660, 2123, 8607])
-  dot_chart.add('Firefox', [7473, 8099, 11700, 2651, 6361, 1044, 3797, 9450])
-  dot_chart.add('Opera', [3472, 2933, 4203, 5229, 5810, 1828, 9013, 4669])
-  dot_chart.add('IE', [43, 41, 59, 79, 144, 136, 34, 102])
-
-
-Funnel charts
--------------
-
-Basic
-~~~~~
-
-Funnel chart:
-
-.. pygal-code::
-
-  funnel_chart = pygal.Funnel()
-  funnel_chart.title = 'V8 benchmark results'
-  funnel_chart.x_labels = ['Richards', 'DeltaBlue', 'Crypto', 'RayTrace', 'EarleyBoyer', 'RegExp', 'Splay', 'NavierStokes']
-  funnel_chart.add('Opera', [3472, 2933, 4203, 5229, 5810, 1828, 9013, 4669])
-  funnel_chart.add('Firefox', [7473, 8099, 11700, 2651, 6361, 1044, 3797, 9450])
-  funnel_chart.add('Chrome', [6395, 8212, 7520, 7218, 12464, 1660, 2123, 8607])
-
-
-Gauge charts
-------------
-
-Basic
-~~~~~
-
-Simple gauge chart:
-
-.. pygal-code::
-
-  gauge_chart = pygal.Gauge(human_readable=True)
-  gauge_chart.title = 'DeltaBlue V8 benchmark results'
-  gauge_chart.x_labels = ['Richards', 'DeltaBlue', 'Crypto', 'RayTrace', 'EarleyBoyer', 'RegExp', 'Splay', 'NavierStokes']
-  gauge_chart.range = [0, 10000]
-  gauge_chart.add('Chrome', 8212)
-  gauge_chart.add('Firefox', 8099)
-  gauge_chart.add('Opera', 2933)
-  gauge_chart.add('IE', 41)
-
-
-Pyramid charts
---------------
-
-Basic
-~~~~~
-
-Population pyramid:
-
-.. pygal-code:: 600 600
-
-  ages = [(364381, 358443, 360172, 345848, 334895, 326914, 323053, 312576, 302015, 301277, 309874, 318295, 323396, 332736, 330759, 335267, 345096, 352685, 368067, 381521, 380145, 378724, 388045, 382303, 373469, 365184, 342869, 316928, 285137, 273553, 250861, 221358, 195884, 179321, 171010, 162594, 152221, 148843, 143013, 135887, 125824, 121493, 115913, 113738, 105612, 99596, 91609, 83917, 75688, 69538, 62999, 58864, 54593, 48818, 44739, 41096, 39169, 36321, 34284, 32330, 31437, 30661, 31332, 30334, 23600, 21999, 20187, 19075, 16574, 15091, 14977, 14171, 13687, 13155, 12558, 11600, 10827, 10436, 9851, 9794, 8787, 7993, 6901, 6422, 5506, 4839, 4144, 3433, 2936, 2615),
-     (346205, 340570, 342668, 328475, 319010, 312898, 308153, 296752, 289639, 290466, 296190, 303871, 309886, 317436, 315487, 316696, 325772, 331694, 345815, 354696, 354899, 351727, 354579, 341702, 336421, 321116, 292261, 261874, 242407, 229488, 208939, 184147, 162662, 147361, 140424, 134336, 126929, 125404, 122764, 116004, 105590, 100813, 95021, 90950, 85036, 79391, 72952, 66022, 59326, 52716, 46582, 42772, 38509, 34048, 30887, 28053, 26152, 23931, 22039, 20677, 19869, 19026, 18757, 18308, 14458, 13685, 12942, 12323, 11033, 10183, 10628, 10803, 10655, 10482, 10202, 10166, 9939, 10138, 10007, 10174, 9997, 9465, 9028, 8806, 8450, 7941, 7253, 6698, 6267, 5773),
-     (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 23, 91, 412, 1319, 2984, 5816, 10053, 16045, 24240, 35066, 47828, 62384, 78916, 97822, 112738, 124414, 130658, 140789, 153951, 168560, 179996, 194471, 212006, 225209, 228886, 239690, 245974, 253459, 255455, 260715, 259980, 256481, 252222, 249467, 240268, 238465, 238167, 231361, 223832, 220459, 222512, 220099, 219301, 221322, 229783, 239336, 258360, 271151, 218063, 213461, 207617, 196227, 174615, 160855, 165410, 163070, 157379, 149698, 140570, 131785, 119936, 113751, 106989, 99294, 89097, 78413, 68174, 60592, 52189, 43375, 35469, 29648, 24575, 20863),
-     (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 74, 392, 1351, 3906, 7847, 12857, 19913, 29108, 42475, 58287, 74163, 90724, 108375, 125886, 141559, 148061, 152871, 159725, 171298, 183536, 196136, 210831, 228757, 238731, 239616, 250036, 251759, 259593, 261832, 264864, 264702, 264070, 258117, 253678, 245440, 241342, 239843, 232493, 226118, 221644, 223440, 219833, 219659, 221271, 227123, 232865, 250646, 261796, 210136, 201824, 193109, 181831, 159280, 145235, 145929, 140266, 133082, 124350, 114441, 104655, 93223, 85899, 78800, 72081, 62645, 53214, 44086, 38481, 32219, 26867, 21443, 16899, 13680, 11508),
-     (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 7, 5, 17, 15, 31, 34, 38, 35, 45, 299, 295, 218, 247, 252, 254, 222, 307, 316, 385, 416, 463, 557, 670, 830, 889, 1025, 1149, 1356, 1488, 1835, 1929, 2130, 2362, 2494, 2884, 3160, 3487, 3916, 4196, 4619, 5032, 5709, 6347, 7288, 8139, 9344, 11002, 12809, 11504, 11918, 12927, 13642, 13298, 14015, 15751, 17445, 18591, 19682, 20969, 21629, 22549, 23619, 25288, 26293, 27038, 27039, 27070, 27750, 27244, 25905, 24357, 22561, 21794, 20595),
-     (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 6, 8, 0, 8, 21, 34, 49, 84, 97, 368, 401, 414, 557, 654, 631, 689, 698, 858, 1031, 1120, 1263, 1614, 1882, 2137, 2516, 2923, 3132, 3741, 4259, 4930, 5320, 5948, 6548, 7463, 8309, 9142, 10321, 11167, 12062, 13317, 15238, 16706, 18236, 20336, 23407, 27024, 32502, 37334, 34454, 38080, 41811, 44490, 45247, 46830, 53616, 58798, 63224, 66841, 71086, 73654, 77334, 82062, 87314, 92207, 94603, 94113, 92753, 93174, 91812, 87757, 84255, 79723, 77536, 74173),
-     (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 5, 0, 11, 35, 137, 331, 803, 1580, 2361, 3632, 4866, 6849, 8754, 10422, 12316, 14152, 16911, 19788, 22822, 27329, 31547, 35711, 38932, 42956, 46466, 49983, 52885, 55178, 56549, 57632, 57770, 57427, 56348, 55593, 55554, 53266, 51084, 49342, 48555, 47067, 45789, 44988, 44624, 44238, 46267, 46203, 36964, 33866, 31701, 28770, 25174, 22702, 21934, 20638, 19051, 17073, 15381, 13736, 11690, 10368, 9350, 8375, 7063, 6006, 5044, 4030, 3420, 2612, 2006, 1709, 1264, 1018),
-     (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 4, 6, 11, 20, 68, 179, 480, 1077, 2094, 3581, 5151, 7047, 9590, 12434, 15039, 17257, 19098, 21324, 24453, 27813, 32316, 37281, 43597, 49647, 53559, 58888, 62375, 67219, 70956, 73547, 74904, 75994, 76224, 74979, 72064, 70330, 68944, 66527, 63073, 60899, 60968, 58756, 57647, 56301, 57246, 57068, 59027, 59187, 47549, 44425, 40976, 38077, 32904, 29431, 29491, 28020, 26086, 24069, 21742, 19498, 17400, 15738, 14451, 13107, 11568, 10171, 8530, 7273, 6488, 5372, 4499, 3691, 3259, 2657)]
-
-  types = ['Males single', 'Females single',
-           'Males married', 'Females married',
-           'Males widowed', 'Females widowed',
-           'Males divorced', 'Females divorced']
-
-  pyramid_chart = pygal.Pyramid(human_readable=True, legend_at_bottom=True)
-  pyramid_chart.title = 'England population by age in 2010 (source: ons.gov.uk)'
-  pyramid_chart.x_labels = map(lambda x: str(x) if not x % 5 else '', range(90))
-  for type, age in zip(types, ages):
-      pyramid_chart.add(type, age)
-
-
-Worldmap charts
----------------
-
-Basic
-~~~~~
-
-Highlight some countries:
-
-.. pygal-code::
-
-  worldmap_chart = pygal.Worldmap()
-  worldmap_chart.title = 'Some countries'
-  worldmap_chart.add('F countries', ['fr', 'fi'])
-  worldmap_chart.add('M countries', ['ma', 'mc', 'md', 'me', 'mg',
-                                     'mk', 'ml', 'mm', 'mn', 'mo',
-                                     'mr', 'mt', 'mu', 'mv', 'mw',
-                                     'mx', 'my', 'mz'])
-  worldmap_chart.add('U countries', ['ua', 'ug', 'us', 'uy', 'uz'])
-
-
-You can also specify an number for a country:
-
-.. pygal-code::
-
-  worldmap_chart = pygal.Worldmap()
-  worldmap_chart.title = 'Minimum deaths by capital punishement (source: Amnesty International)'
-  worldmap_chart.add('In 2012', {
-    'af': 14,
-    'bd': 1,
-    'by': 3,
-    'cn': 1000,
-    'gm': 9,
-    'in': 1,
-    'ir': 314,
-    'iq': 129,
-    'jp': 7,
-    'kp': 6,
-    'pk': 1,
-    'ps': 6,
-    'sa': 79,
-    'so': 6,
-    'sd': 5,
-    'tw': 6,
-    'ae': 1,
-    'us': 43,
-    'ye': 28
-  })
-
-
-The following countries are supported:
-
-    - `ad`: Andorra
-    - `ae`: United Arab Emirates
-    - `af`: Afghanistan
-    - `al`: Albania
-    - `am`: Armenia
-    - `ao`: Angola
-    - `aq`: Antarctica
-    - `ar`: Argentina
-    - `at`: Austria
-    - `au`: Australia
-    - `az`: Azerbaijan
-    - `ba`: Bosnia and Herzegovina
-    - `bd`: Bangladesh
-    - `be`: Belgium
-    - `bf`: Burkina Faso
-    - `bg`: Bulgaria
-    - `bh`: Bahrain
-    - `bi`: Burundi
-    - `bj`: Benin
-    - `bn`: Brunei Darussalam
-    - `bo`: Bolivia, Plurinational State of
-    - `br`: Brazil
-    - `bt`: Bhutan
-    - `bw`: Botswana
-    - `by`: Belarus
-    - `bz`: Belize
-    - `ca`: Canada
-    - `cd`: Congo, the Democratic Republic of the
-    - `cf`: Central African Republic
-    - `cg`: Congo
-    - `ch`: Switzerland
-    - `ci`: Cote d'Ivoire
-    - `cl`: Chile
-    - `cm`: Cameroon
-    - `cn`: China
-    - `co`: Colombia
-    - `cr`: Costa Rica
-    - `cu`: Cuba
-    - `cv`: Cape Verde
-    - `cy`: Cyprus
-    - `cz`: Czech Republic
-    - `de`: Germany
-    - `dj`: Djibouti
-    - `dk`: Denmark
-    - `do`: Dominican Republic
-    - `dz`: Algeria
-    - `ec`: Ecuador
-    - `ee`: Estonia
-    - `eg`: Egypt
-    - `eh`: Western Sahara
-    - `er`: Eritrea
-    - `es`: Spain
-    - `et`: Ethiopia
-    - `fi`: Finland
-    - `fr`: France
-    - `ga`: Gabon
-    - `gb`: United Kingdom
-    - `ge`: Georgia
-    - `gf`: French Guiana
-    - `gh`: Ghana
-    - `gl`: Greenland
-    - `gm`: Gambia
-    - `gn`: Guinea
-    - `gq`: Equatorial Guinea
-    - `gr`: Greece
-    - `gt`: Guatemala
-    - `gu`: Guam
-    - `gw`: Guinea-Bissau
-    - `gy`: Guyana
-    - `hk`: Hong Kong
-    - `hn`: Honduras
-    - `hr`: Croatia
-    - `ht`: Haiti
-    - `hu`: Hungary
-    - `id`: Indonesia
-    - `ie`: Ireland
-    - `il`: Israel
-    - `in`: India
-    - `iq`: Iraq
-    - `ir`: Iran, Islamic Republic of
-    - `is`: Iceland
-    - `it`: Italy
-    - `jm`: Jamaica
-    - `jo`: Jordan
-    - `jp`: Japan
-    - `ke`: Kenya
-    - `kg`: Kyrgyzstan
-    - `kh`: Cambodia
-    - `kp`: Korea, Democratic People's Republic of
-    - `kr`: Korea, Republic of
-    - `kw`: Kuwait
-    - `kz`: Kazakhstan
-    - `la`: Lao People's Democratic Republic
-    - `lb`: Lebanon
-    - `li`: Liechtenstein
-    - `lk`: Sri Lanka
-    - `lr`: Liberia
-    - `ls`: Lesotho
-    - `lt`: Lithuania
-    - `lu`: Luxembourg
-    - `lv`: Latvia
-    - `ly`: Libyan Arab Jamahiriya
-    - `ma`: Morocco
-    - `mc`: Monaco
-    - `md`: Moldova, Republic of
-    - `me`: Montenegro
-    - `mg`: Madagascar
-    - `mk`: Macedonia, the former Yugoslav Republic of
-    - `ml`: Mali
-    - `mm`: Myanmar
-    - `mn`: Mongolia
-    - `mo`: Macao
-    - `mr`: Mauritania
-    - `mt`: Malta
-    - `mu`: Mauritius
-    - `mv`: Maldives
-    - `mw`: Malawi
-    - `mx`: Mexico
-    - `my`: Malaysia
-    - `mz`: Mozambique
-    - `na`: Namibia
-    - `ne`: Niger
-    - `ng`: Nigeria
-    - `ni`: Nicaragua
-    - `nl`: Netherlands
-    - `no`: Norway
-    - `np`: Nepal
-    - `nz`: New Zealand
-    - `om`: Oman
-    - `pa`: Panama
-    - `pe`: Peru
-    - `pg`: Papua New Guinea
-    - `ph`: Philippines
-    - `pk`: Pakistan
-    - `pl`: Poland
-    - `pr`: Puerto Rico
-    - `ps`: Palestine, State of
-    - `pt`: Portugal
-    - `py`: Paraguay
-    - `re`: Reunion
-    - `ro`: Romania
-    - `rs`: Serbia
-    - `ru`: Russian Federation
-    - `rw`: Rwanda
-    - `sa`: Saudi Arabia
-    - `sc`: Seychelles
-    - `sd`: Sudan
-    - `se`: Sweden
-    - `sg`: Singapore
-    - `sh`: Saint Helena, Ascension and Tristan da Cunha
-    - `si`: Slovenia
-    - `sk`: Slovakia
-    - `sl`: Sierra Leone
-    - `sm`: San Marino
-    - `sn`: Senegal
-    - `so`: Somalia
-    - `sr`: Suriname
-    - `st`: Sao Tome and Principe
-    - `sv`: El Salvador
-    - `sy`: Syrian Arab Republic
-    - `sz`: Swaziland
-    - `td`: Chad
-    - `tg`: Togo
-    - `th`: Thailand
-    - `tj`: Tajikistan
-    - `tl`: Timor-Leste
-    - `tm`: Turkmenistan
-    - `tn`: Tunisia
-    - `tr`: Turkey
-    - `tw`: Taiwan, Province of China
-    - `tz`: Tanzania, United Republic of
-    - `ua`: Ukraine
-    - `ug`: Uganda
-    - `us`: United States
-    - `uy`: Uruguay
-    - `uz`: Uzbekistan
-    - `va`: Holy See (Vatican City State)
-    - `ve`: Venezuela, Bolivarian Republic of
-    - `vn`: Viet Nam
-    - `ye`: Yemen
-    - `yt`: Mayotte
-    - `za`: South Africa
-    - `zm`: Zambia
-    - `zw`: Zimbabwe
-
-
-Country charts
---------------
-
-As of now, only France is available. As other country are implemented, this will be externalized in other packages.
-(Please submit pull requests :))
-
-French map
-~~~~~~~~~~
-
-Highlight some departments:
-
-
-.. pygal-code::
-
-  fr_chart = pygal.FrenchMap_Departments()
-  fr_chart.title = 'Some departments'
-  fr_chart.add('Métropole', ['69', '92', '13'])
-  fr_chart.add('Corse', ['2A', '2B'])
-  fr_chart.add('DOM COM', ['971', '972', '973', '974'])
-
-You can also specify an number for a department:
-
-.. pygal-code::
-
-  fr_chart = pygal.FrenchMap_Departments(human_readable=True)
-  fr_chart.title = 'Population by department'
-  fr_chart.add('In 2011', {
-    '01': 603827,
-    '02': 541302,
-    '03': 342729,
-    '04': 160959,
-    '05': 138605,
-    '06': 1081244,
-    '07': 317277,
-    '08': 283110,
-    '09': 152286,
-    '10': 303997,
-    '11': 359967,
-    '12': 275813,
-    '13': 1975896,
-    '14': 685262,
-    '15': 147577,
-    '16': 352705,
-    '17': 625682,
-    '18': 311694,
-    '19': 242454,
-    '2A': 145846,
-    '2B': 168640,
-    '21': 525931,
-    '22': 594375,
-    '23': 122560,
-    '24': 415168,
-    '25': 529103,
-    '26': 487993,
-    '27': 588111,
-    '28': 430416,
-    '29': 899870,
-    '30': 718357,
-    '31': 1260226,
-    '32': 188893,
-    '33': 1463662,
-    '34': 1062036,
-    '35': 996439,
-    '36': 230175,
-    '37': 593683,
-    '38': 1215212,
-    '39': 261294,
-    '40': 387929,
-    '41': 331280,
-    '42': 749053,
-    '43': 224907,
-    '44': 1296364,
-    '45': 659587,
-    '46': 174754,
-    '47': 330866,
-    '48': 77156,
-    '49': 790343,
-    '50': 499531,
-    '51': 566571,
-    '52': 182375,
-    '53': 307031,
-    '54': 733124,
-    '55': 193557,
-    '56': 727083,
-    '57': 1045146,
-    '58': 218341,
-    '59': 2579208,
-    '60': 805642,
-    '61': 290891,
-    '62': 1462807,
-    '63': 635469,
-    '64': 656608,
-    '65': 229228,
-    '66': 452530,
-    '67': 1099269,
-    '68': 753056,
-    '69': 1744236,
-    '70': 239695,
-    '71': 555999,
-    '72': 565718,
-    '73': 418949,
-    '74': 746994,
-    '75': 2249975,
-    '76': 1251282,
-    '77': 1338427,
-    '78': 1413635,
-    '79': 370939,
-    '80': 571211,
-    '81': 377675,
-    '82': 244545,
-    '83': 1012735,
-    '84': 546630,
-    '85': 641657,
-    '86': 428447,
-    '87': 376058,
-    '88': 378830,
-    '89': 342463,
-    '90': 143348,
-    '91': 1225191,
-    '92': 1581628,
-    '93': 1529928,
-    '94': 1333702,
-    '95': 1180365,
-    '971': 404635,
-    '972': 392291,
-    '973': 237549,
-    '974': 828581,
-    '976': 212645
-  })
-
-You can do the same with regions:
-
-
-.. pygal-code::
-
-  fr_chart = pygal.FrenchMap_Regions()
-  fr_chart.title = 'Some regions'
-  fr_chart.add('Métropole', ['82', '11', '93'])
-  fr_chart.add('Corse', ['94'])
-  fr_chart.add('DOM COM', ['01', '02', '03', '04'])
-
-
-You can also specify a number for a region and use a department to region aggregation:
-
-
-.. pygal-code::
-
-  from pygal.graph.frenchmap import aggregate_regions
-  fr_chart = pygal.FrenchMap_Regions(human_readable=True)
-  fr_chart.title = 'Population by region'
-  fr_chart.add('In 2011', aggregate_regions({
-    '01': 603827,
-    '02': 541302,
-    '03': 342729,
-    '04': 160959,
-    '05': 138605,
-    '06': 1081244,
-    '07': 317277,
-    '08': 283110,
-    '09': 152286,
-    '10': 303997,
-    '11': 359967,
-    '12': 275813,
-    '13': 1975896,
-    '14': 685262,
-    '15': 147577,
-    '16': 352705,
-    '17': 625682,
-    '18': 311694,
-    '19': 242454,
-    '2A': 145846,
-    '2B': 168640,
-    '21': 525931,
-    '22': 594375,
-    '23': 122560,
-    '24': 415168,
-    '25': 529103,
-    '26': 487993,
-    '27': 588111,
-    '28': 430416,
-    '29': 899870,
-    '30': 718357,
-    '31': 1260226,
-    '32': 188893,
-    '33': 1463662,
-    '34': 1062036,
-    '35': 996439,
-    '36': 230175,
-    '37': 593683,
-    '38': 1215212,
-    '39': 261294,
-    '40': 387929,
-    '41': 331280,
-    '42': 749053,
-    '43': 224907,
-    '44': 1296364,
-    '45': 659587,
-    '46': 174754,
-    '47': 330866,
-    '48': 77156,
-    '49': 790343,
-    '50': 499531,
-    '51': 566571,
-    '52': 182375,
-    '53': 307031,
-    '54': 733124,
-    '55': 193557,
-    '56': 727083,
-    '57': 1045146,
-    '58': 218341,
-    '59': 2579208,
-    '60': 805642,
-    '61': 290891,
-    '62': 1462807,
-    '63': 635469,
-    '64': 656608,
-    '65': 229228,
-    '66': 452530,
-    '67': 1099269,
-    '68': 753056,
-    '69': 1744236,
-    '70': 239695,
-    '71': 555999,
-    '72': 565718,
-    '73': 418949,
-    '74': 746994,
-    '75': 2249975,
-    '76': 1251282,
-    '77': 1338427,
-    '78': 1413635,
-    '79': 370939,
-    '80': 571211,
-    '81': 377675,
-    '82': 244545,
-    '83': 1012735,
-    '84': 546630,
-    '85': 641657,
-    '86': 428447,
-    '87': 376058,
-    '88': 378830,
-    '89': 342463,
-    '90': 143348,
-    '91': 1225191,
-    '92': 1581628,
-    '93': 1529928,
-    '94': 1333702,
-    '95': 1180365,
-    '971': 404635,
-    '972': 392291,
-    '973': 237549,
-    '974': 828581,
-    '976': 212645
-  }))
-

docs/documentation/index.rst

@@ -5,7 +5,7 @@ Documentation
    :maxdepth: 2
 
    first_steps
-   chart_types
+   types/index
    styles
    basic_customizations
    interpolations

docs/documentation/types/bar.rst

@@ -0,0 +1,49 @@
+Bar charts / Histograms
+-----------------------
+
+Basic
+~~~~~
+
+Basic simple bar graph:
+
+.. pygal-code::
+
+  line_chart = pygal.Bar()
+  line_chart.title = 'Browser usage evolution (in %)'
+  line_chart.x_labels = map(str, range(2002, 2013))
+  line_chart.add('Firefox', [None, None, 0, 16.6,   25,   31, 36.4, 45.5, 46.3, 42.8, 37.1])
+  line_chart.add('Chrome',  [None, None, None, None, None, None,    0,  3.9, 10.8, 23.8, 35.3])
+  line_chart.add('IE',      [85.8, 84.6, 84.7, 74.5,   66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1])
+  line_chart.add('Others',  [14.2, 15.4, 15.3,  8.9,    9, 10.4,  8.9,  5.8,  6.7,  6.8,  7.5])
+
+
+Stacked
+~~~~~~~
+
+Same graph but with stacked values:
+
+.. pygal-code::
+
+  line_chart = pygal.StackedBar()
+  line_chart.title = 'Browser usage evolution (in %)'
+  line_chart.x_labels = map(str, range(2002, 2013))
+  line_chart.add('Firefox', [None, None, 0, 16.6,   25,   31, 36.4, 45.5, 46.3, 42.8, 37.1])
+  line_chart.add('Chrome',  [None, None, None, None, None, None,    0,  3.9, 10.8, 23.8, 35.3])
+  line_chart.add('IE',      [85.8, 84.6, 84.7, 74.5,   66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1])
+  line_chart.add('Others',  [14.2, 15.4, 15.3,  8.9,    9, 10.4,  8.9,  5.8,  6.7,  6.8,  7.5])
+
+
+Horizontal
+~~~~~~~~~~
+
+Horizontal bar diagram:
+
+.. pygal-code::
+
+  line_chart = pygal.HorizontalBar()
+  line_chart.title = 'Browser usage in February 2012 (in %)'
+  line_chart.add('IE', 19.5)
+  line_chart.add('Firefox', 36.6)
+  line_chart.add('Chrome', 36.3)
+  line_chart.add('Safari', 4.5)
+  line_chart.add('Opera', 2.3)

docs/documentation/types/box.rst

@@ -0,0 +1,16 @@
+Box plot
+--------
+
+Basic
+~~~~~
+
+Here's some whiskers:
+
+.. pygal-code::
+
+  box_plot = pygal.Box()
+  box_plot.title = 'V8 benchmark results'
+  box_plot.add('Chrome', [6395, 8212, 7520, 7218, 12464, 1660, 2123, 8607])
+  box_plot.add('Firefox', [7473, 8099, 11700, 2651, 6361, 1044, 3797, 9450])
+  box_plot.add('Opera', [3472, 2933, 4203, 5229, 5810, 1828, 9013, 4669])
+  box_plot.add('IE', [43, 41, 59, 79, 144, 136, 34, 102])

docs/documentation/types/dot.rst

@@ -0,0 +1,17 @@
+Dot charts
+----------
+
+Basic
+~~~~~
+
+Punch card like chart:
+
+.. pygal-code::
+
+  dot_chart = pygal.Dot(x_label_rotation=30)
+  dot_chart.title = 'V8 benchmark results'
+  dot_chart.x_labels = ['Richards', 'DeltaBlue', 'Crypto', 'RayTrace', 'EarleyBoyer', 'RegExp', 'Splay', 'NavierStokes']
+  dot_chart.add('Chrome', [6395, 8212, 7520, 7218, 12464, 1660, 2123, 8607])
+  dot_chart.add('Firefox', [7473, 8099, 11700, 2651, 6361, 1044, 3797, 9450])
+  dot_chart.add('Opera', [3472, 2933, 4203, 5229, 5810, 1828, 9013, 4669])
+  dot_chart.add('IE', [43, 41, 59, 79, 144, 136, 34, 102])

docs/documentation/types/funnel.rst

@@ -0,0 +1,16 @@
+Funnel charts
+-------------
+
+Basic
+~~~~~
+
+Funnel chart:
+
+.. pygal-code::
+
+  funnel_chart = pygal.Funnel()
+  funnel_chart.title = 'V8 benchmark results'
+  funnel_chart.x_labels = ['Richards', 'DeltaBlue', 'Crypto', 'RayTrace', 'EarleyBoyer', 'RegExp', 'Splay', 'NavierStokes']
+  funnel_chart.add('Opera', [3472, 2933, 4203, 5229, 5810, 1828, 9013, 4669])
+  funnel_chart.add('Firefox', [7473, 8099, 11700, 2651, 6361, 1044, 3797, 9450])
+  funnel_chart.add('Chrome', [6395, 8212, 7520, 7218, 12464, 1660, 2123, 8607])

docs/documentation/types/gauge.rst

@@ -0,0 +1,18 @@
+Gauge charts
+------------
+
+Basic
+~~~~~
+
+Simple gauge chart:
+
+.. pygal-code::
+
+  gauge_chart = pygal.Gauge(human_readable=True)
+  gauge_chart.title = 'DeltaBlue V8 benchmark results'
+  gauge_chart.x_labels = ['Richards', 'DeltaBlue', 'Crypto', 'RayTrace', 'EarleyBoyer', 'RegExp', 'Splay', 'NavierStokes']
+  gauge_chart.range = [0, 10000]
+  gauge_chart.add('Chrome', 8212)
+  gauge_chart.add('Firefox', 8099)
+  gauge_chart.add('Opera', 2933)
+  gauge_chart.add('IE', 41)

docs/documentation/types/index.rst

@@ -0,0 +1,20 @@
+Chart types
+===========
+
+pygal provides various kinds of charts:
+
+.. toctree::
+   :maxdepth: 2
+
+   line
+   bar
+   xy
+   pie
+   radar
+   box
+   dot
+   funnel
+   gauge
+   pyramid
+   treemap
+   maps/index

docs/documentation/types/line.rst

@@ -0,0 +1,49 @@
+Line charts
+-----------
+
+Basic
+~~~~~
+
+Basic simple line graph:
+
+.. pygal-code::
+
+  line_chart = pygal.Line()
+  line_chart.title = 'Browser usage evolution (in %)'
+  line_chart.x_labels = map(str, range(2002, 2013))
+  line_chart.add('Firefox', [None, None,    0, 16.6,   25,   31, 36.4, 45.5, 46.3, 42.8, 37.1])
+  line_chart.add('Chrome',  [None, None, None, None, None, None,    0,  3.9, 10.8, 23.8, 35.3])
+  line_chart.add('IE',      [85.8, 84.6, 84.7, 74.5,   66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1])
+  line_chart.add('Others',  [14.2, 15.4, 15.3,  8.9,    9, 10.4,  8.9,  5.8,  6.7,  6.8,  7.5])
+
+Stacked
+~~~~~~~
+
+Same graph but with stacked values and filled rendering:
+
+.. pygal-code::
+
+  line_chart = pygal.StackedLine(fill=True)
+  line_chart.title = 'Browser usage evolution (in %)'
+  line_chart.x_labels = map(str, range(2002, 2013))
+  line_chart.add('Firefox', [None, None, 0, 16.6,   25,   31, 36.4, 45.5, 46.3, 42.8, 37.1])
+  line_chart.add('Chrome',  [None, None, None, None, None, None,    0,  3.9, 10.8, 23.8, 35.3])
+  line_chart.add('IE',      [85.8, 84.6, 84.7, 74.5,   66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1])
+  line_chart.add('Others',  [14.2, 15.4, 15.3,  8.9,    9, 10.4,  8.9,  5.8,  6.7,  6.8,  7.5])
+
+
+Time
+~~~~
+
+For time related plots, just format your labels or use `one variant of xy charts <xy.html#dates>`_:
+
+.. pygal-code::
+
+  from datetime import datetime, timedelta
+  date_chart = pygal.Line(x_label_rotation=20)
+  date_chart.x_labels = map(lambda d: d.strftime('%Y-%m-%d'), [
+   datetime(2013, 1, 2),
+   datetime(2013, 1, 12),
+   datetime(2013, 2, 2),
+   datetime(2013, 2, 22)])
+  date_chart.add("Visits", [300, 412, 823, 672])

docs/documentation/types/maps/index.rst

@@ -0,0 +1,491 @@
+Worldmap charts
+---------------
+
+Basic
+~~~~~
+
+Highlight some countries:
+
+.. pygal-code::
+
+  worldmap_chart = pygal.Worldmap()
+  worldmap_chart.title = 'Some countries'
+  worldmap_chart.add('F countries', ['fr', 'fi'])
+  worldmap_chart.add('M countries', ['ma', 'mc', 'md', 'me', 'mg',
+                                     'mk', 'ml', 'mm', 'mn', 'mo',
+                                     'mr', 'mt', 'mu', 'mv', 'mw',
+                                     'mx', 'my', 'mz'])
+  worldmap_chart.add('U countries', ['ua', 'ug', 'us', 'uy', 'uz'])
+
+
+You can also specify an number for a country:
+
+.. pygal-code::
+
+  worldmap_chart = pygal.Worldmap()
+  worldmap_chart.title = 'Minimum deaths by capital punishement (source: Amnesty International)'
+  worldmap_chart.add('In 2012', {
+    'af': 14,
+    'bd': 1,
+    'by': 3,
+    'cn': 1000,
+    'gm': 9,
+    'in': 1,
+    'ir': 314,
+    'iq': 129,
+    'jp': 7,
+    'kp': 6,
+    'pk': 1,
+    'ps': 6,
+    'sa': 79,
+    'so': 6,
+    'sd': 5,
+    'tw': 6,
+    'ae': 1,
+    'us': 43,
+    'ye': 28
+  })
+
+
+The following countries are supported:
+
+    - `ad`: Andorra
+    - `ae`: United Arab Emirates
+    - `af`: Afghanistan
+    - `al`: Albania
+    - `am`: Armenia
+    - `ao`: Angola
+    - `aq`: Antarctica
+    - `ar`: Argentina
+    - `at`: Austria
+    - `au`: Australia
+    - `az`: Azerbaijan
+    - `ba`: Bosnia and Herzegovina
+    - `bd`: Bangladesh
+    - `be`: Belgium
+    - `bf`: Burkina Faso
+    - `bg`: Bulgaria
+    - `bh`: Bahrain
+    - `bi`: Burundi
+    - `bj`: Benin
+    - `bn`: Brunei Darussalam
+    - `bo`: Bolivia, Plurinational State of
+    - `br`: Brazil
+    - `bt`: Bhutan
+    - `bw`: Botswana
+    - `by`: Belarus
+    - `bz`: Belize
+    - `ca`: Canada
+    - `cd`: Congo, the Democratic Republic of the
+    - `cf`: Central African Republic
+    - `cg`: Congo
+    - `ch`: Switzerland
+    - `ci`: Cote d'Ivoire
+    - `cl`: Chile
+    - `cm`: Cameroon
+    - `cn`: China
+    - `co`: Colombia
+    - `cr`: Costa Rica
+    - `cu`: Cuba
+    - `cv`: Cape Verde
+    - `cy`: Cyprus
+    - `cz`: Czech Republic
+    - `de`: Germany
+    - `dj`: Djibouti
+    - `dk`: Denmark
+    - `do`: Dominican Republic
+    - `dz`: Algeria
+    - `ec`: Ecuador
+    - `ee`: Estonia
+    - `eg`: Egypt
+    - `eh`: Western Sahara
+    - `er`: Eritrea
+    - `es`: Spain
+    - `et`: Ethiopia
+    - `fi`: Finland
+    - `fr`: France
+    - `ga`: Gabon
+    - `gb`: United Kingdom
+    - `ge`: Georgia
+    - `gf`: French Guiana
+    - `gh`: Ghana
+    - `gl`: Greenland
+    - `gm`: Gambia
+    - `gn`: Guinea
+    - `gq`: Equatorial Guinea
+    - `gr`: Greece
+    - `gt`: Guatemala
+    - `gu`: Guam
+    - `gw`: Guinea-Bissau
+    - `gy`: Guyana
+    - `hk`: Hong Kong
+    - `hn`: Honduras
+    - `hr`: Croatia
+    - `ht`: Haiti
+    - `hu`: Hungary
+    - `id`: Indonesia
+    - `ie`: Ireland
+    - `il`: Israel
+    - `in`: India
+    - `iq`: Iraq
+    - `ir`: Iran, Islamic Republic of
+    - `is`: Iceland
+    - `it`: Italy
+    - `jm`: Jamaica
+    - `jo`: Jordan
+    - `jp`: Japan
+    - `ke`: Kenya
+    - `kg`: Kyrgyzstan
+    - `kh`: Cambodia
+    - `kp`: Korea, Democratic People's Republic of
+    - `kr`: Korea, Republic of
+    - `kw`: Kuwait
+    - `kz`: Kazakhstan
+    - `la`: Lao People's Democratic Republic
+    - `lb`: Lebanon
+    - `li`: Liechtenstein
+    - `lk`: Sri Lanka
+    - `lr`: Liberia
+    - `ls`: Lesotho
+    - `lt`: Lithuania
+    - `lu`: Luxembourg
+    - `lv`: Latvia
+    - `ly`: Libyan Arab Jamahiriya
+    - `ma`: Morocco
+    - `mc`: Monaco
+    - `md`: Moldova, Republic of
+    - `me`: Montenegro
+    - `mg`: Madagascar
+    - `mk`: Macedonia, the former Yugoslav Republic of
+    - `ml`: Mali
+    - `mm`: Myanmar
+    - `mn`: Mongolia
+    - `mo`: Macao
+    - `mr`: Mauritania
+    - `mt`: Malta
+    - `mu`: Mauritius
+    - `mv`: Maldives
+    - `mw`: Malawi
+    - `mx`: Mexico
+    - `my`: Malaysia
+    - `mz`: Mozambique
+    - `na`: Namibia
+    - `ne`: Niger
+    - `ng`: Nigeria
+    - `ni`: Nicaragua
+    - `nl`: Netherlands
+    - `no`: Norway
+    - `np`: Nepal
+    - `nz`: New Zealand
+    - `om`: Oman
+    - `pa`: Panama
+    - `pe`: Peru
+    - `pg`: Papua New Guinea
+    - `ph`: Philippines
+    - `pk`: Pakistan
+    - `pl`: Poland
+    - `pr`: Puerto Rico
+    - `ps`: Palestine, State of
+    - `pt`: Portugal
+    - `py`: Paraguay
+    - `re`: Reunion
+    - `ro`: Romania
+    - `rs`: Serbia
+    - `ru`: Russian Federation
+    - `rw`: Rwanda
+    - `sa`: Saudi Arabia
+    - `sc`: Seychelles
+    - `sd`: Sudan
+    - `se`: Sweden
+    - `sg`: Singapore
+    - `sh`: Saint Helena, Ascension and Tristan da Cunha
+    - `si`: Slovenia
+    - `sk`: Slovakia
+    - `sl`: Sierra Leone
+    - `sm`: San Marino
+    - `sn`: Senegal
+    - `so`: Somalia
+    - `sr`: Suriname
+    - `st`: Sao Tome and Principe
+    - `sv`: El Salvador
+    - `sy`: Syrian Arab Republic
+    - `sz`: Swaziland
+    - `td`: Chad
+    - `tg`: Togo
+    - `th`: Thailand
+    - `tj`: Tajikistan
+    - `tl`: Timor-Leste
+    - `tm`: Turkmenistan
+    - `tn`: Tunisia
+    - `tr`: Turkey
+    - `tw`: Taiwan, Province of China
+    - `tz`: Tanzania, United Republic of
+    - `ua`: Ukraine
+    - `ug`: Uganda
+    - `us`: United States
+    - `uy`: Uruguay
+    - `uz`: Uzbekistan
+    - `va`: Holy See (Vatican City State)
+    - `ve`: Venezuela, Bolivarian Republic of
+    - `vn`: Viet Nam
+    - `ye`: Yemen
+    - `yt`: Mayotte
+    - `za`: South Africa
+    - `zm`: Zambia
+    - `zw`: Zimbabwe
+
+
+Country charts
+--------------
+
+As of now, only France is available. As other country are implemented, this will be externalized in other packages.
+(Please submit pull requests :))
+
+French map
+~~~~~~~~~~
+
+Highlight some departments:
+
+
+.. pygal-code::
+
+  fr_chart = pygal.FrenchMap_Departments()
+  fr_chart.title = 'Some departments'
+  fr_chart.add('Métropole', ['69', '92', '13'])
+  fr_chart.add('Corse', ['2A', '2B'])
+  fr_chart.add('DOM COM', ['971', '972', '973', '974'])
+
+You can also specify an number for a department:
+
+.. pygal-code::
+
+  fr_chart = pygal.FrenchMap_Departments(human_readable=True)
+  fr_chart.title = 'Population by department'
+  fr_chart.add('In 2011', {
+    '01': 603827,
+    '02': 541302,
+    '03': 342729,
+    '04': 160959,
+    '05': 138605,
+    '06': 1081244,
+    '07': 317277,
+    '08': 283110,
+    '09': 152286,
+    '10': 303997,
+    '11': 359967,
+    '12': 275813,
+    '13': 1975896,
+    '14': 685262,
+    '15': 147577,
+    '16': 352705,
+    '17': 625682,
+    '18': 311694,
+    '19': 242454,
+    '2A': 145846,
+    '2B': 168640,
+    '21': 525931,
+    '22': 594375,
+    '23': 122560,
+    '24': 415168,
+    '25': 529103,
+    '26': 487993,
+    '27': 588111,
+    '28': 430416,
+    '29': 899870,
+    '30': 718357,
+    '31': 1260226,
+    '32': 188893,
+    '33': 1463662,
+    '34': 1062036,
+    '35': 996439,
+    '36': 230175,
+    '37': 593683,
+    '38': 1215212,
+    '39': 261294,
+    '40': 387929,
+    '41': 331280,
+    '42': 749053,
+    '43': 224907,
+    '44': 1296364,
+    '45': 659587,
+    '46': 174754,
+    '47': 330866,
+    '48': 77156,
+    '49': 790343,
+    '50': 499531,
+    '51': 566571,
+    '52': 182375,
+    '53': 307031,
+    '54': 733124,
+    '55': 193557,
+    '56': 727083,
+    '57': 1045146,
+    '58': 218341,
+    '59': 2579208,
+    '60': 805642,
+    '61': 290891,
+    '62': 1462807,
+    '63': 635469,
+    '64': 656608,
+    '65': 229228,
+    '66': 452530,
+    '67': 1099269,
+    '68': 753056,
+    '69': 1744236,
+    '70': 239695,
+    '71': 555999,
+    '72': 565718,
+    '73': 418949,
+    '74': 746994,
+    '75': 2249975,
+    '76': 1251282,
+    '77': 1338427,
+    '78': 1413635,
+    '79': 370939,
+    '80': 571211,
+    '81': 377675,
+    '82': 244545,
+    '83': 1012735,
+    '84': 546630,
+    '85': 641657,
+    '86': 428447,
+    '87': 376058,
+    '88': 378830,
+    '89': 342463,
+    '90': 143348,
+    '91': 1225191,
+    '92': 1581628,
+    '93': 1529928,
+    '94': 1333702,
+    '95': 1180365,
+    '971': 404635,
+    '972': 392291,
+    '973': 237549,
+    '974': 828581,
+    '976': 212645
+  })
+
+You can do the same with regions:
+
+
+.. pygal-code::
+
+  fr_chart = pygal.FrenchMap_Regions()
+  fr_chart.title = 'Some regions'
+  fr_chart.add('Métropole', ['82', '11', '93'])
+  fr_chart.add('Corse', ['94'])
+  fr_chart.add('DOM COM', ['01', '02', '03', '04'])
+
+
+You can also specify a number for a region and use a department to region aggregation:
+
+
+.. pygal-code::
+
+  from pygal.graph.frenchmap import aggregate_regions
+  fr_chart = pygal.FrenchMap_Regions(human_readable=True)
+  fr_chart.title = 'Population by region'
+  fr_chart.add('In 2011', aggregate_regions({
+    '01': 603827,
+    '02': 541302,
+    '03': 342729,
+    '04': 160959,
+    '05': 138605,
+    '06': 1081244,
+    '07': 317277,
+    '08': 283110,
+    '09': 152286,
+    '10': 303997,
+    '11': 359967,
+    '12': 275813,
+    '13': 1975896,
+    '14': 685262,
+    '15': 147577,
+    '16': 352705,
+    '17': 625682,
+    '18': 311694,
+    '19': 242454,
+    '2A': 145846,
+    '2B': 168640,
+    '21': 525931,
+    '22': 594375,
+    '23': 122560,
+    '24': 415168,
+    '25': 529103,
+    '26': 487993,
+    '27': 588111,
+    '28': 430416,
+    '29': 899870,
+    '30': 718357,
+    '31': 1260226,
+    '32': 188893,
+    '33': 1463662,
+    '34': 1062036,
+    '35': 996439,
+    '36': 230175,
+    '37': 593683,
+    '38': 1215212,
+    '39': 261294,
+    '40': 387929,
+    '41': 331280,
+    '42': 749053,
+    '43': 224907,
+    '44': 1296364,
+    '45': 659587,
+    '46': 174754,
+    '47': 330866,
+    '48': 77156,
+    '49': 790343,
+    '50': 499531,
+    '51': 566571,
+    '52': 182375,
+    '53': 307031,
+    '54': 733124,
+    '55': 193557,
+    '56': 727083,
+    '57': 1045146,
+    '58': 218341,
+    '59': 2579208,
+    '60': 805642,
+    '61': 290891,
+    '62': 1462807,
+    '63': 635469,
+    '64': 656608,
+    '65': 229228,
+    '66': 452530,
+    '67': 1099269,
+    '68': 753056,
+    '69': 1744236,
+    '70': 239695,
+    '71': 555999,
+    '72': 565718,
+    '73': 418949,
+    '74': 746994,
+    '75': 2249975,
+    '76': 1251282,
+    '77': 1338427,
+    '78': 1413635,
+    '79': 370939,
+    '80': 571211,
+    '81': 377675,
+    '82': 244545,
+    '83': 1012735,
+    '84': 546630,
+    '85': 641657,
+    '86': 428447,
+    '87': 376058,
+    '88': 378830,
+    '89': 342463,
+    '90': 143348,
+    '91': 1225191,
+    '92': 1581628,
+    '93': 1529928,
+    '94': 1333702,
+    '95': 1180365,
+    '971': 404635,
+    '972': 392291,
+    '973': 237549,
+    '974': 828581,
+    '976': 212645
+  }))
+

docs/documentation/types/pie.rst

@@ -0,0 +1,34 @@
+Pie
+---
+
+Basic
+~~~~~
+
+Simple pie:
+
+
+.. pygal-code::
+
+  pie_chart = pygal.Pie()
+  pie_chart.title = 'Browser usage in February 2012 (in %)'
+  pie_chart.add('IE', 19.5)
+  pie_chart.add('Firefox', 36.6)
+  pie_chart.add('Chrome', 36.3)
+  pie_chart.add('Safari', 4.5)
+  pie_chart.add('Opera', 2.3)
+
+
+Multi-series pie
+~~~~~~~~~~~~~~~~
+
+Same pie but divided in sub category:
+
+.. pygal-code::
+
+  pie_chart = pygal.Pie()
+  pie_chart.title = 'Browser usage by version in February 2012 (in %)'
+  pie_chart.add('IE', [5.7, 10.2, 2.6, 1])
+  pie_chart.add('Firefox', [.6, 16.8, 7.4, 2.2, 1.2, 1, 1, 1.1, 4.3, 1])
+  pie_chart.add('Chrome', [.3, .9, 17.1, 15.3, .6, .5, 1.6])
+  pie_chart.add('Safari', [4.4, .1])
+  pie_chart.add('Opera', [.1, 1.6, .1, .5])

docs/documentation/types/pyramid.rst

@@ -0,0 +1,29 @@
+Pyramid charts
+--------------
+
+Basic
+~~~~~
+
+Population pyramid:
+
+.. pygal-code:: 600 600
+
+  ages = [(364381, 358443, 360172, 345848, 334895, 326914, 323053, 312576, 302015, 301277, 309874, 318295, 323396, 332736, 330759, 335267, 345096, 352685, 368067, 381521, 380145, 378724, 388045, 382303, 373469, 365184, 342869, 316928, 285137, 273553, 250861, 221358, 195884, 179321, 171010, 162594, 152221, 148843, 143013, 135887, 125824, 121493, 115913, 113738, 105612, 99596, 91609, 83917, 75688, 69538, 62999, 58864, 54593, 48818, 44739, 41096, 39169, 36321, 34284, 32330, 31437, 30661, 31332, 30334, 23600, 21999, 20187, 19075, 16574, 15091, 14977, 14171, 13687, 13155, 12558, 11600, 10827, 10436, 9851, 9794, 8787, 7993, 6901, 6422, 5506, 4839, 4144, 3433, 2936, 2615),
+     (346205, 340570, 342668, 328475, 319010, 312898, 308153, 296752, 289639, 290466, 296190, 303871, 309886, 317436, 315487, 316696, 325772, 331694, 345815, 354696, 354899, 351727, 354579, 341702, 336421, 321116, 292261, 261874, 242407, 229488, 208939, 184147, 162662, 147361, 140424, 134336, 126929, 125404, 122764, 116004, 105590, 100813, 95021, 90950, 85036, 79391, 72952, 66022, 59326, 52716, 46582, 42772, 38509, 34048, 30887, 28053, 26152, 23931, 22039, 20677, 19869, 19026, 18757, 18308, 14458, 13685, 12942, 12323, 11033, 10183, 10628, 10803, 10655, 10482, 10202, 10166, 9939, 10138, 10007, 10174, 9997, 9465, 9028, 8806, 8450, 7941, 7253, 6698, 6267, 5773),
+     (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 23, 91, 412, 1319, 2984, 5816, 10053, 16045, 24240, 35066, 47828, 62384, 78916, 97822, 112738, 124414, 130658, 140789, 153951, 168560, 179996, 194471, 212006, 225209, 228886, 239690, 245974, 253459, 255455, 260715, 259980, 256481, 252222, 249467, 240268, 238465, 238167, 231361, 223832, 220459, 222512, 220099, 219301, 221322, 229783, 239336, 258360, 271151, 218063, 213461, 207617, 196227, 174615, 160855, 165410, 163070, 157379, 149698, 140570, 131785, 119936, 113751, 106989, 99294, 89097, 78413, 68174, 60592, 52189, 43375, 35469, 29648, 24575, 20863),
+     (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 74, 392, 1351, 3906, 7847, 12857, 19913, 29108, 42475, 58287, 74163, 90724, 108375, 125886, 141559, 148061, 152871, 159725, 171298, 183536, 196136, 210831, 228757, 238731, 239616, 250036, 251759, 259593, 261832, 264864, 264702, 264070, 258117, 253678, 245440, 241342, 239843, 232493, 226118, 221644, 223440, 219833, 219659, 221271, 227123, 232865, 250646, 261796, 210136, 201824, 193109, 181831, 159280, 145235, 145929, 140266, 133082, 124350, 114441, 104655, 93223, 85899, 78800, 72081, 62645, 53214, 44086, 38481, 32219, 26867, 21443, 16899, 13680, 11508),
+     (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 7, 5, 17, 15, 31, 34, 38, 35, 45, 299, 295, 218, 247, 252, 254, 222, 307, 316, 385, 416, 463, 557, 670, 830, 889, 1025, 1149, 1356, 1488, 1835, 1929, 2130, 2362, 2494, 2884, 3160, 3487, 3916, 4196, 4619, 5032, 5709, 6347, 7288, 8139, 9344, 11002, 12809, 11504, 11918, 12927, 13642, 13298, 14015, 15751, 17445, 18591, 19682, 20969, 21629, 22549, 23619, 25288, 26293, 27038, 27039, 27070, 27750, 27244, 25905, 24357, 22561, 21794, 20595),
+     (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 6, 8, 0, 8, 21, 34, 49, 84, 97, 368, 401, 414, 557, 654, 631, 689, 698, 858, 1031, 1120, 1263, 1614, 1882, 2137, 2516, 2923, 3132, 3741, 4259, 4930, 5320, 5948, 6548, 7463, 8309, 9142, 10321, 11167, 12062, 13317, 15238, 16706, 18236, 20336, 23407, 27024, 32502, 37334, 34454, 38080, 41811, 44490, 45247, 46830, 53616, 58798, 63224, 66841, 71086, 73654, 77334, 82062, 87314, 92207, 94603, 94113, 92753, 93174, 91812, 87757, 84255, 79723, 77536, 74173),
+     (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 5, 0, 11, 35, 137, 331, 803, 1580, 2361, 3632, 4866, 6849, 8754, 10422, 12316, 14152, 16911, 19788, 22822, 27329, 31547, 35711, 38932, 42956, 46466, 49983, 52885, 55178, 56549, 57632, 57770, 57427, 56348, 55593, 55554, 53266, 51084, 49342, 48555, 47067, 45789, 44988, 44624, 44238, 46267, 46203, 36964, 33866, 31701, 28770, 25174, 22702, 21934, 20638, 19051, 17073, 15381, 13736, 11690, 10368, 9350, 8375, 7063, 6006, 5044, 4030, 3420, 2612, 2006, 1709, 1264, 1018),
+     (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 4, 6, 11, 20, 68, 179, 480, 1077, 2094, 3581, 5151, 7047, 9590, 12434, 15039, 17257, 19098, 21324, 24453, 27813, 32316, 37281, 43597, 49647, 53559, 58888, 62375, 67219, 70956, 73547, 74904, 75994, 76224, 74979, 72064, 70330, 68944, 66527, 63073, 60899, 60968, 58756, 57647, 56301, 57246, 57068, 59027, 59187, 47549, 44425, 40976, 38077, 32904, 29431, 29491, 28020, 26086, 24069, 21742, 19498, 17400, 15738, 14451, 13107, 11568, 10171, 8530, 7273, 6488, 5372, 4499, 3691, 3259, 2657)]
+
+  types = ['Males single', 'Females single',
+           'Males married', 'Females married',
+           'Males widowed', 'Females widowed',
+           'Males divorced', 'Females divorced']
+
+  pyramid_chart = pygal.Pyramid(human_readable=True, legend_at_bottom=True)
+  pyramid_chart.title = 'England population by age in 2010 (source: ons.gov.uk)'
+  pyramid_chart.x_labels = map(lambda x: str(x) if not x % 5 else '', range(90))
+  for type, age in zip(types, ages):
+      pyramid_chart.add(type, age)

docs/documentation/types/radar.rst

@@ -0,0 +1,17 @@
+Radar charts
+------------
+
+Basic
+~~~~~
+
+Simple Kiviat diagram:
+
+.. pygal-code::
+
+  radar_chart = pygal.Radar()
+  radar_chart.title = 'V8 benchmark results'
+  radar_chart.x_labels = ['Richards', 'DeltaBlue', 'Crypto', 'RayTrace', 'EarleyBoyer', 'RegExp', 'Splay', 'NavierStokes']
+  radar_chart.add('Chrome', [6395, 8212, 7520, 7218, 12464, 1660, 2123, 8607])
+  radar_chart.add('Firefox', [7473, 8099, 11700, 2651, 6361, 1044, 3797, 9450])
+  radar_chart.add('Opera', [3472, 2933, 4203, 5229, 5810, 1828, 9013, 4669])
+  radar_chart.add('IE', [43, 41, 59, 79, 144, 136, 34, 102])

docs/documentation/types/treemap.rst

@@ -0,0 +1,21 @@
+Treemap
+-------
+
+Basic
+~~~~~
+
+Treemap:
+
+.. pygal-code::
+
+  treemap = pygal.Treemap()
+  treemap.title = 'Binary TreeMap'
+  treemap.add('A', [2, 1, 12, 4, 2, 1, 1, 3, 12, 3, 4, None, 9])
+  treemap.add('B', [4, 2, 5, 10, 3, 4, 2, 7, 4, -10, None, 8, 3, 1])
+  treemap.add('C', [3, 8, 3, 3, 5, 3, 3, 5, 4, 12])
+  treemap.add('D', [23, 18])
+  treemap.add('E', [1, 2, 1, 2, 3, 3, 1, 2, 3,
+        4, 3, 1, 2, 1, 1, 1, 1, 1])
+  treemap.add('F', [31])
+  treemap.add('G', [5, 9.3, 8.1, 12, 4, 3, 2])
+  treemap.add('H', [12, 3, 3])

docs/documentation/types/xy.rst

@@ -0,0 +1,111 @@
+XY charts
+---------
+
+Basic
+~~~~~
+
+Basic XY lines, drawing cosinus:
+
+.. pygal-code::
+
+  from math import cos
+  xy_chart = pygal.XY()
+  xy_chart.title = 'XY Cosinus'
+  xy_chart.add('x = cos(y)', [(cos(x / 10.), x / 10.) for x in range(-50, 50, 5)])
+  xy_chart.add('y = cos(x)', [(x / 10., cos(x / 10.)) for x in range(-50, 50, 5)])
+  xy_chart.add('x = 1',  [(1, -5), (1, 5)])
+  xy_chart.add('x = -1', [(-1, -5), (-1, 5)])
+  xy_chart.add('y = 1',  [(-5, 1), (5, 1)])
+  xy_chart.add('y = -1', [(-5, -1), (5, -1)])
+
+
+Scatter Plot
+~~~~~~~~~~~~
+
+Disabling stroke make a good scatter plot
+
+.. pygal-code::
+
+  xy_chart = pygal.XY(stroke=False)
+  xy_chart.title = 'Correlation'
+  xy_chart.add('A', [(0, 0), (.1, .2), (.3, .1), (.5, 1), (.8, .6), (1, 1.08), (1.3, 1.1), (2, 3.23), (2.43, 2)])
+  xy_chart.add('B', [(.1, .15), (.12, .23), (.4, .3), (.6, .4), (.21, .21), (.5, .3), (.6, .8), (.7, .8)])
+  xy_chart.add('C', [(.05, .01), (.13, .02), (1.5, 1.7), (1.52, 1.6), (1.8, 1.63), (1.5, 1.82), (1.7, 1.23), (2.1, 2.23), (2.3, 1.98)])
+
+
+Dates
+~~~~~
+
+You can use these helpers to plot date related charts:
+
+DateTime
+++++++++
+
+.. pygal-code::
+
+  from datetime import datetime
+  datetimeline = pygal.DateTimeLine(
+      x_label_rotation=35, truncate_label=-1,
+      x_value_formatter=lambda dt: dt.strftime('%d, %b %Y at %I:%M:%S %p'))
+  datetimeline.add("Serie", [
+      (datetime(2013, 1, 2, 12, 0), 300),
+      (datetime(2013, 1, 12, 14, 30, 45), 412),
+      (datetime(2013, 2, 2, 6), 823),
+      (datetime(2013, 2, 22, 9, 45), 672)
+  ])
+
+
+Date
+++++
+
+.. pygal-code::
+
+  from datetime import date
+  dateline = pygal.DateLine(x_label_rotation=25)
+  dateline.x_labels = [
+      date(2013, 1, 1),
+      date(2013, 7, 1),
+      date(2014, 1, 1),
+      date(2014, 7, 1),
+      date(2015, 1, 1),
+      date(2015, 7, 1)
+  ]
+  dateline.add("Serie", [
+      (date(2013, 1, 2), 213),
+      (date(2013, 8, 2), 281),
+      (date(2014, 12, 7), 198),
+      (date(2015, 3, 21), 120)
+  ])
+
+
+Time
+++++
+
+.. pygal-code::
+
+  from datetime import time
+  dateline = pygal.TimeLine(x_label_rotation=25)
+  dateline.add("Serie", [
+    (time(), 0),
+    (time(6), 5),
+    (time(8, 30), 12),
+    (time(11, 59, 59), 4),
+    (time(18), 10),
+    (time(23, 30), -1),
+  ])
+
+
+TimeDelta
++++++++++
+
+.. pygal-code::
+
+  from datetime import timedelta
+  dateline = pygal.TimeDeltaLine(x_label_rotation=25)
+  dateline.add("Serie", [
+    (timedelta(), 0),
+    (timedelta(seconds=6), 5),
+    (timedelta(minutes=11, seconds=59), 4),
+    (timedelta(days=3, microseconds=30), 12),
+    (timedelta(weeks=1), 10),
+  ])

docs/ext/pygal_sphinx_directives.py

@@ -19,7 +19,7 @@
 
 
 from docutils.parsers.rst import Directive
-from traceback import format_exc
+from traceback import format_exc, print_exc
 from sphinx.directives.code import CodeBlock
 
 import base64
@@ -52,6 +52,7 @@ class PygalDirective(Directive):
         try:
             exec(code, scope)
         except Exception:
+            print_exc()
             return [docutils.nodes.system_message(
                 'An exception as occured during code parsing:'
                 ' \n %s' % format_exc(), type='ERROR', source='/',

docs/installing.rst

@@ -29,7 +29,7 @@ Pygal has been packaged for:
 
 - `Fedora <https://admin.fedoraproject.org/pkgdb/acls/name/python-pygal>`_
 - `Gentoo <http://packages.gentoo.org/package/dev-python/pygal>`_
-- `Ubuntu <https://launchpad.net/ubuntu/+source/python-pygal`_
+- `Ubuntu <https://launchpad.net/ubuntu/+source/python-pygal>`_
 - `Debian <https://packages.debian.org/unstable/python-pygal>`_
 - `Arch Linux <https://aur.archlinux.org/packages/python-pygal/>`_
 

pygal/config.py

@@ -400,11 +400,13 @@ class Config(CommonConfig):
 
     truncate_legend = Key(
         None, int, "Text",
-        "Legend string length truncation threshold", "None = auto")
+        "Legend string length truncation threshold",
+        "None = auto, Negative for none")
 
     truncate_label = Key(
         None, int, "Text",
-        "Label string length truncation threshold", "None = auto")
+        "Label string length truncation threshold",
+        "None = auto, Negative for none")
 
     # Misc #
     js = Key(

pygal/graph/base.py

@@ -107,9 +107,17 @@ class BaseGraph(object):
             adapters = adapters + [positive, not_zero]
         adapters = adapters + [decimal_to_float]
         adapter = reduce(compose, adapters) if not self.strict else ident
+
+        if adapter and self.y_labels:
+            self.y_labels = list(map(adapter, self.y_labels))
+
         x_adapter = reduce(
             compose, self._x_adapters) if getattr(
                 self, '_x_adapters', None) else None
+
+        if x_adapter and self.x_labels:
+            self.x_labels = list(map(x_adapter, self.x_labels))
+
         series = []
 
         raw = [(
@@ -131,7 +139,7 @@ class BaseGraph(object):
                 else:
                     value_list = [None] * width
                     for k, v in raw_values.items():
-                        if k in self.x_labels:
+                        if k in (self.x_labels or []):
                             value_list[self.x_labels.index(k)] = v
                     raw_values = value_list
 
@@ -181,7 +189,7 @@ class BaseGraph(object):
         """Init the graph"""
         # Keep labels in case of map
         if getattr(self, 'x_labels', None) is not None:
-            self.x_labels = list(map(to_unicode, self.x_labels))
+            self.x_labels = list(self.x_labels)
         if getattr(self, 'y_labels', None) is not None:
             self.y_labels = list(self.y_labels)
         self.state = State(self, **kwargs)

pygal/graph/line.py

@@ -159,6 +159,10 @@ class Line(Graph):
             self._box.ymin = self._min
             self._box.ymax = self._max
 
+        if self.y_labels:
+            self._box.ymin = min(self._box.ymin, min(self.y_labels))
+            self._box.ymax = max(self._box.ymax, max(self.y_labels))
+
         y_pos = compute_scale(
             self._box.ymin, self._box.ymax, self.logarithmic, self.order_min
         ) if not self.y_labels else list(map(float, self.y_labels))

pygal/graph/time.py

@@ -19,7 +19,7 @@
 """
 Various datetime line plot
 """
-
+from pygal.adapters import positive
 from pygal.graph.xy import XY
 from datetime import datetime, date, time, timedelta
 from pygal._compat import timestamp, total_seconds
@@ -31,6 +31,12 @@ def datetime_to_timestamp(x):
     return x
 
 
+def datetime_to_time(x):
+    if isinstance(x, datetime):
+        return x.time()
+    return x
+
+
 def date_to_datetime(x):
     if not isinstance(x, datetime) and isinstance(x, date):
         return datetime.combine(x, time())
@@ -49,6 +55,26 @@ def timedelta_to_seconds(x):
     return x
 
 
+def time_to_seconds(x):
+    if isinstance(x, time):
+        return ((
+            ((x.hour * 60) + x.minute) * 60 + x.second
+        ) * 10 ** 6 + x.microsecond) / 10 ** 6
+    return x
+
+
+def seconds_to_time(x):
+    t = int(x * 10 ** 6)
+    ms = t % 10 ** 6
+    t = t // 10 ** 6
+    s = t % 60
+    t = t // 60
+    m = t % 60
+    t = t // 60
+    h = t
+    return time(h, m, s, ms)
+
+
 class DateTimeLine(XY):
     _x_adapters = [datetime_to_timestamp, date_to_datetime]
 
@@ -77,13 +103,13 @@ class DateLine(DateTimeLine):
 
 
 class TimeLine(DateTimeLine):
-    _x_adapters = [datetime_to_timestamp, time_to_datetime]
+    _x_adapters = [positive, time_to_seconds, datetime_to_time]
 
     @property
     def _x_format(self):
         """Return the value formatter for this graph"""
         def date_to_str(x):
-            t = datetime.fromtimestamp(x).time()
+            t = seconds_to_time(x)
             if self.x_value_formatter:
                 return self.x_value_formatter(t)
             return t.isoformat()

pygal/graph/xy.py

@@ -32,6 +32,10 @@ class XY(Line):
     _dual = True
     _x_adapters = []
 
+    def _get_value(self, values, i):
+        vals = values[i]
+        return '%s: %s' % (self._x_format(vals[0]), self._format(vals[1]))
+
     @cached_property
     def xvals(self):
         return [val[0]
@@ -116,14 +120,25 @@ class XY(Line):
 
         if xrng:
             self._box.xmin, self._box.xmax = xmin, xmax
+
+        if self.x_labels:
+            self._box.xmin = min(self.x_labels)
+            self._box.xmax = max(self.x_labels)
+
         if yrng:
             self._box.ymin, self._box.ymax = ymin, ymax
 
+        if self.y_labels:
+            self._box.ymin = min(self.y_labels)
+            self._box.ymax = max(self.y_labels)
+
         x_pos = compute_scale(
-            self._box.xmin, self._box.xmax, self.logarithmic,
-            self.order_min)
+            self._box.xmin, self._box.xmax, self.logarithmic, self.order_min
+        ) if not self.x_labels else list(map(float, self.x_labels))
+
         y_pos = compute_scale(
-            self._box.ymin, self._box.ymax, self.logarithmic, self.order_min)
+            self._box.ymin, self._box.ymax, self.logarithmic, self.order_min
+        ) if not self.y_labels else list(map(float, self.y_labels))
 
         self._x_labels = list(zip(map(self._x_format, x_pos), x_pos))
         self._y_labels = list(zip(map(self._format, y_pos), y_pos))

pygal/test/test_config.py

@@ -330,7 +330,8 @@ def test_label_rotation(Chart):
     chart = Chart(x_label_rotation=28, y_label_rotation=76)
     chart.add('1', [4, -5, 123, 59, 38])
     chart.add('2', [89, 0, 8, .12, 8])
-    chart.x_labels = ['one', 'twoooooooooooooooooooooo', 'three', '4']
+    if not chart._dual:
+        chart.x_labels = ['one', 'twoooooooooooooooooooooo', 'three', '4']
     q = chart.render_pyquery()
     if Chart in (Line, Bar):
         assert len(q('.axis.x text[transform^="rotate(28"]')) == 4
@@ -341,7 +342,6 @@ def test_legend_at_bottom(Chart):
     chart = Chart(legend_at_bottom=True)
     chart.add('1', [4, -5, 123, 59, 38])
     chart.add('2', [89, 0, 8, .12, 8])
-    chart.x_labels = ['one', 'twoooooooooooooooooooooo', 'three', '4']
     lab = chart.render()
     chart.legend_at_bottom = False
     assert lab != chart.render()
@@ -353,7 +353,6 @@ def test_x_y_title(Chart):
                   y_title="I am a y title")
     chart.add('1', [4, -5, 123, 59, 38])
     chart.add('2', [89, 0, 8, .12, 8])
-    chart.x_labels = ['one', 'twoooooooooooooooooooooo', 'three', '4']
     q = chart.render_pyquery()
     assert len(q('.titles .title')) == 3
 
@@ -363,7 +362,7 @@ def test_x_label_major(Chart):
             Pie, Treemap, Funnel, Dot, Gauge, Histogram, Box,
             Pyramid, DateTimeLine, TimeLine, DateLine,
             TimeDeltaLine
-    ) or issubclass(Chart, BaseMap):
+    ) or issubclass(Chart, BaseMap) or Chart._dual:
         return
     chart = Chart()
     chart.add('test', range(12))

pygal/test/test_date.py

@@ -19,7 +19,6 @@
 from pygal import DateLine, TimeLine, DateTimeLine, TimeDeltaLine
 from pygal.test.utils import texts
 from datetime import datetime, date, time, timedelta
-import sys
 
 
 def test_date():
@@ -36,11 +35,18 @@ def test_date():
     assert list(
         map(lambda t: t.split(' ')[0],
             q(".axis.x text").map(texts))) == [
-        '2013-01-12',
-        '2013-01-24',
-        '2013-02-04',
-        '2013-02-16'
-    ]
+                '2013-01-03',
+                '2013-01-08',
+                '2013-01-12',
+                '2013-01-17',
+                '2013-01-21',
+                '2013-01-26',
+                '2013-01-31',
+                '2013-02-04',
+                '2013-02-09',
+                '2013-02-14',
+                '2013-02-18'
+            ]
 
 
 def test_time():
@@ -56,13 +62,13 @@ def test_time():
     assert list(
         map(lambda t: t.split(' ')[0],
             q(".axis.x text").map(texts))) == [
-                '03:46:40',
-                '06:33:20',
-                '09:20:00',
-                '12:06:40',
-                '14:53:20',
-                '17:40:00',
-                '20:26:40'
+                '02:46:40',
+                '05:33:20',
+                '08:20:00',
+                '11:06:40',
+                '13:53:20',
+                '16:40:00',
+                '19:26:40'
             ]
 
 
@@ -80,10 +86,17 @@ def test_datetime():
     assert list(
         map(lambda t: t.split(' ')[0],
             q(".axis.x text").map(texts))) == [
+                '2013-01-03T09:00:00',
+                '2013-01-08T00:06:40',
                 '2013-01-12T15:13:20',
-                '2013-01-24T05:00:00',
+                '2013-01-17T06:20:00',
+                '2013-01-21T21:26:40',
+                '2013-01-26T12:33:20',
+                '2013-01-31T03:40:00',
                 '2013-02-04T18:46:40',
-                '2013-02-16T08:33:20'
+                '2013-02-09T09:53:20',
+                '2013-02-14T01:00:00',
+                '2013-02-18T16:06:40'
             ]
 
 

pygal/test/test_graph.py

@@ -36,8 +36,6 @@ except ImportError:
 def test_multi_render(Chart, datas):
     chart = Chart()
     chart = make_data(chart, datas)
-    chart.x_labels = (str(a) for a in 'labels')
-    chart.y_labels = (str(a) for a in range(6))
     svg = chart.render()
     for i in range(2):
         assert svg == chart.render()
@@ -115,7 +113,8 @@ def test_empty_lists(Chart):
     chart = Chart()
     chart.add('A', [1, 2])
     chart.add('B', [])
-    chart.x_labels = ('red', 'green', 'blue')
+    if not chart._dual:
+        chart.x_labels = ('red', 'green', 'blue')
     q = chart.render_pyquery()
     assert len(q(".legend")) == 2
 
@@ -124,7 +123,6 @@ def test_empty_lists_with_nones(Chart):
     chart = Chart()
     chart.add('A', [None, None])
     chart.add('B', [None, 4, 4])
-    chart.x_labels = ('red', 'green', 'blue')
     q = chart.render_pyquery()
     assert len(q(".legend")) == 2
 
@@ -132,7 +130,6 @@ def test_empty_lists_with_nones(Chart):
 def test_only_one_value(Chart):
     chart = Chart()
     chart.add('S', [1])
-    chart.x_labels = ('single')
     q = chart.render_pyquery()
     assert len(q(".legend")) == 1
 
@@ -140,7 +137,8 @@ def test_only_one_value(Chart):
 def test_only_one_value_log(Chart):
     chart = Chart(logarithmic=True)
     chart.add('S', [1])
-    chart.x_labels = ('single')
+    if not chart._dual:
+        chart.x_labels = ('single')
     q = chart.render_pyquery()
     assert len(q(".legend")) == 1
 
@@ -148,7 +146,6 @@ def test_only_one_value_log(Chart):
 def test_only_one_value_intrp(Chart):
     chart = Chart(interpolate='cubic')
     chart.add('S', [1])
-    chart.x_labels = ('single')
     q = chart.render_pyquery()
     assert len(q(".legend")) == 1
 
@@ -157,12 +154,14 @@ def test_non_iterable_value(Chart):
     chart = Chart(no_prefix=True)
     chart.add('A', 1)
     chart.add('B', 2)
-    chart.x_labels = ('red', 'green', 'blue')
+    if not chart._dual:
+        chart.x_labels = ('red', 'green', 'blue')
     chart1 = chart.render()
     chart = Chart(no_prefix=True)
     chart.add('A', [1])
     chart.add('B', [2])
-    chart.x_labels = ('red', 'green', 'blue')
+    if not chart._dual:
+        chart.x_labels = ('red', 'green', 'blue')
     chart2 = chart.render()
     assert chart1 == chart2
 
@@ -171,13 +170,15 @@ def test_iterable_types(Chart):
     chart = Chart(no_prefix=True)
     chart.add('A', [1, 2])
     chart.add('B', [])
-    chart.x_labels = ('red', 'green', 'blue')
+    if not chart._dual:
+        chart.x_labels = ('red', 'green', 'blue')
     chart1 = chart.render()
 
     chart = Chart(no_prefix=True)
     chart.add('A', (1, 2))
     chart.add('B', tuple())
-    chart.x_labels = ('red', 'green', 'blue')
+    if not chart._dual:
+        chart.x_labels = ('red', 'green', 'blue')
     chart2 = chart.render()
     assert chart1 == chart2
 
@@ -186,7 +187,7 @@ def test_values_by_dict(Chart):
     chart1 = Chart(no_prefix=True)
     chart2 = Chart(no_prefix=True)
 
-    if not issubclass(Chart, BaseMap):
+    if not issubclass(Chart, BaseMap) and not Chart._dual:
         chart1.add('A', {'red': 10, 'green': 12, 'blue': 14})
         chart1.add('B', {'green': 11, 'red': 7})
         chart1.add('C', {'blue': 7})
@@ -200,7 +201,7 @@ def test_values_by_dict(Chart):
         chart2.add('D', [])
         chart2.add('E', [13, None, 2])
         chart2.x_labels = ('red', 'green', 'blue')
-    else:
+    elif not Chart._dual:
         chart1.add('A', {'fr': 10, 'us': 12, 'jp': 14})
         chart1.add('B', {'cn': 99})
         chart1.add('C', {})
@@ -277,7 +278,8 @@ def test_unicode_labels_decode(Chart):
         'value': 3,
         'label': 'unicode <3'
     }])
-    chart.x_labels = [u('&œ'), u('¿?'), u('††††††††'), 'unicode <3']
+    if not chart._dual:
+        chart.x_labels = [u('&œ'), u('¿?'), u('††††††††'), 'unicode <3']
     chart.render_pyquery()
 
 
@@ -299,7 +301,8 @@ def test_unicode_labels_python2(Chart):
         'value': 3,
         'label': eval("'unicode <3'")
     }])
-    chart.x_labels = eval("[u'&œ', u'¿?', u'††††††††', 'unicode <3']")
+    if not chart._dual:
+        chart.x_labels = eval("[u'&œ', u'¿?', u'††††††††', 'unicode <3']")
     chart.render_pyquery()
 
 
@@ -321,7 +324,8 @@ def test_unicode_labels_python3(Chart):
         'value': 3,
         'label': eval("b'unicode <3'")
     }])
-    chart.x_labels = eval("['&œ', '¿?', '††††††††', 'unicode <3']")
+    if not chart._dual:
+        chart.x_labels = eval("['&œ', '¿?', '††††††††', 'unicode <3']")
     chart.render_pyquery()
 
 

pygal/util.py

@@ -161,7 +161,7 @@ def compute_logarithmic_scale(min_, max_, min_scale, max_scale):
 
 def compute_scale(
         min_, max_, logarithmic=False, order_min=None,
-        min_scale=4, max_scale=20):
+        min_scale=5, max_scale=20):
     """Compute an optimal scale between min and max"""
     if min_ == 0 and max_ == 0:
         return [0]