Add user backend provider system

app/Core/Base.php

@@ -7,7 +7,7 @@ use Pimple\Container;
 /**
  * Base Class
  *
- * @package core
+ * @package Kanboard\Core
  * @author  Frederic Guillot
  *
  * @property \Kanboard\Analytic\TaskDistributionAnalytic             $taskDistributionAnalytic
@@ -22,6 +22,7 @@ use Pimple\Container;
  * @property \Kanboard\Core\Cache\BaseCache                          $cacheDriver
  * @property \Kanboard\Core\Event\EventManager                       $eventManager
  * @property \Kanboard\Core\Group\GroupManager                       $groupManager
+ * @property \Kanboard\Core\User\UserManager                         $userManager
  * @property \Kanboard\Core\Http\Client                              $httpClient
  * @property \Kanboard\Core\Http\OAuth2                              $oauth
  * @property \Kanboard\Core\Http\RememberMeCookie                    $rememberMeCookie

app/Core/Group/GroupBackendProviderInterface.php

@@ -5,7 +5,7 @@ namespace Kanboard\Core\Group;
 /**
  * Group Backend Provider Interface
  *
- * @package  group
+ * @package  Kanboard\Core\Group
  * @author   Frederic Guillot
  */
 interface GroupBackendProviderInterface

app/Core/Group/GroupManager.php

@@ -5,7 +5,7 @@ namespace Kanboard\Core\Group;
 /**
  * Group Manager
  *
- * @package  group
+ * @package  Kanboard\Core\Group
  * @author   Frederic Guillot
  */
 class GroupManager
@@ -13,10 +13,10 @@ class GroupManager
     /**
      * List of backend providers
      *
-     * @access private
+     * @access protected
      * @var array
      */
-    private $providers = array();
+    protected $providers = array();
 
     /**
      * Register a new group backend provider
@@ -52,11 +52,11 @@ class GroupManager
     /**
      * Remove duplicated groups
      *
-     * @access private
+     * @access protected
      * @param  array $groups
      * @return GroupProviderInterface[]
      */
-    private function removeDuplicates(array $groups)
+    protected function removeDuplicates(array $groups)
     {
         $result = array();
 

app/Core/Group/GroupProviderInterface.php

@@ -5,7 +5,7 @@ namespace Kanboard\Core\Group;
 /**
  * Group Provider Interface
  *
- * @package  group
+ * @package  Kanboard\Core\Group
  * @author   Frederic Guillot
  */
 interface GroupProviderInterface

app/Core/User/UserBackendProviderInterface.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Kanboard\Core\User;
+
+/**
+ * User Backend Provider Interface
+ *
+ * @package  Kanboard\Core\User
+ * @author   Frederic Guillot
+ */
+interface UserBackendProviderInterface
+{
+    /**
+     * Find a user from a search query
+     *
+     * @access public
+     * @param  string $input
+     * @return UserProviderInterface[]
+     */
+    public function find($input);
+}

app/Core/User/UserManager.php

@@ -0,0 +1,71 @@
+<?php
+
+namespace Kanboard\Core\User;
+
+/**
+ * User Manager
+ *
+ * @package  Kanboard\Core\User
+ * @author   Frederic Guillot
+ */
+class UserManager
+{
+    /**
+     * List of backend providers
+     *
+     * @access protected
+     * @var array
+     */
+    protected $providers = array();
+
+    /**
+     * Register a new group backend provider
+     *
+     * @access public
+     * @param  UserBackendProviderInterface $provider
+     * @return $this
+     */
+    public function register(UserBackendProviderInterface $provider)
+    {
+        $this->providers[] = $provider;
+        return $this;
+    }
+
+    /**
+     * Find a group from a search query
+     *
+     * @access public
+     * @param  string $input
+     * @return UserProviderInterface[]
+     */
+    public function find($input)
+    {
+        $groups = array();
+
+        foreach ($this->providers as $provider) {
+            $groups = array_merge($groups, $provider->find($input));
+        }
+
+        return $this->removeDuplicates($groups);
+    }
+
+    /**
+     * Remove duplicated users
+     *
+     * @access protected
+     * @param  array $users
+     * @return UserProviderInterface[]
+     */
+    protected function removeDuplicates(array $users)
+    {
+        $result = array();
+
+        foreach ($users as $user) {
+            if (! isset($result[$user->getUsername()])) {
+                $result[$user->getUsername()] = $user;
+            }
+        }
+
+        return array_values($result);
+    }
+}