``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.



``jaraco.nxt`` is written by Jason R. Coombs.  It is licensed under an

`MIT-style permissive license

<https://svn.jaraco.com/jaraco/python/svg.charts/docs/license.txt>`_.



You can install it with ``easy_install svg.charts``, or from the

`subversion repository

<https://svn.jaraco.com/jaraco/python/svg.charts#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://svn.jaraco.com/jaraco/python/svg.charts/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