Add Block::generateIdsUsing

Author: aarondfrancis

CHANGELOG.md

@@ -1 +1,5 @@
 # Changelog
+
+## 0.2.1 - 2021-05-20
+
+- Add `Block::generateIdsUsing`

src/Block.php

@@ -9,6 +9,11 @@
 
 class Block
 {
+    /**
+     * @var null|callable
+     */
+    public static $generateIdsUsing;
+
     /**
      * The language of the code that is being highlighted.
      *
@@ -80,7 +85,7 @@ public static function make($id = null)
     public function __construct($id = null)
     {
         // Generate a unique UUID.
-        $this->id = $id ?? (string)Str::uuid();
+        $this->id = $id ?? $this->generateId();
 
         // Set a default theme.
         $this->theme = config('torchlight.theme');
@@ -94,6 +99,16 @@ public function id()
         return $this->id;
     }
 
+    /**
+     * @return string
+     */
+    protected function generateId()
+    {
+        $id = is_callable(static::$generateIdsUsing) ? call_user_func(static::$generateIdsUsing) : Str::uuid();
+
+        return (string)$id;
+    }
+
     /**
      * @return string
      */

tests/BlockTest.php

@@ -113,7 +113,20 @@ public function default_theme_is_used()
         $block = Block::make('id');
 
         $this->assertEquals('a new default', $block->theme);
+    }
+
+    /** @test */
+    public function can_specify_an_id_generator()
+    {
+        Block::$generateIdsUsing = function () {
+            return 'generated_via_test';
+        };
+
+        $block = Block::make();
+
+        $this->assertEquals('generated_via_test', $block->id());
 
+        Block::$generateIdsUsing = null;
     }