mogilefs-client

home	bogomips.org/mogilefs-client
list	mogile@googlegroups.com
email	normalperson@yhbt.net
repo	git://bogomips.org/mogilefs-client.git
cgit	bogomips.org/mogilefs-client.git
gitweb	repo.or.cz/w/ruby-mogilefs-client.git

Description

A MogileFS client library for Ruby. MogileFS is an open source (Free Software) distributed filesystem. For information on MogileFS see: mogilefs.org

Installing mogilefs-client

First you need a MogileFS setup. You can find information on how to do that at mogilefs.org

Then install the gem:

$ gem install mogilefs-client

Using mogilefs-client

# Create a new instance that will communicate with these trackers:
hosts = %w[192.168.1.69:6001 192.168.1.70:6001]
mg = MogileFS::MogileFS.new(:domain => 'test', :hosts => hosts)

# Stores "A bunch of text to store" into 'some_key' with a class of 'text'.
mg.store_content 'some_key', 'text', "A bunch of text to store"

# Retrieve data from 'some_key'
data = mg.get_file_data 'some_key'

# Store the contents of 'image.jpeg' into the key 'my_image' with a class of
# 'image'.
mg.store_file 'my_image', 'image', 'image.jpeg'

# Store the contents of 'image.jpeg' into the key 'my_image' with a class of
# 'image' using an open IO.
File.open 'image.jpeg', 'rb' do |fp|
  mg.store_file 'my_image', 'image', fp
end

# Retrieve the contents of 'my_image' into '/path/to/huge_file'
# without slurping the entire contents into memory:
File.open '/path/to/huge_file', 'w' do |fp|
  mg.get_file_data 'my_image', wr
end

# Remove the key 'my_image' and 'some_key'.
mg.delete 'my_image'
mg.delete 'some_key'

Contact

Feedback (bug reports, user/development dicussion, patches, pull requests) are greatly appreciated and handled via email. We currently piggy-back onto the public MogileFS mailing list.

If you do not want to deal with the corporate host of the MogileFS mailing list, or if you wish to keep your issue secret, feel free to email Eric Wong at.

Do not expect Eric Wong to read HTML mail under any circumstances.

WARNING!

This client is only supported in HTTP mode. NFS mode was previously supported in 1.3.x, but since MogileFS 2.x has dropped support for NFS, this client has removed support for it.

Home Classes Methods