318 lines
164 KiB
Plaintext
318 lines
164 KiB
Plaintext
|
rust
|
|||
|
|
ÑŒ #rustc 1.93.0 (254b59607 2026-01-19)Á“õ…·fÊvŠ ¦%g- -c48c539199cbc88bÁ ³VOÐêùÿ²?ÑL¼�§Ì± -a7a40eb546f9e2b0Á á\ƒ¦è3$|]åŒ[IÚ tæ -14b12edc9f8cd90bÁ ë&Gf·Ã ¬ëñq:¤»b -bb76018b1173caf6Áà 9m Ù„«ÐÒþá•c‘B; -030c5b0bba47cc8fÁ rustc_std_workspace_coreÁÛ¹þÓ7>H%¸ÚÉ’› -4b81d37a5530864dÁ üÃùs<Uß7VyóHr#QÏ -c66cc7807550ce25Á miniz_oxideÁõFÖˆÚ™ª‹"ÞXzLVª -62cbc7af83058505Á adler2Á—wÉD‘嵯�|6¨%Œ
|
|||
|
|
+ -2f171dd2394b4b62Á hashbrownÁ,ïcV¼¨ø¢:Ê\'È߈ -9571ba9e0f6c7a90Á rustc_std_workspace_allocÁ%¥Èxµù·¼5Ä3Bœ -aac566ad65903fa4Á
|
|||
|
|
std_detectÁMmáýZ^9õ Îà§e˜÷e -2edb296e590136d8Á rustc_demangleÁ@¼§VÉNb˜æ¨fHÌ+V3 -53b132e4a2fa6e26Á cfg_ifÁfÝv�.Å"ÒÜuPp¹ˆ¶ -f76b385d7d4d7f3eÁ addr2lineÁÕú-WiúQVÓ¬
|
|||
|
|
µT§�5 -fe25100bd73e48e4Á gimliÁ¹xLáÇí÷‘o ±Ñ8£Å -265ba9e6e4f70b3fÁ objectÁÔ³ÝzÓÿ¶ò°öM›¼òü` -9ae0d1f8ea52a318Á memchrÁRÎ÷׎™te~QÓ¿ØC\Ò -0bff3c8e8f4e489eÁ –©H�tGNÏ ·ˆ!á -d69228d077d46f36Á “ …| ¶<Ñ{ “,Û{ |Ñ{ ŒÐ{
|
|||
|
|
__log_keyÁLƒy¶<åx kvÁ$ïxtåx
|
|||
|
|
__log_valueÁ\È|¶<ª|�$´|tª|
|
|||
|
|
__log_value_svalÁ„燶<ć kv_svalÁL·œÄ‡
|
|||
|
|
__log_value_serdeÁŒüŠ¶<ØŠ kv_serdeÁT⊤؊
|
|||
|
|
__log_value_errorÁŒ¯Ž¶<�Ž kv_stdÁD—Ž”�Ž serdeÁ,�} ¶<
|
|||
|
|
serde_coreÁd´ �·} ¶<ž} �$¨} tž} q$Å~ ÑŒ™~ ÷ ,~ Ì™~ ܘ~ ÕD‰ ÑŒÕ~ ÷ ,é~ ÌÕ~ ÜÔ~ b\ ьž ÷ ,² Ìž Ü� KeyValuesÁL·é ¶<Žé �$˜é tŽé Ÿ
|
|||
|
|
kv_supportÁT©¶<”�$žt” testsÁ,‡Ÿ à$üž “ macrosÁ
|
|||
|
|
__logÁ
|
|||
|
|
log_enabledÁ
|
|||
|
|
|
|||
|
|
__log_enabledÁ
|
|||
|
|
__log_loggerÁ
|
|||
|
|
è
|
|||
|
|
‘
|
|||
|
|
º
|
|||
|
|
ó
|
|||
|
|
®
|
|||
|
|
LOGGERÁ STATEÁ
|
|||
|
|
UNINITIALIZEDÁ INITIALIZINGÁ INITIALIZEDÁ MAX_LOG_LEVEL_FILTERÁ LOG_LEVEL_NAMESÁ SET_LOGGER_ERRORÁ LEVEL_PARSE_ERRORÁ !Õ #¤ %“ %÷ (Í *û * maxÁ * to_level_filterÁ *‡ *£ / / * increment_severityÁ * decrement_severityÁ 4Õ 6¤ 8“ 8÷ ;Í =û =§ = to_levelÁ =‡ =£ B B =Ý =ö
|
|||
|
|
G 'aÁ G getÁ J‹ J builderÁ Jþ J metadataÁ J levelÁ JÈ Jé
|
|||
|
|
Q J module_path_staticÁ JÀ T J file_staticÁ JÈ X‹ X• Xþ X¾ XÍ XÈ Xé
|
|||
|
|
Xë XÀ X� XÈ X buildÁ
|
|||
|
|
e> g‹ g© gÍ gÈ l‹ l• lÍ lÈ lù r> LogÁ t enabledÁ t logÁ t flushÁ NopLoggerÁ x
|
|||
|
|
zê zø z‚ ~™ ~ê ~ø ~‚ ƒ™ ƒê ƒø ƒ‚ ˆ™ ˆê ˆø ˆ‚
|
|||
|
|
set_max_levelÁ set_max_level_racyÁ max_levelÁ set_boxed_loggerÁ �
|
|||
|
|
set_loggerÁ ’ set_logger_innerÁ ” FÁ set_logger_racyÁ —Í šÍ loggerÁ � NOPÁ
|
|||
|
|
__private_apiÁ Ÿ ŸŸŸŸŸŸŸŸŸ Ÿ
|
|||
|
|
Ÿ Ÿ Ÿ ValueÁ ‹ Ÿ sealedÁ ¯ KVsÁ °‹ ° into_kvsÁ Ÿ ³‹ ³Œ Ÿ¶‹ ¶Œ Ÿ¹ê ¹ø ¹‚ Ÿ log_implÁ ½ LÁ Ÿø ¿‹ ¿ KÁ ¿ó Ÿê Ãó Ÿ locÁ STATIC_MAX_LEVELÁ
|
|||
|
|
ø
|
|||
|
|
errorÁ
|
|||
|
|
º
|
|||
|
|
infoÁ
|
|||
|
|
ã
|
|||
|
|
traceÁ LevelÁ Í” Î
|
|||
|
|
Î Í WarnÁ Ñ
|
|||
|
|
Í InfoÁ Ó
|
|||
|
|
Í� Õ
|
|||
|
|
Í TraceÁ ×
|
|||
|
|
ÚÈ ÞÕ à˜ â¤ äÐ !æÍ "è¢ éµ LevelFilterÁ ë OffÁ ì
|
|||
|
|
ë” î
|
|||
|
|
ë¥ ð
|
|||
|
|
ë¶ ò
|
|||
|
|
ë� ô
|
|||
|
|
ëÔ ö
|
|||
|
|
# $ùÈ % & 'ýÕ (ÿ˜ )�¤ *ƒÐ +…Í ,‡¢ ˆµ MaybeStaticStrÁ Š‹ Š StaticÁ Œ
|
|||
|
|
Œì Š BorrowedÁ �
|
|||
|
|
�ì -’‹ .”‹ /–‹ –È 0™‹ ™˜ 1œ‹ 2ž‹ žÕ 3¡‹ ¡Ð 4¤‹ ¤¤ 5§‹ §¢ ©µ 6«‹ «Í RecordÁ ®‹ ®¾ ®þ ®é
|
|||
|
|
®À ®È 7µ‹ µÈ 8¸‹ ¸Í
|
|||
|
|
RecordBuilderÁ »‹ » recordÁ 9¾‹ ¾Í MetadataÁ Á‹ ÁÍ ÁÈ :Å‹ ÅÈ ;È‹ Ș <Ë‹ =Í‹ ÍÕ >Ћ ÐÐ ?Ó‹ Ó¤ @Ö‹ Ö¢ ص AÚ‹ ÚÍ MetadataBuilderÁ Ý‹ ݾ Bà‹ à˜ Cã‹ Då‹ åÕ Eè‹ èÐ Fë‹ ë¤ Gî‹ î¢ ðµ Hò‹ òÍ SetLoggerErrorÁ õ
|
|||
|
|
õì IøÍ ParseLevelErrorÁ ú
|
|||
|
|
úì JýÍ K L€Õ M‚˜ Ÿ GlobalLoggerÁ „
|
|||
|
|
Ÿ†Í "
|
|||
|
|
"
|
|||
|
|
$
|
|||
|
|
$
|
|||
|
|
'
|
|||
|
|
)
|
|||
|
|
)
|
|||
|
|
)
|
|||
|
|
-
|
|||
|
|
.
|
|||
|
|
2
|
|||
|
|
3
|
|||
|
|
5
|
|||
|
|
5
|
|||
|
|
7
|
|||
|
|
7
|
|||
|
|
:
|
|||
|
|
<
|
|||
|
|
<
|
|||
|
|
<
|
|||
|
|
@
|
|||
|
|
A
|
|||
|
|
E
|
|||
|
|
F
|
|||
|
|
I
|
|||
|
|
M
|
|||
|
|
N
|
|||
|
|
O
|
|||
|
|
P
|
|||
|
|
Q
|
|||
|
|
S
|
|||
|
|
T
|
|||
|
|
V
|
|||
|
|
W
|
|||
|
|
[
|
|||
|
|
\
|
|||
|
|
]
|
|||
|
|
^
|
|||
|
|
_
|
|||
|
|
`
|
|||
|
|
a
|
|||
|
|
b
|
|||
|
|
c
|
|||
|
|
d
|
|||
|
|
e
|
|||
|
|
j
|
|||
|
|
k
|
|||
|
|
o
|
|||
|
|
p
|
|||
|
|
q
|
|||
|
|
r
|
|||
|
|
u
|
|||
|
|
u
|
|||
|
|
u
|
|||
|
|
v
|
|||
|
|
v
|
|||
|
|
v
|
|||
|
|
w
|
|||
|
|
{
|
|||
|
|
{
|
|||
|
|
{
|
|||
|
|
|
|
|||
|
|
|
|
|||
|
|
|
|
|||
|
|
}
|
|||
|
|
~
|
|||
|
|
€
|
|||
|
|
€
|
|||
|
|
€
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
‚
|
|||
|
|
…
|
|||
|
|
…
|
|||
|
|
…
|
|||
|
|
†
|
|||
|
|
†
|
|||
|
|
†
|
|||
|
|
‡
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
‹
|
|||
|
|
‹
|
|||
|
|
‹
|
|||
|
|
Œ
|
|||
|
|
˜
|
|||
|
|
˜
|
|||
|
|
˜
|
|||
|
|
›
|
|||
|
|
›
|
|||
|
|
›
|
|||
|
|
º
|
|||
|
|
º
|
|||
|
|
º
|
|||
|
|
»
|
|||
|
|
»
|
|||
|
|
»
|
|||
|
|
¼
|
|||
|
|
½
|
|||
|
|
½
|
|||
|
|
½
|
|||
|
|
½
|
|||
|
|
½
|
|||
|
|
½
|
|||
|
|
½
|
|||
|
|
¿
|
|||
|
|
¿
|
|||
|
|
¿
|
|||
|
|
¿
|
|||
|
|
Ã
|
|||
|
|
Û
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
á
|
|||
|
|
ã
|
|||
|
|
ã
|
|||
|
|
å
|
|||
|
|
å
|
|||
|
|
ç
|
|||
|
|
ç
|
|||
|
|
ç
|
|||
|
|
é
|
|||
|
|
é
|
|||
|
|
ú
|
|||
|
|
þ
|
|||
|
|
þ
|
|||
|
|
€
|
|||
|
|
‚
|
|||
|
|
‚
|
|||
|
|
„
|
|||
|
|
„
|
|||
|
|
†
|
|||
|
|
†
|
|||
|
|
†
|
|||
|
|
ˆ
|
|||
|
|
ˆ
|
|||
|
|
˜
|
|||
|
|
›
|
|||
|
|
|
|||
|
|
|
|||
|
|
£
|
|||
|
|
£
|
|||
|
|
¦
|
|||
|
|
¦
|
|||
|
|
©
|
|||
|
|
©
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
·
|
|||
|
|
º
|
|||
|
|
º
|
|||
|
|
º
|
|||
|
|
À
|
|||
|
|
À
|
|||
|
|
À
|
|||
|
|
Ç
|
|||
|
|
Ê
|
|||
|
|
Ï
|
|||
|
|
Ï
|
|||
|
|
Ò
|
|||
|
|
Ò
|
|||
|
|
Õ
|
|||
|
|
Õ
|
|||
|
|
Ø
|
|||
|
|
Ø
|
|||
|
|
Ü
|
|||
|
|
Ü
|
|||
|
|
Ü
|
|||
|
|
â
|
|||
|
|
ç
|
|||
|
|
ç
|
|||
|
|
ê
|
|||
|
|
ê
|
|||
|
|
í
|
|||
|
|
í
|
|||
|
|
ð
|
|||
|
|
ð
|
|||
|
|
ô
|
|||
|
|
ô
|
|||
|
|
ô
|
|||
|
|
ù
|
|||
|
|
ù
|
|||
|
|
ù
|
|||
|
|
þ
|
|||
|
|
þ
|
|||
|
|
þ
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
ƒ
|
|||
|
|
‡
|
|||
|
|
‡
|
|||
|
|
‡
|
|||
|
|
t°á Í Î Ï” Ð Ñ Ò¥ Ó Ô¶ Õ Ö� × ØÔ ™l˜Þ<g Þñ, þ ñ, ¬âñ, žñ,ñ, £ñ, Éñ,ñ, Ãñ, à`ñ, »bñ, žñ, ë ì íà î ï” ð ñ¥ ò ó¶ ô õ� ö ÷Ô cÕ¦w]ÛåÕ Éñ,Å. Ôvñ, å`ñ, áÅ. ÞÅ. þ Å. ¬âÅ. žÅ.Å. £Å. ÉÅ.Å. ÃÅ. à`Å. »bÅ. žÅ.ñ, ÉÅ.ñ, ÔvÅ. å`Å. þ Š Œ �¶ Žì � �Ñ ‘ì Ȫ›êPª5 ‹ áý0 Þý0 £ý0 ¬âý0 žý0ý0 Ãý0 Éý0ý0 »bý0 à`ý0 Þ ® ® ¥ °¾ ±þ ²é
|
|||
|
|
³À ´È Ý•©^.Ѥ» ‹ à`¶2 à` » » Š ½§ ÝDŒˆH »Ë ‹ Ä » » Š ½§ ÝDŒˆH »Ë 8 Þ Á Á È ÃÍ ÄÈ óÃ=!n3- ‹ £–4 ¬â–4 ž–4–4 Ö4 É–4–4 »b–4 à`–4 £ Ý Ý �" ß¾ W“ÀjzW< ‹ ¬â§5 ž§5§5 ç5 ɧ5§5 »b§5 à`§5 Ä Ý Ý �" ß¾ W“ÀjzW< 8 t x x yŽ ææX³cô` t 8™ t•• – BoxÁ ™ìƒ šíƒ l Õ°Ù[¢'õ ™•E•E–E GlobalÁ Ï€ûkW¬ s t“7“7 I –7÷ Ï6 —7 phantomÁÏ6 ˜7áÏ6 Ç *ÅÇr pÔ7Ú7 à` õ õ öÁ# ÷ì sÀLTbE' å`ã8 Ïã8 à` ú ú ûï# üì û€�Љ ¬â®9 ž®9®9 £®9 å`®9 Ï®9 ° ‹
|
|||
|
|
‹ ¤: ‹ ° ‹ à` „ „ …»$ ÁUì °xD tÍ: Ù Íø ë” ŠÚ Íù ë– Šµ ®Å ÁÜ Íû ë’ ŠÝ Íü ëœ ŠË Áã Ýÿ úÞ Í! Íý ë4 ëž ŠÍ Áå Ý€ úà Íÿ ë™ ŠÈ Áà Ý‚ úâ Í# Í� ë6 ë¤ ŠÓ Áë Ýä ̓ ë¡ ŠÐ Áè Ýæ Í… ë« Š¸ ®¾ »Ú Áò Ýø õý ú† „è ͇ ë§ ŠÖ Áî Ý% Í8 ë( Í; ë— õš úe »r Ýz x~
|
|||
|
|
ƒ•ˆ“7¹ „™ õœ ú³
|
|||
|
|
¶
|
|||
|
|
áúÞþ #¬âž*£6É*Ã/à`
|
|||
|
|
#»bFÔv#å` Ä t Ï ° 0Á Ó? 1Á Ó? 2Á Ó? 6Á Ó? 1Á°M®˜
|
|||
|
|
øTœœ øNÔ˜' Nú˜ „ÿ˜
|
|||
|
|
ë ' øOž™) OÆ™ ”Ë™
|
|||
|
|
ë ' øPì™( P“š Œ˜š
|
|||
|
|
ë ' øQ¸š(
|
|||
|
|
Qßš Œäš
|
|||
|
|
ë ' øR„›) R¬› ”±›
|
|||
|
|
ë ' øSÒ›)
|
|||
|
|
Sú› ”ÿ›
|
|||
|
|
ë ' ,É› Tºœ „¿œ
|
|||
|
|
ë ' øUÚœ!
|
|||
|
|
|
|||
|
|
|
|||
|
|
Uúœ
|
|||
|
|
”ÿœ
|
|||
|
|
ë '
|
|||
|
|
øVœ� V»� ŒÀ�
|
|||
|
|
ë ' øWÜ� Wû� Œ€ž
|
|||
|
|
ë ' øXœž!
|
|||
|
|
|
|||
|
|
|
|||
|
|
X¼ž
|
|||
|
|
”Áž
|
|||
|
|
ë '
|
|||
|
|
”Þž
|
|||
|
|
ë òž üþ—ö Æ Å. \š˜ e o Ê w $ Ñ ~ t ù ¦ S † _Á 4³Ø
|
|||
|
|
Š � ( Š Œ �¶ Žì � �Ñ ‘ì Ȫ›êPª5 } † � DÍØ
|
|||
|
|
Š � ( ¶J 3 ‡K : A ̤‡
|
|||
|
|
õ ö & ã8 1 ½: 8 ? ÔÈ‹
|
|||
|
|
ú û & ®9 1 ½: 8 ?
|
|||
|
|
txy�Ž��’”–�ŸÆÍÁ®ëŠ»Ýõöúû“ ¢ ”| ” Õ,º| ä Õ È FromStrÁ<Ï| Ôv Ð â| ‘ Í ç| ï+ memÁ ì| Õ ¿ ,š Ë \³k Ý lãr
|
|||
|
|
ñ dµv èLˆ{ ‘\ † º„œ‰ 󌴌 ® Œä� b\ö} ®¸ ÕDƒ~ д ø « Ç º$»4 É è$ÖA Ê ã,ÂM Ë ú,‹[ Ì üÓÖû üÓ! A lightweight logging facade.Á õ Ë üùI F The `log` crate provides a single logging API that abstracts over theÁ üÃM J actual logging implementation. Libraries can use the logging API providedÁ ü‘M J by this crate, and the consumer of those libraries can choose the loggingÁ üß: 7 implementation that is most suitable for its use case.Á š Ë üžO L If no logging implementation is selected, the facade falls back to a "noop"Á üîK H implementation that ignores all log messages. The overhead in this caseÁ üº> ; is very small - just an integer load, comparison and jump.Á ù Ë üýP M A log request consists of a _target_, a _level_, and a _body_. A target is aÁ üÎP M string which defaults to the module path of the location of the log request,Á üŸ O L though that default may be overridden. Logger implementations typically useÁ üï C @ the target to filter requests based on some user configuration.Á ³
|
|||
|
|
Ë \·
|
|||
|
|
# UsageÁ Ã
|
|||
|
|
Ë üÇ
|
|||
|
|
R O The basic use of the log crate is through the five logging macros: [`error!`],Á üš 3 0 [`warn!`], [`info!`], [`debug!`] and [`trace!`]Á üÎ ? < where `error!` represents the highest-priority log messagesÁ üŽ I F and `trace!` the lowest. The log messages are filtered by configuringÁ üØ < 9 the log level to exclude messages with a lower priority.Á ü•
|
|||
|
|
I F Each of these macros accept format strings similarly to [`println!`].Á ß
|
|||
|
|
Ë ã
|
|||
|
|
Ë üç
|
|||
|
|
" [`error!`]: ./macro.error.htmlÁ üŠ [`warn!`]: ./macro.warn.htmlÁ ü« [`info!`]: ./macro.info.htmlÁ üÌ" [`debug!`]: ./macro.debug.htmlÁ üï" [`trace!`]: ./macro.trace.htmlÁ ü’I F [`println!`]: https://doc.rust-lang.org/stable/std/macro.println.htmlÁ Ü Ë üà] Z Avoid writing expressions with side-effects in log statements. They may not be evaluated.Á ¾ Ë œÂ ## In librariesÁ Ö Ë üÚG D Libraries should link only to the `log` crate, and use the providedÁ ü¢N K macros to log whatever information will be useful to downstream consumers.Á ñ Ë „õ
|
|||
|
|
### ExamplesÁ † Ë <Š ```Á ü’. + # #[derive(Debug)] pub struct Yak(String);Á üÁ1 . # impl Yak { fn shave(&mut self, _: u32) {} }Á üó5 2 # fn find_a_razor() -> Result<u32, u32> { Ok(1) }Á Ô© use log::{info, warn};Á Ä Ë üÈ) & pub fn shave_the_yak(yak: &mut Yak) {Á üòJ G info!(target: "yak_events", "Commencing yak shaving for {yak:?}");Á ½ Ë tÁ loop {Á üÐ" match find_a_razor() {Á ôó Ok(razor) => {Á ü’4 1 info!("Razor located: {razor}");Á üÇ% " yak.shave(razor);Á Ôí break;Á Œˆ }Á ìš Err(err) => {Á ü¸G D warn!("Unable to locate a razor: {err}, retrying");Á Œ€ Óe l’
|
|||
|
|
}Á L }Á ,ª }Á ”° # fn main() {}Á <à ä` Ë Ë ¬Ï ## In executablesÁ å Ë üéU R Executables should choose a logging implementation and initialize it early in theÁ ü¿L I runtime of the program. Logging implementations will typically include aÁ üŒ: 7 function to do this. Any log messages generated beforeÁ üÇ6 3 the implementation is initialized will be ignored.Á þ Ë ü‚A > The executable itself may use the `log` crate to log as well.Á Ä Ë |È ### WarningÁ Ø Ë üÜ4 1 The logging system may only be initialized once.Á ‘ Ë Ì• ## Structured loggingÁ ¯ Ë ü³F C If you enable the `kv` feature you can associate structured valuesÁ üúM J with your log records. If we take the example from before, we can includeÁ üÈ D A some additional context besides what's in the formatted message:Á � Ë <‘ ä` Ü™ # use serde::Serialize;Á üµ 9 6 # #[derive(Debug, Serialize)] pub struct Yak(String);Á üï 1 «a ü¡ @ = # fn find_a_razor() -> Result<u32, std::io::Error> { Ok(1) }Á üâ " # #[cfg(feature = "kv_serde")]Á Œ… # fn main() {Á Ô— ¢b ² Ë ü¶ ) Ðb üà I F info!(target: "yak_events", yak:serde; "Commencing yak shaving");Á ª Ë t® ßc ü½ " öc ôà d üÿ 2 / info!(razor; "Razor located");Á ü²!% „e ÔØ! ±e Œó! Óe Ü…" Err(e) => {Á ü¡"G D warn!(e:err; "Unable to locate a razor, retrying");Á Œé" Óe lû" ìf L‰# �g ,“# ’g <™# # }Á ü¡#' $ # #[cfg(not(feature = "kv_serde"))]Á ”É# Ÿg <Ü# ä` ä# Ë üè#9 6 See the [`kv`] module documentation for more details.Á ¢$ Ë ü¦$' $ # Available logging implementationsÁ Î$ Ë üÒ$: 7 In order to produce log output executables have to useÁ ü�%7 4 a logger implementation compatible with the facade.Á üÅ%< 9 There are many available implementations to choose from,Á ü‚&+ ( here are some of the most popular ones:Á ®& Ë ì²& * Simple minimal loggers:Á ´Ð& * [env_logger]Á Œç& * [colog]Á Ìù& * [simple_logger]Á ¬“' * [simplelog]Á ì©' * [pretty_env_logger]Á ¬Ç' * [stderrlog]Á ÄÝ' * [flexi_logger]Á ¼ö' * [call_logger]Á ´Ž( * [std-logger]Á ì¥( * [structured-logger]Á ¬Ã( * [clang_log]Á ŒÙ( * [ftail]Á üë(& # * Complex configurable frameworks:Á ”’) * [log4rs]Á ¤¥) * [logforth]Á „º)
|
|||
|
|
* [fern]Á ¬Ë) * [spdlog-rs]Á üá)$ ! * Adaptors for other facilities:Á ”†* * [syslog]Á ¼™* * [slog-stdlog]Á ü±*" * [systemd-journal-logger]Á ¼Ô* * [android_log]Á Ôì* * [win_dbg_logger]Á ¬‡+ * [db_logger]Á Ä�+ * [log-to-defmt]Á Ô¶+ * [logcontrol-log]Á üÑ+ * For WebAssembly binaries:Á ¼ñ+ * [console_log]Á ä‰, * For dynamic libraries:Á ü¦,b _ * You may need to construct an FFI-safe wrapper over `log` to initialize in your librariesÁ „‰-
|
|||
|
|
* Utilities:Á œš- * [log_err]Á ´®- * [log-reload]Á äÅ- * [alterable_logger]Á â- Ë Üæ- # Implementing a LoggerÁ ‚. Ë ü†.P M Loggers implement the [`Log`] trait. Here's a very basic example that simplyÁ ü×.K H logs all messages at the [`Error`][level_link], [`Warn`][level_link] orÁ ü£/* ' [`Info`][level_link] levels to stdout:Á Î/ Ë <Ò/ ä` üÚ/' $ use log::{Record, Level, Metadata};Á ‚0 Ë Ä†0 struct SimpleLogger;Á Ÿ0 Ë ü£0$ ! impl log::Log for SimpleLogger {Á üÈ08 5 fn enabled(&self, metadata: &Metadata) -> bool {Á ü�1+ ( metadata.level() <= Level::InfoÁ L1 �g ·1 Ë ü»1( % fn log(&self, record: &Record) {Á üä10 - if self.enabled(record.metadata()) {Á ü•2C @ println!("{} - {}", record.level(), record.args());Á lÙ2 ìf Lç2
|
|||
|
|
txy�Ž��’”–�ŸÆÍÁ®ëŠ»Ýõöúû“B& ¢R& ” Õf& ä Õf& È …MŽ& Ôv С& ‘ Í´& ï+ ÅMÊ& Õ ¿ Ý& Ë ì& Ý û&
|
|||
|
|
ñ
|
|||
|
|
' è' ‘(' º8' óH' ® X' bg' ®¸ Õ{' д ø�' Ç ºŸ' É è¯' Ê ã¿' Ë úÏ' Ì B&B&B&D�| R&Tµ| f&ŒÅ| Ž&¤Ü| ¡&¡&´&´&Ê&Ê&T€} 4„} ”�¡ ð ó ú 8° 4ô tî &|ý Ý& µ% — ‹ 8è 4˜ & ž , 8è 4¡ & § 8ï $¨ $ ¬ 8È 4® & ´ , ¶ 8È 4· & ½ 8ï $¾ $  , Ä 8 lvlÁ Å & È 8ï $É $ Í , Ï Ð û
|
|||
|
|
, Ñ 8 keyÁ Ò & Õ 8� Ö , Ù Ú ç & Û , Ü 8 captureÁ <Ý & ä 8� å - è , ê ë ù ì , î 8˜ ,ï & ô 8ï $õ - ú $ ü ý % þ , € � ‰ , ‚ 8 argÁ ƒ & † 8� ‡ Š *� � ý ‘ ü 8 › 8òÇ Ÿ £ , ¥ 8òÇ ¦ % © 8 ³ 8òÇ ¶ º , ½ 8 ,¾ 'à 8· „Å Ö 8òÇ Ù Ý , à 8 ,á 'æ 8Ð Lè ñ ò ô ö , ‚ 8 ,ƒ 'ˆ 8€ lŠ '— 8ø ™ œ ë , ® 8è 4¯ $ µ , Ç 8 ,È 'Í 8€ lÏ 'Ü 8â \Þ é ê ó , ë ì ñ , í 8—Ê î ò $ ô 8òÇ † $ ‰ › œ é , � 8È 4ž $ ¤ , ¦ 8 ,§ '¬ 8€ l® '» 8é
|
|||
|
|
\½ È É Ê $ Ë , Í 8 ,Î 'Ó 8€ lÕ 'â 8 ä ç è $ ê ü ý Ô , þ ÿ Ñ € Ð
|
|||
|
|
, � 8 ,‚ '‡ 8è L‰ ’ “ ˜ , ” 8´È • $ ™ , › 8 ,œ '¡ 8‘ \£ ® ¯ Ï , ° 8´È ± , µ ¶ À & · , ¸ 8öÈ <¹
|
|||
|
|
Á Ã , Å Æ Í , Ç 8˜ ,È
|
|||
|
|
Î $ Ò Ó 8 Ö Ù Ú Ü 8 Û $ Ý % ì % þ Ü! Ÿ" 8è 4Ý! & ã! , å! 8è 4æ! & ì! 8ï $í! $ ñ! 8È 4ó! & ù! , û! 8È 4ü! & ‚" 8ï $ƒ" $ ‡" , ‰" 8òÇ Š" & �" 8ï $Ž" $ ’" , ”" •" �" , –" 8—Ê —" & š" 8� ›" ž" *¡" ¤" ²% ¥" ±% 8 ¯" 8òÇ ³" ·" , ¹" 8òÇ º" % ½" 8 Ç" 8òÇ Ê" Î" , Ñ" 8 ,Ò" '×" 8· „Ù" ê" 8òÇ í" ñ" , ô" 8 ,õ" 'ú" 8Ð Lü" …# †# ˆ# «% , –# 8 ,—# 'œ# 8€ lž# '«# 8ø # °# % , Â# 8è 4Ã# $ É# , Û# 8 ,Ü# 'á# 8€ lã# 'ð# 8â \ò# ý# þ# ‡$ , ÿ# €$ …$ , �$ 8—Ê ‚$ †$ $ ˆ$ 8òÇ š$ $ �$ ¯$ °$ ý$ , ±$ 8È 4²$ $ ¸$ , º$ 8 ,»$ 'À$ 8€ lÂ$ 'Ï$ 8é
|
|||
|
|
\Ñ$ Ü$ Ý$ Þ$ $ ß$ , á$ 8 ,â$ 'ç$ 8€ lé$ 'ö$ 8 ø$ û$ ü$ $ þ$ �% ‘% $ ’% % ¡% % ³% Ħk üƒcM J Determines if a message logged at the specified level in that module willÁ tÑc be logged.Á àcË üäcO L This can be used to avoid expensive computation of log message arguments ifÁ ü´d( % the message would be ignored anyway.Á ÝdË tád # ExamplesÁ ðdË <ôdä` üüd) & use log::{debug, log_enabled, Level};Á ¦eË üªe$ ! # struct Data { x: u32, y: u32 }Á üÏe9 6 # fn expensive_call() -> Data { Data { x: 0, y: 0 } }Á ü‰f7 4 # let my_logger = log::__private_api::GlobalLogger;Á üÁf# if log_enabled!(Level::Debug) {Á üåf$ ! let data = expensive_call();Á üŠg> ; debug!("expensive debug data: {} {}", data.x, data.y);Á ,Ég’g ÏgË üÓg5 2 if log_enabled!(target: "Global", Level::Debug) {Á ü‰h# let data = expensive_call();Á ühO L debug!(target: "Global", "expensive debug data: {} {}", data.x, data.y);Á ,ýh’g ƒiË ü‡i6 3 if log_enabled!(logger: my_logger, Level::Debug) {Á ü¾i#»à üâiOçà ,²j’g <¸jä` ÀjË üÄjQ N This macro accepts the same `target` and `logger` arguments as [`macro@log`].Á &|–k ì& ¿k ´r Žl Äl 8è 4�l & •l , —l 8è 4˜l & žl 8ï $Ÿl $ £l 8È 4¥l & «l , l 8È 4®l & ´l 8ï $µl $ ¹l , »l 8òÇ ¼l & ¿l 8ï $Àl *Æl Él ¯m Êl ®m , Ôl 8 ,Õl 'Úl 8Ý lÜl él êl ¨m 8è 4ël & ñl , ól 8 ,ôl 'ùl 8ñ dûl ‡m ˆm �m , ‰m 8è 4Šm $ ‘m 8È 4“m & ™m , ›m 8È 4œm $ ¢m , ¤m 8òÇ ¥m % °m ëm ‹n 8è 4ìm & òm , ôm 8è 4õm & ûm 8ï $üm $ €n , ‚n 8òÇ ƒn & †n 8ï $‡n *�n �n ”o ‘n “o , ›n 8 ,œn '¡n 8Ý l£n °n ±n �o 8è 4²n & ¸n , ºn 8 ,»n 'Àn 8ñ dÂn În Ïn ×n , Ðn 8è 4Ñn $ Øn 8È 4Ún & àn , ân 8 ,ãn 'èn 8€ lên '÷n 8é
|
|||
|
|
\ùn „o …o †o $ ‡o , ‰o 8òÇ Šo % •o Òo òo 8È 4Óo & Ùo , Ûo 8È 4Üo & âo 8ï $ão $ ço , éo 8òÇ êo & ío 8ï $îo *ôo ÷o ép øo èp , ‚p 8 ,ƒp 'ˆp 8Ý lŠp —p ˜p âp 8è 4™p & Ÿp , ¡p 8 ,¢p '§p 8ñ d©p µp ¶p Êp 8 __log_global_loggerÁ œ·p $ Ëp 8È 4Íp & Óp , Õp 8È 4Öp $ Üp , Þp 8òÇ ßp % êp ’q œq , “q 8òÇ ”q & —q 8ï $˜q *žq ¡q ±r ¢q °r , ¬q 8 ,q '²q 8Ý l´q Áq Âq ªr 8è 4Ãq & Éq , Ëq 8 ,Ìq 'Ñq 8ñ dÓq ßq àq ôq 8—ì œáq $ õq 8È 4÷q & ýq , ÿq 8 ,€r '…r 8€ l‡r '”r 8é
|
|||
|
|
\–r ¡r ¢r £r $ ¤r , ¦r 8òÇ §r % ²r ÔÖr¡ ¹r ¼r Ãr 8° 4½r t·r &|Ær û& ñr µu Às ös 8è 4Ás & Çs , És 8è 4Ês & Ðs 8ï $Ñs $ Õs 8È 4×s & Ýs , ßs 8È 4às & æs 8ï $çs $ ës , ís 8òÇ îs & ñs 8ï $òs *øs ûs ²u üs ±u 8 †t 8òÇ Št Žt , �t 8òÇ ‘t % ”t 8òÇ žt ¢t , ¥t 8 ,¦t '«t 8· „t Êt 8òÇ Ít Ñt , Ôt 8 ,Õt 'Út 8Ð LÜt åt æt ôt , ÷t 8 ,øt 'ýt 8€ lÿt 'Œu 8ê <Žu •u «u , –u 8è 4—u $ �u 8òÇ Ÿu $ ¢u , ¤u 8È 4¥u % ³u ̨v¡ ‹v Žv •v 8° 4�v t‰v &|˜v
|
|||
|
|
' Âv Íw Èv Üv 8—ì œÉv *Þv áv •w âv ”w , ìv 8 ,ív 'òv 8€ lôv '�w 8»$ dƒw % –w �w ªw , žw 8è 4Ÿw & ¥w 8ï $¦w *¬w ¯w Êw °w Éw ºw »w Ãw , ¼w 8è 4½w % Ëw ´ûz¡ Âz Åz Ìz 8° 4Æz tÀz» áz äz øz 8Æ åz èz ÷z 8¶ <éz ñz 7� $óz Üßz &|Ïz ' ’{ ‚| ˜{ ¥{ , ™{ š{ £{ , ›{ 8þ $œ{ & { 8� ¡{
|
|||
|
|
¤{ *§{ ª{ ÿ{ 8é l´{ Á{ Â{ ù{ 7 4key value support requires the `kv` feature of `log`Á üÃ{6 % €| Ä“†¡ Ú… Ý… ä… 8° 4Þ… tØ…» ù… ü… �† 8Æ ý… €† �† 8¶ <�† ‰† 7� $‹† Ü÷… &|ç… (' ¬† œ‡ ²† ¿† , ³† ´† ½† , µ† 8þ $¶† & º† 8� »†
|
|||
|
|
¾† *Á† Ć ™‡ 8é lΆ Û† ܆ “‡ 7øø ü݆6 % š‡ ì�‰¡ ш Ôˆ Ûˆ 8° 4Õˆ tψ» ðˆ óˆ Œ‰ 8Æ ôˆ ÷ˆ ‹‰ 8¶ <øˆ €‰ 7Ü L‚‰ üîˆ &|Þˆ 8' ‰ °Š ³‰ ¾‰ , ´‰ 8þ $µ‰ & ¹‰ 8ï $º‰ *À‰ É Š 8é l͉ Ú‰ Û‰ §Š 7 Icapturing values as `sval::Value` requites the `kv_sval` feature of `log`Á ü܉K % ®Š ô§Œ¡ è‹ ë‹ ò‹ 8° 4ì‹ tæ‹» ‡Œ ŠŒ ¤Œ 8Æ ‹Œ ŽŒ £Œ 8¶ <�Œ —Œ 7– T™Œ ü…Œ! &|õ‹ H' ÆŒ å� ÌŒ ׌ , ÍŒ 8þ $ÎŒ & ÒŒ 8ï $ÓŒ *ÙŒ ÜŒ â� 8é læŒ óŒ ôŒ Ü� 7 Ocapturing values as `serde::Serialize` requites the `kv_serde` feature of `log`Á ü‚�Q % ã� ô×�¡ š� �� ¤� 8° 4ž� t˜�» ¹� ¼� Ô� 8Æ ½� À� Ó� 8¶ <Á� É� 7Ñ DË� ü·� &|§� X' ö� ”‘ ü� ‡� , ý� 8þ $þ� & ‚� 8ï $ƒ� *‰� Œ� ‘‘ 8é l–� £� ¤� ‹‘ 7 Ncapturing values as `std::error::Error` requites the `kv_std` feature of `log`Á ü²�P % ’‘ üâ}* g'g'{'{'Üþ„ 4‰… t à ÿÿ Ì©… ,°… ®¸®¸ b ¯¸ vÁÓZ iVwƒ' à ԫ‡ l±‡ Ó?Ìˇ dч Ó?Äê‡ \ð‡ Ó?ü‰ˆ( ¤�ˆ ë†Ã üʈ! |ш Ó? ` 0@P ` éˆ Ó?죉 „ª‰ »ˆ J ÿÿ ô´Š Œ»Š »ˆ F ÿÿ üÅ”% ñ," " üÿ”) ‚• ˆ ‰ ˆñ, ‰Å. ! …• !
|
|||
|
|
" $†• î ,Œ• üÞ•& ñ,$ Ë $ ü™–C \œ– Š ‹ Šñ, ‹Å. ø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE>üÕýÕþÕ LessÁ ÿÕ €Ö�Ö’ ‚Ö ƒÖ„Ö GreaterÁ …Ö iÒ6’<Ë # ¨– #
|
|||
|
|
$ $©– î ,¯– ´Ÿ— ñ,&' Õv Öv ' D¼— Á— % % ®9üÜ—4 Dß— Œ Œ ê³í³ î³Ò ï³ì ð³ ñ³“ò³ì äs{ ©¶‘ñ, ñ,Õv % ï— %
|
|||
|
|
' Í,è— Ü¬š ñ,) æ` ) üΚ6 Ñš � Ž � �ñ, ŽÁ`Á` œ Ã`è Á] Ä` bufÁÁ] Ê\É:• �ê³í³ î³Ò ï³ì ð³ ñ³“ò³ì äs{ ©¶‘½:ѼѼҼ” štÀ. ( Õš (
|