https://github.com/erickwendel/testing-serverless-apps

Code samples of how to make unit and e2e tests in serverless applications
https://github.com/erickwendel/testing-serverless-apps

aws aws-lambda aws-s3 continuous-integration debugging docker e2e-testing github-actions javascript jest localstack nodejs serverless serverless-framework unit-testing vscode

Last synced: 2 days ago
JSON representation

Code samples of how to make unit and e2e tests in serverless applications

• Host: GitHub
• URL: https://github.com/erickwendel/testing-serverless-apps
• Owner: ErickWendel
• Created: 2024-03-18T23:35:35.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-03-24T23:44:46.000Z (8 months ago)
• Last Synced: 2024-04-15T04:12:30.435Z (7 months ago)
• Topics: aws, aws-lambda, aws-s3, continuous-integration, debugging, docker, e2e-testing, github-actions, javascript, jest, localstack, nodejs, serverless, serverless-framework, unit-testing, vscode
• Language: JavaScript
• Homepage: https://youtu.be/rwyhw9UYHkA
• Size: 327 KB
• Stars: 62
• Watchers: 2
• Forks: 12
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Example of how to run e2e and unit tests on serverless apps using LocalStack and Jest

[![Build Status](https://github.com/ErickWendel/testing-serverless-apps/workflows/Docker%20Actions/badge.svg)](https://github.com/ErickWendel/testing-serverless-apps/actions)

Code samples of my video on [testing serverless applications](https://youtu.be/rwyhw9UYHkA). 

It uses **Jest** as test runner, **LocalStack** as a mock server for AWS Services, **serverless framework** to deploy apps on AWS and **GitHub Actions** as continuous integration platform.

Note that it uses **ECMAScript Modules** empowered by **Node.js v20** without any bundlers (NICE).

Leave your star 🌟 in the project 💚

- In the ./tests folder I put two examples: [**e2e**](./test/e2e/listBuckets.test.js) and [**unit**](./test/unit/listBuckets.test.js) tests folder and there you can take a look on how to make those tests. 

- In [./src/factory.js](./src/factory.js) you can take a look on how to configure the **AWS SDK v3** to point it to localStack when in development mode.

  

## Running

![Testando aplicacnes serverless](https://github.com/ErickWendel/testing-serverless-apps/assets/8060102/41ea502b-8d62-4592-9311-91ae1e269113)

### Pre reqs

- Install Docker & Docker-compose

- Install Node.js v20

### Running

- run `docker-compose up -d localstack`

- restore node.js dependencies `npm ci`

- run tests `npm t` or press `F5` on VSCode.