[Buildbot-commits] buildbot/buildbot interfaces.py,1.33,1.34

[Brian Warner]

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

Modified Files:
	interfaces.py 
Log Message:
Revision: arch at buildbot.sf.net--2004/buildbot--dev--0--patch-334
Creator:  Brian Warner <warner at lothar.com>

add getURLForThing status method

	* buildbot/status/builder.py (Status.getURLForThing): add method
	to provide a URL for arbitrary IStatusFoo objects. The idea is to
	use this in email/IRC status clients to make them more useful, by
	providing the end user with hints on where to learn more about the
	object being reported on.
	* buildbot/test/test_web.py (GetURL): tests for it


Index: interfaces.py
===================================================================
RCS file: /cvsroot/buildbot/buildbot/buildbot/interfaces.py,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -d -r1.33 -r1.34
--- interfaces.py	14 Oct 2005 19:42:39 -0000	1.33
+++ interfaces.py	16 Oct 2005 06:25:34 -0000	1.34
@@ -96,6 +96,11 @@
     def getBuildbotURL():
         """Return the URL of the top-most Buildbot status page, or None if
         this Buildbot does not provide a web status page."""
+    def getURLFor(thing):
+        """Return the URL of a page which provides information on 'thing',
+        which should be an object that implements one of the status
+        interfaces defined in L{buildbot.interfaces}. Returns None if no
+        suitable page is available (or if no Waterfall is running)."""
 
     def getSchedulers():
         """Return a list of ISchedulerStatus objects for all
@@ -207,6 +212,7 @@
     def getPendingBuildsets():
         """Return an IBuildSet for all BuildSets that are pending. These
         BuildSets are waiting for their tree-stable-timers to expire."""
+        # TODO: this is not implemented anywhere
 
 
 class IBuilderStatus(Interface):