Skip to content

Latest commit

 

History

History
83 lines (60 loc) · 1.59 KB

README.md

File metadata and controls

83 lines (60 loc) · 1.59 KB
Raw

Easy Mojo

A small example of Mojolicious power.

List of features

  • A fully working skeleton of web service
  • RESTful actions
  • Simple creation and configuration of new resources
  • Easily create custom actions
  • Resources based on various databases and other webservices
  • Content negotiation (supported response formats: JSON, YAML, CSV, HTML, XLS, XLSX, text)
  • Database migrations
  • Dockerizing everything

Prepare environment

bin/docker.sh --help

bin/docker.sh --build

Run Easy Mojo as a service

Interactive mode for development:

bin/docker.sh --start -i

You can control specific behaviors:

  • creating databases (env variable MOJO_DB_CREATE to 1 or 0 - by default)
  • running migrations (env variable MOJO_DB_MIGRATIONS to 1 or 0 - by default)
  • operating mode (env variable MOJO_ENV to prod, test, dev - by default)

All of these env variables are set in the docker-compose.yml

Setting the dev or test mode will start Morbo. Other modes will start the Hypnotoad server.

At the beginning:

MOJO_DB_CREATE=1 MOJO_DB_MIGRATIONS=1 bin/docker.sh --start -i

Run specific commands

Run BASH console inside the easy_mojo container:

bin/emojo

Prepare and run all unit tests

In other console:

bin/emojo
make test

After this first run you can run tests multiple times:

make test_run

Also you can run test code coverage:

make test_cc

All code coverage results are in a db_test/cover_db folder.

In daily work, e.g:

bin/emojo
MOJO_TEST_EXIT=1 perl t/App/Controller/REST/V1/Bar.pm.t

Author

Paweł Kościelny