Add regex project endpoint

Since the project query parameter is unable to search by regex,
add it explicity. This addition makes it easier to narrow down project
results where the regular query option "inname" is insufficent.

Author: DanSoQt

gerrit/projects/projects.py

@@ -43,6 +43,26 @@ def search(self, query):
         result = self.gerrit.decode_response(response)
         return GerritProject.parse_list(result, gerrit=self.gerrit)
 
+    def regex(self, query):
+        """
+        Regex queries projects visible to the caller.
+        The query string must be provided by the query parameter.
+        The start and limit parameters can be used to skip/limit results.
+
+        query parameter
+         * Boundary matchers '^' and '$' are implicit.
+         * For example: the regex 'test.*' will match any projects that start with 'test' and regex
+           '.*test' will match any project that end with 'test'.
+         * The match is case sensitive.
+
+        :param query:
+        :return:
+        """
+        endpoint = "/projects/?r=%s" % query
+        response = self.gerrit.requester.get(self.gerrit.get_endpoint_url(endpoint))
+        result = self.gerrit.decode_response(response)
+        return GerritProject.parse_dict(result, gerrit=self.gerrit)
+
     def get(self, project_name):
         """
         Retrieves a project.

gerrit/utils/models.py

@@ -39,6 +39,16 @@ def parse_list(cls, data, **kwargs):
                 results.append(cls.parse(obj, **kwargs))
         return results
 
+    @classmethod
+    def parse_dict(cls, data, **kwargs):
+        """Parse a dict of JSON objects into a result set of model instances."""
+        results = ResultSet()
+        data = data or []
+        for obj in data.keys():
+            if obj:
+                results.append(cls.parse(data[obj], **kwargs))
+        return results
+
     def __repr__(self):
         key = self.attributes[0]
         value = getattr(self, key)