This is your commit reference: 2f56dbdf614e453a6105fed0f90e8ecf12be9298
That is the last commit before the merge of the moped-integration branch, going forward on master from that commit no longer uses the 10gen driver.
Important things to note:
- Remove any references to bson_ext, bson, or the mongo gems.
- If you are using GridFS, you cannot go past this commit as it is not currently supported in Moped or Mongoid.
- If you are dropping down to the driver level for anything, you've got a syntax change. Please see the Moped README about this until we have the new docs out with the official releases.
https://github.com/mongoid/moped
- The entire mongoid.yml has changed. You will be getting validation errors now when the mongoid.yml is loaded to instruct you what to change. You can generate a new one via rails g mongoid:config - the new yaml has comments all over it to help you get running quickly. You can also see a sample here:
https://github.com/mongoid/mongoid/blob/master/spec/config/mongoid.yml
- The persist_in_safe_mode option has been removed. You now provide this in the mongoid.yml on your session configuration options.
- #safely and #unsafely have been removed. You now can use #with to provide safe/unsafe options. Ex: Band.with(safe: true).create
- Index definition syntax has changed - you will get an error you tell you how to fix this.
- The store_in macro syntax has changed - you will get an error to tell you how to fix this as well.
- There may be some gem incompatibilities we have not addressed yet by sending them pull requests. The following is a list of gems we have tested and are currently compatible that have a dependency on mongoid itself: carrierwave-mongoid, kaminari, state_machine, fabrication. We have a target list of all other gems we will be going through next week and submitting pull requests to to bring them up to date if they need to change - most likely none of them will.
- For logging you simply only need to change the log level in Moped: Moped.logger.level = Logger::DEBUG
Pay attention to the CHANGELOG (
https://github.com/mongoid/mongoid/blob/master/CHANGELOG.md) - especially the Major Changes section under 3.0. New features are there with examples, as well as bug fixes. Note that ALL bug fixes that went into 2.4.x releases are in master (3.0), but are listed under each respective 2.4.x release in the CHANGELOG.
If you have questions, problems, ping me here.
Cheers!
d