public
Fork of rackspace/ruby-cloudfiles
Description: Ruby API for Cloud Files
Homepage: www.rackspace.com
Clone URL: git://github.com/phillc/ruby-cloudfiles.git
name age message
file .gitignore Wed Jan 28 07:18:48 -0800 2009 Update for 1/28 API changes. [minter]
file COPYING Wed Mar 11 13:22:39 -0700 2009 Licensing/copyright information. [minter]
file Manifest Wed Feb 04 12:48:11 -0800 2009 Documentation enhancements. [minter]
file README.rdoc Loading commit data...
file Rakefile
file TODO Wed Feb 04 18:36:46 -0800 2009 Add StorageObject.save_to_filename convenience ... [minter]
file cloudfiles.gemspec
directory lib/
directory test/
README.rdoc

Rackspace Cloud Files

Description

This is a Ruby interface into the Rackspace Cloud Files service. Cloud Files is reliable, scalable and affordable web-based storage hosting for backing up and archiving all your static content. Cloud Files is the first and only cloud service that leverages a tier one CDN provider to create such an easy and complete storage-to-delivery solution for media content.

Installation

This gem is available on Github. To install it, do

  gem sources -a http://gems.github.com

  sudo gem install rackspace-cloudfiles

To use it in a Rails application, add the following information to your config/environment.rb

  config.gem "rackspace-cloudfiles", :source => "http://gems.github.com", :lib => "cloudfiles"

Examples

See the class definitions for documentation on specific methods and operations.

  require 'cloudfiles'

  # Log into the Cloud Files system
  cf = CloudFiles::Connection.new(USERNAME, API_KEY)

  # Get a listing of all containers under this account
  cf.containers
  => ["backup", "Books", "cftest", "test", "video", "webpics"]

  # Access a specific container
  container = cf.container('test')

  # See how many objects are under this container
  container.count
  => 3

  # List the objects
  container.objects
  => ["bigfile.txt", "new.txt", "test.txt"]

  # Select an object
  object = container.object('test.txt')

  # Get that object's data
  object.data
  => "This is test data"

Authors

Initial work by Major Hayden <major.hayden@rackspace.com>

Subsequent work by H. Wade Minter <wade.minter@rackspace.com>

License

See COPYING for license information. Copyright © 2009, Rackspace US, Inc.