Makefile

# preamable as per https://tech.davis-hansson.com/p/make/, minus RECIPEPREFIX
SHELL := bash
#.ONESHELL:
.SHELLFLAGS := -eu -o pipefail -c
.DELETE_ON_ERROR:
MAKEFLAGS += --warn-undefined-variables
MAKEFLAGS += --no-builtin-rules

VERSION_ROSSGRAMBO := 1.0.15
VERSION_SWAGGER_CODEGEN := v3.0.15

DIR_BUILD_SWAGGER_CODEGEN := build-swagger_codegen/

CMD_GIT_CLONE := git clone --quiet
CMD_NPM_INSTALL := npm install --no-progress
CMD_SWAGGER_CLI := swagger-codegen-cli.jar

FILE_CODEZ_API_OAS := $(realpath $(OPENAPI_DIR)/dist/public_asana_oas.yaml)
FILE_CODEZ_APP_COMPONENTS_OAS := $(realpath $(OPENAPI_DIR)/app_components_oas.yaml)
FILE_SOURCE_UI_HOOKS_REFERENCE := source/includes/app-components-reference/_index.html.md
FILE_SOURCE_API_REFERENCE := source/includes/api-reference/_index.html.md
FILE_SOURCE_CHANGELOG := source/includes/markdown/_news-and-changelog-1.html.md

ALL_CLIENT_LANGS := ruby java node php python
ALL_CLIENT_LIBS := $(addsuffix /,$(addprefix build-client_libs/,$(ALL_CLIENT_LANGS)))
ALL_CLIENT_SWAGGER_CONFIGS := $(addprefix build-client_libs/,$(ALL_CLIENT_LIBS))
ALL_OAS_YAML := defs/asana_oas.yaml defs/app_components_oas.yaml
ALL_SAMPLES := $(subst client_libs,client_libs_with_samples,$(ALL_CLIENT_LIBS)) build-api_explorer/src/resources/gen/

.PHONY: clean clean_client_libs all;

clean: clean_client_libs
	-rm -rf build*

clean_client_libs:
	-rm -rf build-client_libs*

all: \
	$(FILE_SOURCE_API_REFERENCE) \
	$(FILE_SOURCE_UI_HOOKS_REFERENCE) \
	$(FILE_SOURCE_CHANGELOG) \
	;

.DEFAULT_GOAL := all

$(CMD_SWAGGER_CLI): ;

build-widdershins/:
	rm -rf '$@'
	# $(CMD_GIT_CLONE) git@github.com:Mermade/widdershins.git '$@'
	$(CMD_GIT_CLONE) git@github.com:Asana/widdershins.git '$@'
	cd '$@' && asdf exec $(CMD_NPM_INSTALL)

build-client_libs/:
	mkdir build-client_libs

$(ALL_CLIENT_LIBS): | build-client_libs/
	rm -rf 'build-client_libs/$(notdir $@)'
	$(CMD_GIT_CLONE) 'git@github.com:Asana/$(notdir $@)-asana.git' 'build-client_libs/$(notdir $@)'

ALL_YAML_DEPS := $(shell find '$(OPENAPI_DIR)')

$(ALL_OAS_YAML): $(ALL_YAML_DEPS)
	cd '$(OPENAPI_DIR)' && \
		bash -l -c 'python build.py'
	cp '$(FILE_CODEZ_API_OAS)' defs/asana_oas.yaml
	cp '$(FILE_CODEZ_APP_COMPONENTS_OAS)' defs/app_components_oas.yaml

build-client_libs_with_samples/:
	mkdir build-client_libs_with_samples

build-client_libs_with_samples/%/: build-client_libs/%/ $(CMD_SWAGGER_CLI) | build-client_libs_with_samples/
	rm -rf '$@'
	cp -r '$<' '$@'
	cd '$@' && \
		java -jar '$(realpath $(CMD_SWAGGER_CLI))' \
		generate \
		--input-spec '$(realpath defs/asana_oas.yaml)' \
		--template-dir 'swagger_templates' \
		--lang 'asana-$(shell basename '$@')' \
		--config 'swagger_templates/$(shell basename '$@')-config.json' \
		-Dapis

build-api_explorer/: | build-client_libs/
	$(CMD_GIT_CLONE) git@github.com:Asana/api-explorer.git '$@'

build-api_explorer/src/resources/gen: build-api_explorer/ $(CMD_SWAGGER_CLI)
	# swagger's cli does not actually seem to respect the `--output` flag and so
	# we have to cd into the client lib dir and do work there
	cd 'build-api_explorer' && \
		java -jar '$(realpath $(CMD_SWAGGER_CLI))' \
		generate \
		--input-spec '$(realpath defs/asana_oas.yaml)' \
		--lang asana-api-explorer \
		--config swagger_templates/api-explorer-config.json \
		-Dapis

ALL_SERVE_DEPENDENCIES := \
													Makefile \
													build-widdershins \
													replace_code_samples.js \
													$(wildcard source/templates/*) \
													$(ALL_SAMPLES)

$(FILE_SOURCE_UI_HOOKS_REFERENCE): defs/app_components_oas.yaml pui_widdershins_config.json $(ALL_SERVE_DEPENDENCIES)
	$(CMD_NPM_INSTALL)
	node build-widdershins/widdershins.js \
		-e pui_widdershins_config.json \
		--summary defs/app_components_oas.yaml \
		-o '$@'

$(FILE_SOURCE_API_REFERENCE): defs/asana_oas.yaml widdershins_config.json $(ALL_SERVE_DEPENDENCIES)
	$(CMD_NPM_INSTALL)
	node build-widdershins/widdershins.js \
		-e widdershins_config.json \
		--summary defs/asana_oas.yaml \
		-o '$@'
	node replace_code_samples.js '$@'

$(FILE_SOURCE_CHANGELOG): pull_forum_updates.js
	$(CMD_NPM_INSTALL)
	node pull_forum_updates.js