TinyMongo

Simple MongoDB wrapper

Notice

This gem is not yet ready for production use.

Install

gem install tinymongo

Rails Setup (Rails 3)

To create TinyMongo config file (config/tinymongo.yml) and initializer file (config/initializers/tinymongo.rb), do the following:

rails generate tinymongo

Connecting To MongoDB directly (for non-Rails projects)

TinyMongo.configure({:host => 'localhost', :database => 'db_name'})
TinyMongo.connect

Example

class Person < TinyMongo::Model
mongo_collection :people          # optional if using Rails
mongo_key :name
mongo_key :age, :default => 0
mongo_key :children, :default => []

def make_child
  child = Person.create(:name => 'Baby')
  push({:children => child})      # push child into children array
end

def grow_up
  inc({:age => 1})                # increments age by 1
end

def set_stuff(n,a,c)
  # don't forget to put self
  self.name = n
  self.age = a
  self.children = c
  save
end
end

Person.drop                         # empty person collection

p = Person.create(:name => 'John', :age => 20)
p.make_child
p.grow_up

Person.find.each do |person|
puts person.name
end

Person.find_one(:name => 'John').age

Person.create(:name => 'Jim')
Person.create(:name => 'Pam')

Person.find.to_a.map { |person| person.name }

Person.find.has_next?

Person.find.sort({:name => 1}).skip(2).limit(1).next!.name 

Person.find({:name => 'John'}, {:age => 1}) # select only age field

Person.find.count # count ignores skip and limit
Person.find.skip(1).size # size is affected by skip and limit

Person.distinct(:name)

Person.ensure_index({:name => 1})
Person.drop_index({:name => 1})

Copyright

Copyright (c) 2010 Peter Jihoon Kim. See LICENSE for details.