- Go 99.5%
- Groovy 0.3%
- Makefile 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .github | ||
| .semgrep | ||
| configtesting | ||
| diag | ||
| endpoints | ||
| internal | ||
| logging | ||
| META.d | ||
| mockdata | ||
| servicemocks | ||
| tfawserr | ||
| tools | ||
| useragent | ||
| v2/awsv1shim | ||
| validation | ||
| .golangci.yml | ||
| .markdownlint.yml | ||
| .semgrepignore | ||
| aws_config.go | ||
| aws_config_test.go | ||
| awsauth.go | ||
| awsauth_test.go | ||
| CHANGELOG.md | ||
| clients.go | ||
| config.go | ||
| credentials.go | ||
| credentials_test.go | ||
| endpoints.go | ||
| errors.go | ||
| errors_test.go | ||
| GNUmakefile | ||
| go.mod | ||
| go.sum | ||
| go.work | ||
| go.work.sum | ||
| http_client.go | ||
| http_client_test.go | ||
| LICENSE | ||
| logger.go | ||
| README.md | ||
| s3attributes_test.go | ||
| user_agent.go | ||
| user_agent_test.go | ||
aws-sdk-go-base
An opinionated AWS SDK for Go v2 library for consistent authentication configuration between projects plus additional helper functions. This library was originally started in HashiCorp Terraform, migrated with the Terraform AWS Provider during the Terraform 0.10 Core and Provider split, and now is offered as a separate library to allow easier dependency management in the Terraform ecosystem.
NOTE: This library is not currently designed or intended for usage outside the Terraform S3 Backend, the Terraform AWS Provider, and the Terraform AWS Cloud Control Provider.
This project publishes two Go modules, aws-sdk-go-base/v2 and aws-sdk-go-base/v2/awsv1shim/v2.
The module aws-sdk-go-base/v2 returns configuration compatible with the AWS SDK for Go v2.
In order to assist with migrating large code bases using the AWS SDK for Go v1, the module aws-sdk-go-base/v2/awsv1shim/v2 takes the AWS SDK for Go v2 configuration and returns configuration for the AWS SDK for Go v1.
Go Compatibility
This project follows the support policy of Go as its support policy. The two latest major releases of Go are supported by the project.
Currently, that means Go 1.24 or later must be used when including this project as a dependency.
Development
Running make test will test both aws-sdk-go-base/v2 and aws-sdk-go-base/v2/awsv1shim/v2.
To test individual cases, go test works as well, but be aware that it only works in the current module.
To test both modules, run:
$ go test -v ./...
$ cd v2/awsv1shim && go test -v ./...
Code is validated using
golangci-lint for general code quality,
impi for import block formatting, and
Semgrep to validate additional rules.
golangci-lint and impi are Go tools, and can be installed using either make tools or installing the Go packages.
Installing the packages from the tools directory will ensure that you are using the expected version.
Semgrep can be installed as described in the documentation or using a Docker container.
Validation can be run using make lint to run golangci-lint and impi.
make semgrep will run Semgrep using a Docker container.
If running linters directly, be aware that golangci-lint will only run for the current module.
To validate both modules, run:
$ golangci-lint run ./...
$ cd v2/awsv1shim && golangci-lint run ./...
Release Process
The two modules can be released separately.
If changes are only made to awsv1shim, aws-sdk-go-base should not be released.
However, if changes are made to aws-sdk-go-base, both modules should be released.
- If creating a new release of
aws-sdk-go-base- Update the reference in the
awsv1shimgo.modfile - Run
go mod tidy
- Update the reference in the
- Update the CHANGELOG.md file
- Push the updated files to GitHub
- Push new version tags to GitHub. For more details on Go module versioning, see https://go.dev/doc/modules/version-numbers. (Commands
git tag -a -m "" <version tag>,git push --tags)- For
aws-sdk-go-base, use the formvX.Y.Z - For
awsv1shim, use the formv2/awsv1shim/vX.Y.Z
- For
- Close the associated GitHub milestone
- Create the releases on GitHub
AWS SDK Upgrade Policy
aws-sdk-go-base will only upgrade AWS SDKs as needed to bring in bug fixes or required enhancements.
This leaves software making use of this module free to manage their own SDK versions.