Use service titles in client package descriptions

codegen-output/aws-json-1-0/README.md

@@ -2,4 +2,4 @@
 
 ## Sample Json 1.0 Protocol Service Client
 
-awsjson10 client
+Python client for Sample Json 1.0 Protocol Service

codegen-output/aws-json-1-0/pyproject.toml

@@ -3,7 +3,7 @@
 [project]
 name = "awsjson10"
 version = "0.0.1"
-description = "awsjson10 client"
+description = "Python client for Sample Json 1.0 Protocol Service"
 readme = "README.md"
 requires-python = ">=3.12"
 keywords = ["smithy", "awsjson10"]

codegen-output/aws-json-1-1/README.md

@@ -2,4 +2,4 @@
 
 ## Sample Json 1.1 Protocol Service Client
 
-awsjson11 client
+Python client for Sample Json 1.1 Protocol Service

codegen-output/aws-json-1-1/pyproject.toml

@@ -3,7 +3,7 @@
 [project]
 name = "awsjson11"
 version = "0.0.1"
-description = "awsjson11 client"
+description = "Python client for Sample Json 1.1 Protocol Service"
 readme = "README.md"
 requires-python = ">=3.12"
 keywords = ["smithy", "awsjson11"]

codegen-output/aws-query/README.md

@@ -2,7 +2,7 @@
 
 ## Sample Query Protocol Service Client
 
-awsquery client
+Python client for Sample Query Protocol Service
 
 ### Documentation
 

codegen-output/aws-query/pyproject.toml

@@ -3,7 +3,7 @@
 [project]
 name = "awsquery"
 version = "0.0.1"
-description = "awsquery client"
+description = "Python client for Sample Query Protocol Service"
 readme = "README.md"
 requires-python = ">=3.12"
 keywords = ["smithy", "awsquery"]

codegen-output/ec2-query/README.md

@@ -2,7 +2,7 @@
 
 ## Sample Ec2 Protocol Service Client
 
-ec2query client
+Python client for Sample Ec2 Protocol Service
 
 ### Documentation
 

codegen-output/ec2-query/pyproject.toml

@@ -3,7 +3,7 @@
 [project]
 name = "ec2query"
 version = "0.0.1"
-description = "ec2query client"
+description = "Python client for Sample Ec2 Protocol Service"
 readme = "README.md"
 requires-python = ">=3.12"
 keywords = ["smithy", "ec2query"]

codegen-output/my-handwritten-model/README.md

@@ -2,4 +2,4 @@
 
 ## My Handwritten Model Client
 
-my_handwritten_model client
+Python client for My Handwritten Model

codegen-output/my-handwritten-model/pyproject.toml

@@ -3,7 +3,7 @@
 [project]
 name = "my_handwritten_model"
 version = "0.0.1"
-description = "my_handwritten_model client"
+description = "Python client for My Handwritten Model"
 readme = "README.md"
 requires-python = ">=3.12"
 keywords = ["smithy", "my_handwritten_model"]

codegen-output/non-query-compatible-rpcv2-cbor/README.md

@@ -2,4 +2,4 @@
 
 ## Non Query Compatible RpcV2 Protocol Service Client
 
-nonquerycompatiblerpcv2cbor client
+Python client for Non Query Compatible RpcV2 Protocol Service

codegen-output/non-query-compatible-rpcv2-cbor/pyproject.toml

@@ -3,7 +3,7 @@
 [project]
 name = "nonquerycompatiblerpcv2cbor"
 version = "0.0.1"
-description = "nonquerycompatiblerpcv2cbor client"
+description = "Python client for Non Query Compatible RpcV2 Protocol Service"
 readme = "README.md"
 requires-python = ">=3.12"
 keywords = ["smithy", "nonquerycompatiblerpcv2cbor"]

codegen-output/query-compatible-aws-json-1-0/README.md

@@ -2,4 +2,4 @@
 
 ## Query Compatible Json 1.0 Protocol Service Client
 
-querycompatibleawsjson10 client
+Python client for Query Compatible Json 1.0 Protocol Service

codegen-output/query-compatible-aws-json-1-0/pyproject.toml

@@ -3,7 +3,7 @@
 [project]
 name = "querycompatibleawsjson10"
 version = "0.0.1"
-description = "querycompatibleawsjson10 client"
+description = "Python client for Query Compatible Json 1.0 Protocol Service"
 readme = "README.md"
 requires-python = ">=3.12"
 keywords = ["smithy", "querycompatibleawsjson10"]

codegen-output/query-compatible-rpcv2-cbor/README.md

@@ -2,4 +2,4 @@
 
 ## Query Compatible RpcV2 Protocol Service Client
 
-querycompatiblerpcv2cbor client
+Python client for Query Compatible RpcV2 Protocol Service

codegen-output/query-compatible-rpcv2-cbor/pyproject.toml

@@ -3,7 +3,7 @@
 [project]
 name = "querycompatiblerpcv2cbor"
 version = "0.0.1"
-description = "querycompatiblerpcv2cbor client"
+description = "Python client for Query Compatible RpcV2 Protocol Service"
 readme = "README.md"
 requires-python = ">=3.12"
 keywords = ["smithy", "querycompatiblerpcv2cbor"]

codegen-output/rest-json-1/README.md

@@ -2,4 +2,4 @@
 
 ## Sample Rest Json Protocol Service Client
 
-restjson client
+Python client for Sample Rest Json Protocol Service

codegen-output/rest-json-1/pyproject.toml

@@ -3,7 +3,7 @@
 [project]
 name = "restjson"
 version = "0.0.1"
-description = "restjson client"
+description = "Python client for Sample Rest Json Protocol Service"
 readme = "README.md"
 requires-python = ">=3.12"
 keywords = ["smithy", "restjson"]

codegen-output/rest-xml-with-namespace/README.md

@@ -2,7 +2,7 @@
 
 ## Sample Rest Xml Protocol Service With Namespace Client
 
-restxmlwithnamespace client
+Python client for Sample Rest Xml Protocol Service With Namespace
 
 ### Documentation
 

codegen-output/rest-xml-with-namespace/pyproject.toml

@@ -3,7 +3,7 @@
 [project]
 name = "restxmlwithnamespace"
 version = "0.0.1"
-description = "restxmlwithnamespace client"
+description = "Python client for Sample Rest Xml Protocol Service With Namespace"
 readme = "README.md"
 requires-python = ">=3.12"
 keywords = ["smithy", "restxmlwithnamespace"]

codegen-output/rest-xml/README.md

@@ -2,7 +2,7 @@
 
 ## Sample Rest Xml Protocol Service Client
 
-restxml client
+Python client for Sample Rest Xml Protocol Service
 
 ### Documentation
 

codegen-output/rest-xml/pyproject.toml

@@ -3,7 +3,7 @@
 [project]
 name = "restxml"
 version = "0.0.1"
-description = "restxml client"
+description = "Python client for Sample Rest Xml Protocol Service"
 readme = "README.md"
 requires-python = ">=3.12"
 keywords = ["smithy", "restxml"]

codegen-output/rpcv2-cbor/README.md

@@ -2,4 +2,4 @@
 
 ## RpcV2 Protocol Service Client
 
-rpcv2cbor client
+Python client for RpcV2 Protocol Service

codegen-output/rpcv2-cbor/pyproject.toml

@@ -3,7 +3,7 @@
 [project]
 name = "rpcv2cbor"
 version = "0.0.1"
-description = "rpcv2cbor client"
+description = "Python client for RpcV2 Protocol Service"
 readme = "README.md"
 requires-python = ">=3.12"
 keywords = ["smithy", "rpcv2cbor"]

codegen/core/src/main/java/software/amazon/smithy/python/codegen/PythonSettings.java

@@ -5,7 +5,6 @@
 package software.amazon.smithy.python.codegen;
 
 import java.util.Arrays;
-import java.util.Locale;
 import java.util.Objects;
 import software.amazon.smithy.codegen.core.CodegenException;
 import software.amazon.smithy.model.Model;
@@ -56,9 +55,8 @@ private PythonSettings(Builder builder) {
                 builder.service,
                 builder.moduleName,
                 builder.moduleVersion,
-                StringUtils.isBlank(builder.moduleDescription)
-                        ? builder.moduleName + " " + builder.artifactType.name().toLowerCase(Locale.ENGLISH)
-                        : builder.moduleDescription,
+                // Unset descriptions stay empty; SetupGenerator resolves them from the service.
+                StringUtils.isBlank(builder.moduleDescription) ? "" : builder.moduleDescription,
                 builder.artifactType);
     }
 
@@ -87,10 +85,9 @@ public ServiceShape service(Model model) {
     public static PythonSettings fromNode(ObjectNode config) {
         config.warnIfAdditionalProperties(Arrays.asList(SERVICE, MODULE_NAME, MODULE_DESCRIPTION, MODULE_VERSION));
 
-        String moduleName = config.expectStringMember(MODULE_NAME).getValue();
         Builder builder = builder()
                 .service(config.expectStringMember(SERVICE).expectShapeId())
-                .moduleName(moduleName)
+                .moduleName(config.expectStringMember(MODULE_NAME).getValue())
                 .moduleVersion(config.expectStringMember(MODULE_VERSION).getValue());
         config.getStringMember(MODULE_DESCRIPTION).map(StringNode::getValue).ifPresent(builder::moduleDescription);
         return builder.build();

codegen/core/src/main/java/software/amazon/smithy/python/codegen/generators/SetupGenerator.java

@@ -41,8 +41,24 @@ public static void generateSetup(
             GenerationContext context
     ) {
         var dependencies = gatherDependencies(context.writerDelegator().getDependencies().stream());
-        writePyproject(settings, context.writerDelegator(), dependencies);
-        writeReadme(settings, context);
+        var description = resolveDescription(settings, context);
+        writePyproject(settings, description, context.writerDelegator(), dependencies);
+        writeReadme(settings, description, context);
+    }
+
+    /**
+     * Use the configured description if set, otherwise describe the client or types
+     * package by the service's {@code smithy.api#title} trait or else the service shape's name.
+     */
+    private static String resolveDescription(PythonSettings settings, GenerationContext context) {
+        if (!StringUtils.isBlank(settings.moduleDescription())) {
+            return settings.moduleDescription();
+        }
+        var service = context.model().expectShape(settings.service());
+        var artifact = settings.artifactType() == PythonSettings.ArtifactType.TYPES ? "types" : "client";
+        return "Python " + artifact + " for " + service.getTrait(TitleTrait.class)
+                .map(StringTrait::getValue)
+                .orElse(service.getId().getName());
     }
 
     /**
@@ -106,6 +122,7 @@ private static Map<String, Map<String, SymbolDependency>> gatherDependencies(
      */
     private static void writePyproject(
             PythonSettings settings,
+            String description,
             WriterDelegator<PythonWriter> writers,
             Map<String, Map<String, SymbolDependency>> dependencies
     ) {
@@ -139,7 +156,7 @@ private static void writePyproject(
                         "Programming Language :: Python :: 3.14",
                         "Programming Language :: Python :: 3.15"
                     ]
-                    """, settings.moduleName(), settings.moduleVersion(), settings.moduleDescription());
+                    """, settings.moduleName(), settings.moduleVersion(), description);
 
             Optional.ofNullable(dependencies.get(PythonDependency.Type.DEPENDENCY.getType())).ifPresent(deps -> {
                 writer.openBlock("dependencies = [", "]\n", () -> writeDependencyList(writer, deps.values()));
@@ -283,6 +300,7 @@ private static List<String> getOptionalDependencies(SymbolDependency dependency)
 
     private static void writeReadme(
             PythonSettings settings,
+            String description,
             GenerationContext context
     ) {
         var service = context.model().expectShape(settings.service());
@@ -292,17 +310,13 @@ private static void writeReadme(
                 .map(StringTrait::getValue)
                 .orElse(StringUtils.capitalize(settings.moduleName()));
 
-        var description = StringUtils.isBlank(settings.moduleDescription())
-                ? "Generated service client for " + title
-                : StringUtils.wrap(settings.moduleDescription(), 80);
-
         context.writerDelegator().useFileWriter("README.md", writer -> {
             writer.pushState(new ReadmeSection());
             writer.write("""
                     ## $L Client
 
                     $L
-                    """, title, description);
+                    """, title, StringUtils.wrap(description, 80));
 
             service.getTrait(DocumentationTrait.class).map(StringTrait::getValue).ifPresent(documentation -> {
                 writer.write("""