Sort before looking for first

DavidSouther · DavidSouther · commit 127888b12e90 · 2024-09-12T22:05:18.000-04:00
diff --git a/.tools/readmes/scanner.py b/.tools/readmes/scanner.py
@@ -142,14 +142,11 @@ def snippet(self, example: Example, readme_folder, api_name: str):
             excerpt = first(ex_ver.excerpts)
             if excerpt is not None:
                 if excerpt.snippet_tags:
-                    tags = excerpt.snippet_tags
-                    tags = [*filter(lambda t: api_name in t, tags)]
-
                     # This form ensures that READMEs are always consistent,
                     # but does not always give the "best" README link.
-                    tags = [*sorted(tags)]
-
-                    tag = first(tags) or excerpt.snippet_tags[0]
+                    tags = [*sorted(excerpt.snippet_tags)]
+                    filtered = filter(lambda t: api_name in t, tags)
+                    tag = first(filtered) or tags[0]
                     tags = excerpt.snippet_tags
                 elif excerpt.snippet_files:
                     # TODO: Find the best (or all?) snippet files, not the first.
diff --git a/aws-cli/bash-linux/s3/README.md b/aws-cli/bash-linux/s3/README.md
@@ -47,7 +47,7 @@ Code excerpts that show you how to call individual service functions.
 - [DeleteObjects](bucket-lifecycle-operations/bucket_operations.sh#L303)
 - [GetObject](bucket-lifecycle-operations/bucket_operations.sh#L168)
 - [HeadBucket](bucket-lifecycle-operations/bucket_operations.sh#L20)
-- [ListObjectsV2](bucket-lifecycle-operations/awsdocs_general.sh#L94)
+- [ListObjectsV2](bucket-lifecycle-operations/bucket_operations.sh#L236)
 - [PutObject](bucket-lifecycle-operations/bucket_operations.sh#L134)
 
 
diff --git a/cpp/example_code/iam/README.md b/cpp/example_code/iam/README.md
@@ -49,7 +49,7 @@ Code excerpts that show you how to call individual service functions.
 - [AttachRolePolicy](attach_role_policy.cpp#L38)
 - [CreateAccessKey](create_access_key.cpp#L35)
 - [CreateAccountAlias](create_account_alias.cpp#L35)
-- [CreatePolicy](create_policy.cpp#L43)
+- [CreatePolicy](create_policy.cpp#L69)
 - [CreateRole](create_role.cpp#L35)
 - [CreateUser](create_user.cpp#L40)
 - [DeleteAccessKey](delete_access_key.cpp#L35)
diff --git a/cpp/example_code/s3/README.md b/cpp/example_code/s3/README.md
@@ -72,7 +72,7 @@ Code excerpts that show you how to call individual service functions.
 - [ListBuckets](list_buckets.cpp#L29)
 - [ListObjectsV2](list_objects.cpp#L32)
 - [PutBucketAcl](put_bucket_acl.cpp#L47)
-- [PutBucketPolicy](put_bucket_policy.cpp#L37)
+- [PutBucketPolicy](put_bucket_policy.cpp#L68)
 - [PutBucketWebsite](put_website_config.cpp#L33)
 - [PutObject](put_object.cpp#L33)
 - [PutObjectAcl](get_put_object_acl.cpp#L165)
diff --git a/gov2/s3/README.md b/gov2/s3/README.md
@@ -60,7 +60,7 @@ Code excerpts that show you how to call individual service functions.
 - [ListObjectsV2](actions/bucket_basics.go#L238)
 - [PutObject](actions/bucket_basics.go#L100)
 - [PutObjectLegalHold](../workflows/s3_object_lock/actions/s3_actions.go#L173)
-- [PutObjectLockConfiguration](../workflows/s3_object_lock/actions/s3_actions.go#L22)
+- [PutObjectLockConfiguration](../workflows/s3_object_lock/actions/s3_actions.go#L234)
 - [PutObjectRetention](../workflows/s3_object_lock/actions/s3_actions.go#L276)
 
 ### Scenarios
diff --git a/php/example_code/dynamodb/README.md b/php/example_code/dynamodb/README.md
@@ -40,12 +40,12 @@ Code examples that show you how to perform the essential operations within a ser
 
 Code excerpts that show you how to call individual service functions.
 
-- [BatchExecuteStatement](DynamoDBService.php#L273)
+- [BatchExecuteStatement](DynamoDBService.php#L319)
 - [BatchWriteItem](DynamoDBService.php#L201)
 - [CreateTable](dynamodb_basics/GettingStartedWithDynamoDB.php#L52)
-- [DeleteItem](dynamodb_basics/GettingStartedWithDynamoDB.php#L100)
+- [DeleteItem](dynamodb_basics/GettingStartedWithDynamoDB.php#L148)
 - [DeleteTable](DynamoDBService.php#L84)
-- [ExecuteStatement](DynamoDBService.php#L243)
+- [ExecuteStatement](DynamoDBService.php#L263)
 - [GetItem](dynamodb_basics/GettingStartedWithDynamoDB.php#L131)
 - [ListTables](DynamoDBService.php#L64)
 - [PutItem](dynamodb_basics/GettingStartedWithDynamoDB.php#L67)
diff --git a/php/example_code/glue/README.md b/php/example_code/glue/README.md
@@ -41,19 +41,19 @@ Code examples that show you how to perform the essential operations within a ser
 Code excerpts that show you how to call individual service functions.
 
 - [CreateCrawler](GettingStartedWithGlue.php#L47)
-- [CreateJob](GettingStartedWithGlue.php#L54)
+- [CreateJob](GettingStartedWithGlue.php#L110)
 - [DeleteCrawler](GettingStartedWithGlue.php#L180)
 - [DeleteDatabase](GettingStartedWithGlue.php#L173)
 - [DeleteJob](GettingStartedWithGlue.php#L159)
 - [DeleteTable](GettingStartedWithGlue.php#L166)
 - [GetCrawler](GettingStartedWithGlue.php#L69)
 - [GetDatabase](GettingStartedWithGlue.php#L58)
-- [GetJobRun](GettingStartedWithGlue.php#L107)
-- [GetJobRuns](GettingStartedWithGlue.php#L107)
+- [GetJobRun](GettingStartedWithGlue.php#L120)
+- [GetJobRuns](GettingStartedWithGlue.php#L130)
 - [GetTables](GettingStartedWithGlue.php#L58)
 - [ListJobs](GettingStartedWithGlue.php#L151)
 - [StartCrawler](GettingStartedWithGlue.php#L47)
-- [StartJobRun](GettingStartedWithGlue.php#L107)
+- [StartJobRun](GettingStartedWithGlue.php#L58)
 
 
 <!--custom.examples.start-->
diff --git a/php/example_code/iam/README.md b/php/example_code/iam/README.md
@@ -33,11 +33,11 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `php`
 
 Code excerpts that show you how to call individual service functions.
 
-- [AttachRolePolicy](GettingStartedWithIAM.php#L46)
-- [CreatePolicy](GettingStartedWithIAM.php#L46)
-- [CreateRole](GettingStartedWithIAM.php#L46)
+- [AttachRolePolicy](GettingStartedWithIAM.php#L82)
+- [CreatePolicy](GettingStartedWithIAM.php#L70)
+- [CreateRole](GettingStartedWithIAM.php#L57)
 - [CreateServiceLinkedRole](GettingStartedWithIAM.php#L46)
-- [CreateUser](GettingStartedWithIAM.php#L46)
+- [CreateUser](GettingStartedWithIAM.php#L51)
 - [GetAccountPasswordPolicy](GettingStartedWithIAM.php#L46)
 - [GetPolicy](GettingStartedWithIAM.php#L46)
 - [GetRole](GettingStartedWithIAM.php#L46)
diff --git a/php/example_code/s3/README.md b/php/example_code/s3/README.md
@@ -45,8 +45,8 @@ Code examples that show you how to perform the essential operations within a ser
 
 Code excerpts that show you how to call individual service functions.
 
-- [CopyObject](GettingStartedWithS3.php#L52)
-- [CreateBucket](GettingStartedWithS3.php#L52)
+- [CopyObject](GettingStartedWithS3.php#L104)
+- [CreateBucket](GettingStartedWithS3.php#L61)
 - [DeleteBucket](GettingStartedWithS3.php#L52)
 - [DeleteObjects](GettingStartedWithS3.php#L52)
 - [GetObject](GettingStartedWithS3.php#L52)
diff --git a/python/example_code/cognito/README.md b/python/example_code/cognito/README.md
@@ -43,7 +43,7 @@ python -m pip install -r requirements.txt
 
 Code excerpts that show you how to call individual service functions.
 
-- [AdminGetUser](cognito_idp_actions.py#L23)
+- [AdminGetUser](cognito_idp_actions.py#L56)
 - [AdminInitiateAuth](cognito_idp_actions.py#L187)
 - [AdminRespondToAuthChallenge](cognito_idp_actions.py#L292)
 - [AssociateSoftwareToken](cognito_idp_actions.py#L241)
diff --git a/python/example_code/kms/README.md b/python/example_code/kms/README.md
@@ -45,7 +45,7 @@ Code excerpts that show you how to call individual service functions.
 - [DeleteAlias](alias_management.py#L164)
 - [DescribeKey](key_management.py#L82)
 - [DisableKey](key_management.py#L128)
-- [EnableKey](key_management.py#L20)
+- [EnableKey](key_management.py#L128)
 - [Encrypt](key_encryption.py#L26)
 - [GenerateDataKey](key_management.py#L104)
 - [GetKeyPolicy](key_policies.py#L50)
diff --git a/python/example_code/polly/README.md b/python/example_code/polly/README.md
@@ -44,7 +44,7 @@ Code excerpts that show you how to call individual service functions.
 - [ListLexicons](polly_wrapper.py#L286)
 - [PutLexicon](polly_wrapper.py#L249)
 - [StartSpeechSynthesisTask](polly_wrapper.py#L147)
-- [SynthesizeSpeech](polly_wrapper.py#L20)
+- [SynthesizeSpeech](polly_wrapper.py#L54)
 
 ### Scenarios
 
diff --git a/python/example_code/s3/README.md b/python/example_code/s3/README.md
@@ -68,7 +68,7 @@ Code excerpts that show you how to call individual service functions.
 - [GetObjectLockConfiguration](scenarios/object-locking/cleanup.py#L17)
 - [HeadBucket](s3_basics/bucket_wrapper.py#L64)
 - [ListBuckets](s3_basics/bucket_wrapper.py#L85)
-- [ListObjectsV2](s3_basics/object_wrapper.py#L21)
+- [ListObjectsV2](s3_basics/object_wrapper.py#L99)
 - [PutBucketAcl](s3_basics/bucket_wrapper.py#L122)
 - [PutBucketCors](s3_basics/bucket_wrapper.py#L171)
 - [PutBucketLifecycleConfiguration](s3_basics/bucket_wrapper.py#L279)
diff --git a/python/example_code/ssm/README.md b/python/example_code/ssm/README.md
@@ -56,7 +56,7 @@ Code excerpts that show you how to call individual service functions.
 - [DeleteDocument](document.py#L59)
 - [DeleteMaintenanceWindow](maintenance_window.py#L73)
 - [DeleteOpsItem](ops_item.py#L73)
-- [DescribeOpsItems](ops_item.py#L13)
+- [DescribeOpsItems](ops_item.py#L95)
 - [ListCommandInvocations](document.py#L159)
 - [SendCommand](document.py#L82)
 - [UpdateMaintenanceWindow](maintenance_window.py#L97)
diff --git a/python/example_code/support/README.md b/python/example_code/support/README.md
@@ -51,7 +51,7 @@ Code examples that show you how to perform the essential operations within a ser
 
 Code excerpts that show you how to call individual service functions.
 
-- [AddAttachmentsToSet](support_wrapper.py#L19)
+- [AddAttachmentsToSet](support_wrapper.py#L143)
 - [AddCommunicationToCase](support_wrapper.py#L179)
 - [CreateCase](support_wrapper.py#L103)
 - [DescribeAttachment](support_wrapper.py#L242)
diff --git a/ruby/example_code/dynamodb/README.md b/ruby/example_code/dynamodb/README.md
@@ -45,15 +45,15 @@ Code examples that show you how to perform the essential operations within a ser
 
 Code excerpts that show you how to call individual service functions.
 
-- [BatchExecuteStatement](partiql/partiql_batch.rb#L12)
+- [BatchExecuteStatement](partiql/partiql_batch.rb#L25)
 - [BatchWriteItem](scaffold.rb#L83)
 - [CreateTable](scaffold.rb#L56)
 - [DeleteItem](basics/dynamodb_basics.rb#L127)
 - [DeleteTable](scaffold.rb#L109)
 - [DescribeTable](scaffold.rb#L37)
-- [ExecuteStatement](partiql/partiql_single.rb#L12)
+- [ExecuteStatement](partiql/partiql_single.rb#L25)
 - [GetItem](basics/dynamodb_basics.rb#L40)
-- [ListTables](scaffold.rb#L20)
+- [ListTables](scaffold.rb#L37)
 - [PutItem](basics/dynamodb_basics.rb#L23)
 - [Query](basics/dynamodb_basics.rb#L75)
 - [Scan](basics/dynamodb_basics.rb#L94)
diff --git a/rustv1/examples/aurora/README.md b/rustv1/examples/aurora/README.md
@@ -45,19 +45,19 @@ Code examples that show you how to perform the essential operations within a ser
 
 Code excerpts that show you how to call individual service functions.
 
-- [CreateDBCluster](src/aurora_scenario/mod.rs#L353)
-- [CreateDBClusterParameterGroup](src/aurora_scenario/mod.rs#L204)
-- [CreateDBClusterSnapshot](src/aurora_scenario/mod.rs#L353)
-- [CreateDBInstance](src/aurora_scenario/mod.rs#L353)
-- [DeleteDBCluster](src/aurora_scenario/mod.rs#L513)
-- [DeleteDBClusterParameterGroup](src/aurora_scenario/mod.rs#L513)
-- [DeleteDBInstance](src/aurora_scenario/mod.rs#L513)
-- [DescribeDBClusterParameters](src/aurora_scenario/mod.rs#L287)
-- [DescribeDBClusters](src/aurora_scenario/mod.rs#L353)
-- [DescribeDBEngineVersions](src/aurora_scenario/mod.rs#L142)
-- [DescribeDBInstances](src/aurora_scenario/mod.rs#L513)
-- [DescribeOrderableDBInstanceOptions](src/aurora_scenario/mod.rs#L179)
-- [ModifyDBClusterParameterGroup](src/aurora_scenario/mod.rs#L316)
+- [CreateDBCluster](src/rds.rs#L151)
+- [CreateDBClusterParameterGroup](src/rds.rs#L88)
+- [CreateDBClusterSnapshot](src/rds.rs#L206)
+- [CreateDBInstance](src/rds.rs#L174)
+- [DeleteDBCluster](src/aurora_scenario/tests.rs#L790)
+- [DeleteDBClusterParameterGroup](src/aurora_scenario/tests.rs#L790)
+- [DeleteDBInstance](src/aurora_scenario/tests.rs#L790)
+- [DescribeDBClusterParameters](src/aurora_scenario/tests.rs#L376)
+- [DescribeDBClusters](src/rds.rs#L106)
+- [DescribeDBEngineVersions](src/rds.rs#L56)
+- [DescribeDBInstances](src/aurora_scenario/tests.rs#L790)
+- [DescribeOrderableDBInstanceOptions](src/rds.rs#L69)
+- [ModifyDBClusterParameterGroup](src/rds.rs#L135)
 
 
 <!--custom.examples.start-->
diff --git a/rustv1/examples/auto-scaling/README.md b/rustv1/examples/auto-scaling/README.md
@@ -53,7 +53,7 @@ Code excerpts that show you how to call individual service functions.
 - [DisableMetricsCollection](src/scenario.rs#L617)
 - [EnableMetricsCollection](src/scenario.rs#L294)
 - [SetDesiredCapacity](src/scenario.rs#L595)
-- [TerminateInstanceInAutoScalingGroup](src/scenario.rs#L654)
+- [TerminateInstanceInAutoScalingGroup](src/scenario.rs#L456)
 - [UpdateAutoScalingGroup](src/bin/update-autoscaling-group.rs#L30)
 
 
diff --git a/rustv1/examples/lambda/README.md b/rustv1/examples/lambda/README.md
@@ -41,7 +41,7 @@ Code excerpts that show you how to call individual service functions.
 - [GetFunction](src/actions.rs#L382)
 - [Invoke](src/actions.rs#L407)
 - [ListFunctions](src/actions.rs#L395)
-- [UpdateFunctionCode](src/actions.rs#L423)
+- [UpdateFunctionCode](src/actions.rs#L200)
 - [UpdateFunctionConfiguration](src/actions.rs#L449)
 
 ### Scenarios
diff --git a/swift/example_code/cognito-identity/README.md b/swift/example_code/cognito-identity/README.md
@@ -33,9 +33,9 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `swift
 
 Code excerpts that show you how to call individual service functions.
 
-- [CreateIdentityPool](FindOrCreateIdentityPool/Sources/CognitoIdentityHandler/CognitoIdentityHandler.swift#L7)
-- [DeleteIdentityPool](FindOrCreateIdentityPool/Sources/CognitoIdentityHandler/CognitoIdentityHandler.swift#L7)
-- [ListIdentityPools](FindOrCreateIdentityPool/Sources/CognitoIdentityHandler/CognitoIdentityHandler.swift#L7)
+- [CreateIdentityPool](FindOrCreateIdentityPool/Sources/CognitoIdentityHandler/CognitoIdentityHandler.swift#L94)
+- [DeleteIdentityPool](FindOrCreateIdentityPool/Sources/CognitoIdentityHandler/CognitoIdentityHandler.swift#L116)
+- [ListIdentityPools](FindOrCreateIdentityPool/Sources/CognitoIdentityHandler/CognitoIdentityHandler.swift#L27)
 
 
 <!--custom.examples.start-->
diff --git a/swift/example_code/dynamodb/README.md b/swift/example_code/dynamodb/README.md
@@ -40,17 +40,17 @@ Code examples that show you how to perform the essential operations within a ser
 
 Code excerpts that show you how to call individual service functions.
 
-- [BatchGetItem](basics/Sources/basics.swift#L34)
-- [BatchWriteItem](basics/Sources/basics.swift#L34)
-- [CreateTable](basics/Sources/basics.swift#L34)
-- [DeleteItem](basics/Sources/basics.swift#L34)
-- [DeleteTable](basics/Sources/basics.swift#L34)
-- [GetItem](basics/Sources/basics.swift#L34)
-- [ListTables](basics/Sources/basics.swift#L34)
-- [PutItem](basics/Sources/basics.swift#L34)
-- [Query](basics/Sources/basics.swift#L34)
-- [Scan](basics/Sources/basics.swift#L34)
-- [UpdateItem](basics/Sources/basics.swift#L34)
+- [BatchGetItem](BatchGetItem/Sources/MovieDatabase.swift#L258)
+- [BatchWriteItem](basics/MovieList/MovieTable.swift#L162)
+- [CreateTable](basics/MovieList/MovieTable.swift#L53)
+- [DeleteItem](basics/MovieList/MovieTable.swift#L455)
+- [DeleteTable](basics/MovieList/MovieTable.swift#L121)
+- [GetItem](basics/MovieList/MovieTable.swift#L261)
+- [ListTables](ListTables/Sources/DatabaseManager.swift#L82)
+- [PutItem](basics/MovieList/MovieTable.swift#L219)
+- [Query](basics/MovieList/MovieTable.swift#L294)
+- [Scan](basics/MovieList/MovieTable.swift#L334)
+- [UpdateItem](basics/MovieList/MovieTable.swift#L397)
 
 
 <!--custom.examples.start-->
diff --git a/swift/example_code/iam/README.md b/swift/example_code/iam/README.md
@@ -33,27 +33,27 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `swift
 
 Code excerpts that show you how to call individual service functions.
 
-- [AttachRolePolicy](basics/Sources/Basics/Basics.swift#L29)
-- [CreateAccessKey](basics/Sources/Basics/Basics.swift#L29)
-- [CreatePolicy](basics/Sources/Basics/Basics.swift#L29)
-- [CreateRole](basics/Sources/Basics/Basics.swift#L29)
-- [CreateServiceLinkedRole](basics/Sources/Basics/Basics.swift#L29)
-- [CreateUser](basics/Sources/Basics/Basics.swift#L29)
-- [DeleteAccessKey](basics/Sources/Basics/Basics.swift#L29)
-- [DeletePolicy](basics/Sources/Basics/Basics.swift#L29)
-- [DeleteRole](basics/Sources/Basics/Basics.swift#L29)
-- [DeleteUser](basics/Sources/Basics/Basics.swift#L29)
-- [DeleteUserPolicy](basics/Sources/Basics/Basics.swift#L29)
-- [DetachRolePolicy](basics/Sources/Basics/Basics.swift#L29)
-- [GetPolicy](basics/Sources/Basics/Basics.swift#L29)
-- [GetRole](basics/Sources/Basics/Basics.swift#L29)
+- [AttachRolePolicy](AttachRolePolicy/Sources/ServiceHandler/ServiceHandler.swift#L51)
+- [CreateAccessKey](basics/Sources/ServiceHandler/ServiceHandlerIAM.swift#L177)
+- [CreatePolicy](basics/Sources/ServiceHandler/ServiceHandlerIAM.swift#L202)
+- [CreateRole](CreateRole/Sources/ServiceHandler/ServiceHandler.swift#L51)
+- [CreateServiceLinkedRole](CreateServiceLinkedRole/Sources/ServiceHandler/ServiceHandler.swift#L59)
+- [CreateUser](CreateUser/Sources/ServiceHandler/ServiceHandler.swift#L50)
+- [DeleteAccessKey](basics/Sources/ServiceHandler/ServiceHandlerIAM.swift#L348)
+- [DeletePolicy](basics/Sources/ServiceHandler/ServiceHandlerIAM.swift#L310)
+- [DeleteRole](basics/Sources/ServiceHandler/ServiceHandlerIAM.swift#L374)
+- [DeleteUser](basics/Sources/ServiceHandler/ServiceHandlerIAM.swift#L328)
+- [DeleteUserPolicy](basics/Sources/ServiceHandler/ServiceHandlerIAM.swift#L251)
+- [DetachRolePolicy](basics/Sources/ServiceHandler/ServiceHandlerIAM.swift#L291)
+- [GetPolicy](GetPolicy/Sources/ServiceHandler/ServiceHandler.swift#L50)
+- [GetRole](GetRole/Sources/ServiceHandler/ServiceHandler.swift#L51)
 - [ListAttachedRolePolicies](basics/Sources/Basics/Basics.swift#L29)
 - [ListGroups](basics/Sources/Basics/Basics.swift#L29)
 - [ListPolicies](basics/Sources/Basics/Basics.swift#L29)
 - [ListRolePolicies](basics/Sources/Basics/Basics.swift#L29)
 - [ListRoles](basics/Sources/Basics/Basics.swift#L29)
 - [ListUsers](basics/Sources/Basics/Basics.swift#L29)
-- [PutUserPolicy](basics/Sources/Basics/Basics.swift#L29)
+- [PutUserPolicy](basics/Sources/ServiceHandler/ServiceHandlerIAM.swift#L229)
 
 
 <!--custom.examples.start-->
