Metadata-Version: 1.1
Name: svg.charts
Version: 2.3
Summary: Python SVG Charting Library
Home-page: http://svg-charts.sourceforge.net
Author: Jason R. Coombs
Author-email: jaraco@jaraco.com
License: MIT
Description: ``svg.charts`` - Package for generating SVG Charts in Python
        ============================================================
        
        .. contents::
        
        Status and License
        ------------------
        
        ``svg.charts`` is a pure-python library for generating charts and graphs
        in SVG, originally based on 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://bitbucket.org/jaraco/svg.charts/src/tip/license.txt>`_.
        
        You can install it with easy_install or pip::
        
          easy_install svg.charts
          pip install svg.charts
        
        Or, check out the `mercurial repository source
        <https://bitbucket.org/jaraco/svg.charts>`_.
        
        Tests are continuously run by Travis-CI: |BuildStatus|_
        
        .. |BuildStatus| image:: https://secure.travis-ci.org/jaraco/svg.charts.png
        .. _BuildStatus: http://travis-ci.org/jaraco/svg.charts
        
        To run the tests, refer to the .travis.yml file for the steps run on the
        Travis-CI hosts.
        
        
        Acknowledgements
        ----------------
        
        ``svg.charts`` depends heavily on lxml and cssutils. Thanks to the
        contributors of those projects for stable, performant, standards-based
        packages.
        
        Sean E. Russel for creating the SVG::Graph Ruby package from which this
        Python port was originally derived.
        
        Leo Lapworth for creating the SVG::TT::Graph package which the Ruby
        port was based on.
        
        Stephen Morgan for creating the TT template and SVG.
        
        Getting Started
        ---------------
        
        ``svg.charts`` has some examples (taken directly from the reference implementation)
        in `tests/samples.py <http://svg-charts.hg.sourceforge.net/hgweb/svg-charts/py-svg/raw-file/tip/tests/samples.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.
        
        An example of using ``svg.charts`` in a `CherryPy
        <http://www.cherrypy.org/>`_ web app can be found in `jaraco.site.charts
        <https://bitbucket.org/jaraco/jaraco.site/src/tip/jaraco/site/charts.py>`_.
        If the site is working, you can see the `rendered output here
        <http://www.jaraco.com/charts/plot>`_.
        
        ``svg.charts`` also provides `API documentation
        <http://pythonhosted.org/svg.charts/>`_.
        
        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
        -----------
        
        -  Documentation! This package desperately needs some high-level,
           tutorial-style how-tos, and not just links to example code.
        -  Implement javascript-based animation (See JellyGraph for a Silverlight example of what simple animation can do for a charting library).
        
        Reporting Bugs and Getting Help
        -------------------------------
        
        This project is `hosted at sourceforge
        <https://sourceforge.net/projects/svg-charts/>`_. Please use that site for
        reporting bugs and requesting help. Patches are also welcome.
        
        Changes
        -------
        
        2.3
        ~~~
        
        * #4: Added hook in Graph to allow overriding of the attributes on the
          root SVG element. One can now override or monkeypatch
          ``Graph._get_root_attributes`` to alter the rendering of the root
          attributes such as width and height. For example, to omit width and height::
        
            class MyPlot(plot.Plot):
                def _get_root_attributes(self):
                    attrs = super(MyPlot, self)._get_root_attributes()
                    del attrs['width']
                    del attrs['height']
                    return attrs
        
        2.2.2
        ~~~~~
        
        * #1: Fixed javascript ID names in TimeSeries labels.
        
        2.2.1
        ~~~~~
        
        * #5: Fixed references to class attributes in ``graph.py``.
        
        2.2
        ~~~
        
        * SF Issue #1: Fixed installation on Unix systems again. Author's preference
          for lowercase ``readme.txt`` was trumped by `setuptools #100
          <https://bitbucket.org/pypa/setuptools/issue/100/>`_.
        * Moved hosting to BitBucket.
        * Established Continuous Integration Tests on Github mirror using Travis-CI.
        
        2.1
        ~~~
        
        * Project now builds and tests pass on Python 3 without 2to3.
        
        2.0.9
        ~~~~~
        
        * Corrected buggy logic in y-axis label rendering (thanks to Emmanuel
          Blot).
        * Converted to Unix line endings.
        
        2.0.8
        ~~~~~
        
        * Updated to latest cssutils with Python 3 support. Thanks Christof!
        * Fixed a few remaining issues with Python 3 compatibility.
        
        2.0.7
        ~~~~~
        
        * Fixed bug in rendering of Pie Chart styles.
        * Improved testing framework. Now samples are at least generated as part
          of the test suite.
        * Fixed bug in javascript when label ids had spaces. See #3139197.
        * Fixed build issue where package data wasn't included due to 2to3
          technique. Now using distribute technique and installation on Python
          3 requires distribute.
        
        2.0.6
        ~~~~~
        
        * Fixed bug where x axis labels would not be rendered properly if the
          largest value was the same as the largest visible x value on the
          chart.
        
        2.0.5
        ~~~~~
        
        * Altered the way CSS files are loaded, so they can be more easily
          customized by subclasses (and less dependent on the class names).
        
        2.0.4
        ~~~~~
        
        * A small attempt to improve the documentation - added links to examples
          that already exist.
        
        2.0.3
        ~~~~~
        
        * Fix IndexError in ``svg.charts.plot.Plot.field_size`` when there are
          only two values returned by float_range (in the case there are only
          two different 'y' values in the data) and scale_y_integers == True.
          Credit to `Jean Schurger <http://schurger.org/>`_ for the patch.
        * Fixed problem in setup.py installing on Unix OS (case sensitivity of
          readme.txt). Credit to Luke Miller and Jean Schurger for supplying
          a patch for this issue.
        
        2.0.2
        ~~~~~
        
        * Updated cssutils dependency to 0.9.6 (currently in beta) to require the CSS profiles support.
        * Completed an SVG CSS profile according to the SVG 1.1 spec.
        
        2.0.1
        ~~~~~
        
        * Added preliminary SVG CSS profile, suitable for stock CSS properties.
        
        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
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
