arch-msx/msxbuild
2
0
Fork 0
Code Issues Pull requests 3 Activity Actions

Moved all quoting of docs to print functions.
All checks were successful
Run test asserts / Test-Asserts (push) Successful in 8s
Details

Browse source
This commit is contained in:
Willem Cazander 2024-07-16 19:32:08 +02:00
parent ff16e6b5cb
commit 760ebffb6f
37 changed files with 410 additions and 409 deletions
Download patch file Download diff file Expand all files Collapse all files

56
lib/make/𓃬𓍄𓋹𓀭/mb_flow_proj.mk
View file

@ -1,33 +1,33 @@
MB_PROJ_META_GROUP_ID ?=
$(call mb-make-call,mb-doc-variable,MB_PROJ_META_GROUP_ID,"The project group id.")
$(call mb-make-call,mb-doc-variable,MB_PROJ_META_GROUP_ID,The project group id.)
MB_PROJ_META_ARTIFACT_ID ?=
$(call mb-make-call,mb-doc-variable,MB_PROJ_META_ARTIFACT_ID,"The project artifact id.")
$(call mb-make-call,mb-doc-variable,MB_PROJ_META_ARTIFACT_ID,The project artifact id.)
MB_PROJ_META_VERSION ?=
$(call mb-make-call,mb-doc-variable,MB_PROJ_META_VERSION,"The project version.")
$(call mb-make-call,mb-doc-variable,MB_PROJ_META_VERSION,The project version.)
MB_PROJ_META_NAME ?=
$(call mb-make-call,mb-doc-variable,MB_PROJ_META_NAME,"The project name.")
$(call mb-make-call,mb-doc-variable,MB_PROJ_META_NAME,The project name.)
MB_PROJ_META_DESCRIPTION ?=
$(call mb-make-call,mb-doc-variable,MB_PROJ_META_DESCRIPTION,"The project description.")
$(call mb-make-call,mb-doc-variable,MB_PROJ_META_DESCRIPTION,The project description.)
MB_PROJ_META_WEBSITE ?=
$(call mb-make-call,mb-doc-variable,MB_PROJ_META_WEBSITE,"The project website location.")
$(call mb-make-call,mb-doc-variable,MB_PROJ_META_WEBSITE,The project website location.)
MB_PROJ_PHASE_ALL = @clean @init @prepare @process @compile @link @build @test @package @package-qa @package-deploy @all
$(call mb-make-call,mb-doc-variable-rock,MB_PROJ_PHASE_ALL,"All the phases of an project with flow steps.")
$(call mb-make-call,mb-doc-variable-rock,MB_PROJ_PHASE_ALL,All the phases of an project with flow steps.)
MB_PROJ_FIRE_MODULE_INIT ?=
$(call mb-make-call,mb-doc-variable-flow,MB_PROJ_FIRE_MODULE_INIT,"List of unique module project structure targets.")
$(call mb-make-call,mb-doc-variable-flow,MB_PROJ_FIRE_MODULE_INIT,List of unique module project structure targets.)
MB_PROJ_FIRE_MODULE_RUN ?=
$(call mb-make-call,mb-doc-variable-flow,MB_PROJ_FIRE_MODULE_RUN,"List of unique module project modules run targets.")
$(call mb-make-call,mb-doc-variable-flow,MB_PROJ_FIRE_MODULE_RUN,List of unique module project modules run targets.)
MB_PROJ_FIRE_ASSERT_SUCCESS ?=
$(call mb-make-call,mb-doc-variable-flow,MB_PROJ_FIRE_ASSERT_SUCCESS,"Word count of total asserts successes.")
$(call mb-make-call,mb-doc-variable-flow,MB_PROJ_FIRE_ASSERT_SUCCESS,Word count of total asserts successes.)
define mb-proj-grow-assert-success
@ -35,7 +35,7 @@ $(MB_ᕽᕽᕽ　　　)$(call mb-make-call,mb-make-check-arg1,$(0),$(1))
$(MB_ᕽᕽᕽ　　　)$(call mb-make-call,mb-make-check-value-valid,$(0),$(1),@test @package-qa)
$(MB_ᕽᕽᕽ　　　)$(eval MB_PROJ_FIRE_ASSERT_SUCCESS $(MB_MAKE_APPEND) $(1))
endef
$(call mb-make-call,mb-doc-function-deep,mb-proj-grow-assert-success,"Grow the success counter of assertions.","<phase-id>")
$(call mb-make-call,mb-doc-function-deep,mb-proj-grow-assert-success,Grow the success counter of assertions.,<phase-id>)
define mb-proj-grow-deps-phase
@ -43,7 +43,7 @@ $(MB_ᕽᕽᕽ　　　)$(call mb-make-call,mb-make-check-arg2,$(0),$(1),$(2))
$(MB_ᕽᕽᕽ　　　)$(call mb-make-call,mb-make-check-value-valid,$(0),$(1),$(MB_PROJ_PHASE_ALL))
$(MB_ᕽᕽᕽ　　　)$(eval @$(1)-deps:: $(2))
endef
$(call mb-make-call,mb-doc-function-deep,mb-proj-grow-deps-phase,"Grow the deps of the selected phase.","<phase> <slave-target>")
$(call mb-make-call,mb-doc-function-deep,mb-proj-grow-deps-phase,Grow the deps of the selected phase.,<phase> <slave-target>)
define _mb-proj-flow-step-before
@ -68,7 +68,7 @@ $(3)@clean: $(3)@@clean $(3)@@clean-deps
$(MB_@RECIPE)$$(if $$(wildcard $(1)),$$(call mb-make-call,mb-os-echo-command,$$(MB_I18N_PROJ_DIR_DELETE) $(1)))
$(MB_@RECIPE)$$(if $$(wildcard $(1)),$$(call mb-make-call,mb-os-dir-delete,$(1)))
$(MB_@RECIPE)$$(call mb-make-call,_mb-proj-flow-step-done)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@clean,"Clean's the project build folders.")
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@clean,Clean's the project build folders.)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@clean)
$(3)@@init: $(2)
@ -80,7 +80,7 @@ $(3)@init: $(3)@@init $(3)@@init-deps
$(MB_@RECIPE)$$(if $$(wildcard $(1)),,$$(call mb-make-call,mb-os-echo-command,$$(MB_I18N_PROJ_DIR_CREATE) $(1)))
$(MB_@RECIPE)$$(if $$(wildcard $(1)),,$$(call mb-make-call,mb-os-dir-create,$(1)))
$(MB_@RECIPE)$$(call mb-make-call,_mb-proj-flow-step-done)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@init,"Create the project output folders.")
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@init,Create the project output folders.)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@init)
$(3)@@prepare: $(3)@init
@ -90,7 +90,7 @@ $(3)@@prepare-deps::
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@@prepare-deps)
$(3)@prepare: $(3)@@prepare $(3)@@prepare-deps
$(MB_@RECIPE)$$(call mb-make-call,_mb-proj-flow-step-done)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@prepare,"Prepare sources before processing.")
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@prepare,Prepare sources before processing.)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@prepare)
$(3)@@process: $(3)@prepare
@ -100,7 +100,7 @@ $(3)@@process-deps::
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@@process-deps)
$(3)@process: $(3)@@process $(3)@@process-deps
$(MB_@RECIPE)$$(call mb-make-call,_mb-proj-flow-step-done)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@process,"Process sources before compiling.")
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@process,Process sources before compiling.)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@process)
$(3)@@compile: $(3)@process
@ -110,7 +110,7 @@ $(3)@@compile-deps::
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@@compile-deps)
$(3)@compile: $(3)@@compile $(3)@@compile-deps
$(MB_@RECIPE)$$(call mb-make-call,_mb-proj-flow-step-done)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@compile,"Compiles all project sources.")
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@compile,Compiles all project sources.)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@compile)
$(3)@@link: $(3)@compile
@ -120,7 +120,7 @@ $(3)@@link-deps::
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@@link-deps)
$(3)@link: $(3)@@link $(3)@@link-deps
$(MB_@RECIPE)$$(call mb-make-call,_mb-proj-flow-step-done)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@link,"Link all project intermediate files.")
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@link,Link all project intermediate files.)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@link)
$(3)@@build: $(3)@link
@ -130,7 +130,7 @@ $(3)@@build-deps::
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@@build-deps)
$(3)@build: $(3)@@build $(3)@@build-deps
$(MB_@RECIPE)$$(call mb-make-call,_mb-proj-flow-step-done)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@build,"Build all project artifacts.")
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@build,Build all project artifacts.)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@build)
$(3)@@test: $(3)@build
@ -141,7 +141,7 @@ $(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@@test-dep
$(3)@test: $(3)@@test $(3)@@test-deps
$(MB_@RECIPE)$$(if $(3),,$$(call mb-make-call,mb-os-echo-report,$$(MB_I18N_PROJ_ASSERT_COUNT) @test: $$(words $$(filter @test,$$(MB_PROJ_FIRE_ASSERT_SUCCESS)))))
$(MB_@RECIPE)$$(call mb-make-call,_mb-proj-flow-step-done)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@test,"Run all assertion tests.")
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@test,Run all assertion tests.)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@test)
$(3)@@package: $(3)@test
@ -151,7 +151,7 @@ $(3)@@package-deps::
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@@package-deps)
$(3)@package: $(3)@@package $(3)@@package-deps
$(MB_@RECIPE)$$(call mb-make-call,_mb-proj-flow-step-done)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@package,"Create all packages of project.")
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@package,Create all packages of project.)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@package)
$(3)@@package-qa: $(3)@package
@ -162,7 +162,7 @@ $(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@@package-
$(3)@package-qa: $(3)@@package-qa $(3)@@package-qa-deps
$(MB_@RECIPE)$$(if $(3),,$$(call mb-make-call,mb-os-echo-report,$$(MB_I18N_PROJ_ASSERT_COUNT) @package-qa: $$(words $$(filter @package-qa,$$(MB_PROJ_FIRE_ASSERT_SUCCESS)))))
$(MB_@RECIPE)$$(call mb-make-call,_mb-proj-flow-step-done)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@package-qa,"Run all packages QA of project.")
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@package-qa,Run all packages QA of project.)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@package-qa)
$(3)@@package-deploy: $(3)@package-qa
@ -172,7 +172,7 @@ $(3)@@package-deploy-deps::
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@@package-deploy-deps)
$(3)@package-deploy: $(3)@@package-deploy $(3)@@package-deploy-deps
$(MB_@RECIPE)$$(call mb-make-call,_mb-proj-flow-step-done)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@package-deploy,"Deploy all the packages.")
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@package-deploy,Deploy all the packages.)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@package-deploy)
$(3)@@all: $(3)@package-qa
@ -183,7 +183,7 @@ $(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@@all-deps
$(3)@all: $(3)@@all $(3)@@all-deps
$(MB_@RECIPE)$$(if $$(value MAKECMDGOALS),,$$(call mb-make-call,mb-os-echo-report,$$(MB_I18N_PROJ_OPENMSX_COUNT) $$(words $$(MB_OPENMSX_FIRE_PIPE_SMOKE))))
$(MB_@RECIPE)$$(call mb-make-call,_mb-proj-flow-step-done)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@all,"Run full build and package QA tests.")
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-$$(if $(3),module,help),$(3)@all,Run full build and package QA tests.)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(3)@all)
.RECIPEPREFIX := $(MB_@RECIPEPREFIX)
@ -200,7 +200,7 @@ $(MB_ᕽᕽᕽ　　　)$(if $(filter $(if $(3),$(3)/@init,@init),$(MB_PROJ_FIRE
$(MB_ᕽᕽᕽ　　　)$(if $(3),,$(if $(MB_I18N),$(if $(filter off,$(MB_I18N)),,$(call mb-make-call,_$(0)-i18n))))
$(MB_ᕽᕽᕽ　　　)$(eval MB_PROJ_FIRE_MODULE_INIT $(MB_MAKE_APPEND) $(if $(3),$(3)/@init,@init))
endef
$(call mb-make-call,mb-doc-function-flow,mb-flow-proj-setup,"Inject flow of abstract project build cycle.","<bin-dir> [parent-glue] [bin-mod-dir]")
$(call mb-make-call,mb-doc-function-flow,mb-flow-proj-setup,Inject flow of abstract project build cycle.,<bin-dir> [parent-glue] [bin-mod-dir])
define __mb-flow-proj-setup-i18n
@ -290,7 +290,7 @@ define __mb-flow-proj-module-run
$(1)/@run: $(1)/@build
$(MB_@RECIPE)$$(call mb-make-call,mb-msxpipe-run-gui,$(1),,$(2))
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-run,$(1)/@run,"Run manually with gui.")
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-doc-target-run,$(1)/@run,Run manually with gui.)
$(MB_ᕽᕽᕽ　　　)$$(call mb-make-call,mb-make-target-phony,$(1)/@run)
.RECIPEPREFIX := $(MB_@RECIPEPREFIX)
@ -300,7 +300,7 @@ $(MB_ᕽᕽᕽ　　　)$(call mb-make-call,mb-make-check-arg1,$(0),$(1))
$(MB_ᕽᕽᕽ　　　)$(if $(filter $(1)/@run,$(MB_PROJ_FIRE_MODULE_RUN)),,$(eval $(call mb-make-call,__$(0),$(1),$(2))))
$(MB_ᕽᕽᕽ　　　)$(eval MB_PROJ_FIRE_MODULE_RUN +$(MB_MAKE_EQUALS) $(1)/@run)
endef
$(call mb-make-call,mb-doc-function-flow,mb-flow-proj-module-run,"Inject flow module @run.","<bin-dir> [machine]")
$(call mb-make-call,mb-doc-function-flow,mb-flow-proj-module-run,Inject flow module @run.,<bin-dir> [machine])
define __mb-flow-proj-prepare-packages
@ -318,5 +318,5 @@ define mb-flow-proj-prepare-packages
$(MB_ᕽᕽᕽ　　　)$(call mb-make-call,mb-make-check-arg2,$(0),$(1),$(2))
$(MB_ᕽᕽᕽ　　　)$(foreach _pack,$(2),$(eval $(call mb-make-call,__$(0),$(1),$(_pack),$(3))))
endef
$(call mb-make-call,mb-doc-function-flow,mb-flow-proj-prepare-packages,"Inject package fetch flow for module.","<bin-dir> <packages> [dest-dir]")
$(call mb-make-call,mb-doc-function-flow,mb-flow-proj-prepare-packages,Inject package fetch flow for module.,<bin-dir> <packages> [dest-dir])