[Buildbot-commits] buildbot/buildbot interfaces.py,1.63,1.64

[Brian Warner]

Update of /cvsroot/buildbot/buildbot/buildbot
In directory sc8-pr-cvs3.sourceforge.net:/tmp/cvs-serv17815/buildbot

Modified Files:
	interfaces.py 
Log Message:
[project @ limit the number of builds we examine in generateFinishedBuilds]

Original author: warner at lothar.com
Date: 2007-09-30 18:47:26+00:00

Index: interfaces.py
===================================================================
RCS file: /cvsroot/buildbot/buildbot/buildbot/interfaces.py,v
retrieving revision 1.63
retrieving revision 1.64
diff -u -d -r1.63 -r1.64
--- interfaces.py	12 Aug 2007 23:17:12 -0000	1.63
+++ interfaces.py	30 Sep 2007 18:48:12 -0000	1.64
@@ -159,7 +159,8 @@
         """Return a list of active (non-finished) IBuildSetStatus objects."""
 
     def generateFinishedBuilds(builders=[], branches=[],
-                               num_builds=None, finished_before=None):
+                               num_builds=None, finished_before=None,
+                               max_search=200):
         """Return a generator that will produce IBuildStatus objects each
         time you invoke its .next() method, starting with the most recent
         finished build and working backwards.
@@ -181,6 +182,14 @@
         @type finished_before: int: a timestamp, seconds since the epoch
         @param finished_before: if provided, do not produce any builds that
                                 finished after the given timestamp.
+
+        @type max_search: int
+        @param max_search: this method may have to examine a lot of builds
+                           to find some that match the search parameters,
+                           especially if there aren't any matching builds.
+                           This argument imposes a hard limit on the number
+                           of builds that will be examined within any given
+                           Builder.
         """
 
     def subscribe(receiver):
@@ -348,7 +357,8 @@
 
     def generateFinishedBuilds(branches=[],
                                num_builds=None,
-                               max_buildnum=None, finished_before=None
+                               max_buildnum=None, finished_before=None,
+                               max_search=200,
                                ):
         """Return a generator that will produce IBuildStatus objects each
         time you invoke its .next() method, starting with the most recent
@@ -378,6 +388,13 @@
         @type finished_before: int: a timestamp, seconds since the epoch
         @param finished_before: if provided, do not produce any builds that
                                 finished after the given timestamp.
+
+        @type max_search: int
+        @param max_search: this method may have to examine a lot of builds
+                           to find some that match the search parameters,
+                           especially if there aren't any matching builds.
+                           This argument imposes a hard limit on the number
+                           of builds that will be examined.
         """
 
     def subscribe(receiver):