Repository files navigation

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

Use go to install the library

go get github.com/ncw/swift/v2

See here for full package docs

• https://pkg.go.dev/github.com/ncw/swift/v2

Here is a short example from the docs

import"github.com/ncw/swift/v2"// Create a connectionc:= 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)}// Authenticateerr:=c.Authenticate()iferr!=nil {panic(err)}// List all the containerscontainers,err:=c.ContainerNames(nil)fmt.Println(containers)// etc...

The library has current major version v2. If you want to migrate from the first version oflibrarygithub.com/ncw/swift you have to explicitly add the/v2 suffix to the imports.

Most of the exported functions were added a newcontext.Context parameter in thev2, which you will have to providewhen migrating.

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

To run the tests you can either use an embedded fake Swift server either use a real Openstack Swift server or aRackspace 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 withgo test

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

The project website is at:

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

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

• Nick Craig-Woodnick@craig-wood.com

• Brian "bojo" Jonesmojobojo@gmail.com
• Janika Liivjanika@toggl.com
• Yamamoto, Hirotakaymmt2005@gmail.com
• Stephenyo@groks.org
• platformpurplestephen@platformpurple.com
• Paul Quernapquerna@apache.org
• Livio Soaresliviobs@gmail.com
• thesyncimthesyncim@gmail.com
• lsowenlsowen@s1network.comlogan@s1network.com
• Sylvain Baubeausbaubeau@redhat.com
• Chris Kastorffencryptio@gmail.com
• Dai HaoJunhaojun.dai@hp.com
• Hua Wangwanghua.humble@gmail.com
• Fabian Rufffabian@progra.defabian.ruff@sap.com
• Arturo Reuschenbach Puncernaureuschenbach@gmail.com
• Petr Kotekpetr.kotek@bigcommerce.com
• Stefan Majewskystefan.majewsky@sap.commajewsky@gmx.net
• Cezar Sa Espinolacezarsa@gmail.com
• Sam Gunaratnesamgzeit@gmail.com
• Richard Scothernrichard.scothern@gmail.com
• Michel Couillardmichel.couillard@gmail.com
• Christopher Waldonckwaldon@us.ibm.com
• dennisdai.haojun@gmail.com
• haghannes.georg@xing.com
• Alexander Neumannalexander@bumpern.de
• eclipseo30413512+eclipseo@users.noreply.github.com
• Yuri Peryuri@acronis.com
• Falk Reimannfalk.reimann@sap.com
• Arthur Paim Arnoldarthurpaimarnold@gmail.com
• Bruno Michelbmichel@menfin.info
• Charles Hsucharles0126@gmail.com
• Omar Aliomarali@users.noreply.github.com
• Andreas Andersenandreas@softwaredesign.se
• kayruskay.diam@gmail.com
• CodeLingo Botbot@codelingo.io
• Jérémy Clercjeremy.clerc@tagpay.fr
• 4xicom37339705+4xicom@users.noreply.github.com
• Bobo@4xi.com
• Thiago da Silvathiagodasilva@users.noreply.github.com
• Brandon WELSCHdev@brandon-welsch.eu
• Damien Tournouddamien@platform.sh
• Pedro Kieferpedro@kiefer.com.br
• Martin Chodurm.chodur@seznam.cz
• Devendradevendranath.thadi3@gmail.com
• timsstimsateroy@gmail.com
• Jos Houtmanjos@houtman.it
• Paul Collinspaul.collins@canonical.com
• Joe Caijoe.cai@bigcommerce.com
• fsantagostinobietti6057026+fsantagostinobietti@users.noreply.github.com