config

package
v0.0.0-...-4292577 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 10, 2023 License: GPL-3.0 Imports: 7 Imported by: 0

Documentation

Overview

Package config implements service for manipulating static and dynamic application's configuration.

Index

Constants

This section is empty.

Variables

View Source
var ErrConfigNotFound = errors.New("config: config not found")

ErrConfigNotFound is being returned when there is no config in the system at all.

Functions

This section is empty.

Types

type Dynamic

type Dynamic struct {
	// RegisterFrom is switch for register form. If it's true, then
	// registration form is active and random users from internet
	// are able to create accounts in the website.
	RegisterFrom bool `json:"registerForm"`
}

Dynamic holds configuration variables for application that can be changed at runtime.

type ReadRepository

type ReadRepository interface {
	// ReadLatestConfig returns latest blob of bytes with encoded config
	// as JSON document.
	//
	// It can return ErrConfigNotFound.
	ReadLatestConfig(context.Context) ([]byte, error)
}

ReadRepository reads configuration from storage.

type Service

type Service struct {
	WriteRepository
	ReadRepository
}

Service manages dynamic configuration of system.

func (*Service) Init

func (s *Service) Init(ctx context.Context) error

Init pushes default dynamic config to the database. If there is already existing dynamic configuration, it does nothing.

func (*Service) Latest

func (s *Service) Latest(ctx context.Context) (*Dynamic, error)

Latest returns the latest current version of dynamic config during the time of read.

func (*Service) PushNewVersion

func (s *Service) PushNewVersion(ctx context.Context, c Dynamic) error

PushNewVersion pushes new version of dynamic config and make it live immediately.

func (*Service) RegistrationEnabled

func (s *Service) RegistrationEnabled(ctx context.Context) (bool, error)

RegistrationEnabled returns true if registration for appliation is currently enabled.

type Static

type Static struct {
	// Environment type, which application is run at.
	//
	// Can be: TEST (test), DEV (development) or PRD (production).
	Environment string `envconfig:"env" default:"PRD"`

	// Host part of the address to listen.
	Host string `default:"127.0.0.1"`

	// Port part of the address to listen.
	Port int32 `default:"8080"`

	// DatabasePath is path which points to the database file.
	DatabasePath string `default:"okrzeja.sqlite" split_words:"true"`
}

Static holds configuration variables for application that cannot be changed at runtime and are stored in the environmental variables.

func ReadStatic

func ReadStatic() (*Static, error)

ReadStatic reads Static configuration from environmental variables.

func (*Static) Address

func (s *Static) Address() string

Address returns configured listen address.

type WriteRepository

type WriteRepository interface {
	// WriteConfig writes new version of configuration to the storage.
	//
	// It shouldn't purge the current version of config, instead, new
	// entry should be added to the storage and previous kept in some
	// kid of archive.
	WriteConfig(context.Context, WriteRequest) error
}

WriteRepository writes config to the internal storage.

type WriteRequest

type WriteRequest struct {
	// ID is unique identifier of current config version.
	ID uuid.UUID

	// NewConfig encoded as json blob of bytes.
	NewConfig []byte

	// CreatedAt is time when config was created.
	CreatedAt time.Time
}

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL