Going on doc + Fix y_labels behaviour for lines + Fix x_labels and y_…

…labels behaviour for xy like + Improve gauge a bit + Finally allow call chains on add
Kozea · Jul 7, 2015 · 2531304 · 2531304
1 parent b63bd3f
commit 2531304
Show file tree

Hide file tree

Showing 33 changed files with 871 additions and 676 deletions.
diff --git a/demo/moulinrouge/tests.py b/demo/moulinrouge/tests.py
@@ -158,6 +158,8 @@ def test_gauge():
 
         gauge.range = [-10, 10]
         gauge.add('Need l', [2.3, 5.12])
+        gauge.add('Need m', [-4])
+        gauge.add('Need z', [-10, 10.5])
         gauge.add('No', [99, -99])
         return gauge.render_response()
 

diff --git a/docs/api/pygal.graph.rst b/docs/api/pygal.graph.rst
@@ -116,6 +116,14 @@ pygal.graph.pie module
     :undoc-members:
     :show-inheritance:
 
+pygal.graph.public module
+-------------------------
+
+.. automodule:: pygal.graph.public
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
 pygal.graph.pyramid module
 --------------------------
 

diff --git a/docs/changelog.rst b/docs/changelog.rst
@@ -17,6 +17,10 @@ Changelog
 * Maps are now plugins, they are removed from pygal core and moved to packages (pygal_maps_world, pygal_maps_fr, pygal_maps_ch, ...) (#225)
 * Dot now supports negative values
 * Fix dot with log scale (#201)
+* Fix y_labels behaviour for lines
+* Fix x_labels and y_labels behaviour for xy like
+* Improve gauge a bit
+* Finally allow call chains on add
 
 1.7.0
 =====

diff --git a/docs/documentation/builtin_styles.rst b/docs/documentation/builtin_styles.rst
@@ -9,7 +9,8 @@ Default
 
 .. pygal-code::
 
-  chart = pygal.StackedLine(fill=True, interpolate='cubic')
+  from pygal.style import DefaultStyle
+  chart = pygal.StackedLine(fill=True, interpolate='cubic', style=DefaultStyle) # Setting style here is not necessary
   chart.add('A', [1, 3,  5, 16, 13, 3,  7])
   chart.add('B', [5, 2,  3,  2,  5, 7, 17])
   chart.add('C', [6, 10, 9,  7,  3, 1,  0])

diff --git a/docs/documentation/parametric_styles.rst b/docs/documentation/parametric_styles.rst
@@ -158,7 +158,7 @@ Desaturate
 .. pygal-code::
 
   from pygal.style import DesaturateStyle
-  desaturate_style = DesaturateStyle('#8322dd')
+  desaturate_style = DesaturateStyle('#8322dd', step=8)
   chart = pygal.StackedLine(fill=True, interpolate='cubic', style=desaturate_style)
   chart.add('A', [1, 3,  5, 16, 13, 3,  7])
   chart.add('B', [5, 2,  3,  2,  5, 7, 17])

diff --git a/docs/documentation/sparks.rst b/docs/documentation/sparks.rst
@@ -21,14 +21,14 @@ Sparklines support the same options as normal charts but for those that are over
 
 .. pygal-code:: sparkline
 
-  from pygal.style import RTDStyle
-  chart = pygal.Line(style=RTDStyle, interpolate='cubic')
+  chart = pygal.Line(interpolate='cubic')
   chart.add('', [1, 3,  5, 16, 13, 3,  7])
   chart.render_sparkline()
 
 .. pygal-code:: sparkline
 
-  chart = pygal.Line()
+  from pygal.style import LightSolarizedStyle
+  chart = pygal.Line(style=LightSolarizedStyle)
   chart.add('', [1, 3,  5, 16, 13, 3,  7, 9, 2, 1, 4, 9, 12, 10, 12, 16, 14, 12, 7, 2])
   chart.render_sparkline(width=500, height=25, show_dots=True)
 

diff --git a/docs/documentation/types/bar.rst b/docs/documentation/types/bar.rst
@@ -1,5 +1,5 @@
-Bar charts / Histograms
------------------------
+Bar
+---
 
 Basic
 ~~~~~

diff --git a/docs/documentation/types/box.rst b/docs/documentation/types/box.rst
@@ -1,5 +1,5 @@
-Box plot
---------
+Box
+---
 
 Basic
 ~~~~~

diff --git a/docs/documentation/types/dot.rst b/docs/documentation/types/dot.rst
@@ -1,5 +1,5 @@
-Dot charts
-----------
+Dot
+---
 
 Basic
 ~~~~~
@@ -15,3 +15,15 @@ Punch card like chart:
   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])
+
+
+Negative
+~~~~~~~~
+
+Negative values are also supported, drawing the dot empty:
+
+.. pygal-code:: 600 300
+
+  dot_chart = pygal.Dot(x_label_rotation=30)
+  dot_chart.add('Normal', [10, 50, 76, 80, 25])
+  dot_chart.add('With negatives', [0, -34, -29, 39, -75])
diff --git a/docs/documentation/types/funnel.rst b/docs/documentation/types/funnel.rst
@@ -1,5 +1,5 @@
-Funnel charts
--------------
+Funnel
+------
 
 Basic
 ~~~~~

diff --git a/docs/documentation/types/gauge.rst b/docs/documentation/types/gauge.rst
@@ -1,16 +1,15 @@
-Gauge charts
-------------
+Gauge
+-----
 
 Basic
 ~~~~~
 
-Simple gauge chart:
+Gauge chart:
 
-.. pygal-code::
+.. pygal-code:: 600 550
 
   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)

diff --git a/docs/documentation/types/histogram.rst b/docs/documentation/types/histogram.rst
@@ -0,0 +1,14 @@
+Histogram
+---------
+
+Basic
+~~~~~
+
+Histogram are special bars that take 3 values for a bar: the ordinate height, the abscissa start and the abscissa end.
+
+
+.. pygal-code::
+
+  hist = pygal.Histogram()
+  hist.add('Wide bars', [(5, 0, 10), (4, 5, 13), (2, 0, 15)])
+  hist.add('Narrow bars',  [(10, 1, 2), (12, 4, 4.5), (8, 11, 13)])
diff --git a/docs/documentation/types/index.rst b/docs/documentation/types/index.rst
@@ -8,6 +8,7 @@ pygal provides various kinds of charts:
 
    line
    bar
+   histogram
    xy
    pie
    radar

diff --git a/docs/documentation/types/line.rst b/docs/documentation/types/line.rst
@@ -1,5 +1,5 @@
-Line charts
------------
+Line
+----
 
 Basic
 ~~~~~