mongoid-grid_fs
Ruby
Latest commit 41feadf Jul 21, 2016 @rmm5t rmm5t committed on GitHub Merge pull request #61 from laCour/mongoid-6.0
Mongoid 6.0 Support
Failed to load latest commit information.
gemfiles
lib
script
test
.gitignore
.travis.yml
Gemfile Added pry to the gemfile for script/shell usage Apr 7, 2014
LICENSE
README.md
Rakefile
mongoid-grid_fs.gemspec

README.md

mongoid-grid_fs

Gem Version Build Status Gem Downloads

A pure Mongoid/Moped implementation of the MongoDB GridFS specification

INSTALL

gem install mongoid-grid_fs

SYNOPSIS

require 'mongoid/grid_fs'

grid_fs = Mongoid::GridFs
f = grid_fs.put(readable)

grid_fs.get(f.id)
grid_fs.delete(f.id)

g = grid_fs.get(f.id)
g.data # big huge blob
g.each { |chunk| file.write(chunk) } # streaming write

DESCRIPTION

mongoid_grid_fs is A pure Mongoid/Moped implementation of the MongoDB GridFS specification

Reference: http://docs.mongodb.org/manual/reference/gridfs/

It has the following features:

  • implementation is on top of mongoid for portability. moped (the driver) is barely used, so the library should be quite durable except in the face of massive changes to mongoid itself.

  • simple, REST-like api

  • support for custom namespaces (fs.files vs. image.files, as per the spec)

  • pathnames and io-like objects can be written to the grid

  • auto-unique pathnames are generated (by default) to avoid collisions using #put

    'path/info/a.rb' -> '$object_id/a.rb'

  • [] and []= methods which allow the grid to be used like a giant file hash in the sky

  • support for data_uris, like a html5 boss

    <%= image_tag :src => file.data_uri %>

CONTRIBUTING

$ bundle install
$ bundle exec rake test

LICENSE

This is licensed under the Ruby License: http://www.ruby-lang.org/en/about/license.txt