Debug/TokenList: add column showing nr of nested parentheses

This is based on a count of the `nested_parenthesis` index.

Includes adjusted unit tests.

Author: jrfnl

PHPCSDebug/Sniffs/Debug/TokenListSniff.php

@@ -88,6 +88,7 @@ public function process(File $phpcsFile, $stackPtr)
             $sep, \str_pad('Ln', ($linePadding + 1), ' ', \STR_PAD_BOTH),
             $sep, 'Col ',
             $sep, 'Cond',
+            $sep, '( #)',
             $sep, \str_pad('Token Type', 26), // Longest token type name is 26 chars.
             $sep, '[len]: Content', \PHP_EOL;
 
@@ -116,10 +117,16 @@ public function process(File $phpcsFile, $stackPtr)
                 }
             }
 
+            $parenthesesCount = 0;
+            if (isset($token['nested_parenthesis'])) {
+                $parenthesesCount = \count($token['nested_parenthesis']);
+            }
+
             echo \str_pad($ptr, $ptrPadding, ' ', \STR_PAD_LEFT),
                 $sep, 'L', \str_pad($token['line'], $linePadding, '0', \STR_PAD_LEFT),
                 $sep, 'C', \str_pad($token['column'], 3, ' ', \STR_PAD_LEFT),
                 $sep, 'CC', \str_pad($token['level'], 2, ' ', \STR_PAD_LEFT),
+                $sep, '(', \str_pad($parenthesesCount, 2, ' ', \STR_PAD_LEFT), ')',
                 $sep, \str_pad($token['type'], 26), // Longest token type name is 26 chars.
                 $sep, '[', $token['length'], ']: ', $content, \PHP_EOL;
         }

PHPCSDebug/Tests/Debug/TokenListUnitTest.php

@@ -45,12 +45,12 @@ public function testOutput()
         $this->assertNotEmpty($output);
 
         $expected  = "\n";
-        $expected .= 'Ptr | Ln | Col  | Cond | Token Type                 | [len]: Content' . "\n";
+        $expected .= 'Ptr | Ln | Col  | Cond | ( #) | Token Type                 | [len]: Content' . "\n";
         $expected .= '-------------------------------------------------------------------------' . "\n";
-        $expected .= '  0 | L1 | C  1 | CC 0 | T_OPEN_TAG                 | [5]: <?php' . "\n\n";
-        $expected .= '  1 | L2 | C  1 | CC 0 | T_WHITESPACE               | [0]: ' . "\n\n";
-        $expected .= '  2 | L3 | C  1 | CC 0 | T_FUNCTION                 | [8]: function' . "\n";
-        $expected .= '  3 | L3 | C  9 | CC 0 | T_WHITESPACE               | [0]: ' . "\n\n";
+        $expected .= '  0 | L1 | C  1 | CC 0 | ( 0) | T_OPEN_TAG                 | [5]: <?php' . "\n\n";
+        $expected .= '  1 | L2 | C  1 | CC 0 | ( 0) | T_WHITESPACE               | [0]: ' . "\n\n";
+        $expected .= '  2 | L3 | C  1 | CC 0 | ( 0) | T_FUNCTION                 | [8]: function' . "\n";
+        $expected .= '  3 | L3 | C  9 | CC 0 | ( 0) | T_WHITESPACE               | [0]: ' . "\n\n";
 
         $this->assertSame($expected, $output);
     }