Working toward a 2.0 release

docs/license.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2008-2009 Jason R. Coombs
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

readme.txt

@@ -1,3 +1,30 @@
+``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
 -------------
 
@@ -13,6 +40,29 @@ becomes
 from svg.charts.bar import VerticalBar
 VerticalBar(...)
 
---- Still to do ---
+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

release.howto

@@ -1,10 +1,6 @@
 How to make a release:
 
-- build tar.gz, egg for 2.4 and 2.5 and send them to pypi.
-  On my system (Unbuntu gutsy):
-    python2.4 setup.py egg_info -RDb "" register bdist_egg upload
-    python2.5 setup.py egg_info -RDb "" sdist bdist_egg upload
-
+- Run release-package (from jaraco.util) in the current directory. This uploads to pypi.
+- upload released packages to sourceforge (can we automate this)?
 - announce release on python-announce-list@python.org
-
 - bump the version in setup.py and commit

setup.py

@@ -2,32 +2,30 @@
 
 # $Id$
 
-from ez_setup import use_setuptools
-use_setuptools()
 from setuptools import setup, find_packages
 
 setup(name = "svg.charts",
 	version = "2.0",
 	description = "Python SVG Charting Library",
+	long_description = open('readme.txt').read().strip(),
 	author = "Jason R. Coombs",
 	author_email = "jaraco@jaraco.com",
 	url = "http://py-svg.sourceforge.net",
-	packages = find_packages('src'),
-	package_dir = {'':'src'},
+	packages = find_packages(exclude=['tests', 'docs']),
+	zip_safe=True,
+	namespace_packages=['svg'],
 	install_requires=[
 		'python-dateutil>=1.4',
 		'cssutils>=0.9.5.1',
 		'lxml>=2.0',
 	],
 	license = "MIT",
-	long_description = """\
-SVG Charting library based on the Ruby SVG::Graph
-
-""",
 	classifiers = [
-		"Development Status :: 4 - Beta",
+		"Development Status :: 5 - Production/Stable",
 		"Intended Audience :: Developers",
+		"Intended Audience :: Science/Research",
 		"Programming Language :: Python",
+		"License :: OSI Approved :: MIT License",
 	],
 	entry_points = {
 	},