ceph-csi/vendor/github.com/aws/smithy-go
dependabot[bot] 40ad4163cb rebase: bump the github-dependencies group with 2 updates
Bumps the github-dependencies group with 2 updates: [github.com/aws/aws-sdk-go-v2/service/sts](https://github.com/aws/aws-sdk-go-v2) and [github.com/prometheus/client_golang](https://github.com/prometheus/client_golang).


Updates `github.com/aws/aws-sdk-go-v2/service/sts` from 1.30.7 to 1.31.1
- [Release notes](https://github.com/aws/aws-sdk-go-v2/releases)
- [Changelog](https://github.com/aws/aws-sdk-go-v2/blob/service/s3/v1.31.1/CHANGELOG.md)
- [Commits](https://github.com/aws/aws-sdk-go-v2/compare/service/mgn/v1.30.7...service/s3/v1.31.1)

Updates `github.com/prometheus/client_golang` from 1.20.3 to 1.20.4
- [Release notes](https://github.com/prometheus/client_golang/releases)
- [Changelog](https://github.com/prometheus/client_golang/blob/main/CHANGELOG.md)
- [Commits](https://github.com/prometheus/client_golang/compare/v1.20.3...v1.20.4)

---
updated-dependencies:
- dependency-name: github.com/aws/aws-sdk-go-v2/service/sts
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: github-dependencies
- dependency-name: github.com/prometheus/client_golang
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: github-dependencies
...

Signed-off-by: dependabot[bot] <support@github.com>
2024-09-25 07:11:32 +00:00
..
auth rebase: bump the github-dependencies group with 2 updates 2023-11-21 09:06:47 +00:00
context rebase: bump github.com/aws/aws-sdk-go-v2/service/sts 2022-09-14 08:56:18 +00:00
document rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
encoding rebase: Bump github.com/aws/aws-sdk-go-v2/service/sts 2023-08-01 13:50:10 +00:00
endpoints rebase: Bump github.com/aws/aws-sdk-go-v2/service/sts 2023-08-01 13:50:10 +00:00
internal/sync/singleflight rebase: bump github.com/aws/aws-sdk-go-v2/service/sts 2022-09-14 08:56:18 +00:00
io rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
logging rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
metrics rebase: bump the github-dependencies group with 2 updates 2024-09-25 07:11:32 +00:00
middleware rebase: bump the github-dependencies group with 2 updates 2024-09-25 07:11:32 +00:00
ptr rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
rand rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
time rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
tracing rebase: bump the github-dependencies group with 2 updates 2024-09-25 07:11:32 +00:00
transport/http rebase: bump the github-dependencies group with 2 updates 2024-09-25 07:11:32 +00:00
.gitignore rebase: bump the github-dependencies group with 2 updates 2024-02-20 13:01:15 +00:00
.travis.yml rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
CHANGELOG.md rebase: bump the github-dependencies group with 2 updates 2024-09-25 07:11:32 +00:00
CODE_OF_CONDUCT.md rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
CONTRIBUTING.md rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
doc.go rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
document.go rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
errors.go rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
go_module_metadata.go rebase: bump the github-dependencies group with 2 updates 2024-09-25 07:11:32 +00:00
LICENSE rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
local-mod-replace.sh rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
Makefile rebase: bump the github-dependencies group with 2 updates 2024-02-20 13:01:15 +00:00
modman.toml rebase: bump the github-dependencies group with 2 updates 2024-02-27 08:36:05 +00:00
NOTICE rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00
properties.go rebase: bump the github-dependencies group with 2 updates 2024-09-25 07:11:32 +00:00
README.md rebase: bump the github-dependencies group across 1 directory with 4 updates 2024-08-22 10:52:39 +00:00
validation.go rbd: add aws-sts-metdata encryption type 2022-03-16 07:29:56 +00:00

Smithy Go

Go Build StatusCodegen Build Status

Smithy code generators for Go and the accompanying smithy-go runtime.

The smithy-go runtime requires a minimum version of Go 1.20.

WARNING: All interfaces are subject to change.

Can I use the code generators?

In order to generate a usable smithy client you must provide a protocol definition, such as AWS restJson1, in order to generate transport mechanisms and serialization/deserialization code ("serde") accordingly.

The code generator does not currently support any protocols out of the box other than the new smithy.protocols#rpcv2Cbor, therefore the useability of this project on its own is currently limited. Support for all AWS protocols exists in aws-sdk-go-v2. We are tracking the movement of those out of the SDK into smithy-go in #458, but there's currently no timeline for doing so.

Plugins

This repository implements the following Smithy build plugins:

ID GAV prefix Description
go-codegen software.amazon.smithy.go:smithy-go-codegen Implements Go client code generation for Smithy models.
go-server-codegen software.amazon.smithy.go:smithy-go-codegen Implements Go server code generation for Smithy models.

NOTE: Build plugins are not currently published to mavenCentral. You must publish to mavenLocal to make the build plugins visible to the Smithy CLI. The artifact version is currently fixed at 0.1.0.

go-codegen

Configuration

GoSettings contains all of the settings enabled from smithy-build.json and helper methods and types. The up-to-date list of top-level properties enabled for go-client-codegen can be found in GoSettings::from().

Setting Type Required Description
service string yes The Shape ID of the service for which to generate the client.
module string yes Name of the module in generated.json (and go.mod if generateGoMod is enabled) and doc.go.
generateGoMod boolean Whether to generate a default go.mod file. The default value is false.
goDirective string Go directive of the module. The default value is the minimum supported Go version.

Supported protocols

Protocol Notes
smithy.protocols#rpcv2Cbor Event streaming not yet implemented.

Example

This example applies the go-codegen build plugin to the Smithy quickstart example created from smithy init:

{
  "version": "1.0",
  "sources": [
    "models"
  ],
  "maven": {
    "dependencies": [
      "software.amazon.smithy.go:smithy-go-codegen:0.1.0"
    ]
  },
  "plugins": {
    "go-codegen": {
      "service": "example.weather#Weather",
      "module": "github.com/example/weather",
      "generateGoMod": true,
      "goDirective": "1.20"
    }
  }
}

go-server-codegen

This plugin is a work-in-progress and is currently undocumented.

License

This project is licensed under the Apache-2.0 License.