chore: import upstream snapshot with attribution

go/batch_example/README.md

@@ -0,0 +1,5 @@
+This example expects a `s16le` converted audio file and converts it to text in a
+manner that imitates the Python example of [test_gpu_batch.py](../python/example/test_gpu_batch.py).
+
+Note that the `libvosk.so` must be in the library path. This was successfully tested on
+Ubuntu 24.04 with Go 1.18, gcc-11, NVIDIA driver 570.172.08.

go/batch_example/test_batch.go

@@ -0,0 +1,54 @@
+package main
+
+import (
+	"flag"
+	"fmt"
+	"io"
+	"log"
+	"os"
+
+	vosk "github.com/alphacep/vosk-api/go"
+)
+
+func main() {
+	var filename string
+	flag.StringVar(&filename, "f", "", "file to transcribe")
+	flag.Parse()
+
+	vosk.GPUInit()
+
+	model, err := vosk.NewBatchModel("model")
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	rec, err := vosk.NewBatchRecognizer(model, 16000.0)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	file, err := os.Open(filename)
+	if err != nil {
+		panic(err)
+	}
+	defer file.Close()
+
+	buf := make([]byte, 8000)
+
+	for {
+		if _, err := file.Read(buf); err != nil {
+			if err != io.EOF {
+				log.Fatal(err)
+			}
+
+			break
+		}
+		rec.AcceptWaveform(buf)
+		model.Wait()
+		if rec.FrontResult() != "" {
+			fmt.Println(rec.FrontResult())
+			rec.Pop()
+		}
+	}
+	// Is this needed? rec.FinishStream()
+}