Add method fromClass to TemplatedMessageExceptionTrait

Author: TiSiE

src/Exception/TemplatedMessageExceptionTrait.php

@@ -15,10 +15,23 @@
  * Boilerplate for an exception with templated message.
  *
  * @author Mathias Gelhausen <gelhausen@cross-solution.de>
- * @todo write tests
  */
 trait TemplatedMessageExceptionTrait
 {
+    /**
+     * Creates an exception with templated message.
+     *
+     * Pass in arguments as you would to _sprintf_:
+     * The first argument is the template string, the following
+     * arguments are the replacements.
+     *
+     * If the last argument passed is an instanceof \Throwable, it is used
+     * as previous exception argument to the \Exception constructor.
+     *
+     * @param  array     $args
+     *
+     * @return \Exception
+     */
     public static function create(...$args): \Exception
     {
         $ex      = end($args) instanceof \Throwable ? array_pop($args) : null;
@@ -27,12 +40,36 @@ public static function create(...$args): \Exception
         return new static($message, 0, $ex);
     }
 
+    /**
+     * Creates an exception with templated message prepended by the class name.
+     *
+     * @param  string     $class
+     * @param  string     $message
+     * @param  array      ...$args
+     *
+     * @return \Exception
+     */
+    public static function fromClass(string $class, string $message, ...$args): \Exception
+    {
+        $message = '%s: ' . $message;
+
+        return static::create($message, $class, ...$args);
+    }
+
+    /**
+     * Creates an exception with templated message prepended by trait and class name.
+     *
+     * @param  string     $trait
+     * @param  string     $class
+     * @param  string     $message
+     * @param  array      ...$args
+     *
+     * @return \Exception
+     */
     public static function fromTrait(string $trait, string $class, string $message, ...$args): \Exception
     {
-        if (count($args)) {
-            $message = sprintf($message, ...$args);
-        }
+        $message = '%s: %s: ' . $message;
 
-        return static::create('%s: %s: %s', $trait, $class, $message);
+        return static::create($message, $trait, $class, ...$args);
     }
 }

test/TestUtilsTest/Exception/TemplatedMessageExceptionTraitTest.php

@@ -41,6 +41,13 @@ public function testCreateWithPrevious()
         static::assertSame($ex, $target->getPrevious());
     }
 
+    public function testFromClass()
+    {
+        $target = InvalidUsageException::fromClass('CLASS', '%s', 'value1');
+
+        static::assertEquals('CLASS: value1', $target->getMessage());
+    }
+
     public function testFromTrait()
     {
         $target = InvalidUsageException::fromTrait('TRAIT', 'CLASS', '%s', 'value1');