add example project for testing snippets (#90)

* add example project for testing snippets

* simplify readme

* doc: Updated instructions

Signed-off-by: Anush008 <anushshetty90@gmail.com>

---------

Signed-off-by: Anush008 <anushshetty90@gmail.com>
Co-authored-by: Anush008 <anushshetty90@gmail.com>

Author: generall

examples/simple/Dockerfile

@@ -0,0 +1,16 @@
+FROM golang:1.22-alpine
+
+# Set working directory
+WORKDIR /app
+
+# Copy go mod files
+COPY go.mod go.sum ./
+
+# Download dependencies
+RUN go mod download
+
+# Copy source code
+COPY main.go ./
+
+# Build and run the application
+CMD ["go", "run", "main.go"]

examples/simple/README.md

@@ -0,0 +1,23 @@
+# Simple Qdrant Client Example
+
+This is a simple example application that demonstrates how to create a Go application that could interact with a Qdrant vector database server.
+
+## Prerequisites
+
+- Docker installed on your system
+
+## Quick Start
+
+### 1. Start Qdrant
+
+First, make sure Qdrant is running. You can start it with Docker:
+
+```bash
+docker run --rm -it -p 6334:6334 -p 6333:6333 qdrant/qdrant
+```
+
+### 2. Building and Running
+
+```bash
+bash -x build-and-run.sh
+```

examples/simple/build-and-run.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+
+docker build -t qdrant-simple-example .
+
+docker run --rm -it --network host qdrant-simple-example
+

examples/simple/go.mod

@@ -0,0 +1,14 @@
+module simple-example
+
+go 1.22.2
+
+require github.com/qdrant/go-client v1.15.2
+
+require (
+	golang.org/x/net v0.28.0 // indirect
+	golang.org/x/sys v0.28.0 // indirect
+	golang.org/x/text v0.21.0 // indirect
+	google.golang.org/genproto/googleapis/rpc v0.0.0-20240827150818-7e3bb234dfed // indirect
+	google.golang.org/grpc v1.66.0 // indirect
+	google.golang.org/protobuf v1.34.2 // indirect
+)

examples/simple/go.sum

@@ -0,0 +1,16 @@
+github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
+github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
+github.com/qdrant/go-client v1.15.2 h1:3NSyxpHrfQTP6JLDAwqNUShz6V9tuRBKz0G7hSOxrac=
+github.com/qdrant/go-client v1.15.2/go.mod h1:iO8ts78jL4x6LDHFOViyYWELVtIBDTjOykBmiOTHLnQ=
+golang.org/x/net v0.28.0 h1:a9JDOJc5GMUJ0+UDqmLT86WiEy7iWyIhz8gz8E4e5hE=
+golang.org/x/net v0.28.0/go.mod h1:yqtgsTWOOnlGLG9GFRrK3++bGOUEkNBoHZc8MEDWPNg=
+golang.org/x/sys v0.28.0 h1:Fksou7UEQUWlKvIdsqzJmUmCX3cZuD2+P3XyyzwMhlA=
+golang.org/x/sys v0.28.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
+golang.org/x/text v0.21.0 h1:zyQAAkrwaneQ066sspRyJaG9VNi/YJ1NfzcGB3hZ/qo=
+golang.org/x/text v0.21.0/go.mod h1:4IBbMaMmOPCJ8SecivzSH54+73PCFmPWxNTLm+vZkEQ=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20240827150818-7e3bb234dfed h1:J6izYgfBXAI3xTKLgxzTmUltdYaLsuBxFCgDHWJ/eXg=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20240827150818-7e3bb234dfed/go.mod h1:UqMtugtsSgubUsoxbuAoiCXvqvErP7Gf0so0mK9tHxU=
+google.golang.org/grpc v1.66.0 h1:DibZuoBznOxbDQxRINckZcUvnCEvrW9pcWIE2yF9r1c=
+google.golang.org/grpc v1.66.0/go.mod h1:s3/l6xSSCURdVfAnL+TqCNMyTDAGN6+lZeVxnZR128Y=
+google.golang.org/protobuf v1.34.2 h1:6xV6lTsCfpGD21XK49h7MhtcApnLqkfYgPcdHftf6hg=
+google.golang.org/protobuf v1.34.2/go.mod h1:qYOHts0dSfpeUzUFpOMr/WGzszTmLH+DiWniOlNbLDw=

examples/simple/main.go

@@ -0,0 +1,51 @@
+package main
+
+import (
+	"context"
+	"log"
+
+	"github.com/qdrant/go-client/qdrant"
+)
+
+const (
+	collectionName = "test_collection"
+)
+
+func main() {
+	// Create context
+	ctx := context.Background()
+
+	// Create new client
+	client, err := qdrant.NewClient(&qdrant.Config{
+		Host: "localhost", // Can be omitted, default is "localhost"
+		Port: 6334,        // Can be omitted, default is 6334
+		// APIKey: "<API_KEY>",
+		// UseTLS: true,
+		// TLSConfig: &tls.Config{},
+		// GrpcOptions: []grpc.DialOption{},
+	})
+	if err != nil {
+		log.Fatalf("Failed to create client: %v", err)
+	}
+	defer client.Close()
+
+	err = client.CreateCollection(ctx, &qdrant.CreateCollection{
+		CollectionName: collectionName,
+		VectorsConfig: qdrant.NewVectorsConfig(&qdrant.VectorParams{
+			Size:     uint64(128),
+			Distance: qdrant.Distance_Cosine,
+		}),
+	})
+
+	if err != nil {
+		log.Printf("Could not create collection: %v", err)
+		return
+	}
+
+	collections, err := client.ListCollections(ctx)
+	if err != nil {
+		log.Printf("Could not list collections: %v", err)
+		return
+	}
+	log.Printf("List of collections: %+v", collections)
+}