foundations

Sep 18, 2024

Changes in this version

type Config

+ Cfg *aws.Config

+ EnabledTracing bool

+ type ConfigOption func(*Config)

+ func AwsConfig(cfg *aws.Config) ConfigOption

+ func Debug() ConfigOption

+ func EnabledTracing() ConfigOption

+ func Endpoint(endpoint string) ConfigOption

+ func Local() ConfigOption

+ func Profile(profile string) ConfigOption

+ func Region(region string) ConfigOption

type OptionBuilder

+ Cfg *aws.Config

+ EnabledTracing bool

type UpdateField

+ func AddValue(name string, value any) UpdateField

+ func DeleteValue(name string, value any) UpdateField

+ func RemoveValue(name string) UpdateField

+ func SetValue(name string, value any) UpdateField

Jun 2, 2024

Changes in this version

+ func ScanAll(ctx context.Context, cli ScanClient, condition ScanFilterFunc, ...) (out *dynamodb.ScanOutput, err error)

type FetchItemsFunc

+ func FetchAll[T any](ctx context.Context, list []T) FetchItemsFunc

Mar 30, 2024

Changes in this version

+ func Values(values ...any) (right expression.OperandBuilder, other []expression.OperandBuilder)

Mar 24, 2024

Changes in this version

+ type OptionBuilder struct

+ Debug bool

+ Endpoint string

+ Local bool

+ Profile string

+ Region string

+ func (b *OptionBuilder) Build(ctx context.Context) (*Config, error)

Mar 9, 2024

Changes in this version

+ func Setup(ctx context.Context, builder ConfigBuilder) (*dynamodb.Client, error)

+ type Config struct

+ Debug bool

+ Endpoint string

+ Local bool

+ Profile string

+ Region string

+ type ConfigBuilder interface

+ Build func(ctx context.Context) (*Config, error)

+ type DefaultBuilder struct

+ Config *Config

+ func (b *DefaultBuilder) Build(ctx context.Context) (*Config, error)

+ type EnvBuilder struct

+ func (b *EnvBuilder) Build(ctx context.Context) (*Config, error)

+ type FetchItemPostprocessor interface

+ AfterFetchItem func(ctx context.Context) error

+ type FetchItemsPostprocessor interface

+ AfterFetchItems func(ctx context.Context) error

Jan 10, 2024

Changes in this version

+ type EvaluatedKey map[string]types.AttributeValue

+ func EvaluatedKeyOf(key string) (EvaluatedKey, error)

+ func (ek EvaluatedKey) String() (string, error)

+ type EvaluatedValue struct

+ Type string

+ Value string

+ type Record map[string]types.AttributeValue

+ func (r Record) Unmarshal(v any) error

+ type Records []map[string]types.AttributeValue

+ func (r Records) Unmarshal(v any) error

Nov 12, 2023

Changes in this version

+ func EnableErrorWithEmptyList(v bool)

Nov 1, 2023

Changes in this version

+ type ExpressionFunc func() (expr expression.Expression, err error)

Aug 24, 2023

Changes in this version

+ func NotFound(tableName string) *types.ResourceNotFoundException

Aug 23, 2023

Changes in this version

+ func UpdateBuilder(ctx context.Context, fields ...UpdateField) expression.UpdateBuilder

+ type Client interface

type FetchItemFunc

+ func FetchItem(rec *T) FetchItemFunc

type FetchItemsFunc

+ func FetchItems(rec *T) FetchItemsFunc

+ type PutItemPreprocessor interface

+ BeforePutItem func(ctx context.Context) any

+ type ScanFilterFunc func() (table string, expr expression.Expression, err error)

type UpdateField

+ func UpdateValue(name string, value any) UpdateField

type WriteItemFunc

+ func ConsistentUpdateItem(ctx context.Context, keyFunc GetKeyFunc, fieldName string, count int, ...) WriteItemFunc

+ func DeleteItem(keyFunc GetKeyFunc) WriteItemFunc

+ func PutItem(ctx context.Context, tableName string, rec any) WriteItemFunc

+ func UpdateItem(ctx context.Context, keyFunc GetKeyFunc, fields ...UpdateField) WriteItemFunc

Mar 18, 2023

Changes in this version

+ type GetItemFunc WriteItemFunc

Feb 4, 2023

Changes in this version

+ func Scan(ctx context.Context, cli ScanClient, table string, fetch FetchItemsFunc) error

+ type ScanClient interface

+ Scan func(ctx context.Context, params *dynamodb.ScanInput, ...) (*dynamodb.ScanOutput, error)

Dec 16, 2022

Changes in this version

+ type RecordNotFoundException struct

+ func (err *RecordNotFoundException) Error() string

Dec 12, 2022

Changes in this version

+ func Query(ctx context.Context, cli QueryClient, condition QueryConditionFunc, ...) error

+ type FetchItemsFunc func(tableName string, value []map[string]types.AttributeValue) error

+ type QueryClient interface

+ Query func(ctx context.Context, params *dynamodb.QueryInput, ...) (*dynamodb.QueryOutput, error)

+ type QueryConditionFunc func() (table, index string, expr expression.Expression, desc bool, err error)

Oct 22, 2022

Changes in this version

+ var ErrNotFound *types.ResourceNotFoundException

+ func Delete(ctx context.Context, cli WriteClient, items WriteItemFunc) error

+ func Get(ctx context.Context, cli GetClient, getKeys GetKeyFunc, fetch FetchItemFunc) error

+ func IsNil(record interface{}) bool

+ func IsNotFound(err error) bool

+ func Put(ctx context.Context, cli WriteClient, items WriteItemFunc) error

+ func Update(ctx context.Context, cli WriteClient, items WriteItemFunc) error

+ func UpdateItems(ctx context.Context, fields ...UpdateField) expression.UpdateBuilder

+ type FetchItemFunc func(tableName string, value map[string]types.AttributeValue) error

+ type GetClient interface

+ GetItem func(ctx context.Context, params *dynamodb.GetItemInput, ...) (*dynamodb.GetItemOutput, error)

+ type GetKeyFunc func() (table string, keys map[string]types.AttributeValue, attrs []string, err error)

+ type UpdateField func(ctx context.Context, builder *expression.UpdateBuilder) expression.UpdateBuilder

+ type WriteClient interface

+ DeleteItem func(ctx context.Context, params *dynamodb.DeleteItemInput, ...) (*dynamodb.DeleteItemOutput, error)

+ PutItem func(ctx context.Context, params *dynamodb.PutItemInput, ...) (*dynamodb.PutItemOutput, error)

+ UpdateItem func(ctx context.Context, params *dynamodb.UpdateItemInput, ...) (*dynamodb.UpdateItemOutput, error)

+ type WriteItemFunc func() (table string, item map[string]types.AttributeValue, expr expression.Expression, ...)