Add Kernel Unit Tests Environment (#494)

* Implement Kernel Unit Test Framework with CMock

* Add Readme.md to unit tests

* Add Posix build checker to git actions

* Add Ruby requirement

* Fix file header checks

* Fix header checks

* Add color output to test runs

FreeRTOS/Test/CMock/Makefile

@@ -0,0 +1,70 @@
+# Change to match installed location
+export CC=/usr/local/bin/gcc
+export LD=/usr/local/bin/ld
+# Add units here when adding a new unit test directory with the same name
+UNITS := queue
+
+include makefile.in
+
+.PHONY: all run doc clean directories $(UNITS) coverage
+
+all: doc coverage
+execs: $(UNITS) directories
+
+
+$(UNITS): directories ${LIB_DIR}/libcmock.so  ${LIB_DIR}/libunity.so
+	$(MAKE) -C $@ 
+
+doc: directories
+	$(MAKE) -C doc all
+
+directories:
+	-mkdir $(BUILD_DIR)
+	-mkdir $(GENERATED_DIR)
+	-mkdir $(COVERAGE_DIR)
+	-mkdir $(BIN_DIR)
+	-mkdir $(DOC_DIR)
+	-mkdir $(LIB_DIR)
+
+clean:
+	rm -rf build
+
+help:
+	@echo -e 'Usage: $$ make <unit>\n '
+	@echo -e ' where <unit> is one of: $(UNITS) doc all run run_formatted run_col run_col_formatted coverage'
+
+$(LIB_DIR)/libcmock.so : ${CMOCK_SRC_DIR}/cmock.c     \
+			${CMOCK_SRC_DIR}/cmock.h      \
+			${LIB_DIR}/libunity.so        \
+			Makefile
+	${CC} -o $@ -shared -fPIC  $<  ${INCLUDE_DIR}
+
+$(LIB_DIR)/libunity.so : ${UNITY_SRC_DIR}/unity.c     \
+			${CMOCK_SRC_DIR}/cmock.h      \
+			Makefile directories
+	${CC} -o $@ -shared -fPIC  $< 
+
+run : $(UNITS) directories
+	for f in $(BIN_DIR)/*; do \
+	  $${f}; done 
+
+run_col : $(UNITS) directories
+	for f in $(BIN_DIR)/*; do \
+	  ruby -r $(UNITY_BIN_DIR)/colour_reporter.rb  -e "report('`$${f}`')"; done 
+
+run_formatted :  $(UNITS) directories
+	for f in $(BIN_DIR)/*; do \
+	  $${f} > $(BUILD_DIR)/output; \
+	  ruby  $(UNITY_BIN_DIR)/parse_output.rb $(BUILD_DIR)/output ; \
+	  done 
+
+run_col_formatted :  $(UNITS) directories
+	for f in $(BIN_DIR)/*; do \
+	  $${f} > $(BUILD_DIR)/output; \
+	  ruby -r $(UNITY_BIN_DIR)/colour_reporter.rb  -e "report('$$(ruby $(UNITY_BIN_DIR)/parse_output.rb $(BUILD_DIR)/output)')"; \
+	  done 
+
+coverage : run_col
+	lcov --base-directory . --directory . -c --rc lcov_branch_coverage=1 --rc genhtml_branch_coverage=1  -o $(BUILD_DIR)/cmock_test.info
+	genhtml $(BUILD_DIR)/cmock_test.info --branch-coverage --output-directory $(COVERAGE_DIR)
+