primitives

README

The primitives package is meant to contain definitions and constants that are widely used throughout this repository.

There should serve as the root package in that there should be no imports of any other Temporal package.

Documentation

Index

• Constants
• func MustValidateUUID(s string) string
• func UUIDString(b []byte) string
• func ValidateUUID(s string) (string, error)
• type UUID
  • func MustParseUUID(s string) UUID
  • func NewUUID() UUID
  • func ParseUUID(s string) (UUID, error)
  • func UUIDPtr(u UUID) *UUID
  • func (u UUID) Downcast() []byte
  • func (u *UUID) Scan(src interface{}) error
  • func (u UUID) String() string
  • func (u UUID) StringPtr() *string
  • func (u UUID) Value() (driver.Value, error)

Constants

const (
	AllServices     = "all"
	FrontendService = "frontend"
	HistoryService  = "history"
	MatchingService = "matching"
	WorkerService   = "worker"
)

These const represent role strings

Functions

func MustValidateUUID

func MustValidateUUID(s string) string

MustValidateUUID parses and validates UUID contents from the given string representation returns empty string if the input is empty string panics if the given input is malformed

func UUIDString

func UUIDString(b []byte) string

func ValidateUUID

func ValidateUUID(s string) (string, error)

ValidateUUID parses and validates UUID contents from the given string representation returns:

• nil if the input is empty string
• error if input is malformed
• input if input can be parsed and is valid

Types

type UUID

type UUID []byte

UUID represents a 16-byte universally unique identifier this type is a wrapper around google/uuid with the following differences

• type is a byte slice instead of [16]byte
• db serialization converts uuid to bytes as opposed to string

func MustParseUUID

func MustParseUUID(s string) UUID

MustParseUUID returns a UUID parsed from the given string representation returns nil if the input is empty string panics if the given input is malformed

func NewUUID

func NewUUID() UUID

NewUUID generates a new random UUID

func ParseUUID

func ParseUUID(s string) (UUID, error)

ParseUUID returns a UUID parsed from the given string representation returns:

• nil if the input is empty string
• error if input is malformed
• UUID object if input can be parsed and is valid

func UUIDPtr

func UUIDPtr(u UUID) *UUID

UUIDPtr simply returns a pointer for the given value type

func (UUID) Downcast

func (u UUID) Downcast() []byte

Downcast returns the UUID as a byte slice. This is necessary when passing to type sensitive interfaces such as cql.

func (*UUID) Scan

func (u *UUID) Scan(src interface{}) error

Scan implements sql.Scanner interface to allow this type to be parsed transparently by database drivers

func (UUID) String

func (u UUID) String() string

String returns the 36 byte hexstring representation of this uuid return empty string if this uuid is nil

func (UUID) StringPtr

func (u UUID) StringPtr() *string

StringPtr returns a pointer to the 36 byte hexstring representation of this uuid return empty string if this uuid is nil

func (UUID) Value

func (u UUID) Value() (driver.Value, error)

Value implements sql.Valuer so that UUIDs can be written to databases transparently. This method returns a byte slice representation of uuid