[#58] Update types for golint

This patch addresses guidance from effective go [0] and golint
failures such as:

pkg/document/document.go:8:6: type name will be used as
document.DocumentFactory by other packages, and that stutters; consider
calling this Factory
pkg/remote/errors.go:9:6: type name will be used as
remote.RemoteDirectError by other packages, and that stutters; consider
calling this DirectError
pkg/remote/remote_direct.go:27:6: type name will be used as
remote.RemoteDirectClient by other packages, and that stutters; consider
calling this DirectClient
pkg/remote/redfish/errors.go:10:6: type name will be used as
redfish.RedfishClientError by other packages, and that stutters;
consider calling this ClientError
pkg/remote/redfish/redfish.go:14:6: type name will be used as
redfish.RedfishRemoteDirect by other packages, and that stutters;
consider calling this RemoteDirect

[0] https://golang.org/doc/effective_go.html#package-names

Relates-To: #58

Change-Id: I6d94da7755c8719bbcc4a77917e283074281309a
Signed-off-by: Alexander Hughes <Alexander.Hughes@pm.me>
This commit is contained in:
Alexander Hughes 2020-02-28 10:43:20 -05:00
parent 517cf775c9
commit 2bf3117197
9 changed files with 44 additions and 44 deletions

View File

@ -180,9 +180,9 @@ func (b *BundleFactory) GetByName(name string) (Document, error) {
// by adding strongly typed errors // by adding strongly typed errors
switch found := len(resSet); { switch found := len(resSet); {
case found == 0: case found == 0:
return &DocumentFactory{}, fmt.Errorf("no documents found with name %s", name) return &Factory{}, fmt.Errorf("no documents found with name %s", name)
case found > 1: case found > 1:
return &DocumentFactory{}, fmt.Errorf("more than one document found with name %s", name) return &Factory{}, fmt.Errorf("more than one document found with name %s", name)
default: default:
return NewDocument(resSet[0]) return NewDocument(resSet[0])
} }

View File

@ -4,8 +4,8 @@ import (
"sigs.k8s.io/kustomize/v3/pkg/resource" "sigs.k8s.io/kustomize/v3/pkg/resource"
) )
// DocumentFactory holds document data // Factory holds document data
type DocumentFactory struct { type Factory struct {
resource.Resource resource.Resource
} }
@ -29,90 +29,90 @@ type Document interface {
} }
// GetNamespace returns the namespace the resource thinks it's in. // GetNamespace returns the namespace the resource thinks it's in.
func (d *DocumentFactory) GetNamespace() string { func (d *Factory) GetNamespace() string {
r := d.GetKustomizeResource() r := d.GetKustomizeResource()
return r.GetNamespace() return r.GetNamespace()
} }
// GetString returns the string value at path. // GetString returns the string value at path.
func (d *DocumentFactory) GetString(path string) (string, error) { func (d *Factory) GetString(path string) (string, error) {
r := d.GetKustomizeResource() r := d.GetKustomizeResource()
return r.GetString(path) return r.GetString(path)
} }
// GetStringSlice returns a string slice at path. // GetStringSlice returns a string slice at path.
func (d *DocumentFactory) GetStringSlice(path string) ([]string, error) { func (d *Factory) GetStringSlice(path string) ([]string, error) {
r := d.GetKustomizeResource() r := d.GetKustomizeResource()
return r.GetStringSlice(path) return r.GetStringSlice(path)
} }
// GetBool returns a bool at path. // GetBool returns a bool at path.
func (d *DocumentFactory) GetBool(path string) (bool, error) { func (d *Factory) GetBool(path string) (bool, error) {
r := d.GetKustomizeResource() r := d.GetKustomizeResource()
return r.GetBool(path) return r.GetBool(path)
} }
// GetFloat64 returns a float64 at path. // GetFloat64 returns a float64 at path.
func (d *DocumentFactory) GetFloat64(path string) (float64, error) { func (d *Factory) GetFloat64(path string) (float64, error) {
r := d.GetKustomizeResource() r := d.GetKustomizeResource()
return r.GetFloat64(path) return r.GetFloat64(path)
} }
// GetInt64 returns an int64 at path. // GetInt64 returns an int64 at path.
func (d *DocumentFactory) GetInt64(path string) (int64, error) { func (d *Factory) GetInt64(path string) (int64, error) {
r := d.GetKustomizeResource() r := d.GetKustomizeResource()
return r.GetInt64(path) return r.GetInt64(path)
} }
// GetSlice returns a slice at path. // GetSlice returns a slice at path.
func (d *DocumentFactory) GetSlice(path string) ([]interface{}, error) { func (d *Factory) GetSlice(path string) ([]interface{}, error) {
r := d.GetKustomizeResource() r := d.GetKustomizeResource()
return r.GetSlice(path) return r.GetSlice(path)
} }
// GetStringMap returns a string map at path. // GetStringMap returns a string map at path.
func (d *DocumentFactory) GetStringMap(path string) (map[string]string, error) { func (d *Factory) GetStringMap(path string) (map[string]string, error) {
r := d.GetKustomizeResource() r := d.GetKustomizeResource()
return r.GetStringMap(path) return r.GetStringMap(path)
} }
// GetMap returns a map at path. // GetMap returns a map at path.
func (d *DocumentFactory) GetMap(path string) (map[string]interface{}, error) { func (d *Factory) GetMap(path string) (map[string]interface{}, error) {
r := d.GetKustomizeResource() r := d.GetKustomizeResource()
return r.GetMap(path) return r.GetMap(path)
} }
// AsYAML returns the document as a YAML byte stream. // AsYAML returns the document as a YAML byte stream.
func (d *DocumentFactory) AsYAML() ([]byte, error) { func (d *Factory) AsYAML() ([]byte, error) {
r := d.GetKustomizeResource() r := d.GetKustomizeResource()
return r.AsYAML() return r.AsYAML()
} }
// MarshalJSON returns the document as JSON. // MarshalJSON returns the document as JSON.
func (d *DocumentFactory) MarshalJSON() ([]byte, error) { func (d *Factory) MarshalJSON() ([]byte, error) {
r := d.GetKustomizeResource() r := d.GetKustomizeResource()
return r.MarshalJSON() return r.MarshalJSON()
} }
// GetName returns the name: field from the document. // GetName returns the name: field from the document.
func (d *DocumentFactory) GetName() string { func (d *Factory) GetName() string {
r := d.GetKustomizeResource() r := d.GetKustomizeResource()
return r.GetName() return r.GetName()
} }
// GetKind returns the Kind: field from the document. // GetKind returns the Kind: field from the document.
func (d *DocumentFactory) GetKind() string { func (d *Factory) GetKind() string {
r := d.GetKustomizeResource() r := d.GetKustomizeResource()
return r.GetKind() return r.GetKind()
} }
// GetKustomizeResource returns a Kustomize Resource object for this document. // GetKustomizeResource returns a Kustomize Resource object for this document.
func (d *DocumentFactory) GetKustomizeResource() resource.Resource { func (d *Factory) GetKustomizeResource() resource.Resource {
return d.Resource return d.Resource
} }
// SetKustomizeResource sets a Kustomize Resource object for this document. // SetKustomizeResource sets a Kustomize Resource object for this document.
func (d *DocumentFactory) SetKustomizeResource(r *resource.Resource) error { func (d *Factory) SetKustomizeResource(r *resource.Resource) error {
d.Resource = *r d.Resource = *r
return nil return nil
} }
@ -124,7 +124,7 @@ func (d *DocumentFactory) SetKustomizeResource(r *resource.Resource) error {
// documents - e.g. in the future all documents require an airship // documents - e.g. in the future all documents require an airship
// annotation X // annotation X
func NewDocument(r *resource.Resource) (Document, error) { func NewDocument(r *resource.Resource) (Document, error) {
var doc Document = &DocumentFactory{} var doc Document = &Factory{}
err := doc.SetKustomizeResource(r) err := doc.SetKustomizeResource(r)
return doc, err return doc, err
} }

View File

@ -6,12 +6,12 @@ import (
aerror "opendev.org/airship/airshipctl/pkg/errors" aerror "opendev.org/airship/airshipctl/pkg/errors"
) )
type RemoteDirectError struct { type GenericError struct {
aerror.AirshipError aerror.AirshipError
} }
func NewRemoteDirectErrorf(format string, v ...interface{}) error { func NewRemoteDirectErrorf(format string, v ...interface{}) error {
e := &RemoteDirectError{} e := &GenericError{}
e.Message = fmt.Sprintf(format, v...) e.Message = fmt.Sprintf(format, v...)
return e return e
} }

View File

@ -7,12 +7,12 @@ import (
aerror "opendev.org/airship/airshipctl/pkg/errors" aerror "opendev.org/airship/airshipctl/pkg/errors"
) )
type RedfishClientError struct { type ClientError struct {
aerror.AirshipError aerror.AirshipError
} }
func NewRedfishClientErrorf(format string, v ...interface{}) error { func NewRedfishClientErrorf(format string, v ...interface{}) error {
e := &RedfishClientError{} e := &ClientError{}
e.Message = fmt.Sprintf(format, v...) e.Message = fmt.Sprintf(format, v...)
return e return e
} }

View File

@ -11,7 +11,7 @@ import (
alog "opendev.org/airship/airshipctl/pkg/log" alog "opendev.org/airship/airshipctl/pkg/log"
) )
type RedfishRemoteDirect struct { type RemoteDirect struct {
// Context // Context
Context context.Context Context context.Context
@ -30,7 +30,7 @@ type RedfishRemoteDirect struct {
} }
// Top level function to handle Redfish remote direct // Top level function to handle Redfish remote direct
func (cfg RedfishRemoteDirect) DoRemoteDirect() error { func (cfg RemoteDirect) DoRemoteDirect() error {
alog.Debugf("Using Redfish Endpoint: '%s'", cfg.RemoteURL.String()) alog.Debugf("Using Redfish Endpoint: '%s'", cfg.RemoteURL.String())
/* TODO: Add Authentication when redfish library supports it. */ /* TODO: Add Authentication when redfish library supports it. */
@ -82,23 +82,23 @@ func NewRedfishRemoteDirectClient(ctx context.Context,
remoteURL string, remoteURL string,
ephNodeID string, ephNodeID string,
isoPath string, isoPath string,
) (RedfishRemoteDirect, error) { ) (RemoteDirect, error) {
if remoteURL == "" { if remoteURL == "" {
return RedfishRemoteDirect{}, return RemoteDirect{},
ErrRedfishMissingConfig{ ErrRedfishMissingConfig{
What: "redfish remote url empty", What: "redfish remote url empty",
} }
} }
if ephNodeID == "" { if ephNodeID == "" {
return RedfishRemoteDirect{}, return RemoteDirect{},
ErrRedfishMissingConfig{ ErrRedfishMissingConfig{
What: "redfish ephemeral node id empty", What: "redfish ephemeral node id empty",
} }
} }
if isoPath == "" { if isoPath == "" {
return RedfishRemoteDirect{}, return RemoteDirect{},
ErrRedfishMissingConfig{ ErrRedfishMissingConfig{
What: "redfish ephemeral node iso Path empty", What: "redfish ephemeral node iso Path empty",
} }
@ -114,13 +114,13 @@ func NewRedfishRemoteDirectClient(ctx context.Context,
parsedURL, err := url.Parse(remoteURL) parsedURL, err := url.Parse(remoteURL)
if err != nil { if err != nil {
return RedfishRemoteDirect{}, return RemoteDirect{},
ErrRedfishMissingConfig{ ErrRedfishMissingConfig{
What: fmt.Sprintf("invalid url format: %v", err), What: fmt.Sprintf("invalid url format: %v", err),
} }
} }
client := RedfishRemoteDirect{ client := RemoteDirect{
Context: ctx, Context: ctx,
RemoteURL: *parsedURL, RemoteURL: *parsedURL,
EphemeralNodeID: ephNodeID, EphemeralNodeID: ephNodeID,

View File

@ -75,7 +75,7 @@ func TestRedfishRemoteDirectInvalidSystemId(t *testing.T) {
err := localRDCfg.DoRemoteDirect() err := localRDCfg.DoRemoteDirect()
_, ok := err.(*RedfishClientError) _, ok := err.(*ClientError)
assert.True(t, ok) assert.True(t, ok)
} }
@ -96,7 +96,7 @@ func TestRedfishRemoteDirectGetSystemNetworkError(t *testing.T) {
err := rDCfg.DoRemoteDirect() err := rDCfg.DoRemoteDirect()
_, ok := err.(*RedfishClientError) _, ok := err.(*ClientError)
assert.True(t, ok) assert.True(t, ok)
} }
@ -123,7 +123,7 @@ func TestRedfishRemoteDirectInvalidIsoPath(t *testing.T) {
err := localRDCfg.DoRemoteDirect() err := localRDCfg.DoRemoteDirect()
_, ok := err.(*RedfishClientError) _, ok := err.(*ClientError)
assert.True(t, ok) assert.True(t, ok)
} }
@ -148,7 +148,7 @@ func TestRedfishRemoteDirectCdDvdNotAvailableInBootSources(t *testing.T) {
err := rDCfg.DoRemoteDirect() err := rDCfg.DoRemoteDirect()
_, ok := err.(*RedfishClientError) _, ok := err.(*ClientError)
assert.True(t, ok) assert.True(t, ok)
} }
@ -175,7 +175,7 @@ func TestRedfishRemoteDirectSetSystemBootSourceFailed(t *testing.T) {
err := rDCfg.DoRemoteDirect() err := rDCfg.DoRemoteDirect()
_, ok := err.(*RedfishClientError) _, ok := err.(*ClientError)
assert.True(t, ok) assert.True(t, ok)
} }
@ -209,7 +209,7 @@ func TestRedfishRemoteDirectSystemRebootFailed(t *testing.T) {
err := rDCfg.DoRemoteDirect() err := rDCfg.DoRemoteDirect()
_, ok := err.(*RedfishClientError) _, ok := err.(*ClientError)
assert.True(t, ok) assert.True(t, ok)
} }
@ -240,7 +240,7 @@ func getTestSystem() redfishClient.ComputerSystem {
} }
} }
func getDefaultRedfishRemoteDirectObj(t *testing.T, api redfishAPI.RedfishAPI) RedfishRemoteDirect { func getDefaultRedfishRemoteDirectObj(t *testing.T, api redfishAPI.RedfishAPI) RemoteDirect {
t.Helper() t.Helper()
rDCfg, err := NewRedfishRemoteDirectClient( rDCfg, err := NewRedfishRemoteDirectClient(

View File

@ -25,7 +25,7 @@ func TestRedfishErrorNonNilErrorWithoutHttpResp(t *testing.T) {
realErr := fmt.Errorf("sample error") realErr := fmt.Errorf("sample error")
err := ScreenRedfishError(nil, realErr) err := ScreenRedfishError(nil, realErr)
assert.Error(t, err) assert.Error(t, err)
_, ok := err.(*RedfishClientError) _, ok := err.(*ClientError)
assert.True(t, ok) assert.True(t, ok)
} }

View File

@ -24,13 +24,13 @@ const (
) )
// Interface to be implemented by remoteDirect implementation // Interface to be implemented by remoteDirect implementation
type RemoteDirectClient interface { type Client interface {
DoRemoteDirect() error DoRemoteDirect() error
} }
// Get remotedirect client based on config // Get remotedirect client based on config
func getRemoteDirectClient(remoteConfig *config.RemoteDirect, remoteURL string) (RemoteDirectClient, error) { func getRemoteDirectClient(remoteConfig *config.RemoteDirect, remoteURL string) (Client, error) {
var client RemoteDirectClient var client Client
switch remoteConfig.RemoteType { switch remoteConfig.RemoteType {
case AirshipRemoteTypeRedfish: case AirshipRemoteTypeRedfish:
alog.Debug("Remote type redfish") alog.Debug("Remote type redfish")

View File

@ -36,7 +36,7 @@ func TestUnknownRemoteType(t *testing.T) {
err := DoRemoteDirect(s) err := DoRemoteDirect(s)
_, ok := err.(*RemoteDirectError) _, ok := err.(*GenericError)
assert.True(t, ok) assert.True(t, ok)
} }