Makefile

DC_CI = "bin/docker-compose.sh"
DC = $(shell which docker-compose)
DOCKER = $(shell which docker)
TEST_DOMAIN = www.mozilla.org

all: help

help:
	@echo "Please use \`make <target>' where <target> is one of"
	@echo "  build         - build docker images for dev"
	@echo "  run           - docker-compose up the entire system for dev"
	@echo "  stop          - stop all docker containers"
	@echo "  kill          - kill all docker containers (more forceful than stop)"
	@echo "  pull          - pull the latest production images from Docker Hub"
	@echo "  run-shell     - open a bash shell in a fresh container"
	@echo "  shell         - open a bash shell in the running app"
	@echo "  djshell       - start the Django Python shell in the running app"
	@echo "  fresh-data    - pull the latest database and update all external data"
	@echo "  clean         - remove all build, test, coverage and Python artifacts"
	@echo "  rebuild       - force a rebuild of all of the docker images"
	@echo "  lint          - check style with Flake8, ESlint, Stylelint, and Prettier"
	@echo "  format        - format front-end code using Stylelint and Prettier"
	@echo "  test          - run tests against local files"
	@echo "  test-image    - run tests against files in docker image"
	@echo "  test-cdn      - run CDN tests against TEST_DOMAIN"
	@echo "  docs          - generate Sphinx HTML documentation with server and live reload using Docker"
	@echo "  livedocs      - generate Sphinx HTML documentation with server and live reload"
	@echo "  build-docs    - generate Sphinx HTML documentation using Docker"
	@echo "  build-ci      - build docker images for use in our CI pipeline"
	@echo "  test-ci       - run tests against files in docker image built by CI"

.env:
	@if [ ! -f .env ]; then \
		echo "Copying .env-dist to .env..."; \
		cp .env-dist .env; \
	fi

.docker-build:
	${MAKE} build

.docker-build-pull:
	${MAKE} pull

build: .docker-build-pull
	${DC} build --pull app assets
	touch .docker-build

build-prod: .docker-build-pull
	${DC} build --pull release

pull: .env
	-GIT_COMMIT= ${DC} pull release app assets builder app-base
	touch .docker-build-pull

rebuild: clean build

run: .docker-build-pull
	${DC} up assets app

run-prod: .docker-build-pull
	${DC} up release-local

stop:
	${DC} stop

kill:
	${DC} kill

fresh-data:
	${DC} exec app bin/sync-all.sh

run-shell:
	${DC} run --rm app bash

shell:
	${DC} exec app bash

djshell:
	${DC} exec app python manage.py shell_plus

clean:
#	python related things
	find . -name '*.pyc' -exec rm -f {} +
	find . -name '*.pyo' -exec rm -f {} +
	find . -name '__pycache__' -exec rm -rf {} +
#	test related things
	-rm -f .coverage
#	docs files
	-rm -rf docs/_build/
#	static files
	-rm -rf static_build/
#	state files
	-rm -f .docker-build*
# clean untracked files & directories
	git clean -d -f

lint: .docker-build-pull
	${DC} run test flake8
	${DC} run assets npm run lint

format: .docker-build-pull
	${DC} run assets npm run format
	${DC} run app black .

test: .docker-build-pull
	${DC} run --rm test

test-cdn: .docker-build-pull test_infra/fixtures/tls.json
	${DC} run test py.test --base-url https://${TEST_DOMAIN} test_infra

test-image: .docker-build
	${DC} run test-image

docs: .docker-build-pull
	${DC} up docs

build-docs: .docker-build-pull
	${DC} run app make -C docs/ clean html

livedocs:
	${MAKE} -C docs/ clean livehtml

test_infra/fixtures/tls.json:
	${DOCKER} run -it --rm jumanjiman/ssllabs-scan:latest --quiet https://${TEST_DOMAIN}/en-US/ > "test_infra/fixtures/tls.json"

###############
# For use in CI
###############
.docker-build-ci:
	${MAKE} build-ci

build-ci: .docker-build-pull
	${DC_CI} build --pull release
#	tag intermediate images using cache
	${DC_CI} build app assets builder app-base
	touch .docker-build-ci

test-ci: .docker-build-ci
	${DC_CI} run test-image

.PHONY: all clean build pull docs livedocs build-docs lint run stop kill run-shell shell test test-image rebuild build-ci test-ci fresh-data djshell run-prod build-prod test-cdn