Update sam local invoke to support new runtime options

[jonife]

Why is this change necessary?

Enable testing Lambda functions with a different runtime than specified in the function configuration.

Test using a compatible runtime version: build artifact was in python3.13 and test runtime was python3.11.

jonife@80a9972c3483 sam-app % samdev local invoke --runtime python3.11
2025-02-12 15:00:00 Attaching import module proxy for analyzing dynamic imports
No current session found, using default AWS::AccountId                                                                                                                                                        
Invoking app.lambda_handler (python3.13)                                                                                                                                                                      
Local image is up-to-date                                                                                                                                                                                     
Using local image: public.ecr.aws/lambda/python:3.11-rapid-x86_64.                                                                                                                                            
                                                                                                                                                                                                              
Mounting /Users/jonife/Documents/dev/aws-sam-cli/sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated, inside runtime container                                                                
START RequestId: 75413eb4-7d36-4199-a993-218bd461b9fa Version: $LATEST
END RequestId: eea22581-421f-4a43-913d-3a834b71b055
REPORT RequestId: eea22581-421f-4a43-913d-3a834b71b055  Init Duration: 1.58 ms  Duration: 312.49 ms     Billed Duration: 313 ms Memory Size: 128 MB     Max Memory Used: 128 MB
{"statusCode": 200, "body": "{\"message\": \"hello world\"}"}

Test using an incompatible runtime: build artifact was in python3.13 and test runtime was java11.

jonife@80a9972c3483 sam-app % samdev local invoke --runtime java11    
2025-02-12 15:00:46 Attaching import module proxy for analyzing dynamic imports
No current session found, using default AWS::AccountId                                                                                                                                                        
Invoking app.lambda_handler (python3.13)                                                                                                                                                                      
Local image is up-to-date                                                                                                                                                                                     
Using local image: public.ecr.aws/lambda/java:11-rapid-x86_64.                                                                                                                                                
                                                                                                                                                                                                              
Mounting /Users/jonife/Documents/dev/aws-sam-cli/sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated, inside runtime container                                                                
START RequestId: e0af6df0-a576-440c-89fb-2f995f05f39d Version: $LATEST
Class not found: app.lambda_handler: Runtime.ClassNotFound
java.lang.ClassNotFoundException: app.lambda_handler. Current classpath: file:/var/task/

12 Feb 2025 23:00:50,192 [ERROR] (rapid) Init failed InvokeID= error=Runtime exited with error: exit status 1
12 Feb 2025 23:00:50,196 [ERROR] (rapid) Invoke failed InvokeID=f491b398-209c-48c4-8c4c-e71bfed2e388 error=Runtime exited with error: exit status 1
12 Feb 2025 23:00:50,197 [ERROR] (rapid) Invoke DONE failed: Sandbox.Failure
{"errorMessage": "Class not found: app.lambda_handler", "errorType": "Runtime.ClassNotFound"}

Mandatory Checklist

PRs will only be reviewed after checklist is complete

• Add input/output type hints to new functions/methods
• Write design document if needed (Do I need to write a design document?)
• Write/update unit tests
• Write/update integration tests
• Write/update functional tests if needed
• make pr passes
• make update-reproducible-reqs if dependencies were changed
• Write documentation

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

[valerena]

I think we can get a better text here. I would suggest:

Lambda runtime used to invoke the function.

(in particular "function" instead of "application")

[mbfreder]

Updated.