I'm pleased to announce that we released DataMapper 1.0 "Vermouth"
earlier today.

Thank you to everyone in the community, especially this mailing list
and the IRC channel. There's no way we could've reached this milestone
without your encouragement and assistance.

It's extremely rewarding to see DM hit 1.0, but at the same time it
also sets a baseline for future development to build on. In some ways
we're only just getting started, the future we have planned for DM is
even more ambitious. I'll be writing more about our plans in the
coming weeks.

Before you install
------------------

The installation process for DM 1.0 is pretty similar to what it was
previously in 0.10.x and 0.9.x with a few exceptions:

1) Using auto-migration and auto-upgrading require dm-migrations
rather than just dm-core. The reason for this is that dm-migrations
should share a lot of code with auto-migrations, but they don’t, and
in an attempt to DRY things up we’ve centralized all the code in one
package and will begin refactoring the code over the coming months.

2) Transactions require the use of the dm-transactions gem.

3) It is no longer necessary to gem install data_objects or any do_*
gem directly. Each DO based adapter has been extracted into their own
gems, and installing them will setup the dependencies on dm-core and
the appropriate DO gem(s). The new adapters are:

  dm-sqlite-adapter
  dm-postgres-adaper
  dm-mysql-adapter
  dm-oracle-adapter
  dm-sqlserver-adapter

Installation
------------

Install dm-core:

  $ gem install dm-core

The next thing you want to do is decide which adapter you want to use.
For example if you want to use sqlite, do:

  $ gem install dm-sqlite-adapter

This should pull in data_objects and do_sqlite3 automatically, so no
need to specify either of those explicitly anymore.

It’s likely you’ll want to use migrations (for classic or auto-
migrations), and transactions when using sqlite, so to install them
do:

  $ gem install dm-migrations dm-transactions

There is also a metagem which combines several gems into a single
package:

  $ gem install data_mapper

This pulls a nice base stack for DM development. The gems included
are:

  dm-core
  dm-aggregates
  dm-constraints
  dm-migrations
  dm-transactions
  dm-serializer
  dm-timestamps
  dm-validations
  dm-types

So putting this all together you can do:

  $ gem install data_mapper dm-sqlite-adapter

Changes
-------

In previous release announcements I've provided details about the
changes, so I'm not going to repeat myself ;) Instead I'm going to
refer you to the list of 61 tickets we've resolved for the 1.0
milestone:

  http://datamapper.lighthouseapp.com/projects/20609/milestones/62234-0103

How to report issues
--------------------

Please report any issues you find in IRC, on the mailing list, or in
the tracker:

  IRC: #datamapper
  Mailing List: http://groups.google.com/group/datamapper
  Bug Tracker: http://datamapper.lighthouseapp.com/projects/20609-datamapper

-- 
You received this message because you are subscribed to the Google Groups 
"DataMapper" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/datamapper?hl=en.

Reply via email to