Datastore Wrapper

(AppEngine | Cloud) Datastore wrapper for Go 👉

Simple. Happy. Respect standard library.

$ go get -u go.mercari.io/datastore/v2

see v2 doc at first.

Feature

Wrap google.golang.org/appengine/datastore and cloud.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
Add some useful methods
- aedatastore/TransactionContext

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

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

$ ./setup.sh # exec once
$ ./serve.sh # exec in background
$ ./test.sh

Licensed under the MIT License.

Name		Name	Last commit message	Last commit date
Latest commit History 344 Commits
.github		.github
aedatastore		aedatastore
aeprodtest		aeprodtest
boom		boom
clouddatastore		clouddatastore
dsmiddleware		dsmiddleware
internal		internal
testbed		testbed
testsuite		testsuite
v2		v2
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
LICENSE.google		LICENSE.google
LICENSE.goon		LICENSE.goon
README.md		README.md
app.yaml		app.yaml
batch.go		batch.go
build-in-docker.sh		build-in-docker.sh
caches.go		caches.go
check_update.sh		check_update.sh
doc.go		doc.go
doc_ja.go		doc_ja.go
docker-compose.yml		docker-compose.yml
errors.go		errors.go
example_test.go		example_test.go
export.go		export.go
go.mod		go.mod
go.sum		go.sum
interfaces.go		interfaces.go
load.go		load.go
option.go		option.go
package-lock.json		package-lock.json
package.json		package.json
prop.go		prop.go
prop_test.go		prop_test.go
query.go		query.go
save.go		save.go
serve.sh		serve.sh
setup.sh		setup.sh
test.sh		test.sh
time.go		time.go
tools.go		tools.go
tx_batch.go		tx_batch.go