Unit tests for converting an explicit PHP 8.1 octal reference (e.g."0o777") from two separate T_NUMBER and T_STRING tokens into a single T_NUMBER token with the correct value

Author: MarkBaker

tests/Core/Tokenizer/ExplicitOctalNotationTest.inc

@@ -0,0 +1,4 @@
+<?php
+
+/* testExplicitOctal declaration */
+$foo = 0o137041;

tests/Core/Tokenizer/ExplicitOctalNotationTest.php

@@ -0,0 +1,63 @@
+<?php
+/**
+ * Tests the tokenization of explicit octal notation to PHP < 8.1.
+ *
+ * @author    Mark Baker <mark@demon-angel.eu>
+ * @copyright 2019 Squiz Pty Ltd (ABN 77 084 670 600)
+ * @license   https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
+ */
+
+namespace PHP_CodeSniffer\Tests\Core\Tokenizer;
+
+use PHP_CodeSniffer\Tests\Core\AbstractMethodUnitTest;
+
+class ExplicitOctalNotationTest extends AbstractMethodUnitTest
+{
+
+
+    /**
+     * Test that explicitly-defined octal values are tokenized as a single number and not as a number and a string.
+     *
+     * @param array $testData The data required for the specific test case.
+     *
+     * @dataProvider dataExplicitOctalNotation
+     * @covers       PHP_CodeSniffer\Tokenizers\PHP::tokenize
+     *
+     * @return void
+     */
+    public function testExplicitOctalNotation($testData)
+    {
+        $tokens = self::$phpcsFile->getTokens();
+
+        $number = $this->getTargetToken($testData['marker'], [T_LNUMBER, T_DNUMBER, T_STRING]);
+
+        $this->assertSame(constant($testData['type']), $tokens[$number]['code']);
+        $this->assertSame($testData['type'], $tokens[$number]['type']);
+        $this->assertSame($testData['value'], $tokens[$number]['content']);
+
+    }//end testExplicitOctalNotation()
+
+
+    /**
+     * Data provider.
+     *
+     * @see testExplicitOctalNotation()
+     *
+     * @return array
+     */
+    public function dataExplicitOctalNotation()
+    {
+        return [
+            [
+                [
+                    'marker' => '/* testExplicitOctal declaration */',
+                    'type'   => 'T_LNUMBER',
+                    'value'  => '0o137041',
+                ],
+            ],
+        ];
+
+    }//end dataExplicitOctalNotation()
+
+
+}//end class