(AppEngine | Cloud) Datastore wrapper for Go ๐
Simple. Happy. Respect standard library.
$ go get -u go.mercari.io/datastore
- Wrap
google.golang.org/appengine/datastore
andcloud.google.com/go/datastore
- keep key behavior
- align to
cloud.google.com/go/datastore
first
- Re-implement datastore package
- Re-implement datastore.SaveStruct & LoadStruct
- Ignore unmapped property
- Add PropertyTranslator interface
- Convert types like mytime.Unix to time.Time and reverse it
- Rename property like CreatedAt to createdAt or created_at and reverse it
- Re-implement PropertyLoadSaver
- Pass context.Context to Save & Load method
- Add retry feature to each RPC
- e.g. Retry AllocateID when it failed
- Add middleware layer
- About...
- Local Cache
- AE Memcache
- Logging
- Retry
- etc...
- Easy to ON/OFF switching
- About...
- Add some useful methods
aedatastore/TransactionContext
- have utility functions
- support firestore
aedatastore
package- When using slice of struct, MUST specified
datastore:",flatten"
option.- original (ae & cloud) datastore.SaveStruct have different behaviors.
- see aeprodtest/main.go
/api/test3
- When using slice of struct, MUST specified
- Masahiro Wakame (@vvakame)
Please read the CLA below carefully before submitting your contribution.
- requirements
- gcloud sdk
gcloud components install app-engine-go
gcloud components install beta cloud-datastore-emulator
- gcloud sdk
- Testing in local
$ ./setup.sh # exec once
$ ./serve.sh # exec in background
$ ./test.sh
- Testing with Circle CI CLI
$ circleci build
Copyright 2017 Mercari, Inc.
Licensed under the MIT License.