AWS SDK for Go code examples for Amazon Polly
Purpose
These examples demonstrate how to perform several Amazon Polly operations.
Prerequisites
You must have an AWS account, and have your default credentials and AWS Region
configured as described in
Configuring the AWS SDK for Go
in the AWS SDK for Go Developer Guide.
Running the code
DescribeVoices/DescribeVoices.go
This example describes the Amazon Polly voices.
go run DescribeVoices.go
The unit test mocks the service client and the DescribeVoices
function.
ListLexicons/ListLexicons.go
This example lists the Amazon Polly lexicons,
which enable you to customize the pronunciation of words.
go run ListLexicons.go
The unit test mocks the service client and the ListLexicons
function.
SynthesizeSpeech/SynthesizeSpeech.go
This example produces an MP3 file by synthesisizing speech from a text file.
go run SynthesizeSpeech.go -f FILENAME
- FILENAME is a text file, with a
.txt
file extension.
The unit test mocks the service client and the SynthesizeSpeech
function.
Notes
- We recommend that you grant this code least privilege,
or at most the minimum permissions required to perform the task.
For more information, see
Grant Least Privilege
in the AWS Identity and Access Management User Guide.
- This code has not been tested in all AWS Regions.
Some AWS services are available only in specific
Regions.
- Running this code might result in charges to your AWS account.
Running the unit tests
Unit tests should delete any resources they create.
However, they might result in charges to your
AWS account.
To run a unit test, enter the following.
go test
You should see something like the following,
where PATH is the path to the folder containing the Go files.
PASS
ok PATH 6.593s
To see any log messages, enter the following.
go test -test.v
You should see additional log messages.
The last two lines should be similar to the previous output shown.
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. SPDX-License-Identifier: Apache-2.0