You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
148 lines
8.2 KiB
148 lines
8.2 KiB
#
|
|
# DMBS Build System
|
|
# Released into the public domain.
|
|
#
|
|
# dean [at] fourwalledcubicle [dot] com
|
|
# www.fourwalledcubicle.com
|
|
#
|
|
|
|
DMBS_BUILD_MODULES += CORE
|
|
DMBS_BUILD_TARGETS += help list_targets list_modules list_mandatory list_optional list_provided list_macros
|
|
DMBS_BUILD_MANDATORY_VARS +=
|
|
DMBS_BUILD_OPTIONAL_VARS +=
|
|
DMBS_BUILD_PROVIDED_VARS += DMBS_VERSION
|
|
DMBS_BUILD_PROVIDED_MACROS += DMBS_CHECK_VERSION ERROR_IF_UNSET ERROR_IF_EMPTY ERROR_IF_NONBOOL
|
|
|
|
SHELL = /bin/sh
|
|
|
|
# Current DMBS release version
|
|
DMBS_VERSION := 20170426
|
|
|
|
# Macro to check the DMBS version, aborts if the given DMBS version is below the current version
|
|
DMBS_CHECK_VERSION ?= $(if $(filter-out 0, $(shell test $(DMBS_VERSION) -lt $(1); echo $$?)), , $(error DMBS version $(1) or newer required, current version is $(DMBS_VERSION)))
|
|
|
|
# Macros to use in other modules to check various conditions
|
|
ERROR_IF_UNSET ?= $(if $(filter undefined, $(origin $(strip $(1)))), $(error Makefile $(strip $(1)) value not set))
|
|
ERROR_IF_EMPTY ?= $(if $(strip $($(strip $(1)))), , $(error Makefile $(strip $(1)) option cannot be blank))
|
|
ERROR_IF_NONBOOL ?= $(if $(filter Y N, $($(strip $(1)))), , $(error Makefile $(strip $(1)) option must be Y or N))
|
|
|
|
# Converts a given input to a printable output using "(None)" if no items are in the list
|
|
CONVERT_TO_PRINTABLE = $(if $(strip $(1)), $(1), (None))
|
|
|
|
# Build sorted and filtered lists of the included build module data
|
|
SORTED_DMBS_BUILD_MODULES = $(sort $(DMBS_BUILD_MODULES))
|
|
SORTED_DMBS_BUILD_TARGETS = $(sort $(DMBS_BUILD_TARGETS))
|
|
SORTED_DMBS_MANDATORY_VARS = $(sort $(DMBS_BUILD_MANDATORY_VARS))
|
|
SORTED_DMBS_OPTIONAL_VARS = $(filter-out $(SORTED_DMBS_MANDATORY_VARS), $(sort $(DMBS_BUILD_OPTIONAL_VARS)))
|
|
SORTED_DMBS_PROVIDED_VARS = $(sort $(DMBS_BUILD_PROVIDED_VARS))
|
|
SORTED_DMBS_PROVIDED_MACROS = $(sort $(DMBS_BUILD_PROVIDED_MACROS))
|
|
|
|
# Create printable versions of the sorted build module data (use "(None)" when no data is available)
|
|
PRINTABLE_DMBS_BUILD_MODULES = $(call CONVERT_TO_PRINTABLE, $(SORTED_DMBS_BUILD_MODULES))
|
|
PRINTABLE_DMBS_BUILD_TARGETS = $(call CONVERT_TO_PRINTABLE, $(SORTED_DMBS_BUILD_TARGETS))
|
|
PRINTABLE_DMBS_MANDATORY_VARS = $(call CONVERT_TO_PRINTABLE, $(SORTED_DMBS_MANDATORY_VARS))
|
|
PRINTABLE_DMBS_OPTIONAL_VARS = $(call CONVERT_TO_PRINTABLE, $(SORTED_DMBS_OPTIONAL_VARS))
|
|
PRINTABLE_DMBS_PROVIDED_VARS = $(call CONVERT_TO_PRINTABLE, $(SORTED_DMBS_PROVIDED_VARS))
|
|
PRINTABLE_DMBS_PROVIDED_MACROS = $(call CONVERT_TO_PRINTABLE, $(SORTED_DMBS_PROVIDED_MACROS))
|
|
|
|
help:
|
|
@echo "==================================================================="
|
|
@echo " The DMBS Build System "
|
|
@echo " By Dean Camera { dean @ fourwalledcubicle . com } "
|
|
@echo "==================================================================="
|
|
@echo "DESCRIPTION: "
|
|
@echo " This build system is a set of makefile modules for (GNU) Make, to "
|
|
@echo " provide a simple system for building DMBS powered applications. "
|
|
@echo " Each makefile module can be included from within a user makefile, "
|
|
@echo " to expose the build rules documented in the comments at the top of"
|
|
@echo " each build module. "
|
|
@echo " "
|
|
@echo "USAGE: "
|
|
@echo " To execute a rule, define all variables indicated in the desired "
|
|
@echo " module as a required parameter before including the build module "
|
|
@echo " in your project makefile. Parameters marked as optional will "
|
|
@echo " assume a default value in the modules if not user-assigned. "
|
|
@echo " "
|
|
@echo " By default the target output shows both a friendly summary, as "
|
|
@echo " well as the actual invoked command. To suppress the output of the "
|
|
@echo " invoked commands and show only the friendly command output, run "
|
|
@echo " make with the \"-s\" switch added before the target(s). "
|
|
@echo "==================================================================="
|
|
@echo " "
|
|
@echo " Currently used build system modules in this application: "
|
|
@echo " "
|
|
@printf " %b" "$(PRINTABLE_DMBS_BUILD_MODULES:%= - %\n)"
|
|
@echo " "
|
|
@echo " "
|
|
@echo " Currently available build targets in this application: "
|
|
@echo " "
|
|
@printf " %b" "$(PRINTABLE_DMBS_BUILD_TARGETS:%= - %\n)"
|
|
@echo " "
|
|
@echo " "
|
|
@echo " Mandatory variables required by the selected build Modules: "
|
|
@echo " "
|
|
@printf " %b" "$(PRINTABLE_DMBS_MANDATORY_VARS:%= - %\n)"
|
|
@echo " "
|
|
@echo " "
|
|
@echo " Optional variables required by the selected build Modules: "
|
|
@echo " "
|
|
@printf " %b" "$(PRINTABLE_DMBS_OPTIONAL_VARS:%= - %\n)"
|
|
@echo " "
|
|
@echo " "
|
|
@echo " Variables provided by the selected build Modules: "
|
|
@echo " "
|
|
@printf " %b" "$(PRINTABLE_DMBS_PROVIDED_VARS:%= - %\n)"
|
|
@echo " "
|
|
@echo " "
|
|
@echo " Macros provided by the selected build Modules: "
|
|
@echo " "
|
|
@printf " %b" "$(PRINTABLE_DMBS_PROVIDED_MACROS:%= - %\n)"
|
|
@echo " "
|
|
@echo "==================================================================="
|
|
@echo " The DMBS Build System $(DMBS_VERSION) - Making MAKE easier."
|
|
@echo "==================================================================="
|
|
|
|
# Lists build modules included by the project makefile, in alphabetical order
|
|
list_modules:
|
|
@echo Currently Used Build System Modules:
|
|
@printf " %b" "$(PRINTABLE_DMBS_BUILD_MODULES:%= - %\n)"
|
|
|
|
# Lists build targets included by the project makefile, in alphabetical order
|
|
list_targets:
|
|
@echo Currently Available Build Targets:
|
|
@printf " %b" "$(PRINTABLE_DMBS_BUILD_TARGETS:%= - %\n)"
|
|
|
|
# Lists mandatory variables that must be set by the project makefile, in alphabetical order
|
|
list_mandatory:
|
|
@echo Mandatory Variables for Included Modules:
|
|
@printf " %b" "$(PRINTABLE_DMBS_MANDATORY_VARS:%= - %\n)"
|
|
|
|
# Lists optional variables that must be set by the project makefile, in alphabetical order
|
|
list_optional:
|
|
@echo Optional Variables for Included Modules:
|
|
@printf " %b" "$(PRINTABLE_DMBS_OPTIONAL_VARS:%= - %\n)"
|
|
|
|
# Lists variables provided by the included build modules, in alphabetical order
|
|
list_provided:
|
|
@echo Variables Provided by the Included Modules:
|
|
@printf " %b" "$(PRINTABLE_DMBS_PROVIDED_VARS:%= - %\n)"
|
|
|
|
# Lists macros provided by the included build modules, in alphabetical order
|
|
list_macros:
|
|
@echo Macros Provided by the Included Modules:
|
|
@printf " %b" "$(PRINTABLE_DMBS_PROVIDED_MACROS:%= - %\n)"
|
|
|
|
# Debugging; "make print-VARNAME" will output the variable VARNAME's value
|
|
print-%:
|
|
@printf "%s = %s" $(@:print-%=%) $($(@:print-%=%))
|
|
|
|
# Disable default in-built make rules (those that are needed are explicitly
|
|
# defined, and doing so has performance benefits when recursively building)
|
|
ifeq ($(filter -r,$(MAKEFLAGS)),)
|
|
MAKEFLAGS += -r
|
|
endif
|
|
.SUFFIXES:
|
|
|
|
# Phony build targets for this module
|
|
.PHONY: $(DMBS_BUILD_TARGETS)
|