[PythonReports-checkins] PythonReports README,NONE,1.1

[alexander s. <a1...@us...>]

Update of /cvsroot/pythonreports/PythonReports
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv15219

Added Files:
	README 
Log Message:
guess what?  readme!

--- NEW FILE: README ---
============
Introduction
============

PythonReports_ is a toolkit aimed to build database reports
in |Python(r)| programs.  The toolkit includes report template_
designer, report builder and several printout_ renderers for
GUI and graphic file output.

Report builder applies a template_ to a sequence of uniform data
objects and produces a printout_ structure that can be saved in
a file and/or rendered by one of the front-end drivers to screen,
printer, HTML [*]_, PDF etc.

.. [*] HTML output is not implemented yet.

============
Requirements
============

PythonReports_ require Python_ version 2.4 or newer.  No support
is planned for earlier Python versions.

All parts of the PythonReports_ toolkit require the ElementTree_
module.  Python 2.5 includes this module as part of standard library.
Users of older Python versions can download separate distribution
package from http://effbot.org/downloads/ (cElementTree_ add-on is
highly recommended too).

Report building requires either ReportLab_ or PIL_ or wxPython_
(in that order of preference).  If report template contains
images then either `Python Imaging Library`_ (PIL_) or wxPython_
must be installed.

Requirements for printout_ rendering depend on selected frontend:
  * PDF output requires the ReportLab_ Toolkit;
  * wx-based preview and printing require wxPython_;
  * Tk-based report preview requires Tkinter
    (part of the Python Standard Library).

Report template designer requires Tkinter with Tix_ support
(standard Python installer for Windows includes Tix_; on some
platforms Tix_ must be installed separately).

===========
Quick Start
===========

No documentation yet.  Please look at the `test script`_
for report building example.  All printout rendering modules
(``pdf``, ``Tk`` and ``wxPrint``) have command line interface
that can serve as their API usage example.

.. _External hyperlink targets:

.. _PythonReports: http://pythonreports.sourceforge.net/
.. _template: http://pythonreports.sourceforge.net/prt.html
.. _printout: http://pythonreports.sourceforge.net/prp.html
.. _Python: http://www.python.org/
.. _ElementTree: http://effbot.org/zone/element-index.htm
.. _cElementTree: http://effbot.org/zone/celementtree.htm
.. _ReportLab: http://www.reportlab.org/rl_toolkit.html
.. _Python Imaging Library:
.. _PIL: http://www.pythonware.com/products/pil/
.. _wxPython: http://www.wxpython.org/
.. _Tix: http://tix.sourceforge.net/
.. _test script: http://pythonreports.cvs.sourceforge.net/pythonreports/PythonReports/test/test_build.py?view=markup

.. |Python(r)| unicode:: Python U+00AE

.. vim: set et ft=rst sts=2 sw=2 :