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