[prev in list] [next in list] [prev in thread] [next in thread] 

List:       calendarserver-changes
Subject:    [CalendarServer-changes] [2342]
From:       source_changes () macosforge ! org
Date:       2008-04-24 21:25:56
Message-ID: 20080424212556.F417F15DBAC2 () beta ! macosforge ! org
[Download RAW message or body]

[Attachment #2 (multipart/alternative)]


Revision: 2342
          http://trac.macosforge.org/projects/calendarserver/changeset/2342
Author:   wsanchez@apple.com
Date:     2008-04-24 14:25:54 -0700 (Thu, 24 Apr 2008)

Log Message:
-----------
doc

Modified Paths:
--------------
    CalendarServer/branches/users/wsanchez/logging/twistedcaldav/log.py

Modified: CalendarServer/branches/users/wsanchez/logging/twistedcaldav/log.py
===================================================================
--- CalendarServer/branches/users/wsanchez/logging/twistedcaldav/log.py	2008-04-24 \
                21:13:16 UTC (rev 2341)
+++ CalendarServer/branches/users/wsanchez/logging/twistedcaldav/log.py	2008-04-24 \
21:25:54 UTC (rev 2342) @@ -64,6 +64,10 @@
 logLevelsByNamespace = {}
 
 def logLevelForNamespace(namespace):
+    """
+    @param namespace: a logging namespace
+    @return: the log level for the given namespace.
+    """
     if namespace in logLevelsByNamespace:
         return logLevelsByNamespace[namespace]
 
@@ -79,10 +83,18 @@
     return defaultLogLevel
 
 def setLogLevelForNamespace(namespace, level):
+    """
+    Sets the log level for a logging namespace.
+    @param namespace: a logging namespace
+    @param level: the log level for the given namespace.
+    """
     assert level in logLevels
     logLevelsByNamespace[namespace] = level
 
 def clearLogLevels():
+    """
+    Clears all log levels to the default.
+    """
     logLevelsByNamespace.clear()
 
 ##
@@ -110,6 +122,9 @@
         self.namespace = namespace
 
     def emit(self, level, message, **kwargs):
+        """
+        Called internally to emit log messages at a given log level.
+        """
         log.msg(
             str(message),
             isError = (level == "error"),
@@ -142,12 +157,29 @@
     logger = property(_getLogger, _setLogger)
 
 for level in logLevels:
+    doc = """
+    Emit a log message at log level C{%s}.
+    @param message: The message to emit.
+    """ % (level,)
+
+    #
+    # Attach methods to Logger
+    #
     def log_level(self, message, level=level, **kwargs):
         self.emit(level, message, **kwargs)
+
+    log_level.__doc__ = doc
+
     setattr(Logger, level, log_level)
 
+    #
+    # Attach methods to LoggingMixIn
+    #
     def log_level(self, message, level=level, **kwargs):
         self.logger.emit(level, message, **kwargs)
+
+    log_level.__doc__ = doc
+
     setattr(LoggingMixIn, "log_%s" % (level,), log_level)
 
 del level, log_level


[Attachment #5 (text/html)]

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /><style \
type="text/css"><!-- #msg dl { border: 1px #006 solid; background: #369; padding: \
6px; color: #fff; } #msg dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer { font-family: \
verdana,arial,helvetica,sans-serif; font-size: 10pt;  } #msg dl a { font-weight: \
bold} #msg dl a:link    { color:#fc3; }
#msg dl a:active  { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: \
bold; } #msg pre, #msg p { overflow: auto; background: #ffc; border: 1px #fc0 solid; \
padding: 6px; } #msg ul { overflow: auto; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: \
6px; } #patch { width: 100%; }
#patch h4 {font-family: \
verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
 #patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff  {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, \
#patch .copfile {border:1px solid #ccc;margin:10px 0;} #patch ins \
{background:#dfd;text-decoration:none;display:block;padding:0 10px;} #patch del \
{background:#fdd;text-decoration:none;display:block;padding:0 10px;} #patch .lines, \
                .info {color:#888;background:#fff;}
--></style>
<title>[2342] CalendarServer/branches/users/wsanchez/logging/twistedcaldav/log.py</title>
 </head>
<body>

<div id="msg">
<dl>
<dt>Revision</dt> <dd><a \
href="http://trac.macosforge.org/projects/calendarserver/changeset/2342">2342</a></dd>
 <dt>Author</dt> <dd>wsanchez@apple.com</dd>
<dt>Date</dt> <dd>2008-04-24 14:25:54 -0700 (Thu, 24 Apr 2008)</dd>
</dl>

<h3>Log Message</h3>
<pre>doc</pre>

<h3>Modified Paths</h3>
<ul>
<li><a href="#CalendarServerbranchesuserswsanchezloggingtwistedcaldavlogpy">CalendarServer/branches/users/wsanchez/logging/twistedcaldav/log.py</a></li>
 </ul>

</div>
<div id="patch">
<h3>Diff</h3>
<a id="CalendarServerbranchesuserswsanchezloggingtwistedcaldavlogpy"></a>
<div class="modfile"><h4>Modified: \
CalendarServer/branches/users/wsanchez/logging/twistedcaldav/log.py (2341 => \
2342)</h4> <pre class="diff"><span>
<span class="info">--- \
CalendarServer/branches/users/wsanchez/logging/twistedcaldav/log.py	2008-04-24 \
                21:13:16 UTC (rev 2341)
+++ CalendarServer/branches/users/wsanchez/logging/twistedcaldav/log.py	2008-04-24 \
21:25:54 UTC (rev 2342) </span><span class="lines">@@ -64,6 +64,10 @@
</span><span class="cx"> logLevelsByNamespace = {}
</span><span class="cx"> 
</span><span class="cx"> def logLevelForNamespace(namespace):
</span><ins>+    &quot;&quot;&quot;
+    @param namespace: a logging namespace
+    @return: the log level for the given namespace.
+    &quot;&quot;&quot;
</ins><span class="cx">     if namespace in logLevelsByNamespace:
</span><span class="cx">         return logLevelsByNamespace[namespace]
</span><span class="cx"> 
</span><span class="lines">@@ -79,10 +83,18 @@
</span><span class="cx">     return defaultLogLevel
</span><span class="cx"> 
</span><span class="cx"> def setLogLevelForNamespace(namespace, level):
</span><ins>+    &quot;&quot;&quot;
+    Sets the log level for a logging namespace.
+    @param namespace: a logging namespace
+    @param level: the log level for the given namespace.
+    &quot;&quot;&quot;
</ins><span class="cx">     assert level in logLevels
</span><span class="cx">     logLevelsByNamespace[namespace] = level
</span><span class="cx"> 
</span><span class="cx"> def clearLogLevels():
</span><ins>+    &quot;&quot;&quot;
+    Clears all log levels to the default.
+    &quot;&quot;&quot;
</ins><span class="cx">     logLevelsByNamespace.clear()
</span><span class="cx"> 
</span><span class="cx"> ##
</span><span class="lines">@@ -110,6 +122,9 @@
</span><span class="cx">         self.namespace = namespace
</span><span class="cx"> 
</span><span class="cx">     def emit(self, level, message, **kwargs):
</span><ins>+        &quot;&quot;&quot;
+        Called internally to emit log messages at a given log level.
+        &quot;&quot;&quot;
</ins><span class="cx">         log.msg(
</span><span class="cx">             str(message),
</span><span class="cx">             isError = (level == &quot;error&quot;),
</span><span class="lines">@@ -142,12 +157,29 @@
</span><span class="cx">     logger = property(_getLogger, _setLogger)
</span><span class="cx"> 
</span><span class="cx"> for level in logLevels:
</span><ins>+    doc = &quot;&quot;&quot;
+    Emit a log message at log level C{%s}.
+    @param message: The message to emit.
+    &quot;&quot;&quot; % (level,)
+
+    #
+    # Attach methods to Logger
+    #
</ins><span class="cx">     def log_level(self, message, level=level, **kwargs):
</span><span class="cx">         self.emit(level, message, **kwargs)
</span><ins>+
+    log_level.__doc__ = doc
+
</ins><span class="cx">     setattr(Logger, level, log_level)
</span><span class="cx"> 
</span><ins>+    #
+    # Attach methods to LoggingMixIn
+    #
</ins><span class="cx">     def log_level(self, message, level=level, **kwargs):
</span><span class="cx">         self.logger.emit(level, message, **kwargs)
</span><ins>+
+    log_level.__doc__ = doc
+
</ins><span class="cx">     setattr(LoggingMixIn, &quot;log_%s&quot; % (level,), \
log_level) </span><span class="cx"> 
</span><span class="cx"> del level, log_level
</span></span></pre>
</div>
</div>

</body>
</html>



_______________________________________________
calendarserver-changes mailing list
calendarserver-changes@lists.macosforge.org
http://lists.macosforge.org/mailman/listinfo/calendarserver-changes


[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic