enums

README

enums

Enums provides utilities for creating and using enumerated types in Go. There are two main parts of enums: package enums, which defines the Enum and BitFlag interfaces, and the enum code generation tool enumgen, which is based on dmarkham/enumer and stringer.

Documentation

Overview

Package enums provides common interfaces for enums and bit flag enums and utilities for using them

Package enums provides common interfaces for enums and bit flag enums and utilities for using them

Index

• Constants
• type BitFlag
• type Enum

Constants

const (
	// Version is the version of this package being used
	Version = "v0.9.3"
	// GitCommit is the commit just before the latest version commit
	GitCommit = "052cd0b"
	// VersionDate is the date-time of the latest version commit in UTC (in the format 'YYYY-MM-DD HH:MM', which is the Go format '2006-01-02 15:04')
	VersionDate = "2023-09-02 19:07"
)

Types

type BitFlag

type BitFlag interface {
	Enum
	// HasFlag returns whether these flags
	// have the given flag set.
	HasFlag(f BitFlag) bool
	// SetFlag sets the value of the given
	// flags in these flags to the given value.
	SetFlag(on bool, f ...BitFlag)
}

BitFlag is the interface that all bit flag enum types satisfy. Bit flag enum types support all of the operations that standard enums do, and additionally can get and set bit flags.

type Enum

type Enum interface {
	fmt.Stringer
	// SetString sets the enum value from its
	// string representation, and returns an
	// error if the string is invalid.
	SetString(s string) error
	// Int64 returns the enum value as an int64.
	Int64() int64
	// SetInt64 sets the enum value from an int64.
	SetInt64(i int64)
	// Desc returns the description of the enum value.
	Desc() string
	// IsValid returns whether the value is a
	// valid option for its enum type.
	IsValid() bool
	// Values returns all possible values this
	// enum type has. This slice will be in the
	// same order as those returned by Strings and Descs.
	Values() []Enum
	// Strings returns the string representations of
	// all possible values this enum type has.
	// This slice will be in the same order as
	// those returned by Values and Descs.
	Strings() []string
	// Descs returns the descriptions of all
	// possible values this enum type has.
	// This slice will be in the same order as
	// those returned by Values and Strings.
	Descs() []string
}

Enum is the interface that all enum types satisfy. Enum types must be convertable to and from strings and int64s, must be able to return a description of their value, must be able to report if they are valid, and must be able to return all possible enum values and string and description representations.