Skip to content

andrewbrodie/csharp-cloudfiles

 
 

Repository files navigation

Rackspace Cloud Files CSharp API

Description

This is a .NET/C# interface into the Rackspace CloudFiles service. Cloud Files is a 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.

Contributing

  1. Your code WILL NOT be accepted without tests. period.

  2. Please make sure your autocrlf setting is false

    git config core.autocrlf false

  3. Fork the repository, clone, code, push, and then issue a pull request

Issues vs Inquiries/Questions

Please put issues on Github and ask questions/inquiries on the mailing list

Mailing List

The mailing list

Creating Issues

Please read the wiki about what information is best to help people fix your issues, then create an issue on the issues tab.

Getting dll and using in your project

Go to the downloads page and download the latest "stable" version or go and grab the latest build from our continuous integration server (TeamCity)
Unzip the file, unzip the bin zip, and grab the following files:

Rackspace.Cloudfiles.dll
log4net.dll
log4Net.config

Reference them from your application. Look at the examples below once you done this. Example folder structure:

/Your_project
	/lib
		/cloudfiles
			Rackspace.Cloudfiles.dll
			log4net.dll
	/src
		...

Necessary prerequisites

Visual Studio 2010 and .NET 3.5/.NET 4.0 (depending on the zip file you chose)

Running the tests requires Ruby and Rake to be installed. We suggest you use the Ruby Installer For Windows. We currently use the 1.8.6 version. After that is installed you will need to install the rake and albacore(v0.2.2) gems.

gem install rake
gem install albacore -v 0.2.2

Getting source, compiling, and using in your project

Follow the instructions here to install msysgit [Git for Windows users] and get your ssh keys setup for using Github.

git clone git://github.com/rackspace/csharp-cloudfiles.git

This will create the csharp-cloudfiles directory locally on your computer. Go into that folder and run:

rake compile

This will compile the project and give you a resulting dll in ...csharp-cloudfiles/bin/debug/

Look above for an example folder structure.

Logging

Logging is done with the log4net.dll and log4net.config file that are included in the source/downloads. You just need to edit the log4net.config file to turn it on:

change:
<level value="INFO" />

to:
<level value="DEBUG" /> or
<level value="ERROR" /> or
<level value="ALL" />

so that logging starts and you get the desired logging output and format.

Currently the log is going to log/Rackspace.CloudFiles.Log, where you have the dll referenced.

<file value="logs/Rackspace.CloudFiles.Log" />   (in the log4net.config file)

Please reference the log4net documentation on how to edit that config file.

Testing

Once Ruby/Rake are installed you need to create your integration tests credentials config file.

Run

rake create_credentials_config

from the project solution directory. This will create a Credentials.config file in root of the repository (same place as the sln file):

PUT USERNAME HERE PUT API KEY HERE https://auth.api.rackspacecloud.com/v1.0

Just replace the placeholder text. This file is not under source control. It is ignored by the .gitignore file.

Examples coming soon on our wiki. prior examples were out of date

Committers

Contributors

License

See COPYING for license information. Copyright (c) 2008, 2009 2010, 2011, Rackspace US, Inc.

About

C#/.NET API for Rackspace Cloud Files

Resources

License

Stars

Watchers

Forks

Packages

No packages published