Document not to reuse batch (#258)

gammazero · web-flow · commit 779b962a287f · 2025-10-08T11:03:29.000-07:00
diff --git a/datastore.go b/datastore.go
@@ -277,5 +277,9 @@ func GetBackedSize(ctx context.Context, ds Read, key Key) (int, error) {
 type Batch interface {
 	Write
 
+	// Commit applies the write operations to the datastore.
+	//
+	// A Batch should not be used after calling Commit. A new Batch must be
+	// created to perform additional batched operations.
 	Commit(ctx context.Context) error
 }

Original file line number	Diff line number	Diff line change
`@@ -277,5 +277,9 @@ func GetBackedSize(ctx context.Context, ds Read, key Key) (int, error) {`
`277`	`277`	`type Batch interface {`
`278`	`278`	`Write`
`279`	`279`
	`280`	`+ // Commit applies the write operations to the datastore.`
	`281`	`+ //`
	`282`	`+ // A Batch should not be used after calling Commit. A new Batch must be`
	`283`	`+ // created to perform additional batched operations.`
`280`	`284`	`Commit(ctx context.Context) error`
`281`	`285`	`}`