config

Documentation

Index

• func NewTLS(config TLS, opts ...TLSOption) (*tls.Config, error)
• type DataSourceNamer
• type Logger
  • func NewLogger(opts ...Option) (*Logger, error)
  • func (l *Logger) File() string
  • func (l *Logger) Format() string
  • func (l *Logger) Level() string
• type Option
  • func WithPrefix(prefix string) Option
• type Postgres
  • func NewPostgres(opts ...Option) (*Postgres, error)
  • func (p *Postgres) DSN() string
• type SQLDatabase
  • func NewSQLDatabase(opts ...Option) (*SQLDatabase, error)
  • func (db *SQLDatabase) DriverName() 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 DataSourceNamer

type DataSourceNamer interface {
	DSN() string
}

DataSourceNamer is the interface that wraps the DSN method.

type Logger

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

Logger holds the configuration settings for a logger.

func NewLogger

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

NewLogger returns the configuration of a logger.

func (*Logger) File

func (l *Logger) File() string

File returns the configured log file.

func (*Logger) Format

func (l *Logger) Format() string

Format returns the configured log format.

func (*Logger) Level

func (l *Logger) Level() string

Level returns the configured log level.

type Option

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

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 Postgres

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

Postgres holds the configuration settings needed to connect to a postgres database. The DB, HOST and SSLMODE variables are required. The SSLMODE defaults to "enabled".

For sslmode setting, see https://www.postgresql.org/docs/current/libpq-ssl.html

func NewPostgres

func NewPostgres(opts ...Option) (*Postgres, error)

NewPostgres returns the postgres configuration.

func (*Postgres) DSN

func (p *Postgres) DSN() string

DSN returns a connection string corresponding to the postgres configuration.

See https://godoc.org/github.com/lib/pq for connection string parameters.

type SQLDatabase

type SQLDatabase struct {
	DataSourceNamer
	// contains filtered or unexported fields
}

SQLDatabase holds the configuration information for an SQL database.

func NewSQLDatabase

func NewSQLDatabase(opts ...Option) (*SQLDatabase, error)

NewSQLDatabase returns the configuration of an SQL database.

func (*SQLDatabase) DriverName

func (db *SQLDatabase) DriverName() string

DriverName returns the name of the sql database driver.

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.

func (*Server) CACert

func (s *Server) CACert() string

CACert returns the filepath of the certificate of the client CA. This is used when a mutual TLS connection is desired.

func (*Server) Cert

func (s *Server) Cert() string

Cert returns the filepath of the certificate.

func (*Server) Key

func (s *Server) Key() string

Key returns the filepath of the certificate key.

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.