travis: Add include_check job

[alekla01]

Description

MBEDOSTEST-421
check for #include "mbed.h".
#include "mbed.h" should not be used in header and source files.

Pull request type

[ ] Fix
[ ] Refactor
[ ] Target update
[ ] Functionality change
[ ] Docs update
[x] Test update
[ ] Breaking change

Reviewers

@AnttiKauppila

[0xc0170]

why is targets folder also excluded?

[alekla01]

According to @AnttiKauppila: targets folder is excluded for now because it has not been fixed as of yet.

[AnttiKauppila]

I checked and there are 5 #mbed.h" includes under targets/. Maybe we should raise minor defects out of those. I want that corresponding teams fixes those because testing changes can be difficult.

[0xc0170]

That explains it, lets create issues for these and will be fixed

[ciarmcom]

@alekla01, thank you for your changes.
@AnttiKauppila @ARMmbed/mbed-os-maintainers please review.

[cmonr]

@0xc0170 Could you confirm that astyle settings will guarantee that ^#include "mbed.h"$ is sufficient for matching?

Otherwise, @alekla01 might need to make this search a bit more generic, maybe something like the following:

Suggested change

	- ! git grep '^#include "mbed.h"$' -- '*.c' '*.h' '*.cpp' '*.hpp' ':!*platform_mbed.h' ':!*TESTS/*' ':!TEST_APPS/' ':!UNITTESTS/' ':!*tests/*' ':!*targets/*' ':!*TARGET_*' ':!*unsupported/*'
	- ! git grep '^#include.*mbed.h["']$' -- '*.c' '*.h' '*.cpp' '*.hpp' ':!*platform_mbed.h' ':!*TESTS/*' ':!TEST_APPS/' ':!UNITTESTS/' ':!*tests/*' ':!*targets/*' ':!*TARGET_*' ':!*unsupported/*'

[0xc0170]

@0xc0170 Could you confirm that astyle settings will guarantee that ^#include "mbed.h"$ is sufficient for matching?

I don't think it formats this. Thus between include and mbed should be "any space"

[cmonr]

CI started

[cmonr]

This PR needs a rebase before we can retest it.
A Travis CI fix has landed in master in the past 24 hours.

[0xc0170]

@alekla01 Before this goes to CI, can you squash these 5 commits into one: Add Travis include mbed.h check

[0xc0170]

CI started