hook

Documentation

Index

• func FixedError(err error) entities.Hook
• func If(hk entities.Hook, cond Condition) entities.Hook
• func On(hk entities.Hook, op entities.Op) entities.Hook
• func Reject(op entities.Op) entities.Hook
• func Unless(hk entities.Hook, op entities.Op) entities.Hook
• type Chain
  • func NewChain(hooks ...entities.Hook) Chain
  • func (c Chain) Append(hooks ...entities.Hook) Chain
  • func (c Chain) Extend(chain Chain) Chain
  • func (c Chain) Hook() entities.Hook
• type Condition
  • func And(first, second Condition, rest ...Condition) Condition
  • func HasAddedFields(field string, fields ...string) Condition
  • func HasClearedFields(field string, fields ...string) Condition
  • func HasFields(field string, fields ...string) Condition
  • func HasOp(op entities.Op) Condition
  • func Not(cond Condition) Condition
  • func Or(first, second Condition, rest ...Condition) Condition
• type OrderFunc
  • func (f OrderFunc) Mutate(ctx context.Context, m entities.Mutation) (entities.Value, error)
• type OutboxFunc
  • func (f OutboxFunc) Mutate(ctx context.Context, m entities.Mutation) (entities.Value, error)

Functions

func FixedError

func FixedError(err error) entities.Hook

FixedError is a hook returning a fixed error.

func If

func If(hk entities.Hook, cond Condition) entities.Hook

If executes the given hook under condition.

hook.If(ComputeAverage, And(HasFields(...), HasAddedFields(...)))

func On

func On(hk entities.Hook, op entities.Op) entities.Hook

On executes the given hook only for the given operation.

hook.On(Log, entities.Delete|entities.Create)

func Reject

func Reject(op entities.Op) entities.Hook

Reject returns a hook that rejects all operations that match op.

func (T) Hooks() []entities.Hook {
	return []entities.Hook{
		Reject(entities.Delete|entities.Update),
	}
}

func Unless

func Unless(hk entities.Hook, op entities.Op) entities.Hook

Unless skips the given hook only for the given operation.

hook.Unless(Log, entities.Update|entities.UpdateOne)

Types

type Chain

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

Chain acts as a list of hooks and is effectively immutable. Once created, it will always hold the same set of hooks in the same order.

func NewChain

func NewChain(hooks ...entities.Hook) Chain

NewChain creates a new chain of hooks.

func (Chain) Append

func (c Chain) Append(hooks ...entities.Hook) Chain

Append extends a chain, adding the specified hook as the last ones in the mutation flow.

func (Chain) Extend

func (c Chain) Extend(chain Chain) Chain

Extend extends a chain, adding the specified chain as the last ones in the mutation flow.

func (Chain) Hook

func (c Chain) Hook() entities.Hook

Hook chains the list of hooks and returns the final hook.

type Condition

type Condition func(context.Context, entities.Mutation) bool

Condition is a hook condition function.

func And

func And(first, second Condition, rest ...Condition) Condition

And groups conditions with the AND operator.

func HasAddedFields

func HasAddedFields(field string, fields ...string) Condition

HasAddedFields is a condition validating `.AddedField` on fields.

func HasClearedFields

func HasClearedFields(field string, fields ...string) Condition

HasClearedFields is a condition validating `.FieldCleared` on fields.

func HasFields

func HasFields(field string, fields ...string) Condition

HasFields is a condition validating `.Field` on fields.

func HasOp

func HasOp(op entities.Op) Condition

HasOp is a condition testing mutation operation.

func Not

func Not(cond Condition) Condition

Not negates a given condition.

func Or

func Or(first, second Condition, rest ...Condition) Condition

Or groups conditions with the OR operator.

type OrderFunc

type OrderFunc func(context.Context, *entities.OrderMutation) (entities.Value, error)

The OrderFunc type is an adapter to allow the use of ordinary function as Order mutator.

func (OrderFunc) Mutate

func (f OrderFunc) Mutate(ctx context.Context, m entities.Mutation) (entities.Value, error)

Mutate calls f(ctx, m).

type OutboxFunc

type OutboxFunc func(context.Context, *entities.OutboxMutation) (entities.Value, error)

The OutboxFunc type is an adapter to allow the use of ordinary function as Outbox mutator.

func (OutboxFunc) Mutate

func (f OutboxFunc) Mutate(ctx context.Context, m entities.Mutation) (entities.Value, error)

Mutate calls f(ctx, m).