environments

Documentation

Overview

Package environments defines data structure representing a environment instance and methods for interacting with them it is left to concrete implementations in package db or others to implement these interfaces

Index

• Variables
• func Seed(db *gorm.DB) ([]models.Environment, error)
• type EnvironmentController
  • func NewController(dbConn *gorm.DB) *EnvironmentController
  • func NewMockController(mockStore *MockEnvironmentStore) *EnvironmentController
  • func (environmentController *EnvironmentController) CreateNew(newEnvironment models.CreateEnvironmentRequest) (models.Environment, error)
  • func (environmentController EnvironmentController) DoesEnvironmentExist(name string) (id int, ok bool)
  • func (environmentController *EnvironmentController) FindOrCreate(name string) (int, error)
  • func (environmentController *EnvironmentController) GetByID(ID int) (models.Environment, error)
  • func (environmentController *EnvironmentController) GetByName(name string) (models.Environment, error)
  • func (environmentController *EnvironmentController) ListAll() ([]models.Environment, error)
  • func (ec *EnvironmentController) RegisterHandlers(routerGroup *gin.RouterGroup)
• type EnvironmentResponse
• type EnvironmentSerializer
  • func (es *EnvironmentSerializer) Response() EnvironmentResponse
• type EnvironmentsSerializer
  • func (es *EnvironmentsSerializer) Response() []EnvironmentResponse
• type MockEnvironmentStore
  • func (m *MockEnvironmentStore) CreateNew(newEnvironment models.CreateEnvironmentRequest) (models.Environment, error)
  • func (m *MockEnvironmentStore) GetByID(id int) (models.Environment, error)
  • func (m *MockEnvironmentStore) GetByName(name string) (models.Environment, error)
  • func (m *MockEnvironmentStore) ListAll() ([]models.Environment, error)
• type Response

Variables

var ErrBadCreateRequest error = errors.New("error invalid create environment request. environment name is required")

ErrBadCreateRequest is an error type used when a create environment request fails validation checks

Functions

func Seed

func Seed(db *gorm.DB) ([]models.Environment, error)

Seed takes a gorm DB connection and will seed a db with some fake environment data for use in integration testing

Types

type EnvironmentController

type EnvironmentController struct {
	// contains filtered or unexported fields
}

EnvironmentController is the management layer for environments

func NewController

func NewController(dbConn *gorm.DB) *EnvironmentController

NewController accepts a gorm DB connection and returns a new instance of the environment controller

func NewMockController

func NewMockController(mockStore *MockEnvironmentStore) *EnvironmentController

NewMockController returns an EnvironmentController instance with the provided mock of the storage layer for use in unit tests

func (*EnvironmentController) CreateNew

func (environmentController *EnvironmentController) CreateNew(newEnvironment models.CreateEnvironmentRequest) (models.Environment, error)

CreateNew is the public api on the environmentController for persisting a new service entity to the data store

func (EnvironmentController) DoesEnvironmentExist

func (environmentController EnvironmentController) DoesEnvironmentExist(name string) (id int, ok bool)

DoesEnvironmentExist is a helper method to check if a environment with the given name already exists in sherlock's data storage

func (*EnvironmentController) FindOrCreate

func (environmentController *EnvironmentController) FindOrCreate(name string) (int, error)

FindOrCreate will attempt to look an environment by name and return its ID if successful if unsuccessful it will create a new environment from the provider name and return that id

func (*EnvironmentController) GetByID

func (environmentController *EnvironmentController) GetByID(ID int) (models.Environment, error)

GetByName is the public API for looking up a environment from the data store by name

func (*EnvironmentController) GetByName

func (environmentController *EnvironmentController) GetByName(name string) (models.Environment, error)

GetByName is the public API for looking up a environment from the data store by name

func (*EnvironmentController) ListAll

func (environmentController *EnvironmentController) ListAll() ([]models.Environment, error)

ListAll is the public api for listing out all environments tracked by sherlock

func (*EnvironmentController) RegisterHandlers

func (ec *EnvironmentController) RegisterHandlers(routerGroup *gin.RouterGroup)

RegisterHandlers accepts a routergroup and will attach all the handlers for working with environment entities to it

type EnvironmentResponse

type EnvironmentResponse struct {
	ID   int    `json:"id"`
	Name string `json:"name"`
}

EnvironmentResponse is the type that environment entities are serialized to and used in responses to clients

type EnvironmentSerializer

type EnvironmentSerializer struct {
	Environment models.Environment
}

func (*EnvironmentSerializer) Response

func (es *EnvironmentSerializer) Response() EnvironmentResponse

type EnvironmentsSerializer

type EnvironmentsSerializer struct {
	Environments []models.Environment
}

EnvironmentsSerializer is used to convert a list of environment model types to a Respopnse type used to send environment info to clients

func (*EnvironmentsSerializer) Response

func (es *EnvironmentsSerializer) Response() []EnvironmentResponse

Response is a function that Serializers a slice of Environment models to responses suitable for sending to clients

type MockEnvironmentStore

type MockEnvironmentStore struct {
	mock.Mock
}

MockEnvironmentStore is a concrete type that implements environmentStore interface for use in unit tests

func (*MockEnvironmentStore) CreateNew

func (m *MockEnvironmentStore) CreateNew(newEnvironment models.CreateEnvironmentRequest) (models.Environment, error)

func (*MockEnvironmentStore) GetByID

func (m *MockEnvironmentStore) GetByID(id int) (models.Environment, error)

func (*MockEnvironmentStore) GetByName

func (m *MockEnvironmentStore) GetByName(name string) (models.Environment, error)

func (*MockEnvironmentStore) ListAll

func (m *MockEnvironmentStore) ListAll() ([]models.Environment, error)

type Response

type Response struct {
	Environments []EnvironmentResponse `json:"environments"`
	Error        string                `json:"error,omitempty"`
}

Response is a type that allows all data returned from the /environment api group to share a consistent structure