Serverless Application Repository

Implementation details for API serverlessrepo

Coverage Overview

Serverless Application Repository is supported by LocalStack only in the pro version.

AvailabilityTesting*
OperationImplementedEditionInternal Test SuiteExternal Test SuiteTerraform ValidatedAWS ValidatedSnapshot TestedDetails
CreateApplication✔️pro✔️✔️✔️Show Tests
CreateApplicationVersion✔️pro✔️Show Tests
CreateCloudFormationChangeSet✔️pro✔️Show Tests
CreateCloudFormationTemplate✔️pro✔️Show Tests
DeleteApplication✔️pro✔️✔️✔️Show Tests
GetApplication✔️pro✔️✔️✔️Show Tests
GetApplicationPolicy
GetCloudFormationTemplate✔️pro✔️Show Tests
ListApplicationDependencies
ListApplicationVersions✔️pro✔️✔️Show Tests
ListApplications✔️pro✔️Show Tests
PutApplicationPolicy
UnshareApplication
UpdateApplication

Terminology

  • Internal Test Suite: tested by LocalStack's internal integration test suite
  • External Test Suite: covered by an external integration test suite, that runs against LocalStack
  • Terraform Validated: operation tested with Terraform
  • AWS Validated: the integration test that includes this operation call was validated against AWS
  • Snapshot Tested: the operation is part of a snapshot parity test, which verifies the responses by LocalStack and AWS are the same

Testing Details

This section gives an overview about the internal integration test suite and the specific test cases that recorded the API call.

How to read the test details?

For each operation we put up a list of the related integration test cases.
Those operation calls have been recorded during the exeuction of the outlined test cases. Some calls might be internal, i.e., they are not explicitly called in the test, but are triggered implicitly by the LocalStack framework.

  • Parameters: The tests are ordered by the parameters used, which are highlighted in bold.
  • Test Details: LocalStack Community or LocalStack Pro indicates where the test originates. For each test you see:
    • test name
    • status code returned (which is the expected one for the test case)
    • information about validation:
      • AWS validated the test is validated against AWS, meaning it run successfully against real AWS as well
      • Snapshot Tested this is a snapshot parity test, meaning the responses are validated against AWS


CreateApplication

Parameters: Author, Description, Name
  • LocalStack Pro
    • test_crud_application_versions LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_crud_application_versions HTTP Status Code: 201
    • test_crud_applications LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_crud_applications HTTP Status Code: 201
    • test_minimal_app_without_version LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepoParity::test_minimal_app_without_version HTTP Status Code: 201 AWS validated Snapshot Tested
Parameters: Author, Description, Name, SemanticVersion, TemplateBody
  • LocalStack Pro
    • test_minimal_app_with_version LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepoParity::test_minimal_app_with_version HTTP Status Code: 201 AWS validated Snapshot Tested

CreateApplicationVersion

Parameters: ApplicationId, SemanticVersion
  • LocalStack Pro
    • test_crud_application_versions LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_crud_application_versions HTTP Status Code: 201

CreateCloudFormationChangeSet

Parameters: ApplicationId, Capabilities, ChangeSetName, ParameterOverrides, StackName
  • LocalStack Pro
    • test_create_cloud_formation_change_set LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_create_cloud_formation_change_set HTTP Status Code: 201

CreateCloudFormationTemplate

Parameters: ApplicationId, SemanticVersion
  • LocalStack Pro
    • test_create_cloud_formation_change_set LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_create_cloud_formation_change_set HTTP Status Code: 201
    • test_crud_formation_template LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_crud_formation_template HTTP Status Code: 201

DeleteApplication

Parameters: ApplicationId
  • LocalStack Pro
    • test_create_cloud_formation_change_set LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_create_cloud_formation_change_set HTTP Status Code: 204
    • test_crud_application_versions LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_crud_application_versions HTTP Status Code: 204
    • test_crud_applications LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_crud_applications HTTP Status Code: 204
    • test_minimal_app_with_version LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepoParity::test_minimal_app_with_version HTTP Status Code: 204 AWS validated Snapshot Tested
    • test_minimal_app_without_version LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepoParity::test_minimal_app_without_version HTTP Status Code: 204 AWS validated Snapshot Tested

GetApplication

Parameters: ApplicationId
  • LocalStack Pro
    • test_crud_applications LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_crud_applications HTTP Status Code: 200
    • test_minimal_app_with_version LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepoParity::test_minimal_app_with_version HTTP Status Code: 200 AWS validated Snapshot Tested
Parameters: ApplicationId, SemanticVersion
  • LocalStack Pro
    • test_minimal_app_with_version LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepoParity::test_minimal_app_with_version HTTP Status Code: 200 AWS validated Snapshot Tested

GetCloudFormationTemplate

Parameters: ApplicationId, TemplateId
  • LocalStack Pro
    • test_crud_formation_template LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_crud_formation_template HTTP Status Code: 200

ListApplicationVersions

Parameters: ApplicationId
  • LocalStack Pro
    • test_crud_application_versions LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_crud_application_versions HTTP Status Code: 200
    • test_lookup_predefined_application LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_lookup_predefined_application HTTP Status Code: 200 AWS validated
    • test_crud_application_versions LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_crud_application_versions HTTP Status Code: 404 (NotFoundException)
    • test_not_existing_version LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_not_existing_version HTTP Status Code: 404 (NotFoundException) AWS validated

ListApplications

Parameters: - (without any parameters)
  • LocalStack Pro
    • test_crud_applications LocalStack Pro: tests/aws/services/serverlessrepo/test_serverlessrepo.py::TestServerlessRepo::test_crud_applications HTTP Status Code: 200


Last modified March 20, 2023: improve Coverage Docs (#505) (46f2fb0c0)