Ruport 0.1.0 Released
=======================

This is the initial release of Ruby Reports (Ruport) by Gregory Brown.
This
implements a number of features discussed under the ruby-talk topic
Ruby Report
Generation tool and provides a functional (if a bit experimental) way
to quickly
generate reports using DBI and format them via ERb or various other
Ruby
formatting libraries.

What is Ruport?
-----------------

Ruport is a powerful report generation engine that allows users to
generate
custom ERb templates and easily query various forms of SQL databases
via DBI.
It provides helper methods and utilities to generate professional
reports
quickly and cleanly.


What's new in this release?
---------------------------

EVERYTHING! It's the first release :)

On a serious note, you'll be able to use Ruport to build ERb or plain
ruby
templates, send emails, do custom configuration by template, and even
run
queries stored in your database with this release.

There are some kinks that still need to be worked out, but Ruport is
useful
enough where I've used it to hammer out some quick reports for my
office.

Where can I learn more?
-----------------------

Ruport is hosted on RubyForge.

Project page:   http://rubyforge.org/projects/ruport/
Documentation:  http://ruport.rubyforge.org/docs/
Downloads:      http://rubyforge.org/frs/?group_id=856

The best source of information is the user manual, available at:
http://ruport.rubyforge.org/ruport_manual.pdf

How do I get Ruport?
----------------------

Before you can use Ruport, you'll need a working version of Ruby/DBI.
You can find it and information regarding it's installation at:
http://ruby-dbi.sourceforge.net/

Ruport is a gem, so as long as you have RubyGems installed it's as
simple as:

$ sudo gem install ruport --require-dependencies

The only gem dependancy Ruport has is Parse/Input, which will make more
sense in upcoming releases :)

If you need to install RubyGems, you can download it from:

http://rubyforge.org/frs/?grou p_id=126&release_id=1885

Ruport can also be installed manually.  Just download the latest
release from http://rubyforge.org/frs/?group_id=856 and run setup.rb
(Assuming you have already installed DBI and Parse/Input)

Acknowledgements:
-------------------

A complete list of acknowledgements is available at:
http://ruport.rubyforge.org/acknowledgements.html

But I would like to personally thank James Edward Gray II for writing a
large
amount of the code that Ruport now runs on as well as offering me
continued
support throughout the development.

Additionally, the release of gruf by Daniel Berger helped spark a lot
of ideas
for Ruport and his work is greatly appreciated.

The suggestions and comments of all those on ruby-talk I have tried to
take into
consideration and I would like to thank Austin Ziegler and Alexandru
Popescu in
particular for their suggestions.

I also would like to thank Gregory Gibson, professor at the University
of New
Haven and my current employer.  He put money in my pocket so I could
put Ruport
in your pocket... or your computer... wherever you prefer.

--------------

Hope you enjoy Ruport!

-Greg Brown