Correctly detect spacing on nested parentheses

The `SpaceBetweenParens` linter would not work correctly with nested
parentheses due to its simple regex-based check.

Improve the regex and add a few more specs to ensure this case is
handled properly.

Change-Id: I939cc6cf9626eec76548df2a6d298b8f9d0e3372
Reviewed-on: https://gerrit.causes.com/32350
Tested-by: jenkins <jenkins@causes.com>
Reviewed-by: Shane da Silva <shane@causes.com>