= Welcome to Geniusql =

Geniusql is a [source:trunk/geniusql/license.txt public domain], low-level Object-Relational Mapper for Python applications. If you're familiar with Martin Fowler's work, you can think of Geniusql as providing a Data Source [http://www.martinfowler.com/eaaDev/OrganizingPresentations.html#LayersOfData layer]. It primarily uses a generic [http://www.martinfowler.com/eaaCatalog/tableDataGateway.html Table Data Gateway] 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]). If you want a more powerful solution, we recommend skipping Active Record and going straight to a [http://www.martinfowler.com/eaaCatalog/dataMapper.html Data Mapper] like [http://www.aminus.net/dejavu Dejavu]. Dejavu uses Geniusql behind the scenes for RDBMS back ends, but allows you to mix and match them with RAM, filesystem, and other stores.

= How To Get Geniusql =

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

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

Documentation is at http://www.aminus.net/geniusql/chrome/common/doc/.


= Community and Contact =

The "community" is quite small right now. If you have questions about using Geniusql, start with the [irc://irc.oftc.net/dejavu #dejavu IRC channel] or the [mailto:geniusql-users@googlegroups.com mailing list]. Feature requests should be done via [/geniusql/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||
||1.0   ||alpha ||[wiki:WhatsNewIn10]||[wiki:UpgradeTo1.0]||source:trunk ||