NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #1462 by repository stars
Latest stable
v1.23.0
Last release 3 years ago
no release in 18 months
Release timing varies
gaps range from 2 weeks to 4 months
Nearly every release is documented
notes for 46 of 46 stable releases
1 version withdrawn
withdrawn after publishing
11 years old
100 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
This release includes a small new feature and an important bug fix.
This release includes a small new feature and an important bug fix.
RequestLimit for Query and Scan for finer control of internal pagination (#231)Nothing published for this version
Support nested recursion in types (A → B → A and so on)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
This release fixes these issues:
This release fixes these issues:
Many thanks to everyone who reported the issues. Note: v1.22.0 has been retracted. Please upgrade to the latest version if you're on it.
This is a bugfix release for the following issues related to the new encoding in v1.22.0:
This is a bugfix release for the following issues related to the new encoding in v1.22.0:
Please note the following issues are still around:
Optimize encoding by @guregu in https://github.com/guregu/dynamo/pull/224
(*BatchWrite).PutIn for putting items in other tables(*BatchWrite).DeleteIn and (*BatchWrite).DeleteInRange for deleting items in other tables(*BatchWrite).Merge for merging batch writes together(*BatchGet).From and (*BatchGet).FromRange for getting items from other tables(*BatchGet).Merge for merging batch gets together(*BatchGet).ProjectTable for specifying table-specific projections(*BatchGet).IterWithTable for creating an iterator that keeps track of which table each item comes fromFull Changelog: https://github.com/guregu/dynamo/compare/v1.21.0...v1.22.0
dynamo v2 will target aws-sdk-go v2 and is (finally) nearing completion.
You can test it by depending on the v2-dev branch:
go get github.com/guregu/dynamo/v2@v2-dev
Feedback is welcome at #206.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Includes #224 which greatly improves the speed and memory usage of marshaling/unmarshaling. See benchmarks in #224, or try running them locally. If yo
Includes #224 which greatly improves the speed and memory usage of marshaling/unmarshaling. See benchmarks in #224, or try running them locally. If you've got a test suite that uses dynamo, it would help me a lot if you run this pre-release against it and let me know if you find anything weird. Thanks and please look forward to a release soon. I've been running this on one of my services for a little while and it's looking good so far.
Nothing published for this version
Configuration for retrying by @guregu in https://github.com/guregu/dynamo/pull/223 (issue: #222)
aws.Config setup, the behavior for retrying can change. MaxRetries and Retryer fields will be respected now.Full Changelog: https://github.com/guregu/dynamo/compare/v1.20.2...v1.21.0
Nothing published for this version
Fix nil pointer panic in DescribeTable for LSIs in Global Tables
Bugfix release.
Full Changelog: https://github.com/guregu/dynamo/compare/v1.20.1...v1.20.2
Nothing published for this version
This is a minor bugfix release.
This is a minor bugfix release.
Full Changelog: https://github.com/guregu/dynamo/compare/v1.20.0...v1.20.1
Nothing published for this version
This release adds new methods for Scan to create parallel iterators (#20): Scan.IterParallel, Scan.AllParallel and paginating versions. The parallel i
This release adds new methods for Scan to create parallel iterators (#20): Scan.IterParallel, Scan.AllParallel and paginating versions. The parallel iterators handle the concurrency and segmenting of parallel scan requests automatically.
context.Context instead of aws.Context (which is a type alias to context.Context)Full Changelog: https://github.com/guregu/dynamo/compare/v1.19.0...v1.20.0
Nothing published for this version
Add Parallel Scanning support by @pquerna in https://github.com/guregu/dynamo/pull/216
Full Changelog: https://github.com/guregu/dynamo/compare/v1.18.3...v1.19.0
Fix GetTx using the default context instead of the given one
Full Changelog: https://github.com/guregu/dynamo/compare/v1.18.2...v1.18.3
Nothing published for this version
This is a minor release that improves some error checking.
This is a minor release that improves some error checking.
Full Changelog: https://github.com/guregu/dynamo/compare/v1.18.1...v1.18.2
Bug fix for included attributes in CreateTable @blck-snwmn in https://github.com/guregu/dynamo/pull/211
github.com/gofrs/uuid as a dependency by @danielwhite in https://github.com/guregu/dynamo/pull/210Full Changelog: https://github.com/guregu/dynamo/compare/v1.18.0...v1.18.1
This release adds projection support for batch gets and updates the AWS dependencies.
This release adds projection support for batch gets and updates the AWS dependencies.
Full Changelog: https://github.com/guregu/dynamo/compare/v1.17.0...v1.18.0
This release adds automatic retrying behavior to transactions. See: #203.
This release adds automatic retrying behavior to transactions. See: #203.
IsCondCheckFailed function for working with conditional check failed errorsFull Changelog: https://github.com/guregu/dynamo/compare/v1.16.0...v1.17.0
Adding allowemptyelem support for nested maps and slices by @veedubyou in https://github.com/guregu/dynamo/pull/200 (fixes #199)
Full Changelog: https://github.com/guregu/dynamo/compare/v1.15.1...v1.16.0
Fix map fields not getting cleared on unmarshal by @guregu in https://github.com/guregu/dynamo/pull/196
Full Changelog: https://github.com/guregu/dynamo/compare/v1.15.0...v1.15.1
This release adds table waiters (#52 via #193).
This release adds table waiters (#52 via #193).
CreateTable.Wait() creates the table, then blocks until the table is activeDeleteTable.Wait() deletes the table, then blocks until the table is finished deletingTable.Wait(...) blocks until the table's status matches one of the arguments (for custom waiting purposes)// blocks until table is ready to use
if err := db.CreateTable(name, Widget{}).Wait(); err != nil {
panic(err)
}
// blocks until table is finished deleting
if err := db.Table(name).DeleteTable().Wait(); err != nil {
panic(err)
}
Full Changelog: https://github.com/guregu/dynamo/compare/v1.14.0...v1.15.0
Nothing published for this version
This release adds a new type, ExpressionLiteral (#192). It represents a raw DynamoDB expression and placeholders, using the same data types as the off
This release adds a new type, ExpressionLiteral (#192). It represents a raw DynamoDB expression and placeholders, using the same data types as the official AWS package. You can pass this as a parameter to any method that takes an expression. Both $ and ? will work as variables. dynamo will automatically merge your placeholders with its own, so you can use this in tandem with the rest of the library.
Some use cases include porting projects from the official SDK, and passing around search parameters in APIs.
Be careful, using this is akin to manipulating SQL queries with string concatenation. Make sure you know what you're doing if you use it. Only reach for this hammer when the regular APIs don't cut it.
lit := dynamo.ExpressionLiteral{
Expression: "#meta.#foo = :bar",
AttributeNames: aws.StringMap(map[string]string{
"#meta": "Meta",
"#foo": "foo",
}),
AttributeValues: map[string]*dynamodb.AttributeValue{
":bar": {S: aws.String("bar")},
},
}
err := table.Get("UserID", 42).
Filter("?", lit). // $ also works.
All(&result)
Full Changelog: https://github.com/guregu/dynamo/compare/v1.13.0...v1.14.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add server-side encryption (SSE) support in CreateTable and DescribeTable #189 (thanks @TigerToof!)
CreateTable and DescribeTable #189 (thanks @TigerToof!)PagingIter.LastEvaluatedKey #191
DescribeTable depending on your usage.DescribeTable (such as insufficient permissions) will be treated as warnings, falling back to pre-v1.12.0 behavior.
aws.Config instead of the standard library default.Full Changelog: https://github.com/guregu/dynamo/compare/v1.12.0...v1.13.0
Nothing published for this version
virtual PagingIter.LastEvaluatedKey by @guregu in https://github.com/guregu/dynamo/pull/187
UnmarshalItem does not work with the auxiliary typesPagingIter.LastEvaluatedKey by @guregu in https://github.com/guregu/dynamo/pull/187Full Changelog: https://github.com/guregu/dynamo/compare/v1.11.0...v1.12.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
This release integrates lots of pull requests from the community. Thanks for the PRs, everyone.
This release integrates lots of pull requests from the community. Thanks for the PRs, everyone.
Although this PR doesn't add any shiny new functionality, it introduces a new error called ErrNoInput that is returned if you use the batch/transaction APIs without providing it any input. See #174.
Nothing published for this version
Nothing published for this version
This is a bugfix release that resolves an issue where BatchGet would return ErrNotFound early upon encountering an empty set of 100 results (#161). Th
This is a bugfix release that resolves an issue where BatchGet would return ErrNotFound early upon encountering an empty set of 100 results (#161). Thanks @Dave-Dohmeier!
This is a bugfix release that fixes #158, in which expressions like (A) OR (B) were not getting properly wrapped to ((A) OR (B)) when combined with mu
This is a bugfix release that fixes #158, in which expressions like (A) OR (B) were not getting properly wrapped to ((A) OR (B)) when combined with multiple .If calls, etc.
Also includes #157 which fixes ListTables's context methods not passing the context through to the AWS SDK.
Nothing published for this version
This is a bugfix release that fixes Update.Set's behavior when given an empty typed string value (#151). Instead of removing the empty value, it was e
This is a bugfix release that fixes Update.Set's behavior when given an empty typed string value (#151). Instead of removing the empty value, it was encoding an invalid request resulting in a SerializationException. Thanks to @finnbear for discovering and triaging the issue.
This is a minor release that fixes an issue with decoding number sets (#150). Thanks to @aoldershaw for the contribution.
This is a minor release that fixes an issue with decoding number sets (#150). Thanks to @aoldershaw for the contribution.
Nothing published for this version
This release adds Update.DeleteFromSet which can be useful for deleting values from sets not covered by the pre-existing helper methods (#146). Also,
This release adds Update.DeleteFromSet which can be useful for deleting values from sets not covered by the pre-existing helper methods (#146). Also, Update.OnlyUpdatedValue and Update.OnlyUpdatedOldValue have been added, which are the equivalents of UPDATED_NEW and UPDATED_OLD and encode only the values that have been changed from an update (#142).
AWSEncoding support has been improved (#147). You can now use it with methods that operate on slices, such as:
var list []myAWSEncodedStuff
table.Get("UserID", 123).All(dynamo.AWSEncoding(&list))
This release also bumps up aws-sdk-go to the latest version. Thanks to everyone who reported issues and sent PRs, and to everyone who uses this library.
This release adds support for embedding struct pointers (#139) and avoids panicking when trying to unmarshal to private fields. Thanks @gir for the co
This release adds support for embedding struct pointers (#139) and avoids panicking when trying to unmarshal to private fields. Thanks @gir for the contribution.
This release improves and extends many areas of the encoder, improving support for empty and null values and fixing some important issues. We can now
This release improves and extends many areas of the encoder, improving support for empty and null values and fixing some important issues. We can now take advantage of DynamoDB's support for empty strings and binary attributes!
dynamo:",set" struct tag option). By default, empty strings and binary values are encoded as-is, and nil pointers are set to a DynamoDB NULL type. Previously these cases were a SerializationException. Fixes #102 and #137.
dynamo:",omitemptyelem" that omits these values instead. Note that this will mess up your array indexes.dynamo:",allowempty" to disable auto-omit behavior for empty string or binary field values. Keep in mind that primary keys can't be empty.dynamo:",allowemptyelem" to disable auto-omit behavior for empty string, empty binary, and nil values in maps.dynamo:",null" that will marshal nil or empty values to DynamoDB NULL types. When allowempty is also set, allowempty will take precedence.Update.SetNullable which is Update.Set without automatic empty/nil removal.If and Filter.This release should have total backwards compatibility with previous versions. New support for empty/nil values was added in areas that were previously serialization errors. Auto-omit behavior was kept the same, but now you can use allowempty and allowemptyelem to disable it.
Example:
var widget = struct {
HashKey string
Desc string `dynamo:",allowempty"`
Words []string
Ptr *int `dynamo:",null"`
}{
HashKey: "abc",
Desc: "",
Words: []string{"hello", "world", ""},
Ptr: nil,
}
will be marshaled like so
{
HashKey: {S: "abc"},
Desc: {S: ""},
Words: {L: [{S: "hello"}, {S: "world"} {S: ""}]},
Ptr: {NULL: true},
}
Big thanks to everyone who submitted issues and PRs, and all the users of this library.
Nothing published for this version
This release adds ItemMarshaler and ItemUnmarshaler, which are interfaces allowing for total control of item marshaling. This is useful for handling d
This release adds ItemMarshaler and ItemUnmarshaler, which are interfaces allowing for total control of item marshaling. This is useful for handling dynamic items whose structure depends on its content. Thanks to @luma for submitting this in PR #126!
// ItemMarshaler is the interface implemented by objects that
// can marshal themselves into an Item (a map of strings
// to AttributeValues).
type ItemMarshaler interface {
MarshalDynamoItem() (map[string]*dynamodb.AttributeValue, error)
}
// ItemUnmarshaler is the interface implemented by
// objects that can unmarshal an Item (a map of strings
//to AttributeValues) into themselves.
type ItemUnmarshaler interface {
UnmarshalDynamoItem(item map[string]*dynamodb.AttributeValue) error
}
Nothing published for this version
This release fixes a bug where AWSEncoding items were not being (un)marshaled properly in Put, Get, etc (#125). The module dependency on aws-sdk-go wa
This release fixes a bug where AWSEncoding items were not being (un)marshaled properly in Put, Get, etc (#125). The module dependency on aws-sdk-go was also updated to the latest version.
This release fixes unmarshaling to return an error when unmarshaling a DynamoDB list into an array that is too small. See notes for v1.7.1, which incl
This release fixes unmarshaling to return an error when unmarshaling a DynamoDB list into an array that is too small. See notes for v1.7.1, which includes a similar fix for DynamoDB binary data.
This is a minor release that improves how array marshaling and unmarshaling is handled.
This is a minor release that improves how array marshaling and unmarshaling is handled.
One column per quarter.