= Welcome to Dejavu =

Dejavu is a [source:trunk/license.txt public domain], thread-safe Object-Relational Mapper for Python applications. It is
designed to provide the "Model" third of an MVC application. When you build
an application using Dejavu, you must supply the Controller(s) and View(s)
yourself. Dejavu does not provide these, and does its best to not limit
your choices regarding them.

If you're familiar with Martin Fowler's work,
you can think of Dejavu as providing a Data Source [http://www.martinfowler.com/eaaDev/OrganizingPresentations.html#LayersOfData layer], plus the tools
to write your own Domain layer. For the Presentation layer, you're on your
own. ;) It primarily uses a generic [http://www.martinfowler.com/eaaCatalog/dataMapper.html Data Mapper] architecture (as opposed to the more tightly-coupled [http://www.martinfowler.com/eaaCatalog/activeRecord.html Active Record] architecture recently popularized by [http://wiki.rubyonrails.org/rails/pages/ActiveRecord Ruby On Rails] and [http://www.djangoproject.com/documentation/design_philosophies/#include-all-relevant-domain-logic Django]).

Read [http://www.aminus.net/dejavu/chrome/common/doc/ the documentation] for the most-recent version.

= How To Get Dejavu =

Try the Subversion repository at http://svn.aminus.net/dejavu.

You can also find source and binary distributions at http://www.aminus.net/dejavu/chrome/common/releases/.

= Community and Contact =

The "community" is quite small right now. If you have questions about using Dejavu, start with the [irc://irc.oftc.net/dejavu #dejavu IRC channel] or the [mailto:dejavu-users@googlegroups.com mailing list]. Feature requests should be done via [http://www.aminus.net/dejavu/newticket tickets]. You can also email me, Robert Brewer, personally at the address at the top of the page.

= Versions =

||Branch||Status||What's New         ||Upgrading          ||Browse Source||
||2.0   ||alpha  ||[wiki:WhatsNewIn20]||[wiki:UpgradeTo2.0]||source:trunk||
||1.5   ||stable ||[wiki:WhatsNewIn15]||[wiki:UpgradeTo1.5]||source:branches/1.5||
||1.4   ||stable ||                   ||[wiki:UpgradeTo1.4]||source:tags/1.4.0||

Stay away from trunk for a while; I'm breaking Geniusql out into its own [http://www.aminus.net/geniusql project] (for Dejavu 2.0).