util

Documentation

Overview

Package util contains various utility functions that are useful across all of goiardi.

Index

• Variables
• func CheckForObject(orgname string, checksum string) (bool, error)
• func CustomObjURL(obj GoiardiObj, path string) string
• func CustomURL(path string) string
• func DeepMerge(key string, source interface{}) map[string]interface{}
• func FlattenObj(obj interface{}) map[string]interface{}
• func IndexEscapeStr(s string) string
• func Indexify(flattened map[string]interface{}) []string
• func InitS3(conf *config.Conf) error
• func MapifyObject(obj interface{}) map[string]interface{}
• func ObjURL(obj GoiardiObj) string
• func PgSearchKey(key string) string
• func PgSearchQueryKey(key string) string
• func S3CheckFile(orgname, checksum string) bool
• func S3DeleteHashes(fileHashes []string)
• func S3GetURL(orgname string, checksum string) (string, error)
• func S3PutURL(orgname string, checksum string) (string, error)
• func ValidateDBagName(name string) bool
• func ValidateEnvName(name string) bool
• func ValidateName(name string) bool
• func ValidateUserName(name string) bool
• type Gerror
  • func CastErr(err error) Gerror
  • func CheckAdminPlusValidator(jsonActor map[string]interface{}) Gerror
  • func Errorf(format string, a ...interface{}) Gerror
  • func New(text string) Gerror
  • func ValidateAsBool(b interface{}) (bool, Gerror)
  • func ValidateAsConstraint(t interface{}) (bool, Gerror)
  • func ValidateAsFieldString(str interface{}) (string, Gerror)
  • func ValidateAsString(str interface{}) (string, Gerror)
  • func ValidateAsVersion(ver interface{}) (string, Gerror)
  • func ValidateAttributes(key string, attrs interface{}) (map[string]interface{}, Gerror)
  • func ValidateCookbookDivision(dname string, div interface{}) ([]map[string]interface{}, Gerror)
  • func ValidateCookbookMetadata(mdata interface{}) (map[string]interface{}, Gerror)
  • func ValidateNumVersions(nr string) Gerror
  • func ValidateRunList(rl interface{}) ([]string, Gerror)
• type GoiardiObj
• type StringSlice
  • func (s *StringSlice) Scan(src interface{}) error

Variables

var NoDBConfigured = &gerror{msg: "no db configured, but you tried to use one", status: http.StatusInternalServerError}

NoDBConfigured is an error for when no database has been configured for use, yet an SQL function is being called.

Functions

func CheckForObject

func CheckForObject(orgname string, checksum string) (bool, error)

func CustomObjURL

func CustomObjURL(obj GoiardiObj, path string) string

CustomObjURL crafts a URL for a Goiardi object with additional path elements.

func CustomURL

func CustomURL(path string) string

CustomURL crafts a URL from the provided path, without providing an object.

func DeepMerge

func DeepMerge(key string, source interface{}) map[string]interface{}

DeepMerge merges disparate data structures into a flat hash.

func FlattenObj

func FlattenObj(obj interface{}) map[string]interface{}

FlattenObj flattens an object and expand its keys into a map[string]string so it's suitable for indexing, either with solr (eventually) or with the whipped up replacement for local mode. Objects fed into this function *must* have the "json" tag set for their struct members.

func IndexEscapeStr

func IndexEscapeStr(s string) string

IndexEscapeStr escapes values to index in the database, so characters that need to be escaped for Solr are properly found when using the trie or postgres based searches.

func Indexify

func Indexify(flattened map[string]interface{}) []string

Indexify prepares a flattened object for indexing by turning it into a sorted slice of strings formatted like "key:value".

func InitS3

func InitS3(conf *config.Conf) error

InitS3 sets up the session and whatnot for using goiardi with S3.

func MapifyObject

func MapifyObject(obj interface{}) map[string]interface{}

MapifyObject turns an object into a map[string]interface{}. Useful for when you have a slice of objects that you need to trim, mutilate, fold, etc. before returning them as JSON.

func ObjURL

func ObjURL(obj GoiardiObj) string

ObjURL crafts a URL for an object.

func PgSearchKey

func PgSearchKey(key string) string

PgSearchKey removes characters from search term fields that make the ltree data type unhappy. This leads to the postgres-based search being, perhaps, somewhat less precise than the solr (or ersatz solr) based search, but at the same time one that's less resource demanding and covers almost all known use cases. Potential bug: Postgres considers some, but not all, unicode letters as being alphanumeric; i.e. golang and postgres both consider 'ü' to be a letter, but golang accepts 'ሀ' as a letter while postgres does not. This is reasonably unlikely to be an issue, but if you're using lots of non-European characters in your attributes this could be a problem. We're accepting more than raw ASCII alnum however because it's better behavior and because Postgres does accept at least some other alphabets as being alphanumeric.

func PgSearchQueryKey

func PgSearchQueryKey(key string) string

PgSearchQueryKey is very similar to PgSearchKey, except that it preserves the Solr wildcard charactes '*' and '?' in the queries.

func S3CheckFile

func S3CheckFile(orgname, checksum string) bool

func S3DeleteHashes

func S3DeleteHashes(fileHashes []string)

func S3GetURL

func S3GetURL(orgname string, checksum string) (string, error)

func S3PutURL

func S3PutURL(orgname string, checksum string) (string, error)

func ValidateDBagName

func ValidateDBagName(name string) bool

func ValidateEnvName

func ValidateEnvName(name string) bool

func ValidateName

func ValidateName(name string) bool

func ValidateUserName

func ValidateUserName(name string) bool

Types

type Gerror

type Gerror interface {
	String() string
	Error() string
	Status() int
	SetStatus(int)
}

Gerror is an error type that includes an http status code (defaults to http.BadRequest).

func CastErr

func CastErr(err error) Gerror

CastErr will easily cast a different kind of error to a Gerror.

func CheckAdminPlusValidator

func CheckAdminPlusValidator(jsonActor map[string]interface{}) Gerror

CheckAdminPlusValidator checks that client/user json is not trying to set admin and validator at the same time. This has to be checked separately to make chef-pedent happy.

func Errorf

func Errorf(format string, a ...interface{}) Gerror

Errorf creates a new Gerror, with a formatted error string.

func New

func New(text string) Gerror

New makes a new Gerror. Usually you want Errorf.

func ValidateAsBool

func ValidateAsBool(b interface{}) (bool, Gerror)

func ValidateAsConstraint

func ValidateAsConstraint(t interface{}) (bool, Gerror)

func ValidateAsFieldString

func ValidateAsFieldString(str interface{}) (string, Gerror)

func ValidateAsString

func ValidateAsString(str interface{}) (string, Gerror)

func ValidateAsVersion

func ValidateAsVersion(ver interface{}) (string, Gerror)

func ValidateAttributes

func ValidateAttributes(key string, attrs interface{}) (map[string]interface{}, Gerror)

func ValidateCookbookDivision

func ValidateCookbookDivision(dname string, div interface{}) ([]map[string]interface{}, Gerror)

func ValidateCookbookMetadata

func ValidateCookbookMetadata(mdata interface{}) (map[string]interface{}, Gerror)

func ValidateNumVersions

func ValidateNumVersions(nr string) Gerror

func ValidateRunList

func ValidateRunList(rl interface{}) ([]string, Gerror)

type GoiardiObj

type GoiardiObj interface {
	GetName() string
	URLType() string
}

GoiardiObj is an interface for helping goiardi/chef objects, like cookbooks, roles, etc., be able to easily make URLs and be identified by name.

type StringSlice

type StringSlice []string

StringSlice makes it possible to scan Posgres arrays directly into a golang slice. Borrowed from https://gist.github.com/adharris/4163702.

func (*StringSlice) Scan

func (s *StringSlice) Scan(src interface{}) error

Scan implements sql.Scanner for the StringSlice type.