common

Documentation

Index

• Constants
• Variables
• func GetChecksum(data []byte) (string, error)
• func GetLogger(domain logdomain.ID) (*log.Logger, error)
• func GetLoggerStdout(domain logdomain.ID) (*log.Logger, error)
• func GetUUID() string
• func InitApp() error
• func SetBaseDir(path string) error
• func TimeEqual(t1, t2 time.Time) bool

Constants

const (
	AppName                  = "Raconteur"
	Version                  = "0.0.1"
	Debug                    = true
	TimestampFormatMinute    = "2006-01-02 15:04"
	TimestampFormat          = "2006-01-02 15:04:05"
	TimestampFormatSubSecond = "2006-01-02 15:04:05.0000 MST"
	TimestampFormatDate      = "2006-01-02"
	TimestampFormatTime      = "15:04:05"
	NetName                  = "udp4"
)

AppName is the name under which the application identifies itself. Version is the version number. Debug, if true, causes the application to log additional messages and perform additional sanity checks. TimestampFormat is the default format for timestamp used throughout the application.

Variables

var BaseDir = filepath.Join(
	krylib.GetHomeDirectory(),
	fmt.Sprintf(".%s.d", strings.ToLower(AppName)))

BaseDir is the folder where all application-specific files are stored. It defaults to $HOME/.Kuang2.d

var DbPath = filepath.Join(BaseDir, fmt.Sprintf("%s.db", strings.ToLower(AppName)))

DbPath is the filename of the database.

var DoTrace = true

DoTrace causes the log level to be lowered to TRACE when set.

var LogLevels = []logutils.LogLevel{
	"TRACE",
	"DEBUG",
	"INFO",
	"WARN",
	"ERROR",
	"CRITICAL",
	"CANTHAPPEN",
	"SILENT",
}

LogLevels are the names of the log levels supported by the logger.

var LogPath = filepath.Join(BaseDir, fmt.Sprintf("%s.log", strings.ToLower(AppName)))

LogPath is the filename of the log file.

var MinLogLevel logutils.LogLevel = "TRACE"

MinLogLevel is the minimum level a log message must have to be written out to the log. This value is configurable to reduce log verbosity in regular use.

var PackageLevels = make(map[logdomain.ID]logutils.LogLevel, len(LogLevels))

PackageLevels defines minimum log levels per package.

Functions

func GetChecksum

func GetChecksum(data []byte) (string, error)

GetChecksum computes the SHA512 checksum of the given data.

func GetLogger

func GetLogger(domain logdomain.ID) (*log.Logger, error)

GetLogger tries to create a named logger instance and return it. If the directory to hold the log file does not exist, try to create it.

func GetLoggerStdout

func GetLoggerStdout(domain logdomain.ID) (*log.Logger, error)

GetLoggerStdout returns a Logger that will log to stdout AND the log file.

func GetUUID

func GetUUID() string

GetUUID returns a randomized UUID

func InitApp

func InitApp() error

InitApp performs some basic preparations for the application to run. Currently, this means creating the BaseDir folder.

func SetBaseDir

func SetBaseDir(path string) error

SetBaseDir sets the application's base directory. This should only be done during initialization. Once the log file and the database are opened, this is useless at best and opens a world of confusion at worst, so this function should only be called at the very beginning of the program.

func TimeEqual

func TimeEqual(t1, t2 time.Time) bool

TimeEqual returns true if the two timestamps are less than one second apart.