Finish DB docs for Rackspace
diff --git a/rackspace/db/v1/datastores/results.go b/rackspace/db/v1/datastores/results.go
index 31fd838..a86a3cc 100644
--- a/rackspace/db/v1/datastores/results.go
+++ b/rackspace/db/v1/datastores/results.go
@@ -6,12 +6,14 @@
"github.com/rackspace/gophercloud/pagination"
)
+// Version represents a version API resource. Multiple versions belong to a Datastore.
type Version struct {
ID string
Links []gophercloud.Link
Name string
}
+// Datastore represents a Datastore API resource.
type Datastore struct {
DefaultVersion string `json:"default_version" mapstructure:"default_version"`
ID string
@@ -20,24 +22,31 @@
Versions []Version
}
+// DatastorePartial is a meta structure which is used in various API responses.
+// It is a lightweight and truncated version of a full Datastore resource,
+// offering details of the Version, Type and VersionID only.
type DatastorePartial struct {
Version string
Type string
VersionID string `json:"version_id" mapstructure:"version_id"`
}
+// GetResult represents the result of a Get operation.
type GetResult struct {
gophercloud.Result
}
+// GetVersionResult represents the result of getting a version.
type GetVersionResult struct {
gophercloud.Result
}
+// DatastorePage represents a page of datastore resources.
type DatastorePage struct {
pagination.SinglePageBase
}
+// IsEmpty indicates whether a Datastore collection is empty.
func (r DatastorePage) IsEmpty() (bool, error) {
is, err := ExtractDatastores(r)
if err != nil {
@@ -46,6 +55,8 @@
return len(is) == 0, nil
}
+// ExtractDatastores retrieves a slice of datastore structs from a paginated
+// collection.
func ExtractDatastores(page pagination.Page) ([]Datastore, error) {
casted := page.(DatastorePage).Body
@@ -57,6 +68,7 @@
return resp.Datastores, err
}
+// Extract retrieves a single Datastore struct from an operation result.
func (r GetResult) Extract() (*Datastore, error) {
if r.Err != nil {
return nil, r.Err
@@ -70,10 +82,12 @@
return &response.Datastore, err
}
+// DatastorePage represents a page of version resources.
type VersionPage struct {
pagination.SinglePageBase
}
+// IsEmpty indicates whether a collection of version resources is empty.
func (r VersionPage) IsEmpty() (bool, error) {
is, err := ExtractVersions(r)
if err != nil {
@@ -82,6 +96,7 @@
return len(is) == 0, nil
}
+// ExtractVersions retrieves a slice of versions from a paginated collection.
func ExtractVersions(page pagination.Page) ([]Version, error) {
casted := page.(VersionPage).Body
@@ -93,6 +108,7 @@
return resp.Versions, err
}
+// Extract retrieves a single Version struct from an operation result.
func (r GetVersionResult) Extract() (*Version, error) {
if r.Err != nil {
return nil, r.Err