# step-functions-tester

> Write unit tests for your [aws step functions](https://aws.amazon.com/step-functions/?step-functions.sort-by=item.additionalFields.postDateTime&step-functions.sort-order=desc).

Latest version **0.0.5** (published 2021-07-17) · MIT license · 0 weekly downloads

## Install

```sh
npm install step-functions-tester
pnpm add step-functions-tester
yarn add step-functions-tester
bun add step-functions-tester
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.5 |
| Published | 2021-07-17 |
| First published | 2021-03-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 6 |
| Unpacked size | 82 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| Maintainers | furstenheim |

## Links

- npm: https://www.npmjs.com/package/step-functions-tester
- npm.io page: https://npm.io/package/step-functions-tester

## Dependencies (6)

- [debug](https://npm.io/package/debug.md) ^4.3.1
- [redis](https://npm.io/package/redis.md) ^3.0.2
- [dedent](https://npm.io/package/dedent.md) ^0.7.0
- [lodash](https://npm.io/package/lodash.md) ^4.17.20
- [aws-sdk](https://npm.io/package/aws-sdk.md) ^2.848.0
- [docker-compose](https://npm.io/package/docker-compose.md) ^0.23.6

## Recent versions

- 0.0.5 (latest) — 2021-07-17
- 0.0.4 — 2021-07-17
- 0.0.3 — 2021-03-17
- 0.0.2 — 2021-03-04
- 0.0.1 — 2021-03-04

## README

# step-functions-tester

Write unit tests for your [aws step functions](https://aws.amazon.com/step-functions/?step-functions.sort-by=item.additionalFields.postDateTime&step-functions.sort-order=desc).

![step-function-sample](./step-function-sample.png)

## Installation

```
yarn add step-functions-tester
```

## Usage
With mocha:

```javascript 1.8
const TestRunner = require('step-functions-tester')
const { expect } = require('chai')
let testRunner
describe('Step function tester', function () {
  this.timeout('30s')

  before('Set up test runner', async function () {
    testRunner = new TestRunner()
    await testRunner.setUp()
  })
  afterEach('Clean up', async function () {
    await testRunner.cleanUp()
  })
  after('Tear down', async function () {
    await testRunner.tearDown()
  })

  it('Step function test', async function () {
    // AWS Step Function definition
    const stepFunctionDefinition = {StartAt: 'FirstStep', States: {FirstStep: { /* ... */}}}

    const stepFunctionInput = {}

    // Keys are function names in the step function definition, values are arrays of calls
    const callStubs = {'arn:eu-west:111:mockLambda': [{result: 'First call result'}, {result: 'Second call result'}], 'arn:eu-west:111:mockLambda2': [{exception: {type: 'MyError', message: 'Some exception'}}]/*... */}
    
    const { executions } = await testRunner.run(callStubs, stepFunctionDefinition, stepFunctionInput)
    expect(executions).deep.equal(expectedExecutions)
  })
})
```

## Why?
Short answer: infra is code and code should be tested.

Long answer: current AWS response is to write integration tests. However, it is often complicated to write integration tests for the error paths. Additionally, step functions are conceived to perform long running tasks. For example, to check an external resource every hour. We don't want to wait 4 hours to test what happens if the process always fails. This library allows to run tests on step functions where everything external to the step function is mocked.

## I want to use this, but my step function is defined inside a yaml file
Use [yaml-cfn](https://www.npmjs.com/package/yaml-cfn)

```
yarn add yaml-cfn
```

```javascript 1.8
const parser = require('yaml-cfn')
const file = fs.readFileSync('yourPath.yml')
const parsedYaml = parser.yamlParse(file.toString())
const definition = parsedYaml.Resources/** Navigate to your definition **/

```

## How is the sausage made?

Amazon exposes a docker image to run step functions locally `amazon/aws-stepfunctions-local` additionally using sam it is possible to run lambdas locally.

We save the stubs for your lambda functions in redis and return those to the current execution from a fake lambda.


## Requirements

```
## important different versions, even patches can make the tester not run
pip3 install 'aws-sam-cli==1.23.0'
pip3 install docker-compose==1.25.4
```

Linux.



## Gotchas
* No current support for parallel.
* Current implementation is quite global and it will run docker on the host network and use default redis port.
* Not currently working on Mac, PRs are welcome

---
_Source: https://npm.io/package/step-functions-tester · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._