Update packaging for /v5/, update README.md (#126)

## Problem
To bump the Go SDK to the next major version, we need to update the
module packaging for `/v5/`.

The `README` and a few other pieces of documentation need to be updated
for the release.

## Solution
- Update `go.mod` and relevant imports to move to `/v5/`.
- Update `README`. Update comments. Etc.

## Type of Change
- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [X] This change requires a documentation update
- [X] Infrastructure change (CI configs, etc)
- [ ] Non-code change (docs, etc)
- [ ] None of the above: (explain here)

## Test Plan
CI - unit, integration, etc


---
- To see the specific tasks where the Asana app for GitHub is being
used, see below:
  - https://app.asana.com/0/0/1211903965624968

Author: austin-denoble

README.md

@@ -1,4 +1,4 @@
-module github.com/pinecone-io/go-pinecone/v4
+module github.com/pinecone-io/go-pinecone/v5
 
 go 1.21
 

go.mod

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"strings"
 
-	"github.com/pinecone-io/go-pinecone/v4/internal"
+	"github.com/pinecone-io/go-pinecone/v5/internal"
 )
 
 func getPackageVersion() string {

internal/useragent/useragent.go

@@ -39,5 +39,5 @@ gen:
   ./codegen/build-clients.sh {{api_version}}
 
 docs:
-  @echo "Serving docs at http://localhost:6060/pkg/github.com/pinecone-io/go-pinecone/v4/pinecone/"
+  @echo "Serving docs at http://localhost:6060/pkg/github.com/pinecone-io/go-pinecone/v5/pinecone/"
   @godoc -http=:6060 >/dev/null

justfile

@@ -11,10 +11,10 @@ import (
 	"os"
 
 	"github.com/google/uuid"
-	"github.com/pinecone-io/go-pinecone/v4/internal/gen"
-	"github.com/pinecone-io/go-pinecone/v4/internal/gen/admin"
-	"github.com/pinecone-io/go-pinecone/v4/internal/provider"
-	"github.com/pinecone-io/go-pinecone/v4/internal/useragent"
+	"github.com/pinecone-io/go-pinecone/v5/internal/gen"
+	"github.com/pinecone-io/go-pinecone/v5/internal/gen/admin"
+	"github.com/pinecone-io/go-pinecone/v5/internal/provider"
+	"github.com/pinecone-io/go-pinecone/v5/internal/useragent"
 )
 
 // [AdminClient] provides access to Pinecone's administrative APIs, which supports

pinecone/admin_client.go

@@ -7,7 +7,7 @@ import (
 	"testing"
 
 	"github.com/google/uuid"
-	"github.com/pinecone-io/go-pinecone/v4/internal/gen/admin"
+	"github.com/pinecone-io/go-pinecone/v5/internal/gen/admin"
 	"github.com/stretchr/testify/assert"
 	"github.com/stretchr/testify/require"
 )

pinecone/admin_client_test.go

@@ -15,12 +15,12 @@ import (
 	"os"
 	"strings"
 
-	"github.com/pinecone-io/go-pinecone/v4/internal/gen"
-	"github.com/pinecone-io/go-pinecone/v4/internal/gen/db_control"
-	db_data_rest "github.com/pinecone-io/go-pinecone/v4/internal/gen/db_data/rest"
-	"github.com/pinecone-io/go-pinecone/v4/internal/gen/inference"
-	"github.com/pinecone-io/go-pinecone/v4/internal/provider"
-	"github.com/pinecone-io/go-pinecone/v4/internal/useragent"
+	"github.com/pinecone-io/go-pinecone/v5/internal/gen"
+	"github.com/pinecone-io/go-pinecone/v5/internal/gen/db_control"
+	db_data_rest "github.com/pinecone-io/go-pinecone/v5/internal/gen/db_data/rest"
+	"github.com/pinecone-io/go-pinecone/v5/internal/gen/inference"
+	"github.com/pinecone-io/go-pinecone/v5/internal/provider"
+	"github.com/pinecone-io/go-pinecone/v5/internal/useragent"
 	"google.golang.org/grpc"
 )
 

pinecone/client.go

@@ -14,10 +14,10 @@ import (
 
 	"github.com/google/go-cmp/cmp"
 	"github.com/google/uuid"
-	"github.com/pinecone-io/go-pinecone/v4/internal/gen"
-	"github.com/pinecone-io/go-pinecone/v4/internal/gen/db_control"
-	"github.com/pinecone-io/go-pinecone/v4/internal/provider"
-	"github.com/pinecone-io/go-pinecone/v4/internal/utils"
+	"github.com/pinecone-io/go-pinecone/v5/internal/gen"
+	"github.com/pinecone-io/go-pinecone/v5/internal/gen/db_control"
+	"github.com/pinecone-io/go-pinecone/v5/internal/provider"
+	"github.com/pinecone-io/go-pinecone/v5/internal/utils"
 
 	"github.com/stretchr/testify/assert"
 	"github.com/stretchr/testify/require"

pinecone/client_test.go

@@ -12,10 +12,10 @@ import (
 	"net/url"
 	"strings"
 
-	"github.com/pinecone-io/go-pinecone/v4/internal/gen"
-	db_data_grpc "github.com/pinecone-io/go-pinecone/v4/internal/gen/db_data/grpc"
-	db_data_rest "github.com/pinecone-io/go-pinecone/v4/internal/gen/db_data/rest"
-	"github.com/pinecone-io/go-pinecone/v4/internal/useragent"
+	"github.com/pinecone-io/go-pinecone/v5/internal/gen"
+	db_data_grpc "github.com/pinecone-io/go-pinecone/v5/internal/gen/db_data/grpc"
+	db_data_rest "github.com/pinecone-io/go-pinecone/v5/internal/gen/db_data/rest"
+	"github.com/pinecone-io/go-pinecone/v5/internal/useragent"
 	"google.golang.org/grpc"
 	"google.golang.org/grpc/credentials"
 	"google.golang.org/grpc/credentials/insecure"
@@ -1203,6 +1203,18 @@ func (idx *IndexConnection) SearchRecords(ctx context.Context, in *SearchRecords
 		}
 	}
 
+	var matchTerms *db_data_rest.SearchMatchTerms
+	if in.Query.MatchTerms != nil {
+		strat := "all"
+		if in.Query.MatchTerms.Strategy != nil {
+			strat = *in.Query.MatchTerms.Strategy
+		}
+		matchTerms = &db_data_rest.SearchMatchTerms{
+			Strategy: &strat,
+			Terms:    in.Query.MatchTerms.Terms,
+		}
+	}
+
 	req := db_data_rest.SearchRecordsRequest{
 		Fields: in.Fields,
 		Query: struct {
@@ -1213,10 +1225,11 @@ func (idx *IndexConnection) SearchRecords(ctx context.Context, in *SearchRecords
 			TopK       int32                             `json:"top_k"`
 			Vector     *db_data_rest.SearchRecordsVector `json:"vector,omitempty"`
 		}{
-			Filter: in.Query.Filter,
-			Id:     in.Query.Id,
-			TopK:   in.Query.TopK,
-			Vector: convertedVector,
+			Filter:     in.Query.Filter,
+			Id:         in.Query.Id,
+			TopK:       in.Query.TopK,
+			Vector:     convertedVector,
+			MatchTerms: matchTerms,
 		},
 	}
 

pinecone/index_connection.go

@@ -7,8 +7,8 @@ import (
 	"testing"
 
 	"github.com/google/go-cmp/cmp"
-	db_data_grpc "github.com/pinecone-io/go-pinecone/v4/internal/gen/db_data/grpc"
-	"github.com/pinecone-io/go-pinecone/v4/internal/utils"
+	db_data_grpc "github.com/pinecone-io/go-pinecone/v5/internal/gen/db_data/grpc"
+	"github.com/pinecone-io/go-pinecone/v5/internal/utils"
 	"google.golang.org/grpc"
 	"google.golang.org/grpc/metadata"
 	"google.golang.org/protobuf/types/known/structpb"
@@ -148,6 +148,8 @@ func (ts *integrationTests) TestDescribeIndexStats() {
 	assert.NotNil(ts.T(), res)
 }
 
+// MetadataFilter on this operation isPods-based indexes only.
+// This primarily just validates passing the MetadataFilter to the method.
 func (ts *integrationTests) TestDescribeIndexStatsFiltered() {
 	ctx := context.Background()
 	res, err := ts.idxConn.DescribeIndexStatsFiltered(ctx, &MetadataFilter{})
@@ -601,6 +603,9 @@ func (ts *integrationTests) TestIntegratedInference() {
 				Inputs: &map[string]interface{}{
 					"text": "Disease prevention",
 				},
+				MatchTerms: &SearchMatchTerms{
+					Terms: &[]string{"disease", "prevention"},
+				},
 			},
 		})
 		if err != nil {