Add $strict parameter to `StringHelper::toSnakeCase() method (#113)

Co-authored-by: Sergei Predvoditelev <sergei@predvoditelev.ru>

CHANGELOG.md

@@ -9,6 +9,7 @@
 - New #104: Add methods `StringHelper::trim()`, `StringHelper::ltrim()`, `StringHelper::rtrim()` (@olegbaturin)
 - Enh #83: Make minor refactoring with Rector help (@vjik)
 - Enh #111: Minor refactoring (@Tigrov)
+- Enh #92: Add `$strict` parameter to `Inflector::toSnakeCase()` method (@arogachev)
 
 ## 2.1.2 July 27, 2023
 

src/Inflector.php

@@ -592,12 +592,13 @@ public function toCamelCase(string $input): string
      * so "who's online" will be converted to "who_s_online".
      *
      * @param string $input The word to convert.
+     * @param bool $strict Whether to insert a separator between two consecutive uppercase chars, defaults to true.
      *
      * @return string The "snake_cased" string.
      */
-    public function toSnakeCase(string $input): string
+    public function toSnakeCase(string $input, bool $strict = true): string
     {
-        return $this->pascalCaseToId(preg_replace('/[^\pL\pN]+/u', '_', $input), '_', true);
+        return $this->pascalCaseToId(preg_replace('/[^\pL\pN]+/u', '_', $input), '_', $strict);
     }
 
     /**

tests/InflectorTest.php

@@ -162,17 +162,28 @@ public function testToCamelCase(): void
         $this->assertEquals('ひらがなHepimiz', $inflector->toCamelCase('ひらがな_hepimiz'));
     }
 
-    public function testToSnakeCase(): void
+    public function dataToSnakeCase(): array
+    {
+        return [
+            [['input' => 'userName'], 'user_name'],
+            [['input' => 'travelSGuide'], 'travel_s_guide'],
+            [['input' => 'ひらがなHepimiz'], 'ひらがな_hepimiz'],
+            [['input' => 'Let\'s say "Hello, World!" yii 3 😂'], 'let_s_say_hello_world_yii_3'],
+            [['input' => 'HTML'], 'h_t_m_l'],
+            [['input' => 'createMyDTO'], 'create_my_d_t_o'],
+            [['input' => 'HTML', 'strict' => false], 'html'],
+            [['input' => 'createMyDTO', 'strict' => false], 'create_my_dto'],
+        ];
+    }
+
+    /**
+     * @dataProvider dataToSnakeCase
+     */
+    public function testToSnakeCase(array $arguments, string $expectedOutput): void
     {
         $inflector = new Inflector();
 
-        $this->assertEquals('user_name', $inflector->toSnakeCase('userName'));
-        $this->assertEquals('travel_s_guide', $inflector->toSnakeCase('travelSGuide'));
-        $this->assertEquals('ひらがな_hepimiz', $inflector->toSnakeCase('ひらがなHepimiz'));
-        $this->assertEquals(
-            'let_s_say_hello_world_yii_3',
-            $inflector->toSnakeCase('Let\'s say "Hello, World!" yii 3 😂')
-        );
+        $this->assertEquals($expectedOutput, $inflector->toSnakeCase(...$arguments));
     }
 
     public function testToTable(): void