Introduce AutoPublishCodeSha256 to allow overriding the publish versi…

[jmnarloch]

Issue #, if available: #1375

Description of changes: The change introduces additional attribute to AWS::Serverless::Function that allow to override the hash computed for the created Lambda version. To allow more fine grained control this change adds a AutoPublishCodeSha256 attribute that will allow to associate it in the template.

Example:

Resources:
  MinimalFunction:
    Type: 'AWS::Serverless::Function'
    Properties:
      CodeUri: s3://sam-demo-bucket/hello.zip
      Handler: hello.handler
      Runtime: python2.7
      AutoPublishAlias: live
      AutoPublishCodeSha256: 6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b
      VersionDescription: sam-testing

Description of how you validated changes: Added unit tests to cover this feature.

Checklist:

• Write/update tests
• make pr passes
• Update documentation
• Verify transformed template deploys and application functions as expected
• Add/update example to examples/2016-10-31

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

[codecov-io]

Codecov Report

Merging #1376 into develop will increase coverage by <.01%.
The diff coverage is 100%.

@@             Coverage Diff             @@
##           develop    #1376      +/-   ##
===========================================
+ Coverage    94.46%   94.47%   +<.01%     
===========================================
  Files           78       78              
  Lines         4555     4559       +4     
  Branches       912      913       +1     
===========================================
+ Hits          4303     4307       +4     
  Misses         118      118              
  Partials       134      134

Impacted Files	Coverage Δ
samtranslator/translator/logical_id_generator.py	90.9% <100%> (+0.9%)	⬆️
samtranslator/model/sam_resources.py	94% <100%> (+0.01%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update eabe27d...eca5538. Read the comment docs.

[praneetap]

nit: Just is_str() instead of one_of(is_str())

[brightsparc]

Thanks @praneetap this AutoPublishCodeSha256 looks really useful. I'm looking to test this out but am getting an error when calling aws cloudformation deploy

 Reason: Transform AWS::Serverless-2016-10-31 failed with: Internal transform failure.

Is this live and ready for testing yet, or is there a new transform that is required to support this?

Also does the value passed to AutoPublishCodeSha256 have to be a valid Sha256 hash or could it be a uuid or similar?

[brightsparc]

Thanks @praneetap this AutoPublishCodeSha256 looks really useful. I'm looking to test this out but am getting an error when calling aws cloudformation deploy

This issue was related to passing in a AutoPublishCodeSha256 by Ref which is currently not supported.