composer.json - move tests-related classes to "autoload-dev" section (used for development purposes only and avoid polluting the autoloader in production)

src/Exception/Reflection/TooManyChildClassesException.php

@@ -0,0 +1,39 @@
+<?php
+
+/**
+ * (c) Meritoo.pl, http://www.meritoo.pl
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Meritoo\Common\Exception\Reflection;
+
+use Exception;
+use Meritoo\Common\Utilities\Reflection;
+
+/**
+ * An exception used while given class has more than one child class
+ *
+ * @author    Krzysztof Niziol <krzysztof.niziol@meritoo.pl>
+ * @copyright Meritoo.pl
+ */
+class TooManyChildClassesException extends Exception
+{
+    /**
+     * Class constructor
+     *
+     * @param array|object|string $parentClass  Class that has more than one child class, but it shouldn't. An array
+     *                                          of objects, strings, object or string.
+     * @param array               $childClasses Child classes
+     */
+    public function __construct($parentClass, array $childClasses)
+    {
+        $template = "The '%s' class requires one child class at most who will extend her, but more than one child"
+            . " class was found:\n- %s\n\nWhy did you create more than one classes that extend '%s' class?";
+
+        $parentClassName = Reflection::getClassName($parentClass);
+        $message = sprintf($template, $parentClassName, implode("\n- ", $childClasses), $parentClassName);
+
+        parent::__construct($message);
+    }
+}