RS School REST service

Prerequisites

Downloading

git clone {repository URL}

Installing NPM modules

npm install

Running application

npm start

Docker

To run all services use docker-compose up, to run it in background, use -d flag

Services:

  • postgresql 13.3-alpine on standard port
  • pgadmin 4.5.3 on port 5050
  • express on port 4000

To run cli commands, first make sure containers are running and use following command docker exec -it <container_name> /bin/sh <command>

After starting the app on port (4000 as default) you can open in your browser OpenAPI documentation by typing http://localhost:4000/doc/. For more information about OpenAPI/Swagger please visit https://swagger.io/.

Testing

After application running open new terminal and enter:

To run all tests without authorization

npm test

To run only one of all test suites (users, boards or tasks)

npm test <suite name>

To run all test with authorization

npm run test:auth

To run only specific test suite with authorization (users, boards or tasks)

npm run test:auth <suite name>

Development

If you're using VSCode, you can get a better developer experience from integration with ESLint and Prettier extensions.

Auto-fix and format

npm run lint

Debugging in VSCode

Press F5 to debug.

For more information, visit: https://code.visualstudio.com/docs/editor/debugging