Merge pull request #1 from fguillot/master

Update from upstream

3 files changed, 132 insertions, 0 deletions

diff --git a/app/Core/Group/GroupBackendProviderInterface.php b/app/Core/Group/GroupBackendProviderInterface.php
new file mode 100644
index 00000000..74c5cb03
--- /dev/null
+++ b/app/Core/Group/GroupBackendProviderInterface.php
@@ -0,0 +1,21 @@
+<?php
+
+namespace Kanboard\Core\Group;
+
+/**
+ * Group Backend Provider Interface
+ *
+ * @package  group
+ * @author   Frederic Guillot
+ */
+interface GroupBackendProviderInterface
+{
+    /**
+     * Find a group from a search query
+     *
+     * @access public
+     * @param  string $input
+     * @return GroupProviderInterface[]
+     */
+    public function find($input);
+}
diff --git a/app/Core/Group/GroupManager.php b/app/Core/Group/GroupManager.php
new file mode 100644
index 00000000..48b6c4f8
--- /dev/null
+++ b/app/Core/Group/GroupManager.php
@@ -0,0 +1,71 @@
+<?php
+
+namespace Kanboard\Core\Group;
+
+/**
+ * Group Manager
+ *
+ * @package  group
+ * @author   Frederic Guillot
+ */
+class GroupManager
+{
+    /**
+     * List of backend providers
+     *
+     * @access private
+     * @var array
+     */
+    private $providers = array();
+
+    /**
+     * Register a new group backend provider
+     *
+     * @access public
+     * @param  GroupBackendProviderInterface $provider
+     * @return GroupManager
+     */
+    public function register(GroupBackendProviderInterface $provider)
+    {
+        $this->providers[] = $provider;
+        return $this;
+    }
+
+    /**
+     * Find a group from a search query
+     *
+     * @access public
+     * @param  string $input
+     * @return GroupProviderInterface[]
+     */
+    public function find($input)
+    {
+        $groups = array();
+
+        foreach ($this->providers as $provider) {
+            $groups = array_merge($groups, $provider->find($input));
+        }
+
+        return $this->removeDuplicates($groups);
+    }
+
+    /**
+     * Remove duplicated groups
+     *
+     * @access private
+     * @param  array $groups
+     * @return GroupProviderInterface[]
+     */
+    private function removeDuplicates(array $groups)
+    {
+        $result = array();
+
+        foreach ($groups as $group) {
+            if (! isset($result[$group->getName()])) {
+                $result[$group->getName()] = $group;
+            }
+        }
+
+        return array_values($result);
+    }
+}
diff --git a/app/Core/Group/GroupProviderInterface.php b/app/Core/Group/GroupProviderInterface.php
new file mode 100644
index 00000000..4c7c16ec
--- /dev/null
+++ b/app/Core/Group/GroupProviderInterface.php
@@ -0,0 +1,40 @@
+<?php
+
+namespace Kanboard\Core\Group;
+
+/**
+ * Group Provider Interface
+ *
+ * @package  group
+ * @author   Frederic Guillot
+ */
+interface GroupProviderInterface
+{
+    /**
+     * Get internal id
+     *
+     * You must return 0 if the group come from an external backend
+     *
+     * @access public
+     * @return integer
+     */
+    public function getInternalId();
+
+    /**
+     * Get external id
+     *
+     * You must return a unique id if the group come from an external provider
+     *
+     * @access public
+     * @return string
+     */
+    public function getExternalId();
+
+    /**
+     * Get group name
+     *
+     * @access public
+     * @return string
+     */
+    public function getName();
+}