declare the interface first

src/zope/globalrequest/README.txt

@@ -7,7 +7,9 @@ Introduction
 This package provides a global way to retrieve the currently active request
 object in a zope-based web framework.
 
-Let's see if the test setup works:
+Let's just check the interfaces for now:
 
-  >>> from zope import globalrequest
+  >>> from zope.globalrequest.interfaces import IGlobalRequest
+  >>> IGlobalRequest
+  <InterfaceClass zope.globalrequest.interfaces.IGlobalRequest>
 

src/zope/globalrequest/__init__.py

@@ -1 +1,5 @@
-# the existance of __init__.py make this a module...
+from zope.interface.declarations import moduleProvides
+from zope.globalrequest.interfaces import IGlobalRequest
+
+moduleProvides(IGlobalRequest)
+

src/zope/globalrequest/interfaces.py

@@ -0,0 +1,16 @@
+from zope.interface import Interface
+
+
+class IGlobalRequest(Interface):
+    """ interface to handle retrieval and setting of the currently
+        used request object in a thread-local manner """
+
+    def getRequest():
+        """ return the currently active request object """
+
+    def setRequest(request):
+        """ set the request object to be returned by `getRequest` """
+
+    def clearRequest():
+        """ clear the stored request object """
+