mirror of https://github.com/Kozea/pygal.git
Python to generate nice looking SVG graph
http://pygal.org/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2.0 KiB
2.0 KiB
``svg.charts`` - Package for generating SVG Charts in Python
============================================================
.. contents::
Status and License
------------------
``svg.charts`` is a port of the SVG::Graph Ruby package by Sean E. Russel.
``svg.charts`` supercedes ``svg_charts`` 1.1 and 1.2.
``svg.charts`` is written by Jason R. Coombs. It is licensed under an
`MIT-style permissive license
<https://py-svg.svn.sourceforge.net/svnroot/py-svg/trunk/docs/license.txt>`_.
You can install it with ``easy_install svg.charts``, or from the
`subversion repository
<https://py-svg.svn.sourceforge.net/svnroot/py-svg/trunk#egg=svg.charts-dev>`_ with
``easy_install svg.charts==dev``.
Getting Started
---------------
``svg.charts`` has some examples (taken directly from the reference implementation)
in `tests/testing.py <https://py-svg.svn.sourceforge.net/svnroot/py-svg/trunk/tests/testing.py`.
These examples show sample usage of the various chart types. They should provide a
good starting point for learning the usage of the library.
Upgrade Notes
-------------
Upgrading from 1.x to 2.0
I suggest removing SVG 1.0 from the python installation. This involves removing the SVG directory (or svg_chart*) from site-packages.
Change import statements to import from the new namespace.
from SVG import Bar
Bar.VerticalBar(...)
becomes
from svg.charts.bar import VerticalBar
VerticalBar(...)
More To-Dos
-----------
- Implement javascript-based animation (See JellyGraph for a Silverlight example of what simple animation can do for a charting library).
Changes
-------
2.0
~~~~~
* First major divergence from the Ruby reference implementation
* Now implemented as a namespace package (svg.charts instead of svg_charts)
* Changed XML processor to lxml
* Enabled extensible css support using cssutils, greatly reducing static CSS
* Renamed modules and methods to be more consistent with PEP-8 naming convention
1.2
~~~
* Bug fixes
1.1
~~~
* First public release