From fb6494da01df9a5f29899e41dbc31bf53877b919 Mon Sep 17 00:00:00 2001
From: Julian Sommer <115516918+juliansommer@users.noreply.github.com>
Date: Mon, 14 Sep 2026 11:42:01 +1000
Subject: [PATCH] feat: coverage docs
---
Makefile | 9 +-
cmd/aws-model-coverage/main.go | 101 ++-
docs/README.md | 2 +-
docs/aws-model-operation-coverage.md | 627 -----------------
docs/compatibility/acm-api-coverage/README.md | 57 ++
docs/compatibility/acm-api-coverage/intro.md | 7 +
docs/compatibility/aws-api-coverage/README.md | 45 ++
docs/compatibility/aws-api-coverage/intro.md | 3 +
docs/compatibility/ec2-api-coverage/README.md | 665 ++++++++++++++++++
docs/compatibility/ec2-api-coverage/intro.md | 5 +
docs/compatibility/ecr-api-coverage/README.md | 92 +++
docs/compatibility/ecr-api-coverage/intro.md | 7 +
docs/compatibility/ecs-api-coverage/README.md | 97 +++
docs/compatibility/ecs-api-coverage/intro.md | 3 +
docs/compatibility/eks-api-coverage/README.md | 109 +++
docs/compatibility/eks-api-coverage/intro.md | 14 +
.../elbv2-api-coverage/README.md | 88 +++
.../compatibility/elbv2-api-coverage/intro.md | 3 +
docs/compatibility/iam-api-coverage/README.md | 197 ++++++
docs/compatibility/iam-api-coverage/intro.md | 3 +
docs/compatibility/pages.json | 93 +++
docs/compatibility/rds-api-coverage/README.md | 224 ++++++
docs/compatibility/rds-api-coverage/intro.md | 21 +
docs/compatibility/s3-api-coverage/README.md | 29 +
docs/compatibility/s3-api-coverage/intro.md | 7 +
docs/compatibility/sts-api-coverage/README.md | 52 ++
docs/compatibility/sts-api-coverage/intro.md | 9 +
internal/awsmodel/coverage.go | 66 +-
internal/awsmodel/coverage_test.go | 15 +-
internal/awsmodel/page.go | 267 +++++++
internal/awsmodel/page_test.go | 183 +++++
.../integration/conformance-known-findings.md | 2 +-
32 files changed, 2402 insertions(+), 700 deletions(-)
delete mode 100644 docs/aws-model-operation-coverage.md
create mode 100644 docs/compatibility/acm-api-coverage/README.md
create mode 100644 docs/compatibility/acm-api-coverage/intro.md
create mode 100644 docs/compatibility/aws-api-coverage/README.md
create mode 100644 docs/compatibility/aws-api-coverage/intro.md
create mode 100644 docs/compatibility/ec2-api-coverage/README.md
create mode 100644 docs/compatibility/ec2-api-coverage/intro.md
create mode 100644 docs/compatibility/ecr-api-coverage/README.md
create mode 100644 docs/compatibility/ecr-api-coverage/intro.md
create mode 100644 docs/compatibility/ecs-api-coverage/README.md
create mode 100644 docs/compatibility/ecs-api-coverage/intro.md
create mode 100644 docs/compatibility/eks-api-coverage/README.md
create mode 100644 docs/compatibility/eks-api-coverage/intro.md
create mode 100644 docs/compatibility/elbv2-api-coverage/README.md
create mode 100644 docs/compatibility/elbv2-api-coverage/intro.md
create mode 100644 docs/compatibility/iam-api-coverage/README.md
create mode 100644 docs/compatibility/iam-api-coverage/intro.md
create mode 100644 docs/compatibility/pages.json
create mode 100644 docs/compatibility/rds-api-coverage/README.md
create mode 100644 docs/compatibility/rds-api-coverage/intro.md
create mode 100644 docs/compatibility/s3-api-coverage/README.md
create mode 100644 docs/compatibility/s3-api-coverage/intro.md
create mode 100644 docs/compatibility/sts-api-coverage/README.md
create mode 100644 docs/compatibility/sts-api-coverage/intro.md
create mode 100644 internal/awsmodel/page.go
create mode 100644 internal/awsmodel/page_test.go
diff --git a/Makefile b/Makefile
index 4f14dfe6b..104e86e71 100644
--- a/Makefile
+++ b/Makefile
@@ -181,7 +181,7 @@ test-harness:
# JetStream, with only the daemon-side NATS subjects stubbed.
AWS_MODEL_CONFORMANCE_REPORT ?= $(CURDIR)/.cache/aws-model-conformance-report.txt
AWS_MODEL_CONFORMANCE_MODE ?= fail
-AWS_MODEL_OPERATION_COVERAGE_REPORT ?= $(CURDIR)/docs/aws-model-operation-coverage.md
+AWS_MODEL_OPERATION_COVERAGE_DIR ?= $(CURDIR)/docs/compatibility
# -count=1 is load-bearing: the conformance report is written by the test binary,
# so a cached pass skips the run, leaves no report, and the cat below fails the
# target. It also keeps the conformance gate honest — a cached result would mean
@@ -191,14 +191,13 @@ test-integration:
$(_Q)LOG_IGNORE=1 AWS_MODEL_CONFORMANCE_MODE=$(AWS_MODEL_CONFORMANCE_MODE) AWS_MODEL_CONFORMANCE_REPORT=$(AWS_MODEL_CONFORMANCE_REPORT) go test -count=1 -tags=integration -timeout 60s ./tests/integration/... $(_RACEQ)
@cat $(AWS_MODEL_CONFORMANCE_REPORT)
@$(MAKE) --no-print-directory generate-aws-model-coverage
- @echo "AWS operation coverage: $(AWS_MODEL_OPERATION_COVERAGE_REPORT)"
+ @echo "AWS operation coverage: $(AWS_MODEL_OPERATION_COVERAGE_DIR)"
generate-aws-model-coverage:
- @mkdir -p $(dir $(AWS_MODEL_OPERATION_COVERAGE_REPORT))
- @go run ./cmd/aws-model-coverage > $(AWS_MODEL_OPERATION_COVERAGE_REPORT)
+ @go run ./cmd/aws-model-coverage -out $(AWS_MODEL_OPERATION_COVERAGE_DIR)
aws-model-coverage: generate-aws-model-coverage
- @cat $(AWS_MODEL_OPERATION_COVERAGE_REPORT)
+ @go run ./cmd/aws-model-coverage
# Segscan storage oracle: needs the mulga umbrella repo's scripts/segscan
# checked out alongside spinifex (see spinifex/testutil/segscanoracle), which
diff --git a/cmd/aws-model-coverage/main.go b/cmd/aws-model-coverage/main.go
index b36371e1b..8129de6e1 100644
--- a/cmd/aws-model-coverage/main.go
+++ b/cmd/aws-model-coverage/main.go
@@ -1,8 +1,12 @@
package main
import (
+ "errors"
+ "flag"
"fmt"
+ "io/fs"
"os"
+ "path/filepath"
"github.com/mulgadc/spinifex/internal/awsmodel"
"github.com/mulgadc/spinifex/spinifex/gateway"
@@ -10,7 +14,35 @@ import (
_ "github.com/mulgadc/bluebottle/pkg/fipsboot"
)
+const (
+ pagesFile = "pages.json"
+ introFile = "intro.md"
+ pageFile = "README.md"
+)
+
func main() {
+ outputDir := flag.String("out", "", "write one publishable page per service into this directory")
+ flag.Parse()
+
+ coverages, err := compareAll()
+ if err != nil {
+ fail(err)
+ }
+ if *outputDir == "" {
+ fmt.Print(awsmodel.RenderCoverageSummary(coverages))
+ return
+ }
+ if err := writePages(*outputDir, coverages); err != nil {
+ fail(err)
+ }
+}
+
+func fail(err error) {
+ fmt.Fprintf(os.Stderr, "aws-model-coverage: %v\n", err)
+ os.Exit(1)
+}
+
+func compareAll() ([]awsmodel.OperationCoverage, error) {
dispatch := gateway.AWSOperationInventory()
coverages := make([]awsmodel.OperationCoverage, 0, len(awsmodel.Services()))
for _, service := range awsmodel.Services() {
@@ -29,17 +61,74 @@ func main() {
Note: "Spinifex delegates the S3 REST surface to Predastore, which has no operation-name dispatch table to compare mechanically.",
}
default:
- fmt.Fprintf(os.Stderr, "aws-model-coverage: no gateway inventory for %s\n", service)
- os.Exit(1)
+ return nil, fmt.Errorf("no gateway inventory for %s", service)
}
coverage, err := awsmodel.CompareOperations(service, modelInventory)
if err != nil {
- fmt.Fprintf(os.Stderr, "aws-model-coverage: %v\n", err)
- os.Exit(1)
+ return nil, err
}
coverages = append(coverages, coverage)
}
-
- fmt.Print(awsmodel.RenderCoverageMarkdown(coverages))
+ return coverages, nil
+}
+
+func writePages(outputDir string, coverages []awsmodel.OperationCoverage) error {
+ contents, err := os.ReadFile(filepath.Join(outputDir, pagesFile))
+ if err != nil {
+ return fmt.Errorf("read page metadata: %w", err)
+ }
+ pages, err := awsmodel.ParsePageSet(contents)
+ if err != nil {
+ return err
+ }
+
+ for _, coverage := range coverages {
+ page := pages.Services[coverage.Service]
+ intro, err := readIntro(outputDir, page.Slug)
+ if err != nil {
+ return err
+ }
+ body, err := awsmodel.RenderServicePage(coverage, pages, intro)
+ if err != nil {
+ return err
+ }
+ if err := writePage(outputDir, page.Slug, body); err != nil {
+ return err
+ }
+ }
+
+ intro, err := readIntro(outputDir, pages.Index.Slug)
+ if err != nil {
+ return err
+ }
+ body, err := awsmodel.RenderIndexPage(coverages, pages, intro)
+ if err != nil {
+ return err
+ }
+ return writePage(outputDir, pages.Index.Slug, body)
+}
+
+// readIntro returns the hand-written prose for a page, or "" where the page has
+// none. An intro is optional by design: most services have nothing to add.
+func readIntro(outputDir, slug string) (string, error) {
+ contents, err := os.ReadFile(filepath.Join(outputDir, slug, introFile))
+ if errors.Is(err, fs.ErrNotExist) {
+ return "", nil
+ }
+ if err != nil {
+ return "", fmt.Errorf("read %s intro: %w", slug, err)
+ }
+ return string(contents), nil
+}
+
+func writePage(outputDir, slug, body string) error {
+ dir := filepath.Join(outputDir, slug)
+ if err := os.MkdirAll(dir, 0o755); err != nil {
+ return fmt.Errorf("create %s page directory: %w", slug, err)
+ }
+ if err := os.WriteFile(filepath.Join(dir, pageFile), []byte(body), 0o644); err != nil {
+ return fmt.Errorf("write %s page: %w", slug, err)
+ }
+ return nil
}
diff --git a/docs/README.md b/docs/README.md
index 5d8e6974b..a637eb7cc 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -2,7 +2,7 @@
This directory contains the Spinifex documentation. This is available in individual markdown files, and a generated website to aid navigation and browsing documentation at: [https://docs.mulgadc.com](https://docs.mulgadc.com/)
-The [AWS model operation coverage](aws-model-operation-coverage.md) report is generated from Spinifex's dispatch tables and the pinned AWS API models. Run `make aws-model-coverage` to regenerate and print it.
+The [AWS API coverage](compatibility/aws-api-coverage/README.md) pages are generated from Spinifex's dispatch tables and the pinned AWS API models, one page per service. Run `make aws-model-coverage` to regenerate them and print a summary. Only `pages.json` and the `intro.md` files under `compatibility/` are hand-written; every `README.md` there is generated and will be overwritten.
## Frontmatter
diff --git a/docs/aws-model-operation-coverage.md b/docs/aws-model-operation-coverage.md
deleted file mode 100644
index 25013f81d..000000000
--- a/docs/aws-model-operation-coverage.md
+++ /dev/null
@@ -1,627 +0,0 @@
-# AWS model operation coverage
-
-Generated from the cached `aws-sdk-go v1.55.8` `api-2.json` models and Spinifex's authoritative gateway dispatch tables.
-
-Implemented means a modelled operation is registered to a real handler. Stub and deliberately unsupported handlers are reported separately. Shape conformance does not imply behavioural conformance.
-
-| Service | API version | Modelled | Registered | Implemented | Stubbed | Unsupported | Missing | Extra |
-|---|---:|---:|---:|---:|---:|---:|---:|---:|
-| acm | 2015-12-08 | 15 | 9 | 9 | 0 | 0 | 6 | 0 |
-| ec2 | 2016-11-15 | 625 | 121 | 121 | 0 | 0 | 504 | 0 |
-| ecr | 2015-09-21 | 47 | 39 | 19 | 13 | 7 | 11 | 3 |
-| ecs | 2014-11-13 | 56 | 39 | 31 | 5 | 0 | 20 | 3 |
-| eks | 2017-11-01 | 56 | 38 | 34 | 0 | 0 | 22 | 4 |
-| elasticloadbalancingv2 | 2015-12-01 | 46 | 37 | 33 | 0 | 0 | 13 | 4 |
-| iam | 2010-05-08 | 159 | 75 | 75 | 0 | 0 | 84 | 0 |
-| rds | 2014-10-31 | 162 | 43 | 26 | 0 | 12 | 124 | 5 |
-| s3 | 2006-03-01 | 99 | — | — | — | — | — | — |
-| sts | 2011-06-15 | 8 | 4 | 4 | 0 | 0 | 4 | 0 |
-
-## acm
-
-Implements **9 of 15** modelled operations (60.0%).
-
-Implemented (9)
-
-`AddTagsToCertificate`, `DeleteCertificate`, `DescribeCertificate`, `GetCertificate`, `ImportCertificate`, `ListCertificates`, `ListTagsForCertificate`, `RemoveTagsFromCertificate`
-
-`RequestCertificate`
-
-
-Missing from dispatch (6)
-
-`ExportCertificate`, `GetAccountConfiguration`, `PutAccountConfiguration`, `RenewCertificate`, `ResendValidationEmail`, `UpdateCertificateOptions`
-
-
-Registered stubs (0)
-
-None.
-
-Deliberately unsupported (0)
-
-None.
-
-Registered outside the pinned model (0)
-
-None.
-
-Implemented (121)
-
-`AllocateAddress`, `AssociateAddress`, `AssociateIamInstanceProfile`, `AssociateRouteTable`, `AttachInternetGateway`, `AttachNetworkInterface`, `AttachVolume`, `AuthorizeSecurityGroupEgress`
-
-`AuthorizeSecurityGroupIngress`, `CancelCapacityReservation`, `CancelSpotInstanceRequests`, `CopyImage`, `CopySnapshot`, `CreateCapacityReservation`, `CreateEgressOnlyInternetGateway`, `CreateImage`
-
-`CreateInternetGateway`, `CreateKeyPair`, `CreateLaunchTemplate`, `CreateLaunchTemplateVersion`, `CreateNatGateway`, `CreateNetworkInterface`, `CreatePlacementGroup`, `CreateRoute`
-
-`CreateRouteTable`, `CreateSecurityGroup`, `CreateSnapshot`, `CreateSubnet`, `CreateTags`, `CreateVolume`, `CreateVpc`, `DeleteEgressOnlyInternetGateway`
-
-`DeleteInternetGateway`, `DeleteKeyPair`, `DeleteLaunchTemplate`, `DeleteLaunchTemplateVersions`, `DeleteNatGateway`, `DeleteNetworkInterface`, `DeletePlacementGroup`, `DeleteRoute`
-
-`DeleteRouteTable`, `DeleteSecurityGroup`, `DeleteSnapshot`, `DeleteSubnet`, `DeleteTags`, `DeleteVolume`, `DeleteVpc`, `DeregisterImage`
-
-`DescribeAccountAttributes`, `DescribeAddresses`, `DescribeAddressesAttribute`, `DescribeAvailabilityZones`, `DescribeCapacityReservations`, `DescribeEgressOnlyInternetGateways`, `DescribeIamInstanceProfileAssociations`, `DescribeImageAttribute`
-
-`DescribeImages`, `DescribeInstanceAttribute`, `DescribeInstanceCreditSpecifications`, `DescribeInstanceStatus`, `DescribeInstanceTypes`, `DescribeInstances`, `DescribeInternetGateways`, `DescribeKeyPairs`
-
-`DescribeLaunchTemplateVersions`, `DescribeLaunchTemplates`, `DescribeNatGateways`, `DescribeNetworkInterfaces`, `DescribePlacementGroups`, `DescribeRegions`, `DescribeRouteTables`, `DescribeSecurityGroupRules`
-
-`DescribeSecurityGroups`, `DescribeSnapshots`, `DescribeSpotInstanceRequests`, `DescribeSubnets`, `DescribeTags`, `DescribeVolumeStatus`, `DescribeVolumes`, `DescribeVolumesModifications`
-
-`DescribeVpcAttribute`, `DescribeVpcs`, `DetachInternetGateway`, `DetachNetworkInterface`, `DetachVolume`, `DisableEbsEncryptionByDefault`, `DisableSerialConsoleAccess`, `DisassociateAddress`
-
-`DisassociateIamInstanceProfile`, `DisassociateRouteTable`, `EnableEbsEncryptionByDefault`, `EnableSerialConsoleAccess`, `GetConsoleOutput`, `GetEbsEncryptionByDefault`, `GetPasswordData`, `GetSerialConsoleAccessStatus`
-
-`ImportKeyPair`, `ModifyImageAttribute`, `ModifyInstanceAttribute`, `ModifyInstanceMetadataOptions`, `ModifyLaunchTemplate`, `ModifyNetworkInterfaceAttribute`, `ModifySubnetAttribute`, `ModifyVolume`
-
-`ModifyVpcAttribute`, `MonitorInstances`, `RebootInstances`, `RegisterImage`, `ReleaseAddress`, `ReplaceIamInstanceProfileAssociation`, `ReplaceRoute`, `ReplaceRouteTableAssociation`
-
-`RequestSpotInstances`, `ResetImageAttribute`, `RevokeSecurityGroupEgress`, `RevokeSecurityGroupIngress`, `RunInstances`, `StartInstances`, `StopInstances`, `TerminateInstances`
-
-`UnmonitorInstances`
-
-
-Missing from dispatch (504)
-
-`AcceptAddressTransfer`, `AcceptReservedInstancesExchangeQuote`, `AcceptTransitGatewayMulticastDomainAssociations`, `AcceptTransitGatewayPeeringAttachment`, `AcceptTransitGatewayVpcAttachment`, `AcceptVpcEndpointConnections`, `AcceptVpcPeeringConnection`, `AdvertiseByoipCidr`
-
-`AllocateHosts`, `AllocateIpamPoolCidr`, `ApplySecurityGroupsToClientVpnTargetNetwork`, `AssignIpv6Addresses`, `AssignPrivateIpAddresses`, `AssignPrivateNatGatewayAddress`, `AssociateClientVpnTargetNetwork`, `AssociateDhcpOptions`
-
-`AssociateEnclaveCertificateIamRole`, `AssociateInstanceEventWindow`, `AssociateIpamByoasn`, `AssociateIpamResourceDiscovery`, `AssociateNatGatewayAddress`, `AssociateSubnetCidrBlock`, `AssociateTransitGatewayMulticastDomain`, `AssociateTransitGatewayPolicyTable`
-
-`AssociateTransitGatewayRouteTable`, `AssociateTrunkInterface`, `AssociateVpcCidrBlock`, `AttachClassicLinkVpc`, `AttachVerifiedAccessTrustProvider`, `AttachVpnGateway`, `AuthorizeClientVpnIngress`, `BundleInstance`
-
-`CancelBundleTask`, `CancelCapacityReservationFleets`, `CancelConversionTask`, `CancelExportTask`, `CancelImageLaunchPermission`, `CancelImportTask`, `CancelReservedInstancesListing`, `CancelSpotFleetRequests`
-
-`ConfirmProductInstance`, `CopyFpgaImage`, `CreateCapacityReservationFleet`, `CreateCarrierGateway`, `CreateClientVpnEndpoint`, `CreateClientVpnRoute`, `CreateCoipCidr`, `CreateCoipPool`
-
-`CreateCustomerGateway`, `CreateDefaultSubnet`, `CreateDefaultVpc`, `CreateDhcpOptions`, `CreateFleet`, `CreateFlowLogs`, `CreateFpgaImage`, `CreateInstanceConnectEndpoint`
-
-`CreateInstanceEventWindow`, `CreateInstanceExportTask`, `CreateIpam`, `CreateIpamExternalResourceVerificationToken`, `CreateIpamPool`, `CreateIpamResourceDiscovery`, `CreateIpamScope`, `CreateLocalGatewayRoute`
-
-`CreateLocalGatewayRouteTable`, `CreateLocalGatewayRouteTableVirtualInterfaceGroupAssociation`, `CreateLocalGatewayRouteTableVpcAssociation`, `CreateManagedPrefixList`, `CreateNetworkAcl`, `CreateNetworkAclEntry`, `CreateNetworkInsightsAccessScope`, `CreateNetworkInsightsPath`
-
-`CreateNetworkInterfacePermission`, `CreatePublicIpv4Pool`, `CreateReplaceRootVolumeTask`, `CreateReservedInstancesListing`, `CreateRestoreImageTask`, `CreateSnapshots`, `CreateSpotDatafeedSubscription`, `CreateStoreImageTask`
-
-`CreateSubnetCidrReservation`, `CreateTrafficMirrorFilter`, `CreateTrafficMirrorFilterRule`, `CreateTrafficMirrorSession`, `CreateTrafficMirrorTarget`, `CreateTransitGateway`, `CreateTransitGatewayConnect`, `CreateTransitGatewayConnectPeer`
-
-`CreateTransitGatewayMulticastDomain`, `CreateTransitGatewayPeeringAttachment`, `CreateTransitGatewayPolicyTable`, `CreateTransitGatewayPrefixListReference`, `CreateTransitGatewayRoute`, `CreateTransitGatewayRouteTable`, `CreateTransitGatewayRouteTableAnnouncement`, `CreateTransitGatewayVpcAttachment`
-
-`CreateVerifiedAccessEndpoint`, `CreateVerifiedAccessGroup`, `CreateVerifiedAccessInstance`, `CreateVerifiedAccessTrustProvider`, `CreateVpcEndpoint`, `CreateVpcEndpointConnectionNotification`, `CreateVpcEndpointServiceConfiguration`, `CreateVpcPeeringConnection`
-
-`CreateVpnConnection`, `CreateVpnConnectionRoute`, `CreateVpnGateway`, `DeleteCarrierGateway`, `DeleteClientVpnEndpoint`, `DeleteClientVpnRoute`, `DeleteCoipCidr`, `DeleteCoipPool`
-
-`DeleteCustomerGateway`, `DeleteDhcpOptions`, `DeleteFleets`, `DeleteFlowLogs`, `DeleteFpgaImage`, `DeleteInstanceConnectEndpoint`, `DeleteInstanceEventWindow`, `DeleteIpam`
-
-`DeleteIpamExternalResourceVerificationToken`, `DeleteIpamPool`, `DeleteIpamResourceDiscovery`, `DeleteIpamScope`, `DeleteLocalGatewayRoute`, `DeleteLocalGatewayRouteTable`, `DeleteLocalGatewayRouteTableVirtualInterfaceGroupAssociation`, `DeleteLocalGatewayRouteTableVpcAssociation`
-
-`DeleteManagedPrefixList`, `DeleteNetworkAcl`, `DeleteNetworkAclEntry`, `DeleteNetworkInsightsAccessScope`, `DeleteNetworkInsightsAccessScopeAnalysis`, `DeleteNetworkInsightsAnalysis`, `DeleteNetworkInsightsPath`, `DeleteNetworkInterfacePermission`
-
-`DeletePublicIpv4Pool`, `DeleteQueuedReservedInstances`, `DeleteSpotDatafeedSubscription`, `DeleteSubnetCidrReservation`, `DeleteTrafficMirrorFilter`, `DeleteTrafficMirrorFilterRule`, `DeleteTrafficMirrorSession`, `DeleteTrafficMirrorTarget`
-
-`DeleteTransitGateway`, `DeleteTransitGatewayConnect`, `DeleteTransitGatewayConnectPeer`, `DeleteTransitGatewayMulticastDomain`, `DeleteTransitGatewayPeeringAttachment`, `DeleteTransitGatewayPolicyTable`, `DeleteTransitGatewayPrefixListReference`, `DeleteTransitGatewayRoute`
-
-`DeleteTransitGatewayRouteTable`, `DeleteTransitGatewayRouteTableAnnouncement`, `DeleteTransitGatewayVpcAttachment`, `DeleteVerifiedAccessEndpoint`, `DeleteVerifiedAccessGroup`, `DeleteVerifiedAccessInstance`, `DeleteVerifiedAccessTrustProvider`, `DeleteVpcEndpointConnectionNotifications`
-
-`DeleteVpcEndpointServiceConfigurations`, `DeleteVpcEndpoints`, `DeleteVpcPeeringConnection`, `DeleteVpnConnection`, `DeleteVpnConnectionRoute`, `DeleteVpnGateway`, `DeprovisionByoipCidr`, `DeprovisionIpamByoasn`
-
-`DeprovisionIpamPoolCidr`, `DeprovisionPublicIpv4PoolCidr`, `DeregisterInstanceEventNotificationAttributes`, `DeregisterTransitGatewayMulticastGroupMembers`, `DeregisterTransitGatewayMulticastGroupSources`, `DescribeAddressTransfers`, `DescribeAggregateIdFormat`, `DescribeAwsNetworkPerformanceMetricSubscriptions`
-
-`DescribeBundleTasks`, `DescribeByoipCidrs`, `DescribeCapacityBlockOfferings`, `DescribeCapacityReservationFleets`, `DescribeCarrierGateways`, `DescribeClassicLinkInstances`, `DescribeClientVpnAuthorizationRules`, `DescribeClientVpnConnections`
-
-`DescribeClientVpnEndpoints`, `DescribeClientVpnRoutes`, `DescribeClientVpnTargetNetworks`, `DescribeCoipPools`, `DescribeConversionTasks`, `DescribeCustomerGateways`, `DescribeDhcpOptions`, `DescribeElasticGpus`
-
-`DescribeExportImageTasks`, `DescribeExportTasks`, `DescribeFastLaunchImages`, `DescribeFastSnapshotRestores`, `DescribeFleetHistory`, `DescribeFleetInstances`, `DescribeFleets`, `DescribeFlowLogs`
-
-`DescribeFpgaImageAttribute`, `DescribeFpgaImages`, `DescribeHostReservationOfferings`, `DescribeHostReservations`, `DescribeHosts`, `DescribeIdFormat`, `DescribeIdentityIdFormat`, `DescribeImportImageTasks`
-
-`DescribeImportSnapshotTasks`, `DescribeInstanceConnectEndpoints`, `DescribeInstanceEventNotificationAttributes`, `DescribeInstanceEventWindows`, `DescribeInstanceTopology`, `DescribeInstanceTypeOfferings`, `DescribeIpamByoasn`, `DescribeIpamExternalResourceVerificationTokens`
-
-`DescribeIpamPools`, `DescribeIpamResourceDiscoveries`, `DescribeIpamResourceDiscoveryAssociations`, `DescribeIpamScopes`, `DescribeIpams`, `DescribeIpv6Pools`, `DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociations`, `DescribeLocalGatewayRouteTableVpcAssociations`
-
-`DescribeLocalGatewayRouteTables`, `DescribeLocalGatewayVirtualInterfaceGroups`, `DescribeLocalGatewayVirtualInterfaces`, `DescribeLocalGateways`, `DescribeLockedSnapshots`, `DescribeMacHosts`, `DescribeManagedPrefixLists`, `DescribeMovingAddresses`
-
-`DescribeNetworkAcls`, `DescribeNetworkInsightsAccessScopeAnalyses`, `DescribeNetworkInsightsAccessScopes`, `DescribeNetworkInsightsAnalyses`, `DescribeNetworkInsightsPaths`, `DescribeNetworkInterfaceAttribute`, `DescribeNetworkInterfacePermissions`, `DescribePrefixLists`
-
-`DescribePrincipalIdFormat`, `DescribePublicIpv4Pools`, `DescribeReplaceRootVolumeTasks`, `DescribeReservedInstances`, `DescribeReservedInstancesListings`, `DescribeReservedInstancesModifications`, `DescribeReservedInstancesOfferings`, `DescribeScheduledInstanceAvailability`
-
-`DescribeScheduledInstances`, `DescribeSecurityGroupReferences`, `DescribeSnapshotAttribute`, `DescribeSnapshotTierStatus`, `DescribeSpotDatafeedSubscription`, `DescribeSpotFleetInstances`, `DescribeSpotFleetRequestHistory`, `DescribeSpotFleetRequests`
-
-`DescribeSpotPriceHistory`, `DescribeStaleSecurityGroups`, `DescribeStoreImageTasks`, `DescribeTrafficMirrorFilterRules`, `DescribeTrafficMirrorFilters`, `DescribeTrafficMirrorSessions`, `DescribeTrafficMirrorTargets`, `DescribeTransitGatewayAttachments`
-
-`DescribeTransitGatewayConnectPeers`, `DescribeTransitGatewayConnects`, `DescribeTransitGatewayMulticastDomains`, `DescribeTransitGatewayPeeringAttachments`, `DescribeTransitGatewayPolicyTables`, `DescribeTransitGatewayRouteTableAnnouncements`, `DescribeTransitGatewayRouteTables`, `DescribeTransitGatewayVpcAttachments`
-
-`DescribeTransitGateways`, `DescribeTrunkInterfaceAssociations`, `DescribeVerifiedAccessEndpoints`, `DescribeVerifiedAccessGroups`, `DescribeVerifiedAccessInstanceLoggingConfigurations`, `DescribeVerifiedAccessInstances`, `DescribeVerifiedAccessTrustProviders`, `DescribeVolumeAttribute`
-
-`DescribeVpcClassicLink`, `DescribeVpcClassicLinkDnsSupport`, `DescribeVpcEndpointConnectionNotifications`, `DescribeVpcEndpointConnections`, `DescribeVpcEndpointServiceConfigurations`, `DescribeVpcEndpointServicePermissions`, `DescribeVpcEndpointServices`, `DescribeVpcEndpoints`
-
-`DescribeVpcPeeringConnections`, `DescribeVpnConnections`, `DescribeVpnGateways`, `DetachClassicLinkVpc`, `DetachVerifiedAccessTrustProvider`, `DetachVpnGateway`, `DisableAddressTransfer`, `DisableAwsNetworkPerformanceMetricSubscription`
-
-`DisableFastLaunch`, `DisableFastSnapshotRestores`, `DisableImage`, `DisableImageBlockPublicAccess`, `DisableImageDeprecation`, `DisableImageDeregistrationProtection`, `DisableIpamOrganizationAdminAccount`, `DisableSnapshotBlockPublicAccess`
-
-`DisableTransitGatewayRouteTablePropagation`, `DisableVgwRoutePropagation`, `DisableVpcClassicLink`, `DisableVpcClassicLinkDnsSupport`, `DisassociateClientVpnTargetNetwork`, `DisassociateEnclaveCertificateIamRole`, `DisassociateInstanceEventWindow`, `DisassociateIpamByoasn`
-
-`DisassociateIpamResourceDiscovery`, `DisassociateNatGatewayAddress`, `DisassociateSubnetCidrBlock`, `DisassociateTransitGatewayMulticastDomain`, `DisassociateTransitGatewayPolicyTable`, `DisassociateTransitGatewayRouteTable`, `DisassociateTrunkInterface`, `DisassociateVpcCidrBlock`
-
-`EnableAddressTransfer`, `EnableAwsNetworkPerformanceMetricSubscription`, `EnableFastLaunch`, `EnableFastSnapshotRestores`, `EnableImage`, `EnableImageBlockPublicAccess`, `EnableImageDeprecation`, `EnableImageDeregistrationProtection`
-
-`EnableIpamOrganizationAdminAccount`, `EnableReachabilityAnalyzerOrganizationSharing`, `EnableSnapshotBlockPublicAccess`, `EnableTransitGatewayRouteTablePropagation`, `EnableVgwRoutePropagation`, `EnableVolumeIO`, `EnableVpcClassicLink`, `EnableVpcClassicLinkDnsSupport`
-
-`ExportClientVpnClientCertificateRevocationList`, `ExportClientVpnClientConfiguration`, `ExportImage`, `ExportTransitGatewayRoutes`, `GetAssociatedEnclaveCertificateIamRoles`, `GetAssociatedIpv6PoolCidrs`, `GetAwsNetworkPerformanceData`, `GetCapacityReservationUsage`
-
-`GetCoipPoolUsage`, `GetConsoleScreenshot`, `GetDefaultCreditSpecification`, `GetEbsDefaultKmsKeyId`, `GetFlowLogsIntegrationTemplate`, `GetGroupsForCapacityReservation`, `GetHostReservationPurchasePreview`, `GetImageBlockPublicAccessState`
-
-`GetInstanceMetadataDefaults`, `GetInstanceTpmEkPub`, `GetInstanceTypesFromInstanceRequirements`, `GetInstanceUefiData`, `GetIpamAddressHistory`, `GetIpamDiscoveredAccounts`, `GetIpamDiscoveredPublicAddresses`, `GetIpamDiscoveredResourceCidrs`
-
-`GetIpamPoolAllocations`, `GetIpamPoolCidrs`, `GetIpamResourceCidrs`, `GetLaunchTemplateData`, `GetManagedPrefixListAssociations`, `GetManagedPrefixListEntries`, `GetNetworkInsightsAccessScopeAnalysisFindings`, `GetNetworkInsightsAccessScopeContent`
-
-`GetReservedInstancesExchangeQuote`, `GetSecurityGroupsForVpc`, `GetSnapshotBlockPublicAccessState`, `GetSpotPlacementScores`, `GetSubnetCidrReservations`, `GetTransitGatewayAttachmentPropagations`, `GetTransitGatewayMulticastDomainAssociations`, `GetTransitGatewayPolicyTableAssociations`
-
-`GetTransitGatewayPolicyTableEntries`, `GetTransitGatewayPrefixListReferences`, `GetTransitGatewayRouteTableAssociations`, `GetTransitGatewayRouteTablePropagations`, `GetVerifiedAccessEndpointPolicy`, `GetVerifiedAccessGroupPolicy`, `GetVpnConnectionDeviceSampleConfiguration`, `GetVpnConnectionDeviceTypes`
-
-`GetVpnTunnelReplacementStatus`, `ImportClientVpnClientCertificateRevocationList`, `ImportImage`, `ImportInstance`, `ImportSnapshot`, `ImportVolume`, `ListImagesInRecycleBin`, `ListSnapshotsInRecycleBin`
-
-`LockSnapshot`, `ModifyAddressAttribute`, `ModifyAvailabilityZoneGroup`, `ModifyCapacityReservation`, `ModifyCapacityReservationFleet`, `ModifyClientVpnEndpoint`, `ModifyDefaultCreditSpecification`, `ModifyEbsDefaultKmsKeyId`
-
-`ModifyFleet`, `ModifyFpgaImageAttribute`, `ModifyHosts`, `ModifyIdFormat`, `ModifyIdentityIdFormat`, `ModifyInstanceCapacityReservationAttributes`, `ModifyInstanceCreditSpecification`, `ModifyInstanceEventStartTime`
-
-`ModifyInstanceEventWindow`, `ModifyInstanceMaintenanceOptions`, `ModifyInstanceMetadataDefaults`, `ModifyInstancePlacement`, `ModifyIpam`, `ModifyIpamPool`, `ModifyIpamResourceCidr`, `ModifyIpamResourceDiscovery`
-
-`ModifyIpamScope`, `ModifyLocalGatewayRoute`, `ModifyManagedPrefixList`, `ModifyPrivateDnsNameOptions`, `ModifyReservedInstances`, `ModifySecurityGroupRules`, `ModifySnapshotAttribute`, `ModifySnapshotTier`
-
-`ModifySpotFleetRequest`, `ModifyTrafficMirrorFilterNetworkServices`, `ModifyTrafficMirrorFilterRule`, `ModifyTrafficMirrorSession`, `ModifyTransitGateway`, `ModifyTransitGatewayPrefixListReference`, `ModifyTransitGatewayVpcAttachment`, `ModifyVerifiedAccessEndpoint`
-
-`ModifyVerifiedAccessEndpointPolicy`, `ModifyVerifiedAccessGroup`, `ModifyVerifiedAccessGroupPolicy`, `ModifyVerifiedAccessInstance`, `ModifyVerifiedAccessInstanceLoggingConfiguration`, `ModifyVerifiedAccessTrustProvider`, `ModifyVolumeAttribute`, `ModifyVpcEndpoint`
-
-`ModifyVpcEndpointConnectionNotification`, `ModifyVpcEndpointServiceConfiguration`, `ModifyVpcEndpointServicePayerResponsibility`, `ModifyVpcEndpointServicePermissions`, `ModifyVpcPeeringConnectionOptions`, `ModifyVpcTenancy`, `ModifyVpnConnection`, `ModifyVpnConnectionOptions`
-
-`ModifyVpnTunnelCertificate`, `ModifyVpnTunnelOptions`, `MoveAddressToVpc`, `MoveByoipCidrToIpam`, `ProvisionByoipCidr`, `ProvisionIpamByoasn`, `ProvisionIpamPoolCidr`, `ProvisionPublicIpv4PoolCidr`
-
-`PurchaseCapacityBlock`, `PurchaseHostReservation`, `PurchaseReservedInstancesOffering`, `PurchaseScheduledInstances`, `RegisterInstanceEventNotificationAttributes`, `RegisterTransitGatewayMulticastGroupMembers`, `RegisterTransitGatewayMulticastGroupSources`, `RejectTransitGatewayMulticastDomainAssociations`
-
-`RejectTransitGatewayPeeringAttachment`, `RejectTransitGatewayVpcAttachment`, `RejectVpcEndpointConnections`, `RejectVpcPeeringConnection`, `ReleaseHosts`, `ReleaseIpamPoolAllocation`, `ReplaceNetworkAclAssociation`, `ReplaceNetworkAclEntry`
-
-`ReplaceTransitGatewayRoute`, `ReplaceVpnTunnel`, `ReportInstanceStatus`, `RequestSpotFleet`, `ResetAddressAttribute`, `ResetEbsDefaultKmsKeyId`, `ResetFpgaImageAttribute`, `ResetInstanceAttribute`
-
-`ResetNetworkInterfaceAttribute`, `ResetSnapshotAttribute`, `RestoreAddressToClassic`, `RestoreImageFromRecycleBin`, `RestoreManagedPrefixListVersion`, `RestoreSnapshotFromRecycleBin`, `RestoreSnapshotTier`, `RevokeClientVpnIngress`
-
-`RunScheduledInstances`, `SearchLocalGatewayRoutes`, `SearchTransitGatewayMulticastGroups`, `SearchTransitGatewayRoutes`, `SendDiagnosticInterrupt`, `StartNetworkInsightsAccessScopeAnalysis`, `StartNetworkInsightsAnalysis`, `StartVpcEndpointServicePrivateDnsVerification`
-
-`TerminateClientVpnConnections`, `UnassignIpv6Addresses`, `UnassignPrivateIpAddresses`, `UnassignPrivateNatGatewayAddress`, `UnlockSnapshot`, `UpdateSecurityGroupRuleDescriptionsEgress`, `UpdateSecurityGroupRuleDescriptionsIngress`, `WithdrawByoipCidr`
-
-
-Registered stubs (0)
-
-None.
-
-Deliberately unsupported (0)
-
-None.
-
-Registered outside the pinned model (0)
-
-None.
-
-Implemented (19)
-
-`BatchDeleteImage`, `BatchGetImage`, `CreateRepository`, `DeleteLifecyclePolicy`, `DeleteRepository`, `DeleteRepositoryPolicy`, `DescribeImages`, `DescribeRepositories`
-
-`GetAuthorizationToken`, `GetLifecyclePolicy`, `GetLifecyclePolicyPreview`, `GetRepositoryPolicy`, `ListImages`, `ListTagsForResource`, `PutImage`, `PutImageTagMutability`
-
-`PutLifecyclePolicy`, `SetRepositoryPolicy`, `StartLifecyclePolicyPreview`
-
-
-Missing from dispatch (11)
-
-`CreatePullThroughCacheRule`, `CreateRepositoryCreationTemplate`, `DeletePullThroughCacheRule`, `DeleteRegistryPolicy`, `DeleteRepositoryCreationTemplate`, `DescribeImageReplicationStatus`, `DescribePullThroughCacheRules`, `DescribeRepositoryCreationTemplates`
-
-`UpdatePullThroughCacheRule`, `UpdateRepositoryCreationTemplate`, `ValidatePullThroughCacheRule`
-
-
-Registered stubs (13)
-
-`BatchCheckLayerAvailability`, `CompleteLayerUpload`, `DescribeRegistry`, `GetDownloadUrlForLayer`, `GetRegistryPolicy`, `InitiateLayerUpload`, `ListRepositories`, `PutRegistryPolicy`
-
-`PutReplicationConfiguration`, `ReplicateImage`, `TagResource`, `UntagResource`, `UploadLayerPart`
-
-
-Deliberately unsupported (7)
-
-`BatchGetRepositoryScanningConfiguration`, `DescribeImageScanFindings`, `GetImageScanningConfiguration`, `GetRegistryScanningConfiguration`, `PutImageScanningConfiguration`, `PutRegistryScanningConfiguration`, `StartImageScan`
-
-
-Registered outside the pinned model (3)
-
-`GetImageScanningConfiguration`, `ListRepositories`, `ReplicateImage`
-
-
-Implemented (31)
-
-`CreateCapacityProvider`, `CreateCluster`, `CreateService`, `DeleteCapacityProvider`, `DeleteCluster`, `DeleteService`, `DeregisterContainerInstance`, `DeregisterTaskDefinition`
-
-`DescribeCapacityProviders`, `DescribeClusters`, `DescribeContainerInstances`, `DescribeServices`, `DescribeTaskDefinition`, `DescribeTasks`, `ListClusters`, `ListContainerInstances`
-
-`ListServices`, `ListTagsForResource`, `ListTaskDefinitions`, `ListTasks`, `PutClusterCapacityProviders`, `RegisterContainerInstance`, `RegisterTaskDefinition`, `RunTask`
-
-`StartTask`, `StopTask`, `SubmitTaskStateChange`, `TagResource`, `UntagResource`, `UpdateContainerInstancesState`, `UpdateService`
-
-
-Missing from dispatch (20)
-
-`CreateTaskSet`, `DeleteAccountSetting`, `DeleteAttributes`, `DeleteTaskDefinitions`, `DeleteTaskSet`, `DescribeTaskSets`, `DiscoverPollEndpoint`, `ExecuteCommand`
-
-`GetTaskProtection`, `ListAttributes`, `PutAccountSettingDefault`, `PutAttributes`, `SubmitAttachmentStateChanges`, `SubmitContainerStateChange`, `UpdateCapacityProvider`, `UpdateClusterSettings`
-
-`UpdateContainerAgent`, `UpdateServicePrimaryTaskSet`, `UpdateTaskProtection`, `UpdateTaskSet`
-
-
-Registered stubs (5)
-
-`ListAccountSettings`, `ListServicesByNamespace`, `ListTaskDefinitionFamilies`, `PutAccountSetting`, `UpdateCluster`
-
-
-Deliberately unsupported (0)
-
-None.
-
-Registered outside the pinned model (3)
-
-`PollAssignments`, `ProvisionCapacity`, `ReportTaskGPU`
-
-
-Implemented (34)
-
-`AssociateAccessPolicy`, `AssociateIdentityProviderConfig`, `CreateAccessEntry`, `CreateAddon`, `CreateCluster`, `CreateNodegroup`, `DeleteAccessEntry`, `DeleteAddon`
-
-`DeleteCluster`, `DeleteNodegroup`, `DescribeAccessEntry`, `DescribeAddon`, `DescribeAddonVersions`, `DescribeCluster`, `DescribeIdentityProviderConfig`, `DescribeNodegroup`
-
-`DisassociateAccessPolicy`, `DisassociateIdentityProviderConfig`, `ListAccessEntries`, `ListAccessPolicies`, `ListAddons`, `ListAssociatedAccessPolicies`, `ListClusters`, `ListIdentityProviderConfigs`
-
-`ListNodegroups`, `ListTagsForResource`, `TagResource`, `UntagResource`, `UpdateAccessEntry`, `UpdateAddon`, `UpdateClusterConfig`, `UpdateClusterVersion`
-
-`UpdateNodegroupConfig`, `UpdateNodegroupVersion`
-
-
-Missing from dispatch (22)
-
-`AssociateEncryptionConfig`, `CreateEksAnywhereSubscription`, `CreateFargateProfile`, `CreatePodIdentityAssociation`, `DeleteEksAnywhereSubscription`, `DeleteFargateProfile`, `DeletePodIdentityAssociation`, `DeregisterCluster`
-
-`DescribeAddonConfiguration`, `DescribeEksAnywhereSubscription`, `DescribeFargateProfile`, `DescribeInsight`, `DescribePodIdentityAssociation`, `DescribeUpdate`, `ListEksAnywhereSubscriptions`, `ListFargateProfiles`
-
-`ListInsights`, `ListPodIdentityAssociations`, `ListUpdates`, `RegisterCluster`, `UpdateEksAnywhereSubscription`, `UpdatePodIdentityAssociation`
-
-
-Registered stubs (0)
-
-None.
-
-Deliberately unsupported (0)
-
-None.
-
-Registered outside the pinned model (4)
-
-`GetRecoveryDirective`, `ListInternalAddons`, `PublishInternal`, `WebhookTokenReview`
-
-
-Implemented (33)
-
-`AddListenerCertificates`, `AddTags`, `CreateListener`, `CreateLoadBalancer`, `CreateRule`, `CreateTargetGroup`, `DeleteListener`, `DeleteLoadBalancer`
-
-`DeleteRule`, `DeleteTargetGroup`, `DeregisterTargets`, `DescribeListenerCertificates`, `DescribeListeners`, `DescribeLoadBalancerAttributes`, `DescribeLoadBalancers`, `DescribeRules`
-
-`DescribeSSLPolicies`, `DescribeTags`, `DescribeTargetGroupAttributes`, `DescribeTargetGroups`, `DescribeTargetHealth`, `ModifyListener`, `ModifyLoadBalancerAttributes`, `ModifyRule`
-
-`ModifyTargetGroup`, `ModifyTargetGroupAttributes`, `RegisterTargets`, `RemoveListenerCertificates`, `RemoveTags`, `SetIpAddressType`, `SetRulePriorities`, `SetSecurityGroups`
-
-`SetSubnets`
-
-
-Missing from dispatch (13)
-
-`AddTrustStoreRevocations`, `CreateTrustStore`, `DeleteSharedTrustStoreAssociation`, `DeleteTrustStore`, `DescribeAccountLimits`, `DescribeTrustStoreAssociations`, `DescribeTrustStoreRevocations`, `DescribeTrustStores`
-
-`GetResourcePolicy`, `GetTrustStoreCaCertificatesBundle`, `GetTrustStoreRevocationContent`, `ModifyTrustStore`, `RemoveTrustStoreRevocations`
-
-
-Registered stubs (0)
-
-None.
-
-Deliberately unsupported (0)
-
-None.
-
-Registered outside the pinned model (4)
-
-`DescribeListenerAttributes`, `GetLBConfig`, `LBAgentHeartbeat`, `ModifyListenerAttributes`
-
-
-Implemented (75)
-
-`AddRoleToInstanceProfile`, `AddUserToGroup`, `AttachGroupPolicy`, `AttachRolePolicy`, `AttachUserPolicy`, `CreateAccessKey`, `CreateGroup`, `CreateInstanceProfile`
-
-`CreateOpenIDConnectProvider`, `CreatePolicy`, `CreateRole`, `CreateUser`, `DeleteAccessKey`, `DeleteGroup`, `DeleteGroupPolicy`, `DeleteInstanceProfile`
-
-`DeleteOpenIDConnectProvider`, `DeletePolicy`, `DeleteRole`, `DeleteRolePolicy`, `DeleteUser`, `DeleteUserPolicy`, `DetachGroupPolicy`, `DetachRolePolicy`
-
-`DetachUserPolicy`, `GetAccountSummary`, `GetGroup`, `GetGroupPolicy`, `GetInstanceProfile`, `GetOpenIDConnectProvider`, `GetPolicy`, `GetPolicyVersion`
-
-`GetRole`, `GetRolePolicy`, `GetUser`, `GetUserPolicy`, `ListAccessKeys`, `ListAttachedGroupPolicies`, `ListAttachedRolePolicies`, `ListAttachedUserPolicies`
-
-`ListGroupPolicies`, `ListGroups`, `ListGroupsForUser`, `ListInstanceProfileTags`, `ListInstanceProfiles`, `ListInstanceProfilesForRole`, `ListOpenIDConnectProviderTags`, `ListOpenIDConnectProviders`
-
-`ListPolicies`, `ListPolicyTags`, `ListPolicyVersions`, `ListRolePolicies`, `ListRoleTags`, `ListRoles`, `ListUserPolicies`, `ListUserTags`
-
-`ListUsers`, `PutGroupPolicy`, `PutRolePolicy`, `PutUserPolicy`, `RemoveRoleFromInstanceProfile`, `RemoveUserFromGroup`, `TagInstanceProfile`, `TagOpenIDConnectProvider`
-
-`TagPolicy`, `TagRole`, `TagUser`, `UntagInstanceProfile`, `UntagOpenIDConnectProvider`, `UntagPolicy`, `UntagRole`, `UntagUser`
-
-`UpdateAccessKey`, `UpdateAssumeRolePolicy`, `UpdateRole`
-
-
-Missing from dispatch (84)
-
-`AddClientIDToOpenIDConnectProvider`, `ChangePassword`, `CreateAccountAlias`, `CreateLoginProfile`, `CreatePolicyVersion`, `CreateSAMLProvider`, `CreateServiceLinkedRole`, `CreateServiceSpecificCredential`
-
-`CreateVirtualMFADevice`, `DeactivateMFADevice`, `DeleteAccountAlias`, `DeleteAccountPasswordPolicy`, `DeleteLoginProfile`, `DeletePolicyVersion`, `DeleteRolePermissionsBoundary`, `DeleteSAMLProvider`
-
-`DeleteSSHPublicKey`, `DeleteServerCertificate`, `DeleteServiceLinkedRole`, `DeleteServiceSpecificCredential`, `DeleteSigningCertificate`, `DeleteUserPermissionsBoundary`, `DeleteVirtualMFADevice`, `EnableMFADevice`
-
-`GenerateCredentialReport`, `GenerateOrganizationsAccessReport`, `GenerateServiceLastAccessedDetails`, `GetAccessKeyLastUsed`, `GetAccountAuthorizationDetails`, `GetAccountPasswordPolicy`, `GetContextKeysForCustomPolicy`, `GetContextKeysForPrincipalPolicy`
-
-`GetCredentialReport`, `GetLoginProfile`, `GetMFADevice`, `GetOrganizationsAccessReport`, `GetSAMLProvider`, `GetSSHPublicKey`, `GetServerCertificate`, `GetServiceLastAccessedDetails`
-
-`GetServiceLastAccessedDetailsWithEntities`, `GetServiceLinkedRoleDeletionStatus`, `ListAccountAliases`, `ListEntitiesForPolicy`, `ListMFADeviceTags`, `ListMFADevices`, `ListPoliciesGrantingServiceAccess`, `ListSAMLProviderTags`
-
-`ListSAMLProviders`, `ListSSHPublicKeys`, `ListServerCertificateTags`, `ListServerCertificates`, `ListServiceSpecificCredentials`, `ListSigningCertificates`, `ListVirtualMFADevices`, `PutRolePermissionsBoundary`
-
-`PutUserPermissionsBoundary`, `RemoveClientIDFromOpenIDConnectProvider`, `ResetServiceSpecificCredential`, `ResyncMFADevice`, `SetDefaultPolicyVersion`, `SetSecurityTokenServicePreferences`, `SimulateCustomPolicy`, `SimulatePrincipalPolicy`
-
-`TagMFADevice`, `TagSAMLProvider`, `TagServerCertificate`, `UntagMFADevice`, `UntagSAMLProvider`, `UntagServerCertificate`, `UpdateAccountPasswordPolicy`, `UpdateGroup`
-
-`UpdateLoginProfile`, `UpdateOpenIDConnectProviderThumbprint`, `UpdateRoleDescription`, `UpdateSAMLProvider`, `UpdateSSHPublicKey`, `UpdateServerCertificate`, `UpdateServiceSpecificCredential`, `UpdateSigningCertificate`
-
-`UpdateUser`, `UploadSSHPublicKey`, `UploadServerCertificate`, `UploadSigningCertificate`
-
-
-Registered stubs (0)
-
-None.
-
-Deliberately unsupported (0)
-
-None.
-
-Registered outside the pinned model (0)
-
-None.
-
-Implemented (26)
-
-`AddTagsToResource`, `CreateDBInstance`, `CreateDBParameterGroup`, `CreateDBSnapshot`, `CreateDBSubnetGroup`, `DeleteDBInstance`, `DeleteDBParameterGroup`, `DeleteDBSnapshot`
-
-`DeleteDBSubnetGroup`, `DescribeDBEngineVersions`, `DescribeDBInstanceAutomatedBackups`, `DescribeDBInstances`, `DescribeDBParameterGroups`, `DescribeDBParameters`, `DescribeDBSnapshots`, `DescribeDBSubnetGroups`
-
-`DescribeEvents`, `DescribeOrderableDBInstanceOptions`, `ListTagsForResource`, `ModifyDBInstance`, `ModifyDBParameterGroup`, `RebootDBInstance`, `RemoveTagsFromResource`, `RestoreDBInstanceFromDBSnapshot`
-
-`StartDBInstance`, `StopDBInstance`
-
-
-Missing from dispatch (124)
-
-`AddRoleToDBCluster`, `AddRoleToDBInstance`, `AddSourceIdentifierToSubscription`, `ApplyPendingMaintenanceAction`, `AuthorizeDBSecurityGroupIngress`, `BacktrackDBCluster`, `CancelExportTask`, `CopyDBClusterParameterGroup`
-
-`CopyDBClusterSnapshot`, `CopyDBParameterGroup`, `CopyDBSnapshot`, `CopyOptionGroup`, `CreateBlueGreenDeployment`, `CreateCustomDBEngineVersion`, `CreateDBClusterEndpoint`, `CreateDBClusterParameterGroup`
-
-`CreateDBClusterSnapshot`, `CreateDBProxy`, `CreateDBProxyEndpoint`, `CreateDBSecurityGroup`, `CreateDBShardGroup`, `CreateEventSubscription`, `CreateGlobalCluster`, `CreateIntegration`
-
-`CreateTenantDatabase`, `DeleteBlueGreenDeployment`, `DeleteCustomDBEngineVersion`, `DeleteDBClusterAutomatedBackup`, `DeleteDBClusterEndpoint`, `DeleteDBClusterParameterGroup`, `DeleteDBClusterSnapshot`, `DeleteDBInstanceAutomatedBackup`
-
-`DeleteDBProxy`, `DeleteDBProxyEndpoint`, `DeleteDBSecurityGroup`, `DeleteDBShardGroup`, `DeleteEventSubscription`, `DeleteGlobalCluster`, `DeleteIntegration`, `DeleteTenantDatabase`
-
-`DeregisterDBProxyTargets`, `DescribeAccountAttributes`, `DescribeBlueGreenDeployments`, `DescribeCertificates`, `DescribeDBClusterAutomatedBackups`, `DescribeDBClusterBacktracks`, `DescribeDBClusterEndpoints`, `DescribeDBClusterParameterGroups`
-
-`DescribeDBClusterParameters`, `DescribeDBClusterSnapshotAttributes`, `DescribeDBClusterSnapshots`, `DescribeDBLogFiles`, `DescribeDBProxies`, `DescribeDBProxyEndpoints`, `DescribeDBProxyTargetGroups`, `DescribeDBProxyTargets`
-
-`DescribeDBRecommendations`, `DescribeDBSecurityGroups`, `DescribeDBShardGroups`, `DescribeDBSnapshotAttributes`, `DescribeDBSnapshotTenantDatabases`, `DescribeEngineDefaultClusterParameters`, `DescribeEngineDefaultParameters`, `DescribeEventCategories`
-
-`DescribeEventSubscriptions`, `DescribeExportTasks`, `DescribeGlobalClusters`, `DescribeIntegrations`, `DescribeOptionGroupOptions`, `DescribePendingMaintenanceActions`, `DescribeReservedDBInstances`, `DescribeReservedDBInstancesOfferings`
-
-`DescribeSourceRegions`, `DescribeTenantDatabases`, `DescribeValidDBInstanceModifications`, `DisableHttpEndpoint`, `DownloadDBLogFilePortion`, `EnableHttpEndpoint`, `FailoverGlobalCluster`, `ModifyActivityStream`
-
-`ModifyCertificates`, `ModifyCurrentDBClusterCapacity`, `ModifyCustomDBEngineVersion`, `ModifyDBClusterEndpoint`, `ModifyDBClusterParameterGroup`, `ModifyDBClusterSnapshotAttribute`, `ModifyDBProxy`, `ModifyDBProxyEndpoint`
-
-`ModifyDBProxyTargetGroup`, `ModifyDBRecommendation`, `ModifyDBShardGroup`, `ModifyDBSnapshot`, `ModifyDBSnapshotAttribute`, `ModifyDBSubnetGroup`, `ModifyEventSubscription`, `ModifyGlobalCluster`
-
-`ModifyIntegration`, `ModifyTenantDatabase`, `PromoteReadReplicaDBCluster`, `PurchaseReservedDBInstancesOffering`, `RebootDBCluster`, `RebootDBShardGroup`, `RegisterDBProxyTargets`, `RemoveFromGlobalCluster`
-
-`RemoveRoleFromDBCluster`, `RemoveRoleFromDBInstance`, `RemoveSourceIdentifierFromSubscription`, `ResetDBClusterParameterGroup`, `ResetDBParameterGroup`, `RestoreDBClusterFromS3`, `RestoreDBClusterFromSnapshot`, `RestoreDBClusterToPointInTime`
-
-`RestoreDBInstanceFromS3`, `RevokeDBSecurityGroupIngress`, `StartActivityStream`, `StartDBCluster`, `StartDBInstanceAutomatedBackupsReplication`, `StartExportTask`, `StopActivityStream`, `StopDBCluster`
-
-`StopDBInstanceAutomatedBackupsReplication`, `SwitchoverBlueGreenDeployment`, `SwitchoverGlobalCluster`, `SwitchoverReadReplica`
-
-
-Registered stubs (0)
-
-None.
-
-Deliberately unsupported (12)
-
-`CreateDBCluster`, `CreateDBInstanceReadReplica`, `CreateOptionGroup`, `DeleteDBCluster`, `DeleteOptionGroup`, `DescribeDBClusters`, `DescribeOptionGroups`, `FailoverDBCluster`
-
-`ModifyDBCluster`, `ModifyOptionGroup`, `PromoteReadReplica`, `RestoreDBInstanceToPointInTime`
-
-
-Registered outside the pinned model (5)
-
-`AcknowledgeDBBootstrap`, `GetDBBootstrapConfig`, `PollDBCommands`, `RegisterDBInstance`, `SubmitDBStateChange`
-
-
-Implemented (4)
-
-`AssumeRole`, `AssumeRoleWithWebIdentity`, `GetCallerIdentity`, `GetSessionToken`
-
-
-Missing from dispatch (4)
-
-`AssumeRoleWithSAML`, `DecodeAuthorizationMessage`, `GetAccessKeyInfo`, `GetFederationToken`
-
-
-Registered stubs (0)
-
-None.
-
-Deliberately unsupported (0)
-
-None.
-
-Registered outside the pinned model (0)
-
-None.
-
-%s (%d)
\n\n", title, len(operations))
- if len(operations) == 0 {
- report.WriteString("None.\n")
- } else {
- for start := 0; start < len(operations); start += 8 {
- end := min(start+8, len(operations))
- quoted := make([]string, 0, end-start)
- for _, operation := range operations[start:end] {
- quoted = append(quoted, "`"+operation+"`")
- }
- report.WriteString(strings.Join(quoted, ", ") + "\n\n")
- }
- }
- report.WriteString("\n") {
+ t.Errorf("summary contains raw HTML the docs site would escape:\n%s", report)
+ }
}
diff --git a/internal/awsmodel/page.go b/internal/awsmodel/page.go
new file mode 100644
index 000000000..d98c466db
--- /dev/null
+++ b/internal/awsmodel/page.go
@@ -0,0 +1,267 @@
+package awsmodel
+
+import (
+ "bytes"
+ "encoding/json"
+ "fmt"
+ "regexp"
+ "strconv"
+ "strings"
+ "unicode/utf8"
+)
+
+// Published operation states. The symbol carries the status at a glance and the
+// label disambiguates it; the docs site escapes inline SVG, so these are runes.
+const (
+ StatusImplemented = "✅ Implemented"
+ StatusStub = "🟡 Stub"
+ StatusNotSupported = "🚫 Not supported"
+ StatusNotImplemented = "❌ Not implemented"
+ StatusOutsideModel = "🔒 Outside the pinned model"
+)
+
+// Frontmatter length rules enforced by the docs site. See docs/README.md.
+const (
+ seoTitleSuffix = " — Spinifex Docs"
+ seoTitleMin = 50
+ seoTitleMax = 60
+ descriptionMin = 150
+ descriptionMax = 160
+)
+
+var slugPattern = regexp.MustCompile(`^[a-z0-9]+(-[a-z0-9]+)*$`)
+
+// OperationStatus is one row of a published coverage table.
+type OperationStatus struct {
+ Operation string
+ Status string
+}
+
+// ImplementedPercent is the share of modelled operations bound to a real
+// handler, or zero for a model with no operations.
+func (c OperationCoverage) ImplementedPercent() float64 {
+ if len(c.Modelled) == 0 {
+ return 0
+ }
+ return 100 * float64(len(c.Implemented)) / float64(len(c.Modelled))
+}
+
+// OperationStatuses returns every modelled operation with its dispatch state,
+// followed by the registered operations the pinned model does not describe.
+func (c OperationCoverage) OperationStatuses() []OperationStatus {
+ registered := toSet(c.Registered)
+ stubbed := toSet(c.Stubbed)
+ unsupported := toSet(c.Unsupported)
+
+ statuses := make([]OperationStatus, 0, len(c.Modelled)+len(c.Extra))
+ for _, operation := range c.Modelled {
+ status := StatusNotImplemented
+ switch {
+ case stubbed[operation]:
+ status = StatusStub
+ case unsupported[operation]:
+ status = StatusNotSupported
+ case registered[operation]:
+ status = StatusImplemented
+ }
+ statuses = append(statuses, OperationStatus{Operation: operation, Status: status})
+ }
+ for _, operation := range c.Extra {
+ statuses = append(statuses, OperationStatus{Operation: operation, Status: StatusOutsideModel})
+ }
+ return statuses
+}
+
+// PageMetadata is the checked-in frontmatter for one published coverage page.
+// It is hand-maintained rather than derived, because a description carrying a
+// live count would drift outside the length the docs site enforces.
+type PageMetadata struct {
+ Slug string `json:"slug"`
+ Name string `json:"name"`
+ Title string `json:"title"`
+ SEOTitle string `json:"seoTitle"`
+ Description string `json:"description"`
+ Tags []string `json:"tags"`
+}
+
+// PageSet is the metadata for the index page and every service page.
+type PageSet struct {
+ Category string `json:"category"`
+ Index PageMetadata `json:"index"`
+ Services map[Service]PageMetadata `json:"services"`
+}
+
+// ParsePageSet decodes docs/compatibility/pages.json and checks it describes
+// exactly the services the loader knows about, with publishable frontmatter.
+func ParsePageSet(contents []byte) (PageSet, error) {
+ decoder := json.NewDecoder(bytes.NewReader(contents))
+ decoder.DisallowUnknownFields()
+ var pages PageSet
+ if err := decoder.Decode(&pages); err != nil {
+ return PageSet{}, fmt.Errorf("awsmodel: parse coverage pages: %w", err)
+ }
+ if pages.Category == "" {
+ return PageSet{}, fmt.Errorf("awsmodel: coverage pages: category is empty")
+ }
+
+ slugs := map[string]bool{}
+ if err := validatePage("index", pages.Index, slugs); err != nil {
+ return PageSet{}, err
+ }
+ for _, service := range Services() {
+ page, ok := pages.Services[service]
+ if !ok {
+ return PageSet{}, fmt.Errorf("awsmodel: coverage pages: no entry for service %q", service)
+ }
+ if err := validatePage(string(service), page, slugs); err != nil {
+ return PageSet{}, err
+ }
+ }
+ for service := range pages.Services {
+ if _, ok := modelFiles[service]; !ok {
+ return PageSet{}, fmt.Errorf("awsmodel: coverage pages: unknown service %q", service)
+ }
+ }
+ return pages, nil
+}
+
+func validatePage(owner string, page PageMetadata, slugs map[string]bool) error {
+ fail := func(format string, args ...any) error {
+ return fmt.Errorf("awsmodel: coverage page %s: %s", owner, fmt.Sprintf(format, args...))
+ }
+ if !slugPattern.MatchString(page.Slug) {
+ return fail("slug %q is not lowercase kebab-case", page.Slug)
+ }
+ if slugs[page.Slug] {
+ return fail("slug %q is used by another page", page.Slug)
+ }
+ slugs[page.Slug] = true
+ if page.Name == "" || page.Title == "" {
+ return fail("name and title are required")
+ }
+ if len(page.Tags) == 0 {
+ return fail("at least one tag is required")
+ }
+ if !strings.HasSuffix(page.SEOTitle, seoTitleSuffix) {
+ return fail("seoTitle %q does not end with %q", page.SEOTitle, seoTitleSuffix)
+ }
+ if length := utf8.RuneCountInString(page.SEOTitle); length < seoTitleMin || length > seoTitleMax {
+ return fail("seoTitle is %d characters, want %d-%d", length, seoTitleMin, seoTitleMax)
+ }
+ if length := utf8.RuneCountInString(page.Description); length < descriptionMin || length > descriptionMax {
+ return fail("description is %d characters, want %d-%d", length, descriptionMin, descriptionMax)
+ }
+ return nil
+}
+
+// RenderServicePage renders one publishable coverage page. intro is optional
+// hand-written prose emitted above the table; it may not open a new page
+// section, so its headings must be level three or deeper.
+func RenderServicePage(coverage OperationCoverage, pages PageSet, intro string) (string, error) {
+ if err := checkIntro(string(coverage.Service), intro); err != nil {
+ return "", err
+ }
+ page, ok := pages.Services[coverage.Service]
+ if !ok {
+ return "", fmt.Errorf("awsmodel: coverage pages: no entry for service %q", coverage.Service)
+ }
+
+ var body strings.Builder
+ writeFrontmatter(&body, page, pages.Category)
+ fmt.Fprintf(&body, "# %s\n\n## Overview\n\n", page.Title)
+
+ writeSummary(&body, coverage, page)
+
+ if intro != "" {
+ body.WriteString(strings.TrimSpace(intro) + "\n\n")
+ }
+ if coverage.Opaque {
+ return strings.TrimRight(body.String(), "\n") + "\n", nil
+ }
+
+ body.WriteString("### Operations\n\n")
+ writeStatusLegend(&body)
+ body.WriteString("\n| Operation | Status |\n|---|---|\n")
+ for _, status := range coverage.OperationStatuses() {
+ fmt.Fprintf(&body, "| `%s` | %s |\n", status.Operation, status.Status)
+ }
+ return body.String(), nil
+}
+
+// RenderIndexPage renders the cross-service summary that links to each page.
+func RenderIndexPage(coverages []OperationCoverage, pages PageSet, intro string) (string, error) {
+ if err := checkIntro("index", intro); err != nil {
+ return "", err
+ }
+
+ var body strings.Builder
+ writeFrontmatter(&body, pages.Index, pages.Category)
+ fmt.Fprintf(&body, "# %s\n\n## Overview\n\n", pages.Index.Title)
+ fmt.Fprintf(&body, "Spinifex serves the AWS APIs below. Every page counts the operations in the pinned `aws-sdk-go %s` `api-2.json` model for its service and reports, operation by operation, whether Spinifex implements it.\n\n", SourceSDKVersion)
+ body.WriteString("| Service | API version | Implemented | Modelled | Coverage |\n|---|---|---:|---:|---:|\n")
+ for _, coverage := range sortedCoverages(coverages) {
+ page, ok := pages.Services[coverage.Service]
+ if !ok {
+ return "", fmt.Errorf("awsmodel: coverage pages: no entry for service %q", coverage.Service)
+ }
+ if coverage.Opaque {
+ fmt.Fprintf(&body, "| [%s](/docs/%s) | %s | — | %d | — |\n", page.Name, page.Slug, coverage.APIVersion, len(coverage.Modelled))
+ continue
+ }
+ fmt.Fprintf(&body, "| [%s](/docs/%s) | %s | %d | %d | %.1f%% |\n",
+ page.Name, page.Slug, coverage.APIVersion, len(coverage.Implemented), len(coverage.Modelled), coverage.ImplementedPercent())
+ }
+
+ body.WriteString("\n")
+ writeStatusLegend(&body)
+ if intro != "" {
+ body.WriteString("\n" + strings.TrimSpace(intro) + "\n")
+ }
+ return body.String(), nil
+}
+
+// writeSummary states the implemented-of-modelled count, or why there is none.
+func writeSummary(body *strings.Builder, coverage OperationCoverage, page PageMetadata) {
+ if coverage.Opaque {
+ fmt.Fprintf(body, "The %s API model pins **%d** operations at API version `%s`, but Spinifex's coverage of them is not mechanically enumerable: %s\n\n",
+ page.Name, len(coverage.Modelled), coverage.APIVersion, coverage.Note)
+ return
+ }
+ fmt.Fprintf(body, "Spinifex implements **%d of the %d** operations in the %s `%s` API model, as pinned in `aws-sdk-go %s` — **%.1f%%**.\n\n",
+ len(coverage.Implemented), len(coverage.Modelled), page.Name, coverage.APIVersion, SourceSDKVersion, coverage.ImplementedPercent())
+}
+
+func writeStatusLegend(body *strings.Builder) {
+ body.WriteString("| Status | Meaning |\n|---|---|\n")
+ for _, entry := range [][2]string{
+ {StatusImplemented, "A modelled operation bound to a real handler."},
+ {StatusStub, "A registered handler that answers with a fixed or empty result."},
+ {StatusNotSupported, "A registered handler that deliberately refuses, so a client sees \"not offered\" rather than an unknown action."},
+ {StatusNotImplemented, "Modelled by AWS, not registered by Spinifex."},
+ {StatusOutsideModel, "Registered by Spinifex but absent from the pinned model — an internal route, not a tenant-callable AWS action."},
+ } {
+ fmt.Fprintf(body, "| %s | %s |\n", entry[0], entry[1])
+ }
+}
+
+func writeFrontmatter(body *strings.Builder, page PageMetadata, category string) {
+ body.WriteString("---\n")
+ fmt.Fprintf(body, "title: %s\n", strconv.Quote(page.Title))
+ fmt.Fprintf(body, "seoTitle: %s\n", strconv.Quote(page.SEOTitle))
+ fmt.Fprintf(body, "description: %s\n", strconv.Quote(page.Description))
+ fmt.Fprintf(body, "category: %s\n", strconv.Quote(category))
+ body.WriteString("sections:\n - overview\ntags:\n")
+ for _, tag := range page.Tags {
+ fmt.Fprintf(body, " - %s\n", tag)
+ }
+ body.WriteString("---\n\n")
+}
+
+func checkIntro(owner, intro string) error {
+ for line := range strings.SplitSeq(intro, "\n") {
+ if strings.HasPrefix(line, "# ") || strings.HasPrefix(line, "## ") {
+ return fmt.Errorf("awsmodel: %s intro heading %q opens a new page section; use level three or deeper", owner, strings.TrimSpace(line))
+ }
+ }
+ return nil
+}
diff --git a/internal/awsmodel/page_test.go b/internal/awsmodel/page_test.go
new file mode 100644
index 000000000..ad098b0e9
--- /dev/null
+++ b/internal/awsmodel/page_test.go
@@ -0,0 +1,183 @@
+package awsmodel
+
+import (
+ "os"
+ "path/filepath"
+ "strings"
+ "testing"
+)
+
+func testPageSet(t *testing.T) PageSet {
+ t.Helper()
+ contents, err := os.ReadFile(filepath.Join("..", "..", "docs", "compatibility", "pages.json"))
+ if err != nil {
+ t.Fatal(err)
+ }
+ pages, err := ParsePageSet(contents)
+ if err != nil {
+ t.Fatal(err)
+ }
+ return pages
+}
+
+func TestParsePageSetAcceptsTheCheckedInFile(t *testing.T) {
+ pages := testPageSet(t)
+
+ for _, service := range Services() {
+ if _, ok := pages.Services[service]; !ok {
+ t.Errorf("no page metadata for service %q", service)
+ }
+ }
+}
+
+func TestParsePageSetRejectsUnpublishableMetadata(t *testing.T) {
+ for name, contents := range map[string]string{
+ "unknown service": `{"category":"Coverage","index":{},"services":{"notaservice":{}}}`,
+ "missing category": `{"index":{},"services":{}}`,
+ "unknown field": `{"category":"Coverage","colour":"blue","index":{},"services":{}}`,
+ "short seoTitle": `{"category":"Coverage","index":{"slug":"aws-api-coverage","name":"All","title":"All",` +
+ `"seoTitle":"Too short — Spinifex Docs","description":"` + strings.Repeat("x", 155) + `","tags":["aws"]}}`,
+ "missing suffix": `{"category":"Coverage","index":{"slug":"aws-api-coverage","name":"All","title":"All",` +
+ `"seoTitle":"` + strings.Repeat("x", 55) + `","description":"` + strings.Repeat("x", 155) + `","tags":["aws"]}}`,
+ "short description": `{"category":"Coverage","index":{"slug":"aws-api-coverage","name":"All","title":"All",` +
+ `"seoTitle":"` + strings.Repeat("x", 39) + ` — Spinifex Docs","description":"too short","tags":["aws"]}}`,
+ "bad slug": `{"category":"Coverage","index":{"slug":"AWS Coverage","name":"All","title":"All",` +
+ `"seoTitle":"` + strings.Repeat("x", 39) + ` — Spinifex Docs","description":"` + strings.Repeat("x", 155) + `","tags":["aws"]}}`,
+ } {
+ t.Run(name, func(t *testing.T) {
+ if _, err := ParsePageSet([]byte(contents)); err == nil {
+ t.Fatal("ParsePageSet accepted unpublishable metadata")
+ }
+ })
+ }
+}
+
+func TestRenderServicePageCarriesEveryStatus(t *testing.T) {
+ pages := testPageSet(t)
+ coverage, err := CompareOperations(STS, DispatchInventory{
+ Registered: []string{"AssumeRole", "GetCallerIdentity", "GetSessionToken", "PublishInternal"},
+ Stubbed: []string{"GetSessionToken"},
+ Unsupported: []string{"GetCallerIdentity"},
+ })
+ if err != nil {
+ t.Fatal(err)
+ }
+
+ page, err := RenderServicePage(coverage, pages, "### Scope\n\nHand-written prose.\n")
+ if err != nil {
+ t.Fatal(err)
+ }
+ for _, want := range []string{
+ `title: "STS API Coverage"`,
+ `category: "Coverage"`,
+ "sections:\n - overview\n",
+ "# STS API Coverage\n\n## Overview\n",
+ "Spinifex implements **1 of the 8** operations in the STS `2011-06-15` API model",
+ "### Scope\n\nHand-written prose.",
+ "| `AssumeRole` | " + StatusImplemented + " |",
+ "| `GetSessionToken` | " + StatusStub + " |",
+ "| `GetCallerIdentity` | " + StatusNotSupported + " |",
+ "| `AssumeRoleWithSAML` | " + StatusNotImplemented + " |",
+ "| `PublishInternal` | " + StatusOutsideModel + " |",
+ } {
+ if !strings.Contains(page, want) {
+ t.Errorf("page does not contain %q:\n%s", want, page)
+ }
+ }
+ if strings.Contains(page, "