From a9595114a691fd04ba043c1b1564741a107bbcdd Mon Sep 17 00:00:00 2001 From: Stefan Majewsky Date: Fri, 26 Jan 2018 17:44:33 +0100 Subject: add Account, package docs --- account.go | 89 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 account.go (limited to 'account.go') diff --git a/account.go b/account.go new file mode 100644 index 0000000..6672a62 --- /dev/null +++ b/account.go @@ -0,0 +1,89 @@ +/****************************************************************************** +* +* Copyright 2018 Stefan Majewsky +* +* Licensed under the Apache License, Version 2.0 (the "License"); +* you may not use this file except in compliance with the License. +* You may obtain a copy of the License at +* +* http://www.apache.org/licenses/LICENSE-2.0 +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +* +******************************************************************************/ + +package schwift + +import ( + "fmt" + "regexp" + + "github.com/gophercloud/gophercloud" +) + +//Account represents a Swift account. +type Account struct { + client *gophercloud.ServiceClient + //URL parts + baseURL string + name string +} + +//////////////////////////////////////////////////////////////////////////////// +// interface to Gophercloud, endpoint inspection and manipulation + +var endpointURLRegexp = regexp.MustCompile(`^(.*/)v1/(.*)/$`) + +//AccountFromClient takes a gophercloud.ServiceClient which wraps a Swift +//endpoint, and returns the Account instance corresponding to the account or +//project that this client is connected to. +func AccountFromClient(client *gophercloud.ServiceClient) (*Account, error) { + match := endpointURLRegexp.FindStringSubmatch(client.Endpoint) + if match == nil { + return nil, fmt.Errorf(`schwift.AccountFromClient(): invalid Swift endpoint URL: cannot find "/v1/" in %q`, client.Endpoint) + } + return &Account{ + client: client, + baseURL: match[1], + name: match[2], + }, nil +} + +//SwitchAccount returns a handle on a different account on the same server. Note +//that you need reseller permissions to access accounts other than that where +//you originally authenticated. This method does not check whether the account +//actually exists. +// +//The account name is usually the project name with an additional "AUTH_" +//prefix. +func (a *Account) SwitchAccount(accountName string) *Account { + clonedClient := *a.client + clonedClient.Endpoint = a.baseURL + "v1/" + accountName + "/" + return &Account{ + client: &clonedClient, + baseURL: a.baseURL, + name: accountName, + } +} + +//Name returns the name of the account (usually the prefix "AUTH_" followed by +//the project ID). +func (a *Account) Name() string { + return a.name +} + +//Client returns the gophercloud.ServiceClient which is used to make requests +//against this account. +func (a *Account) Client() *gophercloud.ServiceClient { + return a.client +} + +//////////////////////////////////////////////////////////////////////////////// +// account metadata + +//////////////////////////////////////////////////////////////////////////////// +// container listing -- cgit v1.2.3