Makefile

#!/usr/bin/make
# Makefile readme (ru): <http://linux.yaroslavl.ru/docs/prog/gnu_make_3-79_russian_manual.html>
# Makefile readme (en): <https://www.gnu.org/software/make/manual/html_node/index.html#SEC_Contents>

SHELL = /bin/bash
DC_RUN_ARGS = --rm --user "$(shell id -u):$(shell id -g)"

.PHONY : help install shell migrate test test-cover up down restart logs clean
.SILENT : help install up down shell
.DEFAULT_GOAL : help

# This will output the help for each task. thanks to https://marmelab.com/blog/2016/02/29/auto-documented-makefile.html
help: ## Show this help
	@printf "\033[33m%s:\033[0m\n" 'Available commands'
	@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf "  \033[32m%-18s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)

install: ## Install all app dependencies
	docker-compose run $(DC_RUN_ARGS) --no-deps app composer install --ansi --prefer-dist

shell: ## Start shell into app container
	docker-compose run $(DC_RUN_ARGS) app sh

migrate: ## Migrate application database and generate seeds
	docker-compose run $(DC_RUN_ARGS) app ./artisan migrate --force --seed

test: ## Execute app tests
	docker-compose run $(DC_RUN_ARGS) app composer test

test-cover: ## Execute app tests with coverage
	docker-compose run --rm --user "0:0" -e 'XDEBUG_MODE=coverage' app sh -c '\
		apk --no-cache add autoconf make g++ && pecl install xdebug-3.0.0 && docker-php-ext-enable xdebug \
		&& su $(shell whoami) -s /bin/sh -c "composer phpunit-cover"'

up: ## Create and start containers
	docker-compose up --detach
	@printf "\n   \e[30;42m %s \033[0m\n\n" 'Navigate your browser to ⇒ <http://127.0.0.1:4001>';

down: ## Stop and remove containers, networks, images, and volumes
	docker-compose down -t 5

restart: down up ## Restart all containers

logs: ## Show docker logs
	docker-compose logs --follow

clean: ## Make some clean
	-docker-compose run $(DC_RUN_ARGS) --no-deps app composer clear
	docker-compose down -v -t 5