Add str chop helper

Author: codebarista

bootstrap/helpers.php

@@ -14,6 +14,13 @@ function decode_json(string $value): array
     }
 }
 
+if (! function_exists('str_chop')) {
+    function str_chop(string $value, int $limit, string $center = '...'): string
+    {
+        return \Illuminate\Support\Str::chop($value, $limit, $center);
+    }
+}
+
 if (! function_exists('crush_png')) {
     function crush_png(string $image): bool
     {

src/EssentialsServiceProvider.php

@@ -26,6 +26,7 @@ private function registerStringMacros(): void
     {
         $macros = [
             'toJson' => \Codebarista\LaravelEssentials\Macros\String\Json::class,
+            'chop' => \Codebarista\LaravelEssentials\Macros\String\Chop::class,
         ];
 
         foreach ($macros as $name => $class) {

src/Macros/String/Chop.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Codebarista\LaravelEssentials\Macros\String;
+
+class Chop
+{
+    public function __invoke(string $value, int $limit = 100, string $center = '...'): string
+    {
+        if (mb_strwidth($value, 'UTF-8') <= $limit) {
+            return $value;
+        }
+
+        $length = round($limit / 2);
+
+        return mb_substr($value, 0, $length, encoding: 'UTF-8').$center
+            .mb_substr($value, -$length, encoding: 'UTF-8');
+    }
+}

tests/Feature/HelpersTest.php

@@ -25,14 +25,24 @@
 
 })->covers('encode_json');
 
-it('can crush png', function () {
-    $version = null;
+it('chops a string', function () {
+    $value = Str::random(42);
 
-    if ($pngcrush = exec('which pngcrush')) {
-        $version = exec($pngcrush.' --version');
-    }
-
-    expect($version)->toBeString();
-    // ->toContain('pngcrush');
-
-})->covers('crush_png');
+    expect(str_chop($value, 20))
+        ->toBeString()
+        ->toContain('...')
+        ->toHaveLength(23);
+
+})->covers('str_chop');
+
+//it('can crush png', function () {
+//    $version = null;
+//
+//    if ($pngcrush = exec('which pngcrush')) {
+//        $version = exec($pngcrush.' --version');
+//    }
+//
+//    expect($version)->toBeString();
+//    // ->toContain('pngcrush');
+//
+//})->covers('crush_png');