Serverless Utility Functions

This package several utility functions to Serverless.

CloudFormation Functions

ref(resource)

This function returns the provided resource wrapped in a Ref-object. This makes specifying a Ref more convenient in the context of variable chains.

Example usages:

provider:
  environment:
    BUCKET: ${env:BUCKET, ref(DataBucket)}
    DYNAMO_DB_TABLE: ${cf:${provider.stackName}.Table, ref(Table)}
    SECRET: ${ref(Secret)}

hash(type, string)

Calculate the hash of the specified type for the specified string. Supports any hash that works with the builtin crypto module.

Example usage:

custom:
  hash: ${hash(sha256, 'your-string')} 

filehash(type, path)

Calculate the hash of the specified type for the specified file. Supports any hash that works with the builtin crypto module. Non-existing files result in a null value, which allows chaining.

Example usage:

custom:
  lastDeployedFrontend: ${filehash(sha256, public/manifest.json)}

globhash(type, glob)

Calculate the hash of the specified type for the specified files. Supports any hash that works with the builtin crypto module. If the glob results in an empty set, this will result in a null value, which allows chaining.

Example usage:

custom:
  migrationVersion: ${globhash(sha256, migrations/*)} 

fileIf(condition, file) & fileUnless(condition, file)

Both functions take a condition that will be passed to strToBool if it's a string. If the condition check passes, the builtin file function will be invoked with the specified file and optional address. If the condition check doesn't pass, an empty object is returned or null in case an address was given.

Example usage:

functions:
  - ${fileIf(${param:debug}, functions/debug.yml)}

provider:
  runtime: ${fileIf(${param:experimental}, variables.yml):NEW_RUNTIME, 'python3.9'}