Go Client v8.0.0-beta.1 (#458)

* Rename Transaction in codebase to command

* Parse nil keys properly in query operations

* [CLIENT-3159] Support writing raw payload to the server

* [CLIENT-3214] Remove Proxy code.

* [CLIENT-3183] [CLIENT-3203] [CLIENT-3193] [CLIENT-3190] Support Multi-Record Transactions.

* Update CHANGELOG

* Upgrade To Version 8

---------

Co-authored-by: yrizhkov <[email protected]>

.github/workflows/build.yml

@@ -11,9 +11,7 @@ jobs:
     strategy:
       matrix:
         go-version:
-          - "1.20"
-          - "1.21"
-          - "1.22"
+          - "1.23"
     steps:
       - uses: actions/checkout@v3
       - name: "Setup Go ${{ matrix.go-version }}"
@@ -43,10 +41,10 @@ jobs:
         run: go run github.com/onsi/ginkgo/v2/ginkgo build -tags="as_performance" .
       - name: Build for Google App Engine (unsafe package removed)
         run: go run github.com/onsi/ginkgo/v2/ginkgo build -tags="app_engine" .
-      - name: Build for DBAAS (proxy mode)
-        run: go run github.com/onsi/ginkgo/v2/ginkgo build -tags="as_proxy" .
       - name: Run the tests
         run: go run github.com/onsi/ginkgo/v2/ginkgo -coverprofile=./cover_native.out -covermode=atomic -coverpkg=./... -race -keep-going -succinct -randomize-suites -skip="HyperLogLog"
+      - name: Download gocovmerge
+        run: go mod download github.com/wadey/gocovmerge
       - name: Combine Cover Profiles
         run: go run github.com/wadey/gocovmerge cover_*.out > cover_all.out
       - name: Check Code Coverage

.testcoverage.yml

@@ -9,7 +9,7 @@ profile: cover_all.out
 
 # (optional; but recommended to set)
 # When specified reported file paths will not contain local prefix in the output
-local-prefix: "github.com/aerospike/aerospike-client-go/v7"
+local-prefix: "github.com/aerospike/aerospike-client-go/v8"
 
 # Holds coverage thresholds percentages, values should be in range [0-100]
 threshold:
@@ -55,11 +55,6 @@ exclude:
     - record_exists_action.go
     - replica_policy.go
     - generics.go
-    - proxy_auth_interceptor.go
-    - proxy_client.go
-    - proxy_client_reflect.go
-    - proxy_query_partition_command.go
-    - proxy_scan_command.go
     - login_command.go
     - types/histogram/histogram.go
     - types/rand/xor_shift128.go

CHANGELOG.md

@@ -1,5 +1,27 @@
 # Change History
 
+## December 13 2024: v8.0.0-beta.1
+
+  Major breaking release. This release supports Multi-Record Transactions. Please note that this is a beta release and will be subject to breaking changes.
+
+- **Breaking Changes**
+  - This release removes the proxy client and associated mock interfaces from the codebase. Maintaining those interfaces was very hard due to multiple build flags which had their own set of of supported API. Since interfaces are implicit, doing that by the user is as easy, or potentially easier outside of the library.
+  - Operation used to return the result of multiple ops on a single bin wrapped in `[]any`. That would be confusing, since it was not clear if the result was the contents of the bin, or the results of multiple commands. In version 8, the client will wrap those results inside a `as.OpResults` instead of a `[]any`, removing the confusion.
+  - The client would automatically populate the `stackFrame` field for the `as.AerospikeError`. Since that was an expensive operation, the client now will consult the value of `StackTracesEnabled` variable before doing so. The default is set to `false` of course.
+  - The client now requires Go v1.23+. Needed to implement iterators later.
+
+- **New Features**
+  - [CLIENT-3159] Support writing raw payload to the server.
+  - [CLIENT-3183] [CLIENT-3203] [CLIENT-3193] [CLIENT-3190] Support Multi-Record Transactions.
+
+- **Fixes**
+  - [CLIENT-3214] Remove Proxy code.
+  - [CLIENT-3217] Do not send `nil` or `NullValue` as key to the server.
+
+- **Improvements**
+  - [CLIENT-3214] Support `-use-services-alternate` in test arguments.
+  - Renamed all `interface{}` to `any`.
+
 ## November 29 2024: v7.7.3
 
   Minor fix release.

README.md

@@ -1,24 +1,24 @@
-# Aerospike Go Client v7
+# Aerospike Go Client v8
 
-[![Aerospike Client Go](https://goreportcard.com/badge/github.com/aerospike/aerospike-client-go/v7)](https://goreportcard.com/report/github.com/aerospike/aerospike-client-go/v7)
-[![Godoc](https://godoc.org/github.com/aerospike/aerospike-client-go/v7?status.svg)](https://pkg.go.dev/github.com/aerospike/aerospike-client-go/v7)
-[![Tests](https://github.com/aerospike/aerospike-client-go/actions/workflows/build.yml/badge.svg?branch=v7&event=push)](github.com/aerospike/aerospike-client-go/actions)
+[![Aerospike Client Go](https://goreportcard.com/badge/github.com/aerospike/aerospike-client-go/v8)](https://goreportcard.com/report/github.com/aerospike/aerospike-client-go/v8)
+[![Godoc](https://godoc.org/github.com/aerospike/aerospike-client-go/v8?status.svg)](https://pkg.go.dev/github.com/aerospike/aerospike-client-go/v8)
+[![Tests](https://github.com/aerospike/aerospike-client-go/actions/workflows/build.yml/badge.svg?branch=v8&event=push)](github.com/aerospike/aerospike-client-go/actions)
 
 An Aerospike library for Go.
 
-This library is compatible with Go 1.20+ and supports the following operating systems: Linux, Mac OS X (Windows builds are possible, but untested).
+This library is compatible with Go 1.23+ and supports the following operating systems: Linux, Mac OS X (Windows builds are possible, but untested).
 
-Up-to-date documentation is available in the [![Godoc](https://godoc.org/github.com/aerospike/aerospike-client-go/v7?status.svg)](https://pkg.go.dev/github.com/aerospike/aerospike-client-go/v7).
+Up-to-date documentation is available in the [![Godoc](https://godoc.org/github.com/aerospike/aerospike-client-go/v8?status.svg)](https://pkg.go.dev/github.com/aerospike/aerospike-client-go/v8).
 
 You can refer to the test files for idiomatic use cases.
 
 Please refer to [`CHANGELOG.md`](CHANGELOG.md) for release notes, or if you encounter breaking changes.
 
-- [Aerospike Go Client v7](#aerospike-go-client-v7)
+- [Aerospike Go Client v8](#aerospike-go-client-v8)
   - [Usage](#usage)
   - [Prerequisites](#prerequisites)
   - [Installation](#installation)
-    - [Some Hints:](#some-hints)
+    - [Some Tips](#some-tips)
   - [Performance Tweaking](#performance-tweaking)
   - [Tests](#tests)
   - [Examples](#examples)
@@ -27,7 +27,6 @@ Please refer to [`CHANGELOG.md`](CHANGELOG.md) for release notes, or if you enco
   - [API Documentation](#api-documentation)
   - [Google App Engine](#google-app-engine)
   - [Reflection, and Object API](#reflection-and-object-api)
-  - [Proxy Client / DBAAS](#proxy-client--dbaas)
   - [License](#license)
 
 ## Usage
@@ -40,7 +39,7 @@ package main
 import (
   "fmt"
 
-  aero "github.com/aerospike/aerospike-client-go/v7"
+  aero "github.com/aerospike/aerospike-client-go/v8"
 )
 
 // This is only for this example.
@@ -63,7 +62,7 @@ func main() {
   bins := aero.BinMap{
     "bin1": 42,
     "bin2": "An elephant is a mouse with an operating system",
-    "bin3": []interface{}{"Go", 2009},
+    "bin3": []any{"Go", 2009},
   }
 
   // write the bins
@@ -89,12 +88,11 @@ Details about the API are available in the [`docs`](docs) directory.
 <a name="Prerequisites"></a>
 ## Prerequisites
 
-[Go](http://golang.org) version v1.20+ is required.
+[Go](http://golang.org) version v1.23+ is required.
 
 To install the latest stable version of Go, visit
 [http://golang.org/dl/](http://golang.org/dl/)
 
-
 Aerospike Go client implements the wire protocol, and does not depend on the C client.
 It is goroutine friendly, and works asynchronously.
 
@@ -108,16 +106,14 @@ Supported operating systems:
 ## Installation
 
 1. Install Go 1.21+ and setup your environment as [Documented](http://golang.org/doc/code.html#GOPATH) here.
-2. Get the client in your ```GOPATH``` : ```go get github.com/aerospike/aerospike-client-go/v7```
-  - To update the client library: ```go get -u github.com/aerospike/aerospike-client-go/v7```
-
-Using [gopkg.in](https://gopkg.in/) is also supported: `go get -u gopkg.in/aerospike/aerospike-client-go.v7`
+2. Get the client in your ```GOPATH``` : ```go get github.com/aerospike/aerospike-client-go/v8```
+  - To update the client library: ```go get -u github.com/aerospike/aerospike-client-go/v8```
 
-### Some Hints:
+### Some Tips
 
 - To run a go program directly: ```go run <filename.go>```
 - to build:  ```go build -o <output> <filename.go>```
-- example: ```go build -tags as_proxy -o benchmark tools/benchmark/benchmark.go```
+- example: ```go build -tags as_performance -o benchmark tools/benchmark/benchmark.go```
 
 <a name="Performance"></a>
 ## Performance Tweaking
@@ -160,7 +156,7 @@ See the [`tools/benchmark/README.md`](tools/benchmark/README.md) for details.
 <a name="api-documentation"></a>
 ## API Documentation
 
-A simple API documentation is available in the [`docs`](docs/README.md) directory. The latest up-to-date docs can be found in [![Godoc](https://godoc.org/github.com/aerospike/aerospike-client-go?status.svg)](https://pkg.go.dev/github.com/aerospike/aerospike-client-go/v7).
+A simple API documentation is available in the [`docs`](docs/README.md) directory. The latest up-to-date docs can be found in [![Godoc](https://godoc.org/github.com/aerospike/aerospike-client-go?status.svg)](https://pkg.go.dev/github.com/aerospike/aerospike-client-go/v8).
 
 <a name="google-app-engine"></a>
 ## Google App Engine
@@ -174,11 +170,6 @@ To build the library for App Engine, build it with the build tag `app_engine`. A
 To make the library both flexible and fast, we had to integrate the reflection API (methods with `[Get/Put/...]Object` names) tightly in the library. In case you wanted to avoid mixing those API in your app inadvertently, you can use the build tag `as_performance` to remove those APIs from the build.
 
 
-<a name="proxy-client--dbaas"></a>
-## Proxy Client / DBAAS
-
-To compile the client for the proxy server in our database-as-a-service (dbaas) environment, pass `-tags as_proxy` to the compiler on build.
-
 <a name="license"></a>
 ## License