Nick Craig-Woodvendor: update all dependenciesabb9f896 years agoHistory
NameLast commit messageLast commit date
..
.gitignoreUse a vendor directory for repeatable builds - fixes #81610 years ago
.travis.ymlvendor: update github.com/ncw/swift to bring in Expires changes7 years ago
auth.govendor: update github.com/ncw/swift to bring in Expires changes7 years ago
auth_v3.govendor: update github.com/ncw/swift to bring in Expires changes7 years ago
compatibility_1_0.goUse a vendor directory for repeatable builds - fixes #81610 years ago
compatibility_1_1.goUse a vendor directory for repeatable builds - fixes #81610 years ago
compatibility_1_6.govendor: update github.com/ncw/swift to help with #30417 years ago
compatibility_not_1_6.govendor: pull in github.com/ncw/swift latest to fix reauth on big files7 years ago
COPYINGUse a vendor directory for repeatable builds - fixes #81610 years ago
dlo.govendor: update all dependencies7 years ago
doc.goUse a vendor directory for repeatable builds - fixes #81610 years ago
go.modvendor: update to latest versions of everything8 years ago
largeobjects.govendor: update github.com/ncw/swift to fix memory leak in swift transfers9 years ago
meta.govendor: update github.com/ncw/swift to bring in Expires changes7 years ago
notes.txtUse a vendor directory for repeatable builds - fixes #81610 years ago
README.mdvendor: update all dependencies6 years ago
slo.govendor: update all dependencies to latest versions8 years ago
swift.govendor: update all dependencies6 years ago
timeout_reader.govendor: update github.com/ncw/swift to fix memory leak in swift transfers9 years ago
travis_realserver.shvendor: switch to using go1.11 modules8 years ago
watchdog_reader.goSwitch to using the dep tool and update all the dependencies9 years ago
README.md

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

Build Status GoDoc

Install

Use go to install the library

go get github.com/ncw/swift

Usage

See here for full package docs

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",
    Domain:   "domain",  // Name of the domain (v3 auth only)
    Tenant:   "tenant",  // Name of the tenant (v2 auth only)
}
// 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'

And optionally these if using v3 authentication

export SWIFT_TENANT='TenantName'
export SWIFT_TENANT_ID='TenantId'
export SWIFT_API_DOMAIN_ID='domain id'
export SWIFT_API_DOMAIN='domain name'

And optionally these if using v3 trust

export SWIFT_TRUST_ID='TrustId'

And optionally this if you want to skip server certificate validation

export SWIFT_AUTH_INSECURE=1

And optionally this to configure the connect channel timeout, in seconds

export SWIFT_CONNECTION_CHANNEL_TIMEOUT=60

And optionally this to configure the data channel timeout, in seconds

export SWIFT_DATA_CHANNEL_TIMEOUT=60

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:

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

Authors

Contributors