Make 'publisher-profile-file' configuration file setting work. Note that the...

Make 'publisher-profile-file' configuration file setting work.  Note that the environment variable "PROFILE_PUBLISHER" has been banished with this change.  We also change the core of Publish.py to not conditionally define functions in order to have a bit more control over the process.

lib/python/App/dtml/profile.dtml

@@ -64,9 +64,9 @@ Python profiler documentation</a>.
 <div class="form-text">
 Profiling is not currently enabled or there is not yet any profiling
 data to report.  To enable profiling, restart the Zope process with
-the environment variable PROFILE_PUBLISHER defined. The value of this 
-variable should be the full system path to a file that will be used 
-to dump a profile report when the process restarts or exits.
+the configuration setting 'publisher-profile-file' defined. The value
+of this variable should be the full system path to a file that will be
+used to dump a profile report when the process restarts or exits.
 </div>
 </dtml-if>
 </dtml-let>

lib/python/ZPublisher/Publish.py

@@ -12,8 +12,8 @@
 ##############################################################################
 __doc__="""Python Object Publisher -- Publish Python objects on web servers
 
-$Id: Publish.py,v 1.164 2003/04/18 13:51:21 andreasjung Exp $"""
-__version__='$Revision: 1.164 $'[11:-2]
+$Id: Publish.py,v 1.165 2003/10/21 14:10:16 chrism Exp $"""
+__version__='$Revision: 1.165 $'[11:-2]
 
 import sys, os
 from Response import Response
@@ -142,7 +142,7 @@ def publish(request, module_name, after_list, debug=0,
         else: raise
 
 
-def publish_module(module_name,
+def publish_module_standard(module_name,
                    stdin=sys.stdin, stdout=sys.stdout, stderr=sys.stderr,
                    environ=os.environ, debug=0, request=None, response=None):
     must_die=0
@@ -295,20 +295,18 @@ class DefaultTransactionsManager:
         if auth_user is not None:
             T.setUser(auth_user, request_get('AUTHENTICATION_PATH'))
 
+# profiling support
 
-# ZPublisher profiler support
-# ---------------------------
-
-if os.environ.get('PROFILE_PUBLISHER', None):
-
-    import profile, pstats
+_pfile = None # profiling filename
+_plock=allocate_lock() # profiling lock
+_pfunc=publish_module_standard
+_pstat=None
 
-    _pfile=os.environ['PROFILE_PUBLISHER']
-    _plock=allocate_lock()
-    _pfunc=publish_module
-    _pstat=None
+def install_profiling(filename):
+    global _pfile
+    _pfile = filename
     
-    def pm(module_name, stdin, stdout, stderr,
+def pm(module_name, stdin, stdout, stderr,
        environ, debug, request, response):
     try:
         r=_pfunc(module_name, stdin=stdin, stdout=stdout,
@@ -317,9 +315,10 @@ if os.environ.get('PROFILE_PUBLISHER', None):
     except: r=None
     sys._pr_=r
 
-    def publish_module(module_name, stdin=sys.stdin, stdout=sys.stdout,
+def publish_module_profiled(module_name, stdin=sys.stdin, stdout=sys.stdout,
                             stderr=sys.stderr, environ=os.environ, debug=0,
                             request=None, response=None):
+    import profile, pstats
     global _pstat
     _plock.acquire()
     try:
@@ -358,3 +357,15 @@ if os.environ.get('PROFILE_PUBLISHER', None):
         except: pass
         raise error[0], error[1], error[2]
     return result
+
+def publish_module(module_name,
+                   stdin=sys.stdin, stdout=sys.stdout, stderr=sys.stderr,
+                   environ=os.environ, debug=0, request=None, response=None):
+    """ publish a Python module, with or without profiling enabled """
+    if _pfile: # profiling is enabled
+        return publish_module_profiled(module_name, stdin, stdout, stderr,
+                                       environ, debug, request, response)
+    else:
+        return publish_module_standard(module_name, stdin, stdout, stderr,
+                                       environ, debug, request, response)
+

lib/python/ZServer/PubCore/ZServerPublisher.py

@@ -10,10 +10,10 @@
 # FOR A PARTICULAR PURPOSE
 #
 ##############################################################################
-from ZPublisher import publish_module
 
 class ZServerPublisher:
     def __init__(self, accept):
+        from ZPublisher import publish_module
         while 1:
             try:
                 name, request, response=accept()

lib/python/Zope/Startup/handlers.py

@@ -103,6 +103,8 @@ def maximum_security_manager_stack_size(value):
 
 def publisher_profile_file(value):
     value is not None and _setenv('PROFILE_PUBLISHER', value)
+    from ZPublisher.Publish import install_profiling
+    install_profiling(value)
     return value
 
 def http_realm(value):

skel/etc/zope.conf.in

@@ -428,6 +428,21 @@ instancehome $INSTANCE
 #
 #    maximum-security-manager-stack-size 200
 
+# Directive: publisher-profile-file
+#
+# Description:
+#    Names a file on the filesystem which causes Zope's Python
+#    profiling capabilities to be enabled.  For more information, see
+#    the Debug Information - > Profiling tab of Zope's Control_Panel
+#    via the Zope Management Interface.  IMPORTANT: setting this
+#    filename will cause Zope code to be executed much more slowly
+#    than normal.  This should not be enabled in production.  #
+# Default: unset
+#
+# Example:
+#
+#    publisher-profile-file $INSTANCE/var/profile.dat
+
 
 # Directive: security-policy-implementation
 #