add mbed unittest

Author: lorjala

README.md

@@ -25,6 +25,7 @@ This document covers the installation and usage of Mbed CLI.
     2. [Compiling and running tests](#compiling-and-running-tests)
     3. [Limiting the test scope](#limiting-the-test-scope)
     4. [Test directory structure](#test-directory-structure)
+1. [Unit testing](#unit-testing)
 1. [Publishing your changes](#publishing-your-changes)
     1. [Checking status](#checking-status)
     2. [Pushing upstream](#pushing-upstream)
@@ -727,6 +728,25 @@ As shown above, tests exist inside `TESTS\testgroup\testcase\` directories. Plea
 
 <span class="notes">**Note:** `mbed test` does not work in applications that contain a  `main` function that is outside of a `TESTS` directory.</span>
 
+## Unit testing
+
+Use the `mbed unittest` command to build and run unit tests, and to generate files for new unit tests.
+
+Build and run unit tests with `mbed unittest`. The arguments are:
+
+* `--skip-build` to skip building unit tests.
+* `--skip-run` to skip running unit tests.
+* `--clean` to clean previous build data.
+* `-d` or `--debug` to prepare debug build.
+* `--coverage <TYPE>` to generate code coverage report where TYPE can be "html", "xml" or "both".
+* `-m <NAME>` or `--make-program <NAME>` to select which make build tool to use where NAME can be "make", "gmake", "mingw32-make" or "ninja".
+* `-g <NAME>` or `--generator <NAME>` to select which CMake generator to use where NAME can be "Unix Makefiles", "MinGW Makefiles" or "Ninja".
+* `-r <EXPRESSION>` or `--regex <EXPRESSION>` to run tests matching the regular expression.
+* `--build-path <PATH>` to specify build path.
+* `-v` or `--verbose` for verbose diagnostic output.
+
+Generate files for a new unit test with `mbed unittest --new <FILE>`.
+
 ## Publishing your changes
 
 ### Checking status

mbed/mbed.py

@@ -3011,6 +3011,51 @@ def help_():
     return parser.print_help()
 
 
+@subcommand('unittest',
+    dict(name='--skip-build', action='store_true', help='skip build step'),
+    dict(name='--skip-run', action='store_true', help='skip run step'),
+    dict(name='--clean', action='store_true', help='clean build data'),
+    dict(name=['-d', '--debug'], action='store_true', help='enable debug build'),
+    dict(name='--coverage', choices=['html', 'xml', 'both'], help='generate code coverage report'),
+    dict(name=['-m', '--make-program'], choices=['gmake', 'make', 'mingw32-make', 'ninja'], help='which make program to use'),
+    dict(name=['-g', '--generator'], choices=['Unix Makefiles', 'MinGW Makefiles', 'Ninja'], help='which CMake generator to use'),
+    dict(name=['-r', '--regex'], help='run tests matching regular expression'),
+    dict(name='--build-path', help='specify build path'),
+    dict(name='--new', help='generate files for a new unit test', metavar="FILEPATH"),
+    help='Create, build and run unit tests')
+def unittest_(skip_build=False, skip_run=False, clean=False, debug=False, coverage=None, make_program=None, generator=None, regex=None, build_path=None, new=None):
+    program = Program(getcwd(), False)
+    program.check_requirements(True)
+
+    mbed_os_dir = program.get_os_dir()
+    if mbed_os_dir is None:
+        error("No Mbed OS directory found.")
+    unittests_dir = os.path.join(mbed_os_dir, "UNITTESTS")
+
+    tool = os.path.join(unittests_dir, "mbed_unittest.py")
+
+    # Prepare environment variables
+    env = program.get_env()
+
+    if os.path.exists(tool):
+        popen([python_cmd, tool]
+                + (["--skip-build"] if skip_build else [])
+                + (["--skip-run"] if skip_run else [])
+                + (["--clean"] if clean else [])
+                + (["--debug"] if debug else [])
+                + (["--coverage", coverage] if coverage else [])
+                + (["--make-program", make_program] if make_program else [])
+                + (["--generator", generator] if generator else [])
+                + (["--regex", regex] if regex else [])
+                + (["--build-path", build_path] if build_path else [])
+                + (["--new", new] if new else [])
+                + (["--verbose"] if verbose else [])
+                + remainder,
+                env=env)
+    else:
+        warning("Unit testing is not supported with this Mbed OS version.")
+
+
 def main():
     global verbose, very_verbose, remainder, cwd_root