1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
|
<html>
<head>
<title>logging - clojure-contrib next API documentation</title>
<link href="../static/favicon.png" rel="icon" />
<link href="../static/favicon.png" rel="shortcut icon" />
<link media="all" type="text/css" href="../static/clojure.css" rel="stylesheet" />
<link media="all" type="text/css" href="../static/wiki.css" rel="stylesheet" />
<link media="all" type="text/css" href="../static/internal.css" rel="stylesheet" />
<!-- TODO: are we using these (from clojure.org)? If so, add the files -->
<script src="file/view/code_highlighter.js" type="text/javascript"></script>
<script src="file/view/clojure.js" type="text/javascript"></script>
<style>.menuWrapper{height: 36px;}</style>
<!--[if lte IE 6]>
<link rel="stylesheet" href="http://www.wikispaces.com/_/2009051601/s/internal_ie.css" type="text/css" />
<![endif]-->
</head>
<!--
This document was auto-generated from the source by the clojure autodoc system.
To report errors or ask questions about the overall documentation structure, formatting,
etc., contact Tom Faulhaber (google mail name: tomfaulhaber).
For errors in the documentation of a particular namespace, contact the author of that
namespace.
-->
<body>
<div id="AllContentContainer">
<div id="Header">
<a id="Logo" href="index.html"><img alt="Clojure" height="100" width="100" src="../static/clojure-icon.gif" /></a>
<h1><a title="page header title" id="page-header" href="index.html">Clojure-contrib API Reference</a></h1>
</div>
<div id="leftcolumn"><div style="text-align: center;"></div>
<div class="menu">
<div class="WikiCustomNav WikiElement wiki">
<span class="toc-header"><span id="project-name">clojure-contrib</span> <span id="version">next</span> API</span><br />
<ul>
<li><a class="wiki_link" href="index.html">Overview</a></li>
<li><a class="wiki_link" href="api-index.html">API Index</a></li>
</ul>
<span class="toc-header">Namespaces</span>
<ul id="left-sidebar-list">
<li><a href="accumulators-api.html" class="wiki_link">accumulators</a></li><li><a href="agent-utils-api.html" class="wiki_link">agent-utils</a></li><li><a href="apply-macro-api.html" class="wiki_link">apply-macro</a></li><li><a href="base64-api.html" class="wiki_link">base64</a></li><li><a href="classpath-api.html" class="wiki_link">classpath</a></li><li><a href="combinatorics-api.html" class="wiki_link">combinatorics</a></li><li><a href="command-line-api.html" class="wiki_link">command-line</a></li><li><a href="complex-numbers-api.html" class="wiki_link">complex-numbers</a></li><li><a href="cond-api.html" class="wiki_link">cond</a></li><li><a href="condition-api.html" class="wiki_link">condition</a></li><li><a href="core-api.html" class="wiki_link">core</a></li><li><a href="dataflow-api.html" class="wiki_link">dataflow</a></li><li><a href="datalog-api.html" class="wiki_link">datalog</a></li><li><a href="def-api.html" class="wiki_link">def</a></li><li><a href="duck-streams-api.html" class="wiki_link">duck-streams</a></li><li><a href="error-kit-api.html" class="wiki_link">error-kit</a></li><li><a href="except-api.html" class="wiki_link">except</a></li><li><a href="fcase-api.html" class="wiki_link">fcase</a></li><li><a href="find-namespaces-api.html" class="wiki_link">find-namespaces</a></li><li><a href="fnmap-api.html" class="wiki_link">fnmap</a></li><li><a href="gen-html-docs-api.html" class="wiki_link">gen-html-docs</a></li><li><a href="generic.arithmetic-api.html" class="wiki_link">generic.arithmetic</a></li><li><a href="generic.collection-api.html" class="wiki_link">generic.collection</a></li><li><a href="generic.comparison-api.html" class="wiki_link">generic.comparison</a></li><li><a href="generic.functor-api.html" class="wiki_link">generic.functor</a></li><li><a href="generic.math-functions-api.html" class="wiki_link">generic.math-functions</a></li><li><a href="graph-api.html" class="wiki_link">graph</a></li><li><a href="greatest-least-api.html" class="wiki_link">greatest-least</a></li><li><a href="http.agent-api.html" class="wiki_link">http.agent</a></li><li><a href="http.connection-api.html" class="wiki_link">http.connection</a></li><li><a href="import-static-api.html" class="wiki_link">import-static</a></li><li><a href="io-api.html" class="wiki_link">io</a></li><li><a href="jar-api.html" class="wiki_link">jar</a></li><li><a href="java-utils-api.html" class="wiki_link">java-utils</a></li><li><a href="javadoc.browse-api.html" class="wiki_link">javadoc.browse</a></li><li><a href="jmx-api.html" class="wiki_link">jmx</a></li><li><a href="json-api.html" class="wiki_link">json</a></li><li><a href="lazy-seqs-api.html" class="wiki_link">lazy-seqs</a></li><li><a href="lazy-xml-api.html" class="wiki_link">lazy-xml</a></li><li><a href="logging-api.html" class="wiki_link">logging</a></li><li><a href="macro-utils-api.html" class="wiki_link">macro-utils</a></li><li><a href="macros-api.html" class="wiki_link">macros</a></li><li><a href="map-utils-api.html" class="wiki_link">map-utils</a></li><li><a href="math-api.html" class="wiki_link">math</a></li><li><a href="miglayout-api.html" class="wiki_link">miglayout</a></li><li><a href="mmap-api.html" class="wiki_link">mmap</a></li><li><a href="mock-api.html" class="wiki_link">mock</a></li><li><a href="monadic-io-streams-api.html" class="wiki_link">monadic-io-streams</a></li><li><a href="monads-api.html" class="wiki_link">monads</a></li><li><a href="ns-utils-api.html" class="wiki_link">ns-utils</a></li><li><a href="pprint-api.html" class="wiki_link">pprint</a></li><li><a href="priority-map-api.html" class="wiki_link">priority-map</a></li><li><a href="probabilities.finite-distributions-api.html" class="wiki_link">probabilities.finite-distributions</a></li><li><a href="probabilities.monte-carlo-api.html" class="wiki_link">probabilities.monte-carlo</a></li><li><a href="probabilities.random-numbers-api.html" class="wiki_link">probabilities.random-numbers</a></li><li><a href="profile-api.html" class="wiki_link">profile</a></li><li><a href="properties-api.html" class="wiki_link">properties</a></li><li><a href="prxml-api.html" class="wiki_link">prxml</a></li><li><a href="reflect-api.html" class="wiki_link">reflect</a></li><li><a href="repl-ln-api.html" class="wiki_link">repl-ln</a></li><li><a href="repl-utils-api.html" class="wiki_link">repl-utils</a></li><li><a href="seq-api.html" class="wiki_link">seq</a></li><li><a href="seq-utils-api.html" class="wiki_link">seq-utils</a></li><li><a href="server-socket-api.html" class="wiki_link">server-socket</a></li><li><a href="set-api.html" class="wiki_link">set</a></li><li><a href="shell-api.html" class="wiki_link">shell</a></li><li><a href="shell-out-api.html" class="wiki_link">shell-out</a></li><li><a href="singleton-api.html" class="wiki_link">singleton</a></li><li><a href="sql-api.html" class="wiki_link">sql</a></li><li><a href="str-utils-api.html" class="wiki_link">str-utils</a></li><li><a href="str-utils2-api.html" class="wiki_link">str-utils2</a></li><li><a href="stream-utils-api.html" class="wiki_link">stream-utils</a></li><li><a href="string-api.html" class="wiki_link">string</a></li><li><a href="strint-api.html" class="wiki_link">strint</a></li><li><a href="swing-utils-api.html" class="wiki_link">swing-utils</a></li><li><a href="test-complex-numbers-api.html" class="wiki_link">test-complex-numbers</a></li><li><a href="test-core-api.html" class="wiki_link">test-core</a></li><li><a href="test-dataflow-api.html" class="wiki_link">test-dataflow</a></li><li><a href="test-def-api.html" class="wiki_link">test-def</a></li><li><a href="test-fnmap-api.html" class="wiki_link">test-fnmap</a></li><li><a href="test-graph-api.html" class="wiki_link">test-graph</a></li><li><a href="test-greatest-least-api.html" class="wiki_link">test-greatest-least</a></li><li><a href="test-io-api.html" class="wiki_link">test-io</a></li><li><a href="test-is-api.html" class="wiki_link">test-is</a></li><li><a href="test-jmx-api.html" class="wiki_link">test-jmx</a></li><li><a href="test-json-api.html" class="wiki_link">test-json</a></li><li><a href="test-lazy-seqs-api.html" class="wiki_link">test-lazy-seqs</a></li><li><a href="test-logging-api.html" class="wiki_link">test-logging</a></li><li><a href="test-macro-utils-api.html" class="wiki_link">test-macro-utils</a></li><li><a href="test-math-api.html" class="wiki_link">test-math</a></li><li><a href="test-miglayout-api.html" class="wiki_link">test-miglayout</a></li><li><a href="test-mock-api.html" class="wiki_link">test-mock</a></li><li><a href="test-monads-api.html" class="wiki_link">test-monads</a></li><li><a href="test-profile-api.html" class="wiki_link">test-profile</a></li><li><a href="test-properties-api.html" class="wiki_link">test-properties</a></li><li><a href="test-prxml-api.html" class="wiki_link">test-prxml</a></li><li><a href="test-repl-utils-api.html" class="wiki_link">test-repl-utils</a></li><li><a href="test-seq-api.html" class="wiki_link">test-seq</a></li><li><a href="test-shell-api.html" class="wiki_link">test-shell</a></li><li><a href="test-sql-api.html" class="wiki_link">test-sql</a></li><li><a href="test-string-api.html" class="wiki_link">test-string</a></li><li><a href="test-strint-api.html" class="wiki_link">test-strint</a></li><li><a href="test-trace-api.html" class="wiki_link">test-trace</a></li><li><a href="test-with-ns-api.html" class="wiki_link">test-with-ns</a></li><li><a href="trace-api.html" class="wiki_link">trace</a></li><li><a href="types-api.html" class="wiki_link">types</a></li><li><a href="with-ns-api.html" class="wiki_link">with-ns</a></li><li><a href="zip-filter-api.html" class="wiki_link">zip-filter</a></li>
</ul>
<div class="BranchTOC">
<span class="toc-header">Other Versions</span>
<ul id="left-sidebar-branch-list">
<li><a href="../index.html" class="wiki_link">v1.2 (stable)</a></li><li><a href="../branch-1.1.x/index.html" class="wiki_link">v1.1 (stable)</a></li>
</ul>
</div>
<a href="http://clojure.org" class="wiki_link">Clojure Home</a>
</div>
</div>
</div>
<div id="rightcolumn">
<div id="Content">
<div class="contentBox"><div class="innerContentBox">
<div id="content_view" class="wiki wikiPage">
<div id="right-sidebar"><div id="toc">
<h1 class="nopad">Table of Contents</h1>
<div style="margin-left: 1em;" class="toc-section">
<a href="#toc0">Overview</a>
<div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/*allow-direct-logging*">*allow-direct-logging*</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/*force*">*force*</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/*impl-name*">*impl-name*</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/*log-factory*">*log-factory*</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/*logging-agent*">*logging-agent*</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/*tx-agent-levels*">*tx-agent-levels*</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/Log">Log</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/LogFactory">LogFactory</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/debug">debug</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/debugf">debugf</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/enabled?">enabled?</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/error">error</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/errorf">errorf</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/fatal">fatal</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/fatalf">fatalf</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/find-factory">find-factory</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/impl-enabled?">impl-enabled?</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/impl-get-log">impl-get-log</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/impl-name">impl-name</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/impl-write!">impl-write!</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/info">info</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/infof">infof</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/java-util-logging">java-util-logging</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/log">log</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/log*">log*</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/log-capture!">log-capture!</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/log-stream">log-stream</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/log-uncapture!">log-uncapture!</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/logf">logf</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/logp">logp</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/slf4j-logging">slf4j-logging</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/spy">spy</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/trace">trace</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/tracef">tracef</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/warn">warn</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/warnf">warnf</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.logging/with-logs">with-logs</a>
</div>
<br />
</div>
</div>
</div>
<div id="content-tag"><h1 id="overview">API for <span id="namespace-name">logging</span>
- <span id="header-project">clojure-contrib</span> <span id="header-version">next</span> (<span id="header-status">in development</span>)
</h1>
<span id="author-line">by <span id="author-name">Alex Taggart, with contributions and suggestions by Chris Dean, Phil
Hagelberg, Richard Newman, and Timothy Pratley</span><br /></span>
<br />Usage:
<pre>
(ns your-namespace
(:require <span id="long-name">clojure.contrib.logging</span>))
</pre><pre>
</pre><h2>Overview</h2>
<pre id="namespace-docstr">Logging macros which delegate to a specific logging implementation. At
runtime a specific implementation is selected from, in order, Apache
commons-logging, slf4j, log4j, and finally java.util.logging.
Logging levels are specified by clojure keywords corresponding to the
values used in log4j and commons-logging:
:trace, :debug, :info, :warn, :error, :fatal
Logging occurs with the log macro, or the level-specific convenience macros,
which write either directly or via an agent. See log* for more details
regarding direct vs agent logging.
The log macros will not evaluate their 'message' unless the specific logging
level is in effect. Alternately, you can use the spy macro when you have code
that needs to be evaluated, and also want to output the code and its result to
the log.
Unless otherwise specified, the current namespace (as identified by *ns*) will
be used as the log-ns (similar to how the java class name is usually used).
Note: your log configuration should display the name that was passed to the
logging implementation, and not perform stack-inspection, otherwise you'll see
something like "fn__72$impl_write_BANG__39__auto____81" in your logs.
Use the enabled? macro to write conditional code against the logging level
(beyond simply whether or not to call log, which is handled automatically).
You can redirect all java writes of System.out and System.err to the log
system by calling log-capture!. To bind *out* and *err* to the log system
invoke with-logs. In both cases a log-ns (e.g., "com.example.captured")
must be specified in order to namespace the output.
For those new to using a java logging library, the following is a very basic
configuration for log4j. Place it in a file called "log4j.properties"
and place that file (and the log4j JAR) on the classpath.
log4j.rootLogger=WARN, A1
log4j.logger.user=DEBUG
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%d %-5p %c: %m%n
The above will print messages to the console for :debug or higher if one is
in the user namespace, and :warn or higher in all other namespaces.</pre>
<br />
<h2>Public Variables and Functions</h2>
<div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/*allow-direct-logging*">*allow-direct-logging*</h2>
<span id="var-type">var</span><br />
<pre id="var-usage"></pre>
<pre id="var-docstr">A boolean indicating whether direct logging (as opposed to via an agent) is
allowed when not operating from within a transaction. Defaults to true.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/*force*">*force*</h2>
<span id="var-type">var</span><br />
<pre id="var-usage"></pre>
<pre id="var-docstr">Overrides the default rules for choosing between logging directly or via an
agent. Defaults to nil. See log* for details.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L94" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/*impl-name*">*impl-name*</h2>
<span id="var-type">var</span><br />
<pre id="var-usage"></pre>
<pre id="var-docstr">The name of the logging implementation used.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/*log-factory*">*log-factory*</h2>
<span id="var-type">var</span><br />
<pre id="var-usage"></pre>
<pre id="var-docstr">An instance satisfying the LogFactory protocol. Used internally when needing
to obtain an instance satisfying the Log protocol. Defaults to the value
returned from find-factory. Can be rebound to provide alternate logging
implementations</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L488" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/*logging-agent*">*logging-agent*</h2>
<span id="var-type">var</span><br />
<pre id="var-usage"></pre>
<pre id="var-docstr">The default agent used for performing logging durng a transaction or when
direct logging is disabled.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/*tx-agent-levels*">*tx-agent-levels*</h2>
<span id="var-type">var</span><br />
<pre id="var-usage"></pre>
<pre id="var-docstr">The set of levels that will require using an agent when logging from within a
running transaction. Defaults to #{:info :warn}. See log* for details.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L89" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/Log">Log</h2>
<span id="var-type">var</span><br />
<pre id="var-usage"></pre>
<pre id="var-docstr">The protocol through which macros will interact with an underlying logging
implementation. Implementations should at least support the six specified
logging levels if they wish to benefit from the level-specific macros.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L62" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/LogFactory">LogFactory</h2>
<span id="var-type">var</span><br />
<pre id="var-usage"></pre>
<pre id="var-docstr">The protocol through which macros will obtain an instance satisfying Log as
well as providing information about the particular implementation being used.
Implementations should be bound to *log-factory* in order to be picked up by
this library.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob/09c3ff39255cde416fe7bab6696b1db4f418c673/modules/logging/src/main/clojure/clojure/contrib/logging.clj#L73" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/debug">debug</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (debug message)
(debug message throwable)
</pre>
<pre id="var-docstr">Logs a message at the debug level.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/debugf">debugf</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (debugf fmt & fmt-args)
(debugf throwable fmt & fmt-args)
</pre>
<pre id="var-docstr">Debug level logging using format.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L301" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/enabled?">enabled?</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (enabled? level)
(enabled? level log-ns)
</pre>
<pre id="var-docstr">Returns true if the specific logging level is enabled. Use of this function
should only be necessary if one needs to execute alternate code paths beyond
whether the log should be written to.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/error">error</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (error message)
(error message throwable)
</pre>
<pre id="var-docstr">Logs a message at the error level.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/errorf">errorf</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (errorf fmt & fmt-args)
(errorf throwable fmt & fmt-args)
</pre>
<pre id="var-docstr">Error level logging using format.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L319" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/fatal">fatal</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (fatal message)
(fatal message throwable)
</pre>
<pre id="var-docstr">Logs a message at the fatal level.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/fatalf">fatalf</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (fatalf fmt & fmt-args)
(fatalf throwable fmt & fmt-args)
</pre>
<pre id="var-docstr">Fatal level logging using format.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L325" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/find-factory">find-factory</h2>
<span id="var-type">function</span><br />
<pre id="var-usage">Usage: (find-factory)
</pre>
<pre id="var-docstr">Returns the first LogFactory found that is available from commons-logging,
slf4j-logging, log4j-logging, or java-util-logging. End-users should not need
to call this.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L475" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/impl-enabled?">impl-enabled?</h2>
<span id="var-type">var</span><br />
<pre id="var-usage"></pre>
<pre id="var-docstr">Implementation-specific check if a particular level is enabled. End-users
should not need to call this.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/impl-get-log">impl-get-log</h2>
<span id="var-type">var</span><br />
<pre id="var-usage"></pre>
<pre id="var-docstr">Returns an implementation-specific log by string namespace. End-users should
not need to call this.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/impl-name">impl-name</h2>
<span id="var-type">function</span><br />
<pre id="var-usage">Usage: (impl-name factory)
</pre>
<pre id="var-docstr">Returns some text identifying the underlying implementation.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/impl-write!">impl-write!</h2>
<span id="var-type">var</span><br />
<pre id="var-usage"></pre>
<pre id="var-docstr">Implementation-specific write of a log message. End-users should not need to
call this.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/info">info</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (info message)
(info message throwable)
</pre>
<pre id="var-docstr">Logs a message at the info level.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/infof">infof</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (infof fmt & fmt-args)
(infof throwable fmt & fmt-args)
</pre>
<pre id="var-docstr">Info level logging using format.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L307" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/java-util-logging">java-util-logging</h2>
<span id="var-type">function</span><br />
<pre id="var-usage">Usage: (java-util-logging)
</pre>
<pre id="var-docstr">Returns a java.util.logging-based implementation of the LogFactory protocol,
or nil if not available. End-users should not need to call this.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L439" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/log">log</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (log level message)
(log level message throwable)
(log level message throwable log-ns)
</pre>
<pre id="var-docstr">Logs a message, either directly or via an agent. Also see the level-specific
convenience macros.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/log*">log*</h2>
<span id="var-type">function</span><br />
<pre id="var-usage">Usage: (log* log level throwable message)
</pre>
<pre id="var-docstr">Attempts to log a message, either directly or via an agent; does not check if
the level is enabled.
For performance reasons, an agent will only be used when invoked within a
running transaction, and only for logging levels specified by
*tx-agent-levels*. This allows those entries to only be written once the
transaction commits, and are discarded if it is retried or aborted. As
corollary, other levels (e.g., :debug, :error) will be written even from
failed transactions though at the cost of repeat messages during retries.
One can override the above by setting *force* to :direct or :agent; all
subsequent writes will be direct or via an agent, respectively.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L99" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/log-capture!">log-capture!</h2>
<span id="var-type">function</span><br />
<pre id="var-usage">Usage: (log-capture! log-ns)
</pre>
<pre id="var-docstr">Captures System.out and System.err, redirecting all writes of those streams
to :info and :error logging, respectively. The specified log-ns value will
be used to namespace all redirected logging. NOTE: this will not redirect
output of *out* or *err*; for that, use with-logs.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/log-stream">log-stream</h2>
<span id="var-type">function</span><br />
<pre id="var-usage">Usage: (log-stream level log-ns)
</pre>
<pre id="var-docstr">Creates a PrintStream that will output to the log. End-users should not need
to invoke this.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/log-uncapture!">log-uncapture!</h2>
<span id="var-type">function</span><br />
<pre id="var-usage">Usage: (log-uncapture!)
</pre>
<pre id="var-docstr">Restores System.out and System.err to their original values.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/logf">logf</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (logf level fmt & fmt-args)
(logf level throwable fmt & fmt-args)
</pre>
<pre id="var-docstr">Logs a message using a format string and args. Can optionally take a
throwable as its second arg. See level-specific macros, e.g., debugf.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L151" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/logp">logp</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (logp level message & more)
(logp level throwable message & more)
</pre>
<pre id="var-docstr">Logs a message using print style args. Can optionally take a throwable as its
second arg. See level-specific macros, e.g., debug.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L138" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/slf4j-logging">slf4j-logging</h2>
<span id="var-type">function</span><br />
<pre id="var-usage">Usage: (slf4j-logging)
</pre>
<pre id="var-docstr">Returns a SLF4J-based implementation of the LogFactory protocol, or nil if
not available. End-users should not need to call this.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L369" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/spy">spy</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (spy expr)
</pre>
<pre id="var-docstr">Evaluates expr and outputs the form and its result to the debug log; returns
the result of expr.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/trace">trace</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (trace message)
(trace message throwable)
</pre>
<pre id="var-docstr">Logs a message at the trace level.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/tracef">tracef</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (tracef fmt & fmt-args)
(tracef throwable fmt & fmt-args)
</pre>
<pre id="var-docstr">Trace level logging using format.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L295" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/warn">warn</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (warn message)
(warn message throwable)
</pre>
<pre id="var-docstr">Logs a message at the warn level.</pre>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/warnf">warnf</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (warnf fmt & fmt-args)
(warnf throwable fmt & fmt-args)
</pre>
<pre id="var-docstr">Warn level logging using format.</pre>
<a href="http://github.com/clojure/clojure-contrib/blob//modules/logging/target/classes/clojure/contrib/logging.clj#L313" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.logging/with-logs">with-logs</h2>
<span id="var-type">macro</span><br />
<pre id="var-usage">Usage: (with-logs log-ns & body)
</pre>
<pre id="var-docstr">Evaluates exprs in a context in which *out* and *err* are bound to :info and
:error logging, respectively. The specified log-ns value will be used to
namespace all redirected logging.</pre>
</div>
</div>
</div>
</div>
</div>
</div>
<div id="foot">
<div style="text-align: center;" id="copyright">Copyright 2007-2010 by Rich Hickey and the various contributors</div>
</div>
</div>
<div id="DesignedBy">Logo & site design by <a title="Visit Tom Hickey's website." href="http://www.tomhickey.com">Tom Hickey</a>.<br />
Clojure auto-documentation system by Tom Faulhaber.</div>
</div>
<!-- /AllContentContainer -->
</body>
</html>
|
