Unverified Commit 4d889f7f authored by Zelda Hessler's avatar Zelda Hessler Committed by GitHub
Browse files

fix docgen link (#3815) 

_By submitting this pull request, I confirm that you can use, modify,
copy, and redistribute this contribution, under the terms of your
choice._
parent ed7f7e69

aws/sdk-codegen/src/main/kotlin/software/amazon/smithy/rustsdk/AwsDocs.kt

+1 −1
Original line number Diff line number Diff line
@@ -73,7 +73,7 @@ object AwsDocs { 


                    Occasionally, SDKs may have additional service-specific values that can be set on the [`Config`] that

                    is absent from [`SdkConfig`], or slightly different settings for a specific client may be desired.

                    The [`Builder`] struct implements `From<&SdkConfig>`, so setting these specific settings can be

                    The [`Builder`](crate::config::Builder) struct implements `From<&SdkConfig>`, so setting these specific settings can be

                    done as follows:



                    ```rust,no_run

codegen-core/src/main/kotlin/software/amazon/smithy/rust/codegen/core/smithy/generators/BuilderGenerator.kt

+8 −6
Original line number Diff line number Diff line
@@ -21,6 +21,7 @@ import software.amazon.smithy.rust.codegen.core.rustlang.asOptional 
import software.amazon.smithy.rust.codegen.core.rustlang.conditionalBlockTemplate

import software.amazon.smithy.rust.codegen.core.rustlang.deprecatedShape

import software.amazon.smithy.rust.codegen.core.rustlang.docs

import software.amazon.smithy.rust.codegen.core.rustlang.docsTemplate

import software.amazon.smithy.rust.codegen.core.rustlang.documentShape

import software.amazon.smithy.rust.codegen.core.rustlang.map

import software.amazon.smithy.rust.codegen.core.rustlang.render
@@ -91,7 +92,7 @@ fun MemberShape.enforceRequired( 
    }

    val shape = this

    val isOptional = codegenContext.symbolProvider.toSymbol(shape).isOptional()

    val field = field.letIf(!isOptional) { field.map { rust("Some(#T)", it) } }

    val field = field.letIf(!isOptional) { it.map { t -> rust("Some(#T)", t) } }

    val error =

        OperationBuildError(codegenContext.runtimeConfig).missingField(

            codegenContext.symbolProvider.toMemberName(shape), "A required field was not set",
@@ -100,10 +101,7 @@ fun MemberShape.enforceRequired( 
        when (codegenContext.model.expectShape(this.target)) {

            is StringShape ->

                writable {

                    rustTemplate(

                        "#{field}.filter(|f|!AsRef::<str>::as_ref(f).trim().is_empty())",

                        "field" to field,

                    )

                    rust("#T.filter(|f|!AsRef::<str>::as_ref(f).trim().is_empty())", field)

                }



            else -> field
@@ -221,7 +219,11 @@ class BuilderGenerator( 
            implBlockWriter.docs("This method will fail if any of the following fields are not set:")

            trulyRequiredMembers.forEach {

                val memberName = symbolProvider.toMemberName(it)

                implBlockWriter.docs("- [`$memberName`](#T::$memberName)", symbolProvider.symbolForBuilder(shape))

                implBlockWriter.docsTemplate(

                    // We have to remove the `r##` prefix in the path b/c Rustdoc doesn't support it.

                    "- [`$memberName`](#{struct}::${memberName.removePrefix("r##")})",

                    "struct" to symbolProvider.symbolForBuilder(shape),

                )

            }

        }

        implBlockWriter.rustBlockTemplate("pub fn build(self) -> $returnType", *preludeScope) {