config

Documentation

Index

• func NewTLS(config TLS, opts ...TLSOption) (*tls.Config, error)
• type Logger
  • func NewLogger(opts ...Option) (Logger, error)
  • func (l Logger) Format() string
  • func (l Logger) Level() string
• type Option
  • func WithPrefix(prefix string) Option
• type Options
• type SQL
  • func NewSQL(opts ...Option) (SQL, error)
  • func (s SQL) Driver() string
  • func (s SQL) URL() string
• type Server
  • func NewServer(opts ...Option) (Server, error)
  • func (s Server) Addr() string
  • func (s Server) CACert() string
  • func (s Server) Cert() string
  • func (s Server) Key() string
• type TLS
• type TLSOption
  • func WithMTLS() TLSOption

Functions

func NewTLS

func NewTLS(config TLS, opts ...TLSOption) (*tls.Config, error)

NewTLS will create a *tls.Config given the config and options. This will return an error if there is a problem loading the required certificate files. If the WithMTLS option is specified, a client CA cert is required.

Types

type Logger

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

Logger holds the configuration information for a logger.

func NewLogger

func NewLogger(opts ...Option) (Logger, error)

NewLogger returns the configuration of a logger.

func (Logger) Format

func (l Logger) Format() string

Format returns the logging format for the logger. The value is set from the <PREFIX_>LOG_FORMAT environment variable.

func (Logger) Level

func (l Logger) Level() string

Level returns the logging level for the logger. The value is set from the <PREFIX_>LOG_LEVEL environment variable.

type Option

type Option interface {
	Apply(*Options)
}

Option provides options when loading configuration information.

func WithPrefix

func WithPrefix(prefix string) Option

WithPrefix adds a prefix to the name of the enviroment variables being referenced.

type Options

type Options struct {
	// Prefix, if set, will require the prefix to be present in the name of the
	// environment variables associated with the config object.
	Prefix string
}

Options hold the config package options.

type SQL

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

SQL holds the configuration settings needed to connect to an sql database.

func NewSQL

func NewSQL(opts ...Option) (SQL, error)

NewSQL returns the sql configuration.

func (SQL) Driver

func (s SQL) Driver() string

Driver returns the sql database driver. The value is set from the <PREFIX_>SQL_DRIVER environment variable.

func (SQL) URL

func (s SQL) URL() string

URL returns the connection URL for the SQL database. The value is set from the <PREFIX_>SQL_URL environment variable.

type Server

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

Server holds the configuration settings for a server.

func NewServer

func NewServer(opts ...Option) (Server, error)

NewServer returns the server configuration.

func (Server) Addr

func (s Server) Addr() string

Addr returns the network address the server will listen on. The value is set from the <PREFIX_>SERVER_ADDR environment variable.

func (Server) CACert

func (s Server) CACert() string

CACert returns the path of the certificate of the CA certificate file. This is used when creating a TLS connection with an entity that is presenting a certificate that is not signed by a well known CA available in the OS CA bundle. The value is set from the <PREFIX_>SERVER_CACERT environment variable.

func (Server) Cert

func (s Server) Cert() string

Cert returns the path of the certificate file. The value is set from the <PREFIX_>SERVER_CERT environment variable.

func (Server) Key

func (s Server) Key() string

Key returns the path of the certificate key file. The value is set from the <PREFIX_>SERVER_KEY environment variable.

type TLS

type TLS interface {
	// Cert returns the file name of the PEM encoded public key.
	Cert() string

	// Key returns the file name of the PEM encoded private key.
	Key() string

	// CACert returns the file name of the PEM encoded public key of the client CA.
	CACert() string
}

TLS contains the information necessary to create a tls.Config.

type TLSOption

type TLSOption interface {
	// contains filtered or unexported methods
}

TLSOption provides options for configuring the creation of a tls.Config.

func WithMTLS

func WithMTLS() TLSOption

WithMTLS will setup the tls.Config to require and verify client connections.