Add StaticCache::remember() (#94)

Co-authored-by: EncoreBot <[email protected]>

Author: onairmarc

.git-blame-ignore-revs

@@ -40,3 +40,4 @@ edb78e6307a371aff090127ce28aae9369605af8
 d4b03b64fcfc69e247b12f5f4afa4bd5f90ce5ab
 aa3797614d9280deb1b174d4878d484f2695efec
 e224e927dabcd3046455985118ed424c43aba054
+20e2de4b44af7511cb0eb6e6f71676253b4c2667

.idea/php.xml

@@ -3,6 +3,7 @@
 namespace EncoreDigitalGroup\StdLib\Objects\Support;
 
 use BackedEnum;
+use Closure;
 use EncoreDigitalGroup\StdLib\Objects\Support\Traits\StaticCacheEnabled;
 
 class StaticCache
@@ -66,6 +67,24 @@ public static function flush(BackedEnum|string|null $partition = null): void
         }
     }
 
+    public static function remember(BackedEnum|string $key, Closure $value, BackedEnum|string $partition = "default"): mixed
+    {
+        if (self::disabled()) {
+            return $value();
+        }
+
+        $partition = self::enum($partition);
+
+        if (self::contains($key, $partition)) {
+            return self::get($key, $partition);
+        }
+
+        $result = $value();
+        self::add($key, $result, $partition);
+
+        return $result;
+    }
+
     protected static function enum(BackedEnum|string $name): string
     {
         if ($name instanceof BackedEnum) {