serverless-spy

CDK-based library for writing elegant, fast executing integration tests on AWS serverless architecture and additional web console to monitor events in real-time.

How it works

Add ServerlessSpy construct to your CDK stack, which creates infrastructure to intercept events in Lambda, SNS, SQS, EventBridge, DynamoDB, S3... and send it to a testing library or your local web console via API Gateway websocket. The testing library subscribes to events so tests can be executed fast without checking/retrying if the process has finished. The testing library is integrated with Jest but can also be used with another library. The web console can be used to see and inspect events in real-time.

Key benefits

• Easy to write tests that are strongly typed thanks to TypeScript ❤️.
• Tests are executed much FASTER 🏎️💨 No need to write tests in a way to periodically check if the process has finished because all events are pushed to the testing library.
• Tests can run in parallel if you use conditions and filter events specific to your test. This drastically reduces the execution time of the CI/CD process.
• Web console enables you see all events in real-time during. Debugging 🕵 has never been easier. Search is supported(with regular expression).

What ServerlessSpy is not

• ServerlessSpy can not be used if your infrastructure is not created with CDK.
• The solution is meant for development and (automatic) testing environment only. You should EXCLUDE ServerlessSpy CDK construct in any other environment, especially production or environment with high load. ServerlessSpy is not meant for those; it just induces costs and could contribute to hitting AWS quotas (Lambda concurrent executions, ...).
• Only Node.js stack is supported. There are no plans to support Python or any other. Use of TypeScript is deeply encouraged.
• Web console only runs on your local computer. No cloud hosting of any kind (for now).

Documentation

• Quick Start
• CDK Construct
• Writing tests
  • Lambda
  • SQS
  • SNS
  • EventBridge
  • DynamoDB
  • S3
  • Kinesis (work in progress)
  • Step Functions (work in progress)
• Web Console
• Frequently Asked Questions (FAQ)
• Sample Application
• Roadmap
• Code of Conduct
• Contributing Guide