Makefile

###
### Hi, this is the big fat `Makefile` of the Server-side TodoMVC project.
###
### General design is that we can `build` and `test`. Building is supposed
### to create a packaged artifact, that can be run using some type of web
### server. Testing is aimed at asserting or validating the completeness of
### a built example, by running some high level web-test on it.
###
### Also, my Makefile-foo is not so strong, so bare with me. Any improvements
### are welcome.
###
.PHONY: help setup all build clean test run-test

## Helper target that displays some information.
help:
	@echo "\n Hi, I'm make! I'll make things for you.\n"
	@echo "    'make setup' will help you install the tools you need for development."
	@echo "    'make all' will build and test all the examples in the project."
	@echo "\n Bye, happy hacking!\n"

## Setup target, helping out with the installation of some tools.
setup: which-node which-npm check run-setup

which-%:
	@echo -n '--> Checking if $* is installed... '
	@(which $* > /dev/null && echo '[OK]') || (echo '[MISSING]'; exit 1)

##
## All examples must support the targets `build`, `test` and `clean`.
##
##   `build` - assumes the example is complied, unit tested, packaged and - for
##             that specific language or framework - prepared in such a way that
##             it can be locally run, serving the web app.
##
##   `test`  - will expect the example to start the web app, allow for end to
##             end tests to be run, and then stop the app again.
##
##   `clean` - assumes the example removes any temporarily built artefacts, and
##             ensures the project is source-only, if possible.
##
check build test clean:
	@$(MAKE) -C examples-golang-native $@
	@$(MAKE) -C examples-java-native $@
	@$(MAKE) -C examples-java-ninjaframework $@
	@$(MAKE) -C examples-java-servlet $@
	@$(MAKE) -C examples-java-spark-mustache $@
	@$(MAKE) -C examples-java-spring-boot-freemarker $@
	@$(MAKE) -C examples-java-spring-boot-mustache $@
	@$(MAKE) -C examples-java-wicket $@
	@$(MAKE) -C examples-kotlin-simple $@
	@$(MAKE) -C examples-php-vanilla $@
	@$(MAKE) -C examples-python-flask $@
	@echo '----------------------------------------------------------------------'

run-setup:
	@echo " Everyting seems to be in order."
##	@echo " Let's see if you have Node.js and npm installed?"
##	@which npm || (echo " Ouch, too bad. Start by installing that first please."; exit 1)
##	@echo " Oh, great."
##	@echo "\n Now let's make sure everything is installed properly...\n"
##	@npm install
##	@echo "\nVery good!\n All done. Now move along!\n"

## Build __all__ the examples!
all: build

## Executes the acceptance tests, assuming a correct ${URL} is set
run-test:
	@npm test -s