Add an empty aws codegen package

Author: haydenbaker

codegen/aws/README.md

@@ -0,0 +1,31 @@
+## Smithy AWS Python Codegen
+
+These packages implement AWS-specific code generation plugins to the python generator.
+Anything that is specific to AWS MUST be implemented here. Examples include most [AWS
+protocols](https://smithy.io/2.0/aws/protocols/index.html)(*),
+[SigV4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html),
+and AWS service customizations. Conversely, any features that are
+NOT specific to AWS MUST NOT be implemented here.
+
+*The only exception to this rule is the `RestJson1` protocol implementation, which is
+included in the generic generator for now to provide a default supported protocol.
+
+One very important thing to keep in mind when implementing features and integrations
+here is that they MUST NOT be coupled wherever possible. For example, a user
+MUST be able to use SigV4 even if they aren't using an AWS protocol or even the
+[service trait](https://smithy.io/2.0/aws/aws-core.html#aws-api-service-trait).
+
+### Why separate AWS components from the core package and each other?
+
+Smithy is intended to be a generic IDL that can describe a broad range of protocols,
+not just AWS protocols. Separating the code generation components forces developers
+to provide interfaces capable of achieving that goal and ensures that users only
+have to take what they need.
+
+In the future, these components may be moved to an entirely different repository to
+strengthen that divide even more.
+
+### When should I change this package?
+
+Any time an AWS component needs to be modified or added. This can include adding
+support for new protocols, new auth traits, or new service customizations.

codegen/aws/core/build.gradle.kts

@@ -0,0 +1,15 @@
+plugins {
+    id("smithy-python.module-conventions")
+    id("smithy-python.integ-test-conventions")
+}
+
+description = "This module provides the core aws codegen functionality for Smithy Python"
+group = "software.amazon.smithy.python.codegen.aws"
+
+extra["displayName"] = "Smithy :: Python :: AWS :: Codegen"
+extra["moduleName"] = "software.amazon.smithy.python.aws.codegen"
+
+dependencies {
+    implementation(project(":core"))
+    implementation(libs.smithy.aws.traits)
+}

codegen/aws/core/src/main/java/software/amazon/smithy/python/aws/codegen/AwsAuthIntegration.java

@@ -0,0 +1,14 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+package software.amazon.smithy.python.aws.codegen;
+
+import software.amazon.smithy.python.codegen.integrations.PythonIntegration;
+import software.amazon.smithy.utils.SmithyInternalApi;
+
+/**
+ * Adds support for AWS auth traits.
+ */
+@SmithyInternalApi
+public class AwsAuthIntegration implements PythonIntegration {}

codegen/aws/core/src/main/java/software/amazon/smithy/python/aws/codegen/AwsProtocolsIntegration.java

@@ -0,0 +1,21 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+package software.amazon.smithy.python.aws.codegen;
+
+import java.util.List;
+import software.amazon.smithy.python.codegen.generators.ProtocolGenerator;
+import software.amazon.smithy.python.codegen.integrations.PythonIntegration;
+import software.amazon.smithy.utils.SmithyInternalApi;
+
+/**
+ * Adds AWS protocols to the generator's list of supported protocols.
+ */
+@SmithyInternalApi
+public class AwsProtocolsIntegration implements PythonIntegration {
+    @Override
+    public List<ProtocolGenerator> getProtocolGenerators() {
+        return List.of();
+    }
+}

codegen/aws/core/src/main/resources/META-INF/services/software.amazon.smithy.python.codegen.integrations.PythonIntegration

@@ -0,0 +1,7 @@
+#
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+
+software.amazon.smithy.python.aws.codegen.AwsAuthIntegration
+software.amazon.smithy.python.aws.codegen.AwsProtocolsIntegration

codegen/settings.gradle.kts

@@ -16,3 +16,4 @@
 rootProject.name = "smithy-python"
 include(":core")
 include(":protocol-test")
+include(":aws:core")