identity

package
v0.123.13 Latest Latest
Warning

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

 Go to latest Published: Mar 12, 2024 License: Apache-2.0 Imports: 12 Imported by: 0

Documentation

Overview

Package provides ways to identify values in Hugo. Used for dependency tracking etc.

Package provides ways to identify values in Hugo. Used for dependency tracking etc.

Index

Constants

View Source 
const (
	// Anonymous is an Identity that can be used when identity doesn't matter.
	Anonymous = StringIdentity("__anonymous")

	// GenghisKhan is an Identity everyone relates to.
	GenghisKhan = StringIdentity("__genghiskhan")
)

Variables

View Source 
var NopManager = new(nopManager)

Functions

func CleanString 

func CleanString(s string) string

CleanString cleans s to be suitable as an identifier.

func HashString 

func HashString(vs ...any) string

HashString returns a hash from the given elements. It will panic if the hash cannot be calculated. Note that this hash should be used primarily for identity, not for change detection as it in the more complex values (e.g. Page) will not hash the full content.

func HashUint64 

func HashUint64(vs ...any) uint64

HashUint64 returns a hash from the given elements. It will panic if the hash cannot be calculated. Note that this hash should be used primarily for identity, not for change detection as it in the more complex values (e.g. Page) will not hash the full content.

func NewPredicateIdentity 

func NewPredicateIdentity(
	probablyDependent func(Identity) bool,
	probablyDependency func(Identity) bool,
) *predicateIdentity

NewPredicateIdentity creates a new Identity that implements both IsProbablyDependencyProvider and IsProbablyDependentProvider using the provided functions, both of which are optional.

func PrintIdentityInfo 

func PrintIdentityInfo(v any)

PrintIdentityInfo is used for debugging/tests only.

func WalkIdentitiesDeep 

func WalkIdentitiesDeep(v any, cb func(level int, id Identity) bool)

WalkIdentitiesDeep walks identities in v and applies cb to every identity found. Return true from cb to terminate. If deep is true, it will also walk nested Identities in any Manager found.

func WalkIdentitiesShallow 

func WalkIdentitiesShallow(v any, cb func(level int, id Identity) bool)

WalkIdentitiesShallow will not walk into a Manager's Identities. See WalkIdentitiesDeep. cb is called for every Identity found and returns whether to terminate the walk.

Types

type DependencyManagerProvider 

type DependencyManagerProvider interface {
	GetDependencyManager() Manager
}

DependencyManagerProvider provides a manager for dependencies.

type DependencyManagerProviderFunc 

type DependencyManagerProviderFunc func() Manager

DependencyManagerProviderFunc is a function that implements the DependencyManagerProvider interface.

func (DependencyManagerProviderFunc) GetDependencyManager 

func (d DependencyManagerProviderFunc) GetDependencyManager() Manager

type DependencyManagerScopedProvider 

type DependencyManagerScopedProvider interface {
	GetDependencyManagerForScope(scope int) Manager
}

DependencyManagerScopedProvider provides a manager for dependencies with a given scope.

type FindFirstManagerIdentityProvider 

type FindFirstManagerIdentityProvider interface {
	Identity
	FindFirstManagerIdentity() ManagerIdentity
}

func NewFindFirstManagerIdentityProvider 

func NewFindFirstManagerIdentityProvider(m Manager, id Identity) FindFirstManagerIdentityProvider

type Finder 

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

Finder finds identities inside another.

func NewFinder 

func NewFinder(cfg FinderConfig) *Finder

NewFinder creates a new Finder. This is a thread safe implementation with a cache.

func (*Finder) Contains 

func (f *Finder) Contains(id, in Identity, maxDepth int) FinderResult

Contains returns whether in contains id.

type FinderConfig 

type FinderConfig struct {
	// Match exact matches only.
	Exact bool
}

FinderConfig provides configuration for the Finder. Note that we by default will use a strategy where probable matches are good enough. The primary use case for this is to identity the change set for a given changed identity (e.g. a template), and we don't want to have any false negatives there, but some false positives are OK. Also, speed is important.

type FinderResult 

type FinderResult int
const (
	FinderNotFound FinderResult = iota
	FinderFoundOneOfManyRepetition
	FinderFoundOneOfMany
	FinderFound
)

type ForEeachIdentityByNameProvider 

type ForEeachIdentityByNameProvider interface {
	// ForEeachIdentityByName calls cb for each Identity that relates to name.
	// If cb returns true, the iteration is terminated.
	ForEeachIdentityByName(name string, cb func(id Identity) bool)
}

ForEeachIdentityByNameProvider provides a way to look up identities by name.

type ForEeachIdentityProvider 

type ForEeachIdentityProvider interface {
	// ForEeachIdentityProvider calls cb for each Identity.
	// If cb returns true, the iteration is terminated.
	// The return value is whether the iteration was terminated.
	ForEeachIdentity(cb func(id Identity) bool) bool
}

ForEeachIdentityProvider provides a way iterate over identities.

type ForEeachIdentityProviderFunc 

type ForEeachIdentityProviderFunc func(func(id Identity) bool) bool

ForEeachIdentityProviderFunc is a function that implements the ForEeachIdentityProvider interface.

func (ForEeachIdentityProviderFunc) ForEeachIdentity 

func (f ForEeachIdentityProviderFunc) ForEeachIdentity(cb func(id Identity) bool) bool

type Identities 

type Identities map[Identity]bool

Identities stores identity providers.

func (Identities) AsSlice 

func (ids Identities) AsSlice() []Identity

func (Identities) String 

func (ids Identities) String() string

type Identity 

type Identity interface {
	IdentifierBase() string
}

Identity represents a thing in Hugo (a Page, a template etc.) Any implementation must be comparable/hashable.

func FirstIdentity 

func FirstIdentity(v any) Identity

FirstIdentity returns the first Identity in v, Anonymous if none found

func NewGlobIdentity 

func NewGlobIdentity(pattern string) Identity

NewGlobIdentity creates a new Identity that is probably dependent on any other Identity that matches the given pattern.

func Or 

func Or(a, b Identity) Identity

func Unwrap 

func Unwrap(id Identity) Identity

type IdentityGroupProvider 

type IdentityGroupProvider interface {
	GetIdentityGroup() Identity
}

IdentityGroupProvider can be implemented by tightly connected types. Current use case is Resource transformation via Hugo Pipes.

type IdentityProvider 

type IdentityProvider interface {
	GetIdentity() Identity
}

IdentityProvider can be implemented by types that isn't itself and Identity, usually because they're not comparable/hashable.

type IncrementByOne 

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

IncrementByOne implements Incrementer adding 1 every time Incr is called.

func (*IncrementByOne) Incr 

func (c *IncrementByOne) Incr() int

type Incrementer 

type Incrementer interface {
	Incr() int
}

Incrementer increments and returns the value. Typically used for IDs.

type IsProbablyDependencyProvider 

type IsProbablyDependencyProvider interface {
	IsProbablyDependency(other Identity) bool
}

IsProbablyDependencyProvider is an optional interface for Identity.

type IsProbablyDependentProvider 

type IsProbablyDependentProvider interface {
	IsProbablyDependent(other Identity) bool
}

IsProbablyDependentProvider is an optional interface for Identity.

type Manager 

type Manager interface {
	Identity
	AddIdentity(ids ...Identity)
	AddIdentityForEach(ids ...ForEeachIdentityProvider)
	GetIdentity() Identity
	Reset()
	// contains filtered or unexported methods
}

Manager is an Identity that also manages identities, typically dependencies.

func GetDependencyManager 

func GetDependencyManager(v any) Manager

GetDependencyManager returns the DependencyManager from v or nil if none found.

func NewManager 

func NewManager(name string, opts ...ManagerOption) Manager

NewIdentityManager creates a new Manager.

type ManagerIdentity 

type ManagerIdentity struct {
	Identity
	Manager
}

ManagerIdentity wraps a pair of Identity and Manager.

func (ManagerIdentity) String 

func (p ManagerIdentity) String() string

type ManagerOption 

type ManagerOption func(m *identityManager)

func WithOnAddIdentity 

func WithOnAddIdentity(f func(id Identity)) ManagerOption

WithOnAddIdentity sets a callback that will be invoked when an identity is added to the manager.

type Question 

type Question[T any] struct {
	Identity
	// contains filtered or unexported fields
}

A Question is defined by its Identity and can be answered once.

func NewQuestion 

func NewQuestion[T any](id Identity) *Question[T]

NewQuestion creates a new question with the given identity.

func (*Question[T]) Answer 

func (q *Question[T]) Answer(fn func() T)

Answer takes a func that knows the answer. Note that this is a one-time operation, fn will not be invoked again it the question is already answered. Use Result to check if the question is answered.

func (*Question[T]) Result 

func (q *Question[T]) Result() (any, bool)

Result returns the fasit of the question (if answered), and a bool indicating if the question has been answered.

type StringIdentity 

type StringIdentity string

StringIdentity is an Identity that wraps a string.

func CleanStringIdentity 

func CleanStringIdentity(s string) StringIdentity

CleanStringIdentity cleans s to be suitable as an identifier and wraps it in a StringIdentity.

func (StringIdentity) IdentifierBase 

func (s StringIdentity) IdentifierBase() string

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.