Feat/dictation endpoint

.gitignore

@@ -0,0 +1 @@
+.DS_Store

README.md

@@ -39,7 +39,7 @@ func main() {
 
 ## Testing
 
-Unit tests are executed by Github Actions, but Integration tests have to be executed manually by providing a valid token via `WITAI_INTEGRATION_TOKEN` env var.
+Unit tests are executed by Github Actions.
 
 ### Unit tests
 
@@ -49,6 +49,8 @@ go test -race -v
 
 ### Integration tests
 
+Integration tests have to be executed manually by providing a valid token via `WITAI_INTEGRATION_TOKEN` env var.
+
 Integration tests are connecting to real Wit.ai API, so you need to provide a valid token:
 
 ```

dictation.go

@@ -0,0 +1,51 @@
+// Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
+
+package witai
+
+import (
+	"encoding/json"
+	"io"
+	"net/http"
+)
+
+type DictationRequest struct {
+	File        io.Reader
+	ContentType string
+}
+
+type DictationToken struct {
+	End   int    `json:"end"`
+	Start int    `json:"start"`
+	Token string `json:"token"`
+}
+
+type DictationSpeech struct {
+	Confidence float64          `json:"confidence"`
+	Tokens     []DictationToken `json:"tokens"`
+}
+
+type DictationResponse struct {
+	Speech DictationSpeech `json:"speech"`
+	Text   string          `json:"text"`
+	Type   string          `json:"type"`
+}
+
+// Dictation - Returns the text transcription from an audio file or stream.
+func (c *Client) Dictation(req DictationRequest) (*DictationResponse, error) {
+	resp, err := c.request(http.MethodPost, "/dictation", req.ContentType, req.File)
+	if err != nil {
+		return nil, err
+	}
+
+	defer resp.Close()
+
+	var msgResp *DictationResponse
+	decoder := json.NewDecoder(resp)
+	for {
+		err := decoder.Decode(&msgResp)
+		if err != nil {
+			break
+		}
+	}
+	return msgResp, err
+}

integration_test.go

@@ -146,3 +146,27 @@ func getIntegrationClient() *Client {
 	})
 	return c
 }
+
+func TestIntegrationDictation(t *testing.T) {
+	c := getIntegrationClient()
+
+	f, err := os.Open("./testdata/test.mp3")
+	if err != nil {
+		t.Fatalf("unable to open test file, err: %v", err)
+	}
+	defer f.Close()
+
+	req := DictationRequest{
+		File:        f,
+		ContentType: "audio/mpeg3",
+	}
+
+	resp, err := c.Dictation(req)
+	if err != nil {
+		t.Fatalf("unexpected err, got %v", err)
+	}
+
+	if resp.Text != "Hi this is a test file" {
+		t.Fatalf("unexpected transcript, got %s", resp.Text)
+	}
+}