Add hand written prototype for updated client API design.

aws/transport/http/errors.go

@@ -0,0 +1,63 @@
+package http
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"net/http"
+
+	"github.com/awslabs/smithy-go/middleware"
+	smithyhttp "github.com/awslabs/smithy-go/transport/http"
+)
+
+// ResponseError provides the HTTP centric error type wrapping the underlying
+// error with the HTTP response value and the deserialized RequestID.
+type ResponseError struct {
+	*smithyhttp.ResponseError
+	RequestID string
+}
+
+// ServiceRequestID returns the HTTP response wrapping the underlying error.
+func (e *ResponseError) ServiceRequestID() string { return e.RequestID }
+
+func (e *ResponseError) Error() string {
+	return fmt.Sprintf(
+		"http response error StatusCode: %d, RequestID: %s, %v",
+		e.Response.StatusCode, e.RequestID, e.Err)
+}
+
+// As populates target and returns true if the type of target is a error type
+// that the ResponseError embeds, (e.g. Smithy's HTTP ResponseError)
+func (e *ResponseError) As(target interface{}) bool {
+	return errors.As(e.ResponseError, target)
+}
+
+// Client provides the interface for the minimum HTTP client behavior to
+// invoke a HTTP request.
+type Client interface {
+	Do(*http.Request) (*http.Response, error)
+}
+
+// ClientHandler provides a smithy middleware handler wrapper for an standard
+// HTTP client.
+type ClientHandler struct {
+	Client Client
+}
+
+// Handle invokes the HTTP client with the provided HTTP request. Returns the
+// response, or error if the request failed.
+func (h ClientHandler) Handle(ctx context.Context, input interface{}) (
+	out interface{}, metadata middleware.Metadata, err error,
+) {
+	sReq, ok := input.(*smithyhttp.Request)
+	if !ok {
+		return nil, metadata, fmt.Errorf(
+			"invalid input type for HTTP client handlers, expect %T, got %T",
+			input, (*smithyhttp.Request)(nil))
+	}
+
+	hReq := sReq.Build(ctx)
+
+	resp, err := h.Client.Do(hReq)
+	return resp, metadata, err
+}

service/smithyprototype/lexruntimeservice/api_client_example_test.go

@@ -0,0 +1,60 @@
+package lexruntimeservice_test
+
+import (
+	"context"
+	"fmt"
+	"log"
+
+	"github.com/aws/aws-sdk-go-v2/aws"
+	"github.com/aws/aws-sdk-go-v2/internal/awstesting/unit"
+	lexruntime "github.com/aws/aws-sdk-go-v2/service/smithyprototype/lexruntimeservice"
+)
+
+func ExampleNew() {
+	client := lexruntime.New(lexruntime.Options{
+		RegionID:    "us-west-2",
+		Credentials: customCredProvider,
+	})
+	res, err := client.GetSession(context.TODO(), &lexruntime.GetSessionInput{
+		BotAlias: aws.String("botAlias"),
+		BotName:  aws.String("botName"),
+		UserId:   aws.String("userID"),
+	})
+	if err != nil {
+		log.Fatalf("failed to get session, %v", err)
+	}
+
+	fmt.Println("session:", res.SessionId)
+}
+
+func ExampleNewFromConfig_customOptions() {
+	cfg, err := external.LoadDefaultAWSConfig()
+	if err != nil {
+		log.Fatalf("failed to load config, %v", err)
+	}
+
+	client := lexruntime.NewFromConfig(cfg, func(o *lexruntime.Options) {
+		o.RegionID = "us-west-2"
+	})
+	res, err := client.GetSession(context.TODO(), &lexruntime.GetSessionInput{
+		BotAlias: aws.String("botAlias"),
+		BotName:  aws.String("botName"),
+		UserId:   aws.String("userID"),
+	})
+	if err != nil {
+		log.Fatalf("failed to get session, %v", err)
+	}
+
+	fmt.Println("session:", res.SessionId)
+}
+
+var external = mockExternal{}
+
+type mockExternal struct {
+}
+
+func (mockExternal) LoadDefaultAWSConfig() (aws.Config, error) {
+	return aws.Config{}, nil
+}
+
+var customCredProvider = unit.Config().Credentials