chore: project sturcture

development/makefiles/target-go-fetch-licenses.mk

+#############################################################################################
+#############################################################################################
+##
+## GET LICENSES
+##
+#############################################################################################
+#############################################################################################
+
+ifeq ($(GO),)
+  $(error $(ERRORMARKER) Go is not defined, check your Makefile if go.mk is included)
+endif
+
+GO_MOD_FILE := $(SOURCE_PATH)go.mod
+
+ifeq ($(shell test -e $(GO_MOD_FILE) && echo -n yes),yes)
+  GO_CURRENT_MODULE := $(shell cat $(GO_MOD_FILE) | head -n1 | cut -d" " -f2)
+  # go install github.com/google/go-licenses@latest
+  EXECUTABLES = $(EXECUTABLES:-) go-licenses;    
+endif
+
+.PHONY: go-fetch-licenses
+## Fetch licenses for all modules
+go-fetch-licenses:
+ifeq ($(GO_CURRENT_MODULE),)
+	$(QUIET) $(ECHOERRORMARKER) "no go.mod file found, skipping fetching licenses"
+else
+	$(ECHOMARKER) "Fetch licenses"
+	$(QUIET) cd $(SOURCE_PATH); $(GO_LICENSES_BIN) save $(GO_CURRENT_MODULE) $(GO_LICENSES_IGNORE_PACKAGES) --force --save_path $(DOCUMENTATION_PATH)licenses/ ; cd -
+endif
+

development/makefiles/target-help.mk

+#############################################################################################
+#############################################################################################
+##
+## HELP-TARGETS
+##
+#############################################################################################
+#############################################################################################
+
+# @see .PHONY https://www.gnu.org/software/make/manual/html_node/Phony-Targets.html#Phony-Targets
+.DEFAULT_GOAL := help
+
+.PHONY: print
+## Print Path	
+print:
+	$(ECHO) "THIS_MAKEFILE:      $(THIS_MAKEFILE)"
+	$(ECHO) "THIS_MAKEFILE_PATH: $(THIS_MAKEFILE_PATH)"
+	$(ECHO) "PROJECT_ROOT:       $(PROJECT_ROOT)"
+
+# Add a comment to the public targets so that it appears
+# in this help Use two # characters for a help comment
+.PHONY: help
+help:
+	@printf "${COMMENT}Usage:${RESET}\n"
+	@printf " make [target] [arg=\"val\"...]\n\n"
+	@printf "${COMMENT}Available targets:${RESET}\n"
+	@awk '/^[a-zA-Z\-\\_0-9\.@]+:/ { \
+		helpMessage = match(lastLine, /^## (.*)/); \
+		if (helpMessage) { \
+			helpCommand = substr($$1, 0, index($$1, ":")); \
+			helpMessage = substr(lastLine, RSTART + 3, RLENGTH); \
+			printf " ${INFO}%-22s${RESET} %s\n", helpCommand, helpMessage; \
+		} \
+	} \
+	{ lastLine = $$0 }' $(MAKEFILE_LIST)
+	@printf "\n${COMMENT}Available arguments:${RESET}\n\n"
+	@awk '/^(([a-zA-Z\-\\_0-9\.@]+)\s[?:]?=)/ { \
+		helpMessage = match(lastLine, /^## (.*)/); \
+		if (helpMessage) { \
+			helpMessage = substr(lastLine, RSTART + 3, RLENGTH); \
+			printf " ${INFO}%-22s${RESET} %s (Default: %s)\n", $$1, helpMessage, $$3; \
+		} \
+	} \
+	{ lastLine = $$0 }' $(MAKEFILE_LIST)
+
+
+

development/makefiles/target-init-go-utilities.mk

+#############################################################################################
+#############################################################################################
+##
+## INIT-STANDARD
+##
+#############################################################################################
+#############################################################################################
+
+# @see .PHONY https://www.gnu.org/software/make/manual/html_node/Phony-Targets.html#Phony-Targets
+.PHONY: init-go-utilities 
+
+# The default directories are defined in the 
+# directories-standard.mk file, but all other 
+# targets can define directories as well.
+
+$(PROJECT_DIRECTORIES):
+	$(foreach path,$(PROJECT_DIRECTORIES),\
+    		$(shell $(MKDIR) -p $(path)))
+
+## init go utilities project	
+init-go-utilities: $(PROJECT_DIRECTORIES) $(PROJECT_ROOT).gitignore $(PROJECT_ROOT)README.md  $(LICENSE_PATH)LICENSE
+	$(ECHOMARKER) "Run init-go-utilities"
+	$(ECHO) "Done"
+
+#############################################################################################
+#############################################################################################
+##
+## LICENSE
+##
+#############################################################################################
+#############################################################################################
+
+export LICENSE_FILE_CONTENT
+$(LICENSE_PATH)LICENSE:
+	$(QUIET) $(ECHO) "$$LICENSE_FILE_CONTENT" >> $@
+
+#############################################################################################
+#############################################################################################
+##
+## README
+##
+#############################################################################################
+#############################################################################################
+
+export README_FILE_CONTENT
+$(PROJECT_ROOT)README.md:
+	$(QUIET) $(ECHO) "$$README_FILE_CONTENT" >> $@
+
+

development/makefiles/target-init-platform-part.mk

+#############################################################################################
+#############################################################################################
+##
+## INIT-WEBCOMPONENTS
+##
+#############################################################################################
+#############################################################################################
+
+# @see .PHONY https://www.gnu.org/software/make/manual/html_node/Phony-Targets.html#Phony-Targets
+.PHONY: init-platform-part
+
+# The default directories are defined in the 
+# directories-standard.mk file, but all other 
+# targets can define directories as well.
+
+$(PROJECT_DIRECTORIES):
+	$(foreach path,$(PROJECT_DIRECTORIES),\
+    		$(shell $(MKDIR) -p $(path)))
+
+## init standard project	
+init-platform-part: $(PROJECT_DIRECTORIES) $(PROJECT_ROOT).gitignore $(PROJECT_ROOT)package.json $(PROJECT_ROOT)README.md  $(LICENSE_PATH)LICENSE 
+	$(ECHOMARKER) "Run init-webapp"
+	$(ECHO) "Done"
+
+#############################################################################################
+#############################################################################################
+##
+## LICENSE
+##
+#############################################################################################
+#############################################################################################
+
+export LICENSE_FILE_CONTENT
+$(LICENSE_PATH)LICENSE:
+	$(QUIET) $(ECHO) "$$LICENSE_FILE_CONTENT" >> $@
+
+
+#############################################################################################
+#############################################################################################
+##
+## README
+##
+#############################################################################################
+#############################################################################################
+
+export README_FILE_CONTENT
+$(PROJECT_ROOT)README.md:
+	$(QUIET) $(ECHO) "$$README_FILE_CONTENT" >> $@
+
+#############################################################################################
+#############################################################################################
+##
+## BUILD PACKAGE JSON
+##
+#############################################################################################
+#############################################################################################
+define PLATFORM_PARTS_BUILD_PACKAGE_CONTENT
+{
+  "name": "@alvine/$(COMPONENT_SLUG)",
+  "version": "0.1.0",
+  "description": "$(COMPONENT_NAME)",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.schukai.com/alvine/application/platform-apps/parts/$(COMPONENT_SLUG).git"
+  },
+  "scripts": {
+    "build-and-publish": "script/build-and-publish.sh",
+    "semantic-release": "semantic-release",
+    "build": "vite --config ./vite.config.js build",
+    "preview": "vite --config ./vite.config.js preview",
+    "dev": "vite --config ./vite.config.js"
+  },
+  "type": "module",
+  "author": "schukai GmbH",
+  "license": "see LICENSE file",
+  "dependencies": {
+    "@schukai/component-form": "^2.0.2",
+    "@schukai/component-notify": "^2.0.0",
+    "@schukai/component-state": "^2.0.1",
+    "@schukai/component-style": "^0.6.1",
+    "@schukai/monster": "^2.0.16"
+  },   
+  "devDependencies": {
+    "@peculiar/webcrypto": "^1.4.0",
+    "@semantic-release/changelog": "^6.0.1",
+    "@semantic-release/exec": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/gitlab": "^9.4.2",
+    "cli-real-favicon": "^0.0.8",
+	"@semantic-release/npm": "^9.0.1",
+    "autoprefixer": "^10.4.13",
+    "btoa": "^1.2.1",
+    "c8": "^7.12.0",
+    "chai": "^4.3.6",
+    "glob": "^8.0.3",
+    "chai-dom": "^1.11.0",
+    "clean-jsdoc-theme": "^4.1.6",
+    "create-polyfill-service-url": "^2.2.6",
+    "crypt": "^0.0.2",
+    "cssnano": "^5.1.14",
+    "esbuild": "^0.14.53",
+    "flow-bin": "^0.184.0",
+    "fs": "^0.0.1-security",
+    "graphviz": "^0.0.9",
+    "jsdoc": "^3.6.11",
+    "jsdoc-external-example": "github:volker-schukai/jsdoc-external-example",
+    "jsdom": "^19.0.0",
+    "jsdom-global": "^3.0.2",
+    "mocha": "^10.0.0",
+    "postcss": "^8.4.19",
+    "postcss-color-mod-function": "^3.0.3",
+    "postcss-fluid": "^1.4.2",
+    "postcss-for": "^2.1.1",
+    "postcss-import": "^15.0.0",
+    "postcss-mixins": "^9.0.4",
+    "postcss-nesting": "^10.2.0",
+    "postcss-normalize": "^10.0.1",
+    "postcss-responsive-type": "^1.0.0",
+    "postcss-strip-units": "^2.0.1",
+    "process": "^0.11.10",
+    "semantic-release": "^19.0.5",
+    "sinon": "^14.0.0",
+    "url": "^0.11.0",
+    "url-exist": "3.0.0",
+    "util": "^0.12.4",
+    "vite": "^3.2.3",
+    "vite-plugin-banner": "^0.6.1",
+    "vite-plugin-mkcert": "^1.10.1",
+    "vite-plugin-minify": "^1.5.2"    
+  }
+}
+endef
+
+export PLATFORM_PARTS_BUILD_PACKAGE_CONTENT
+$(PROJECT_ROOT)package.json:
+	$(QUIET) $(ECHO) "$$PLATFORM_PARTS_BUILD_PACKAGE_CONTENT" >> $@
+
+######

development/makefiles/target-init-standard.mk

+#############################################################################################
+#############################################################################################
+##
+## INIT-STANDARD
+##
+#############################################################################################
+#############################################################################################
+
+# @see .PHONY https://www.gnu.org/software/make/manual/html_node/Phony-Targets.html#Phony-Targets
+.PHONY: init-standard
+
+# The default directories are defined in the 
+# directories-standard.mk file, but all other 
+# targets can define directories as well.
+
+$(PROJECT_DIRECTORIES):
+	$(foreach path,$(PROJECT_DIRECTORIES),\
+    		$(shell $(MKDIR) -p $(path)))
+
+## init standard project	
+init-standard: $(PROJECT_DIRECTORIES) $(PROJECT_ROOT).gitignore $(PROJECT_ROOT)README.md  $(LICENSE_PATH)LICENSE
+	$(ECHOMARKER) "Run init-standard"
+	$(ECHO) "Done"
+
+#############################################################################################
+#############################################################################################
+##
+## LICENSE
+##
+#############################################################################################
+#############################################################################################
+
+export LICENSE_FILE_CONTENT
+$(LICENSE_PATH)LICENSE:
+	$(QUIET) $(ECHO) "$$LICENSE_FILE_CONTENT" >> $@
+
+#############################################################################################
+#############################################################################################
+##
+## README
+##
+#############################################################################################
+#############################################################################################
+
+export README_FILE_CONTENT
+$(PROJECT_ROOT)README.md:
+	$(QUIET) $(ECHO) "$$README_FILE_CONTENT" >> $@
+
+

development/makefiles/target-init-webcomponent.mk

+#############################################################################################
+#############################################################################################
+##
+## INIT-WEBCOMPONENTS
+##
+#############################################################################################
+#############################################################################################
+
+# @see .PHONY https://www.gnu.org/software/make/manual/html_node/Phony-Targets.html#Phony-Targets
+.PHONY: init-webcomponent
+
+# The default directories are defined in the 
+# directories-standard.mk file, but all other 
+# targets can define directories as well.
+
+$(PROJECT_DIRECTORIES):
+	$(foreach path,$(PROJECT_DIRECTORIES),\
+    		$(shell $(MKDIR) -p $(path)))
+
+## init standard project	
+init-webcomponent: $(PROJECT_DIRECTORIES) $(PROJECT_ROOT).gitignore $(DEVELOPMENT_PATH)package.json $(APPLICATION_PATH)package.json $(PROJECT_ROOT)README.md  $(LICENSE_PATH)LICENSE $(APPLICATION_PATH)LICENSE
+	$(ECHOMARKER) "Run init-webcomponent"
+	$(ECHO) "Done"
+
+#############################################################################################
+#############################################################################################
+##
+## LICENSE
+##
+#############################################################################################
+#############################################################################################
+
+export LICENSE_FILE_CONTENT
+$(LICENSE_PATH)LICENSE:
+	$(QUIET) $(ECHO) "$$LICENSE_FILE_CONTENT" >> $@
+
+export LICENSE_AGPL_FILE_CONTENT
+$(APPLICATION_PATH)LICENSE:
+	$(QUIET) $(ECHO) "$$LICENSE_AGPL_FILE_CONTENT" >> $@
+
+#############################################################################################
+#############################################################################################
+##
+## README
+##
+#############################################################################################
+#############################################################################################
+
+export README_FILE_CONTENT
+$(PROJECT_ROOT)README.md:
+	$(QUIET) $(ECHO) "$$README_FILE_CONTENT" >> $@
+
+
+#############################################################################################
+#############################################################################################
+##
+## PACKAGE JSON
+##
+#############################################################################################
+#############################################################################################
+define WEBCOMPONENTS_PACKAGE_CONTENT
+{
+  "name": "component-$(COMPONENT_SLUG)",
+  "version": "0.1.0",
+  "description": "component $(COMPONENT_NAME)",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.schukai.com/oss/libraries/javascript/web-components/$(COMPONENT_SLUG).git"
+  },
+  "keywords": [
+    "web",
+    "dom",
+    "css",
+    "mobile-first",
+    "app",
+    "front-end",
+    "ui",
+    "form",
+    "templates",
+    "schukai",
+    "component",
+    "web-component",
+    "monster"
+  ],
+  "dependencies": {
+    "@popperjs/core": "^2.9.2",
+    "@schukai/monster": "^2.0.8"
+  },
+  "main": "source/component.mjs",
+  "module": "source/component.mjs",
+  "type": "module",
+  "homepage": "https://monsterjs.org/",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.schukai.com/oss/libraries/javascript/web-components/$(COMPONENT_SLUG).git"
+  },
+  "author": "schukai GmbH",
+  "license": "AGPL 3.0"
+}
+endef
+
+export WEBCOMPONENTS_PACKAGE_CONTENT
+$(APPLICATION_PATH)package.json:
+	$(QUIET) $(ECHO) "$$WEBCOMPONENTS_PACKAGE_CONTENT" >> $@
+
+#############################################################################################
+#############################################################################################
+##
+## BUILD PACKAGE JSON
+##
+#############################################################################################
+#############################################################################################
+define WEBCOMPONENTS_BUILD_PACKAGE_CONTENT
+{
+  "name": "component-$(COMPONENT_SLUG)",
+  "version": "0.1.0",
+  "description": "component $(COMPONENT_NAME)",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.schukai.com/oss/libraries/javascript/web-components/$(COMPONENT_SLUG).git"
+  },
+  "scripts": {
+    "test": "npx mocha --recursive test/cases/",
+    "web-test": "script/web-test.sh",
+    "publish": "script/release-and-publish.sh",
+    "build-doc": "script/build-doc.sh"
+  },
+  "type": "module",
+  "author": "schukai GmbH",
+  "license": "see LICENSE file",
+  "dependencies": {
+    "@popperjs/core": "^2.11.2",
+    "@schukai/monster": "^2.0.8"
+  },
+  "devDependencies": {
+    "@peculiar/webcrypto": "^1.4.0",
+    "btoa": "^1.2.1",
+    "c8": "^7.12.0",
+    "chai": "^4.3.6",
+    "chai-dom": "^1.11.0",
+    "clean-jsdoc-theme": "^4.1.6",
+    "create-polyfill-service-url": "^2.2.6",
+    "crypt": "^0.0.2",
+    "esbuild": "^0.14.53",
+    "flow-bin": "^0.184.0",
+    "fs": "^0.0.1-security",
+    "graphviz": "^0.0.9",
+    "jsdoc": "^3.6.11",
+    "jsdoc-external-example": "github:volker-schukai/jsdoc-external-example",
+    "jsdoc-plantuml": "^1.0.2",
+    "jsdom": "^19.0.0",
+    "jsdom-global": "^3.0.2",
+    "mocha": "^10.0.0",
+    "node-plantuml": "^0.9.0",
+    "sinon": "^14.0.0",
+    "url": "^0.11.0",
+    "url-exist": "3.0.0",
+    "util": "^0.12.4"
+  }
+}
+endef
+
+export WEBCOMPONENTS_BUILD_PACKAGE_CONTENT
+$(DEVELOPMENT_PATH)package.json:
+	$(QUIET) $(ECHO) "$$WEBCOMPONENTS_BUILD_PACKAGE_CONTENT" >> $@
+
+######

development/makefiles/target-jekyll.mk

+#############################################################################################
+#############################################################################################
+##
+## JEKYLL-TARGETS
+##
+#############################################################################################
+#############################################################################################
+
+
+JEKYLL_VERSION      := snapshot
+JEKYLL_BIN          := $(ALVINE_VENDOR_PATH)jekyll-$(JEKYLL_VERSION).phar
+JEKYLL_PUBKEY       := $(JEKYLL_BIN).pubkey
+
+$(JEKYLL_PUBKEY):
+	$(MKDIR) -p $(ALVINE_VENDOR_PATH)
+	$(WGET) -O $(JEKYLL_PUBKEY) http://download.alvine.io/phar/jekyll-$(JEKYLL_VERSION).phar.pubkey
+
+$(JEKYLL_BIN): $(JEKYLL_PUBKEY)
+	$(MKDIR) -p $(ALVINE_VENDOR_PATH)
+	$(WGET) -O $(JEKYLL_BIN) http://download.alvine.io/phar/jekyll-$(JEKYLL_VERSION).phar
+	$(CHMOD) u+x $(JEKYLL_BIN)
+
+.PHONY: run-jekyll
+## run jekyll 
+run-jekyll: init $(JEKYLL_BIN) $(JEKYLL_PUBKEY) $(TEMP_PATH)jekyll.lock
+	$(ECHOMARKER) "Jekyll finished"
+
+.PHONY: run-jekyll-force
+## run jekyll (-f) 
+run-jekyll-force: init $(JEKYLL_BIN) $(JEKYLL_PUBKEY) 
+	$(RM) $(TEMP_PATH)jekyll.lock
+	$(MAKE) run-jekyll
+	$(ECHOMARKER) "Jekyll finished"
+
+$(TEMP_PATH)jekyll.lock: $(THIS_DIR).jekyll
+	$(ECHOMARKER) "Run Jekyll"
+	$(JEKYLL_BIN) fetch --force
+	$(JEKYLL_BIN) update
+	touch $(TEMP_PATH)jekyll.lock
\ No newline at end of file

development/makefiles/target-jsdoc-build.mk

+
+#############################################################################################
+#############################################################################################
+##
+## JSDOC-TARGETS
+##
+#############################################################################################
+#############################################################################################
+
+FIXBROKENPLANTUML := $(NODE_MODULES_DIR)jsdoc-plantuml/fixBrokenNodeJS.js
+
+.PHONY: jsdoc-build
+## generate js api docs
+jsdoc-build: $(DOCUMENTATION_CONFIG_PATH)jsdoc.json  $(FIXBROKENPLANTUML).fixed
+	$(ECHOMARKER) "create api doc"
+	$(QUIET) $(NPM) --prefix $(NODE_ROOT_DIR) run build-doc
+
+
+$(FIXBROKENPLANTUML).fixed:
+	$(ECHOMARKER) "fix broken plantuml"
+	$(QUIET) chmod u+x $(FIXBROKENPLANTUML) 
+	$(QUIET) $(NODE) $(FIXBROKENPLANTUML)
+	$(QUIET) $(TOUCH) $(FIXBROKENPLANTUML).fixed
\ No newline at end of file

development/makefiles/target-node-build.mk

+#############################################################################################
+#############################################################################################
+##
+## BUILD NODE
+##
+#############################################################################################
+#############################################################################################
+
+SPONGE   ?=   sponge
+
+EXECUTABLES = $(EXECUTABLES:-) $(SPONGE);
+
+.PHONY: node-build
+## Build Node Components
+node-build: $(NODE_MODULES_MODIFIED) $(NODE_PACKAGES)
+	$(ECHOMARKER) "Building Node Components"
+	$(ECHO) "Version: $(PROJECT_VERSION)"
+	$(ECHO) "Source Path: $(SOURCE_PATH)"
+	$(QUIET) $(JQ) '.version = "$(PROJECT_VERSION)"' $(PACKAGE_JSON) | $(SPONGE) $(PACKAGE_JSON)
+	$(QUIET) for p in $(NODE_PACKAGES); do $(JQ) '.version = "$(PROJECT_VERSION)"' $${p} | $(SPONGE) $${p}; done
+	$(QUIET) $(SCRIPTS_PATH)update-version.sh
+	$(QUIET) $(NPM) --prefix $(NODE_ROOT_DIR) run --if-present build 
+		
+	

development/makefiles/target-node-test.mk

+#############################################################################################
+#############################################################################################
+##
+## BUILD NODE
+##
+#############################################################################################
+#############################################################################################
+
+.PHONY: node-test
+## Test JS Components
+node-test: $(NODE_MODULES_MODIFIED)
+	$(ECHOMARKER) "Test Node Components"
+	$(QUIET) $(NPM) --prefix $(NODE_ROOT_DIR) run test  
+
+.PHONY: node-web-test
+## Test JS Components
+node-web-test: $(NODE_MODULES_MODIFIED)
+	$(ECHOMARKER) "Test Node Components"
+	$(QUIET) $(NPM) --prefix $(NODE_ROOT_DIR) run web-test  
+	

development/makefiles/target-npm-publish.mk

+#############################################################################################
+#############################################################################################
+##
+## NPM
+##
+#############################################################################################
+#############################################################################################
+
+.PHONY: npm-publish-major
+## release major version of package
+npm-publish-major:
+	$(ECHOMARKER) "release major version"
+	$(QUIET) $(MAKE) tag-major-version
+	$(QUIET) $(MAKE) node-build
+	$(QUIET) $(MAKE) node-test
+	$(QUIET) $(NPM) --prefix $(NODE_ROOT_DIR) run publish
+
+.PHONY: npm-publish-minor
+## release minor version of package
+npm-publish-minor: 
+	$(ECHOMARKER) "release minor version"
+	$(QUIET) $(MAKE) tag-minor-version
+	$(QUIET) $(MAKE) node-build
+	$(QUIET) $(MAKE) node-test
+	$(QUIET) $(NPM) --prefix $(NODE_ROOT_DIR) run publish
+
+.PHONY: npm-publish-patch
+## release patch version of package
+npm-publish-patch:
+	$(ECHOMARKER) "release patch version"
+	$(QUIET) $(MAKE) tag-patch-version
+	$(QUIET) $(MAKE) node-build
+	$(QUIET) $(MAKE) node-test
+	$(QUIET) $(NPM) --prefix $(NODE_ROOT_DIR) run publish
+

development/makefiles/target-npm.mk

+#############################################################################################
+#############################################################################################
+##
+## RUN NPM BUILD, TEST AND DEV TASKS
+##
+#############################################################################################
+#############################################################################################
+
+.PHONY: npm-dev
+## run npm dev server
+npm-dev:
+	$(ECHOMARKER) "start npm dev server" 
+	$(QUIET) $(NPM) --prefix $(NODE_ROOT_DIR) run dev
+
+.PHONY: npm-build
+## build npm project
+npm-build:
+	$(ECHOMARKER) "build npm project" 
+	$(QUIET) $(NPM) --prefix $(NODE_ROOT_DIR) run build
+
+.PHONY: npm-preview
+## preview npm project
+npm-preview:
+	$(ECHOMARKER) "preview npm project"
+	$(QUIET) $(NPM) --prefix $(NODE_ROOT_DIR) run build 
+	$(QUIET) $(NPM) --prefix $(NODE_ROOT_DIR) run preview
+
+
+

development/makefiles/target-phpunit.mk

+#############################################################################################
+#############################################################################################
+##
+## PHPUNIT
+##
+#############################################################################################
+#############################################################################################
+
+# path and binaries
+PARALLEL               ?= parallel
+
+EXECUTABLES = $(EXECUTABLES:-) $(PARALLEL); 
+
+PHPUNIT_PATH            := $(VENDOR_PATH)phpunit/
+PHPUNIT_BIN             := $(PHPUNIT_PATH)phpunit
+PHPUNIT_SCRIPT_PATH     := $(BUILD_PATH)/script
+
+
+ifeq ($(shell command -v $(PARALLEL) 2> /dev/null),)
+  $(error "parallel is not installed. Please install parallel")
+endif
+
+ifneq ($(shell test -d $(PHPUNIT_SCRIPT_PATH) && echo -n yes),yes)
+    $(shell mkdir -p $(PHPUNIT_SCRIPT_PATH))
+endif
+
+define UNITTEST_SH_SCRIPT
+#!/bin/bash
+
+BIN=$$1
+BOOTSTRAP=$$2
+CONFIG=$$3
+TESTFILES=$$4
+
+export DOCOVERAGE=true
+
+groups=$$($${BIN} \
+           --list-groups \
+           --bootstrap $${BOOTSTRAP} \
+           --configuration $${CONFIG} \
+           development/tests/ | sed -n -e '/^ - /p' | cut -d"-" -f2 |  tr -d ' ')
+
+parallel \
+    $${BIN} \
+            --group {} \
+            --configuration $${CONFIG} \
+            --whitelist application/source/ \
+            --bootstrap $${BOOTSTRAP} \
+            $${TESTFILES}  ::: $${groups}
+endef
+
+export UNITTEST_SH_SCRIPT
+
+$(PHPUNIT_SCRIPT_PATH)/unittests.sh:
+	$(QUIET) $(ECHO) "$$UNITTEST_SH_SCRIPT" >> $@
+	$(CHMOD) u+x $(PHPUNIT_SCRIPT_PATH)/unittests.sh
+
+$(PHPUNIT_BIN):
+	$(MKDIR) -p $(PHPUNIT_PATH)
+	$(WGET) -O $(PHPUNIT_BIN) https://phar.phpunit.de/phpunit-9.phar
+	$(CHMOD) u+x $(PHPUNIT_BIN)
+	$(CHMOD) u+x $(PHPUNIT_SCRIPT_PATH)/unittests.sh
+
+.PHONY: run-phpunit-tests
+## run PHPUNIT Tests
+run-phpunit-tests: $(PHPUNIT_SCRIPT_PATH)/unittests.sh $(PHPUNIT_BIN)
+	$(BUILD_SCRIPTS_PATH)unittests.sh "$(PHPUNIT_BIN)" "$(TEST_PATH)script/bootstrap.inc.php" "$(TEST_PATH)config/phpunit.xml" "$(TEST_PATH)"

development/makefiles/target-reqman.mk

+#############################################################################################
+#############################################################################################
+##
+## REQMAN-TARGETS
+##
+#############################################################################################
+#############################################################################################
+
+
+# @TODO not working, check if this is a bug in this definition!!!
+
+ifeq ($(REQMAN_BIN),) 
+  $(error "$(REQMAN_BIN) is not installed. Please check your makefile and include the reqman.mk")
+endif
+
+$(REQMAN_BIN):
+	$(QUIET) $(MKDIR) -p $(VENDOR_PATH)
+	$(QUIET) $(WGET) -O $(REQMAN_BIN) http://download.schukai.com/tools/reqman/reqman-$(shell uname -s | tr [:upper:] [:lower:])-$(shell echo `uname -m | sed s/aarch64/arm64/ | sed s/x86_64/amd64/`)
+	$(QUIET) $(CHMOD) u+x $(REQMAN_BIN)
+
+$(PROJECT_ROOT)deployment/build/manual.html: $(DOCMAN_BIN)
+	$(REQMAN_BIN) print html --config $(PROJECT_ROOT)requirement/config.yaml
+
+$(PROJECT_ROOT)deployment/build/manual.pdf: $(DOCMAN_BIN)
+	$(REQMAN_BIN) print pdf --config $(PROJECT_ROOT)requirement/config.yaml
+
+.PHONY: build-req-pdf
+## creating the requirement in pdf format
+build-req-pdf: $(PROJECT_ROOT)deployment/build/requirement.pdf
+
+.PHONY: build-req-html
+## creating the requirement in html format
+build-req-html: $(PROJECT_ROOT)deployment/build/requirement.html
+
+
+.PHONY: build-req
+## creating the requirement in pdf and html format
+build-req: build-req-pdf build-req-html
+
+

development/makefiles/target-update-makefiles.mk

+#############################################################################################
+#############################################################################################
+##
+## INIT-TARGETS
+##
+#############################################################################################
+#############################################################################################
+
+ifeq ($(GIT),)
+  $(error $(ERRORMARKER) Git is not defined, check your Makefile if git.mk is included)
+endif
+
+# @see .PHONY https://www.gnu.org/software/make/manual/html_node/Phony-Targets.html#Phony-Targets
+.PHONY: update-makefiles
+
+ifeq ($(QUIET),)
+  _COPYVERBOSE = -v
+endif
+
+## update standard makefiles
+update-makefiles:
+	$(ECHOMARKER) "update standard makefiles"
+	$(QUIET) $(eval TEMPD := $(shell mktemp -d))
+	$(QUIET) $(GIT) clone --quiet --depth=1  https://gitlab.schukai.com/schukai/utilities/makefile.git/ "$(TEMPD)" 
+	$(QUIET) $(CP) -r $(_COPYVERBOSE) $(TEMPD)/makefiles/* $(MAKEFILE_IMPORT_PATH)
+	$(QUIET) $(CP) -r $(_COPYVERBOSE) $(TEMPD)/Makefile $(PROJECT_ROOT)Makefile.example
+	$(QUIET) $(RM) -rf $(TEMPD)
+
+
+
+
+

development/makefiles/target-variable.mk

+#############################################################################################
+#############################################################################################
+##
+## VARIABLES-TARGETS
+##
+#############################################################################################
+#############################################################################################
+
+.PHONY: variables
+## Print all variables
+variables:
+	$(ECHOMARKER) "print all variables"
+	$(QUIET) $(foreach v, $(.VARIABLES), $(if $(filter file,$(origin $(v))), $(info $(INFO)$(v)$(RESET)=$($(v))$(RESET))))
\ No newline at end of file

development/makefiles/target-version.mk

+#############################################################################################
+#############################################################################################
+##
+## VARIABLES-TARGETS
+##
+#############################################################################################
+#############################################################################################
+
+ifeq ($(VERSION_BIN),) 
+  $(error "$(VERSION_BIN) is not installed. Please check your makefile and include the version.mk")
+endif
+
+ifeq ($(GIT),)
+  $(error $(ERRORMARKER) Git is not defined, check your Makefile if git.mk is included)
+endif
+
+ifeq ($(GIT_CHGLOG_BIN),)
+  $(error $(ERRORMARKER) Chglog is not defined, check your Makefile if changelog.mk is included)
+endif
+
+$(VERSION_BIN):
+	$(QUIET) $(MKDIR) -p $(VENDOR_PATH)
+	$(QUIET) $(WGET) -O $(VERSION_BIN) http://download.schukai.com/tools/version/version-$(shell uname -s | tr [:upper:] [:lower:])-$(shell echo `uname -m | sed s/aarch64/arm64/ | sed s/x86_64/amd64/`)
+	$(QUIET) $(CHMOD) u+x $(VERSION_BIN)
+
+
+.PHONY: next-patch-version
+next-patch-version: check-clean-repo $(VERSION_BIN)
+	$(ECHOMARKER)  "Creating next version"
+	$(QUIET) $(VERSION_BIN) patch --path $(RELEASE_FILE) --selector "version"
+	$(QUIET) $(GIT) add $(RELEASE_FILE) && $(GIT) commit -m "Bump version to $$(cat $(RELEASE_FILE) | jq -r .version)"
+
+.PHONY: next-minor-version
+next-minor-version: check-clean-repo $(VERSION_BIN)
+	$(ECHOMARKER)   "Creating next minor version"
+	$(QUIET) $(VERSION_BIN) minor --path $(RELEASE_FILE) --selector "version"
+	$(QUIET) $(GIT) add $(RELEASE_FILE) && $(GIT) commit -m "Bump version to $$( cat $(RELEASE_FILE) | jq -r .version)"
+
+.PHONY: next-major-version
+next-major-version: check-clean-repo $(VERSION_BIN)
+	$(ECHOMARKER)  "Creating next minor version"
+	$(QUIET) $(VERSION_BIN) major --path $(RELEASE_FILE) --selector "version"
+	$(QUIET) $(GIT) add $(RELEASE_FILE) && $(GIT) commit -m "Bump version to $$(cat $(RELEASE_FILE) | jq -r .version)"
+
+.PHONY: check-clean-repo
+check-clean-repo:
+	$(QUIET) $(GIT) diff-index --quiet HEAD || (echo "There are uncommitted changes after running make. Please commit or stash them before running make."; exit 1)
+	
+## tag repository with next patch version
+tag-patch-version: $(GIT_CHGLOG_CONFIG_DIR)/config.yml $(GIT_CHGLOG_CONFIG_DIR)/CHANGELOG.tpl.md next-patch-version 
+	$(ECHOMARKER)  "Tagging patch version"
+	$(eval PROJECT_VERSION := $(shell cat $(RELEASE_FILE) | jq -r .version))
+	$(GIT_CHGLOG_BIN) --next-tag v$(PROJECT_VERSION) -o $(CHANGELOG_FILE)
+	$(QUIET) $(GIT) add $(CHANGELOG_FILE) && $(GIT) commit -m "Update changelog"
+	$(QUIET) $(GIT) tag -a v$(PROJECT_VERSION) -m "Version $(PROJECT_VERSION)"
+
+## tag repository with next minor version
+tag-minor-version: $(GIT_CHGLOG_CONFIG_DIR)/config.yml $(GIT_CHGLOG_CONFIG_DIR)/CHANGELOG.tpl.md next-minor-version 
+	$(ECHOMARKER)  "Tagging minor version"
+	$(eval PROJECT_VERSION := $(shell cat $(RELEASE_FILE) | jq -r .version))
+	$(GIT_CHGLOG_BIN) --next-tag v$(PROJECT_VERSION) -o $(CHANGELOG_FILE)
+	$(QUIET) $(GIT) add $(CHANGELOG_FILE) && $(GIT) commit -m "Update changelog"
+	$(QUIET) $(GIT) tag -a v$(PROJECT_VERSION) -m "Version $(PROJECT_VERSION)"
+
+## tag repository with next major version
+tag-major-version: $(GIT_CHGLOG_CONFIG_DIR)/config.yml $(GIT_CHGLOG_CONFIG_DIR)/CHANGELOG.tpl.md next-major-version 
+	$(ECHOMARKER)  "Tagging major version"
+	$(eval PROJECT_VERSION := $(shell cat $(RELEASE_FILE) | jq -r .version))
+	$(GIT_CHGLOG_BIN) --next-tag v$(PROJECT_VERSION) -o $(CHANGELOG_FILE)
+	$(QUIET) $(GIT) add $(CHANGELOG_FILE) && $(GIT) commit -m "Update changelog"
+	$(QUIET) $(GIT) tag -a v$(PROJECT_VERSION) -m "Version $(PROJECT_VERSION)"

development/makefiles/terminal-check.mk

+#############################################################################################
+#############################################################################################
+##
+## TERMINAL CHECK
+##
+#############################################################################################
+#############################################################################################
+
+
+
+# Executable Programs the Installed be have to
+K := $(foreach exec,$(EXECUTABLES),\
+        $(if $(shell which $(exec)),some string,$(error "Missing $(exec) in PATH; please install")))
\ No newline at end of file

development/makefiles/terminal.mk

+#############################################################################################
+#############################################################################################
+##
+## COMMANDS
+##
+#############################################################################################
+#############################################################################################
+
+# Use bash instead of sh
+## Sets the shell used
+SHELL            =  bash
+
+# path and binaries
+AWK              ?= awk
+CP               ?= cp
+CD               ?= cd
+KILL             ?= kill
+MV               ?= mv
+RM               ?= rm
+MKDIR            ?= mkdir
+SED              ?= sed
+FIND             ?= find
+SORT             ?= sort
+TOUCH            ?= touch
+WGET             ?= wget
+CHMOD            ?= chmod
+RSYNC            ?= rsync
+XARGS            ?= xargs
+GREP             ?= grep
+MAKE             ?= make
+LN               ?= ln
+TOUCH    	 ?= touch
+TEST             ?= test
+JQ		 ?= jq
+
+
+EXECUTABLES = $(EXECUTABLES:-) $(JQ) $(AWK) $(CP) $(KILL) $(MV) $(SED) $(FIND) $(SORT) $(TOUCH) $(WGET) $(CHMOD) $(RSYNC) $(XARGS) $(GREP) $(MAKE) $(LN)  
+
+
+    
\ No newline at end of file

development/makefiles/version.mk

+#############################################################################################
+#############################################################################################
+##
+## VERSIONS
+##
+#############################################################################################
+#############################################################################################
+
+VERSION_BIN   ?= $(VENDOR_PATH)version
+RELEASE_FILE  ?= $(PROJECT_ROOT)release.json
+ 
+ifeq ("$(wildcard $(RELEASE_FILE))","")
+  $(shell echo '{"version":"0.1.0"}' > $(RELEASE_FILE))
+endif
+
+PROJECT_VERSION ?= $(shell cat $(RELEASE_FILE) | jq -r .version)
+PROJECT_BUILD_DATE ?= $(shell $(VERSION_BIN) date)