github.com/lebauce/swift

Swift

This package provides an easy to use library for interfacing with Swift / Openstack Object Storage / Rackspace cloud files from the Go Language

See here for package docs

http://godoc.org/github.com/ncw/swift

Install

Use go to install the library

go get github.com/ncw/swift

Usage

See here for full package docs

• http://godoc.org/github.com/ncw/swift

Here is a short example from the docs

import "github.com/ncw/swift"

// Create a connection
c := swift.Connection{
    UserName: "user",
    ApiKey:   "key",
    AuthUrl:  "auth_url",
}
// Authenticate
err := c.Authenticate()
if err != nil {
    panic(err)
}
// List all the containers
containers, err := c.ContainerNames(nil)
fmt.Println(containers)
// etc...

Additions

The rs sub project contains a wrapper for the Rackspace specific CDN Management interface.

Testing

To run the tests you can either use an embedded fake Swift server either use a real Openstack Swift server or a Rackspace Cloud files account.

When using a real Swift server, you need to set these environment variables before running the tests

export SWIFT_API_USER='user'
export SWIFT_API_KEY='key'
export SWIFT_AUTH_URL='https://url.of.auth.server/v1.0'

And optionally these if using v2 authentication

export SWIFT_TENANT='TenantName'
export SWIFT_TENANT_ID='TenantId'

Then run the tests with go test

License

This is free software under the terms of MIT license (check COPYING file included in this package).

Contact and support

The project website is at:

• https://github.com/ncw/swift

There you can file bug reports, ask for help or contribute patches.

Authors

• Nick Craig-Wood [e-mail]

Contributors

• Brian "bojo" Jones [e-mail]
• Janika Liiv [e-mail]
• Yamamoto, Hirotaka [e-mail]
• Stephen [e-mail]
• platformpurple [e-mail]
• Paul Querna [e-mail]
• Livio Soares [e-mail]
• thesyncim [e-mail]
• lsowen [e-mail]
• Sylvain Baubeau [e-mail]
• Chris Kastorff [e-mail]