[CalendarServer-changes] [10780] CalendarServer/trunk/twext/who/idirectory.py

[source_changes at macosforge.org]

Revision: 10780
          http://trac.calendarserver.org//changeset/10780
Author:   wsanchez at apple.com
Date:     2013-02-21 16:45:14 -0800 (Thu, 21 Feb 2013)
Log Message:
-----------
Add recordsFromExpression to IDirectoryService.

Modified Paths:
--------------
    CalendarServer/trunk/twext/who/idirectory.py

Modified: CalendarServer/trunk/twext/who/idirectory.py
===================================================================
--- CalendarServer/trunk/twext/who/idirectory.py	2013-02-22 00:37:09 UTC (rev 10779)
+++ CalendarServer/trunk/twext/who/idirectory.py	2013-02-22 00:45:14 UTC (rev 10780)
@@ -164,12 +164,22 @@
             types that are kept in this directory.
         """
 
+    def recordsFromExpression(self, expression):
+        """
+        Find records matching an expression.
+        @param expression: an expression to apply
+        @type expression: L{object}
+        @return: a deferred iterable of matching L{IDirectoryRecord}s.
+        @raises: L{QueryNotSupportedError} if the expression is not
+            supported by this directory service.
+        """
+
     def recordsFromQuery(expressions, operand=Operand.AND):
         """
-        Find records matching a query consisting of an iterable of
+        Find records by composing a query consisting of an iterable of
         expressions and an operand.
-        @param expressions: an iterable of expressions
-        @type expressions: L{object}
+        @param expressions: expressions to query against
+        @type expressions: iterable of L{object}s
         @param operand: an operand
         @type operand: a L{NamedConstant}
         @return: a deferred iterable of matching L{IDirectoryRecord}s.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/calendarserver-changes/attachments/20130221/ffaf3e9a/attachment.html>