ascode/Makefile

BASE_PATH := $(realpath -s $(dir $(abspath $(firstword $(MAKEFILE_LIST)))))

# Documentation
OUTLINE_CMD ?= outline
DOCUMENTATION_PATH ?= $(BASE_PATH)/_documentation
DOCUMENTATION_REFERENCE_PATH ?= $(DOCUMENTATION_PATH)/reference
DOCUMENTATION_REFERENCE_TEMPLATE ?= $(DOCUMENTATION_REFERENCE_PATH)/reference.md.tmpl
DOCUMENTATION_INLINE_EXAMPLES_PATH ?= starlark/types/testdata/examples

RUNTIME_MODULES = \
	github.com/mcuadros/ascode/starlark/module/docker \
	github.com/mcuadros/ascode/starlark/module/os \
	github.com/mcuadros/ascode/starlark/types \
	github.com/mcuadros/ascode/starlark/module/filepath \
	github.com/mcuadros/ascode/starlark/module/url \
	github.com/qri-io/starlib/encoding/base64 \
	github.com/qri-io/starlib/encoding/csv \
	github.com/qri-io/starlib/encoding/json \
	github.com/qri-io/starlib/encoding/yaml \
	github.com/qri-io/starlib/re \
	github.com/qri-io/starlib/time \
	github.com/qri-io/starlib/math \
	github.com/qri-io/starlib/http

QUERY_GO_MOD_CMD = go run _scripts/query-go-mod.go
STARLIB_PKG ?= github.com/qri-io/starlib
STARLIB_COMMIT ?= $(shell $(QUERY_GO_MOD_CMD) . $(STARLIB_PKG))
STARLIB_PKG_LOCATION = $(GOPATH)/src/$(STARLIB_PKG)

# Examples
EXAMPLE_TO_MD_CMD = go run _scripts/example-to-md.go
EXAMPLES = functions.star runtime.star
EXAMPLES_PATH = $(BASE_PATH)/_examples
DOCUMENTATION_EXAMPLES_PATH = $(DOCUMENTATION_PATH)/example

# Build Info 
GO_LDFLAGS_CMD = go run _scripts/goldflags.go
GO_LDFLAGS_PACKAGE = cmd
GO_LDFLAGS_PACKAGES = \
 	starlarkVersion=go.starlark.net \
	starlibVersion=github.com/qri-io/starlib \
	terraformVersion=github.com/hashicorp/terraform

GITHUB_REF ?= $(shell cat .git/HEAD | cut -d \  -f 2)
GIT_REF = $(GITHUB_REF)
GIT_REF_SHORT = $(shell echo $(GIT_REF) | cut -d / -f 3)

# Site
HUGO_SITE_PATH ?= $(BASE_PATH)/_site
HUGO_SITE_CONTENT_PATH ?= $(HUGO_SITE_PATH)/content
HUGO_SITE_TEMPLATE_PATH ?= $(HUGO_SITE_PATH)/themes/hugo-ascode-theme
HUGO_THEME_URL ?= https://github.com/mcuadros/hugo-ascode-theme
HUGO_PARAMS_VERSION ?= $(GIT_REF_SHORT)
export HUGO_PARAMS_VERSION

# Rules
.PHONY: documentation clean hugo-server hugo-build goldflags examples

documentation: $(RUNTIME_MODULES)
$(RUNTIME_MODULES): $(DOCUMENTATION_RUNTIME_PATH) $(STARLIB_PKG_LOCATION)
	$(OUTLINE_CMD) package \
		-t $(DOCUMENTATION_REFERENCE_TEMPLATE) \
		-d $(DOCUMENTATION_INLINE_EXAMPLES_PATH) \
		$@ \
		> $(DOCUMENTATION_REFERENCE_PATH)/`basename $@`.md

$(DOCUMENTATION_REFERENCE_PATH):
	mkdir -p $@

$(STARLIB_PKG_LOCATION):
	git clone https://$(STARLIB_PKG) $@; \
	cd $@; \
	git checkout $(STARLIB_COMMIT); \
	cd $(BASE_PATH);

examples: $(EXAMPLES)

$(EXAMPLES):
	$(EXAMPLE_TO_MD_CMD) \
		$(EXAMPLES_PATH)/$@ $(shell ls -1 $(DOCUMENTATION_EXAMPLES_PATH) | wc -l) \
		> $(DOCUMENTATION_EXAMPLES_PATH)/$@.md

goldflags:
	@$(GO_LDFLAGS_CMD) $(GO_LDFLAGS_PACKAGE) . $(GO_LDFLAGS_PACKAGES)

hugo-build: $(HUGO_SITE_PATH) documentation examples
	hugo --minify --source $(HUGO_SITE_PATH) --config $(DOCUMENTATION_PATH)/config.toml

hugo-server: $(HUGO_SITE_PATH) documentation examples
	hugo server --source $(HUGO_SITE_PATH) --config $(DOCUMENTATION_PATH)/config.toml

$(HUGO_SITE_PATH): $(HUGO_SITE_TEMPLATE_PATH)
	mkdir -p $@ \
	mkdir -p $(HUGO_SITE_CONTENT_PATH)
	mkdir -p $(HUGO_SITE_TEMPLATE_PATH)
	ln -s $(DOCUMENTATION_PATH) $(HUGO_SITE_CONTENT_PATH)/docs
	ln -s $(DOCUMENTATION_PATH)/_home.md $(HUGO_SITE_CONTENT_PATH)/_index.md


$(HUGO_SITE_TEMPLATE_PATH):
	git clone $(HUGO_THEME_URL) $(HUGO_SITE_TEMPLATE_PATH)

clean:
	rm -rf $(HUGO_SITE_PATH)