343 lines
164 KiB
Plaintext
343 lines
164 KiB
Plaintext
|
rust
|
|||
|
|
0Ž #rustc 1.96.0 (ac68faa20 2026-05-25)ÁÀ뉊 ]!ÜÛê(¹Þ—šên -5be7b69c3ff7b5b8Á íàÄTËŸ ÜJîÄ)'ß\¥! -3d1337db07d0b3aeÁ ¤²XctÔ'ÐÓ©z¨É½Ó -a4945860e1c53b00Á ¤°ð ¾ä-±($²ï=©Ã -7e98a21bfd32b0edÁ–�òÖÀH•‘P IÓHã#£ -055f30b747f859b6Á rustc_std_workspace_coreÁCçß^ò½èÝ$Çÿ+Cé -c4878ee60b2242c9Á ŸÃï+Ñ]ŠqB<ÏïW# -8dd1dd90e70d0b6aÁ miniz_oxideÁ€š»J(P>àö÷g\K -1eb618da2918ab7fÁ adler2ÁÆ;+Þ®5¥ÌýÝ°¦ÛLˆ -f7919172d268e069Á hashbrownÁPäV9ÒÆèÜ�"ÊÖVŽ\ -0fc2184a5da6723aÁ rustc_std_workspace_allocÁs&ØòØy¯s•bæ!‰ýŠ -97e4bf30be240674Á
|
|||
|
|
std_detectÁhŠBîÙºÌI®Ë�Å�š -9dbbf8346ba7ac8bÁ rustc_demangleÁûë9´Ç×@Œ�’ùXFº -f33013f239bf9f14Á cfg_ifÁÜLh�ž§Œaã¯>� -0a71c8f33a838301Á addr2lineÁ׎Þ!]8V$É@@T· -e618e6be60e87ba2Á gimliÁ¸
|
|||
|
|
°µ~Î1‹Ñt ðÁ€w -1f7768a68858f670Á objectÁ
|
|||
|
|
áPÃ?À¶¼QHJ¥� -914cd6a4dbe590d1Á memchrÁ›º«8Ór2Ù $¨ûib‚ -cf21ca6f2bb15dcdÁë
|
|||
|
|
‹ás «LÖ€îâƒ×ɯŒ -ee6f3747e38367f0Á À …| »À|Ñ{ ŒÐ{
|
|||
|
|
__log_keyÁL‚y» kvÁtäx
|
|||
|
|
__log_valueÁ\‘~»õtó}
|
|||
|
|
__log_value_svalÁ„°‰» kv_svalÁœ�‰
|
|||
|
|
__log_value_serdeÁŒÅŒ» kv_serdeÁ¤¡Œ
|
|||
|
|
__log_value_errorÁŒø�» kv_stdÁ”Ö� serdeÁ,�} »
|
|||
|
|
serde_coreÁ´ õ·} »õtž} a$Å~ óµ Ì™~ ܘ~ ®D‰ óµ ÌÕ~ ÜÔ~ AtomicUsizeÁ\ óµ Ìž Ü� 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Á * as_strÁ *ù / / * increment_severityÁ * decrement_severityÁ 4� 6ï
|
|||
|
|
8 8þ ;× =€ =Â = to_levelÁ =â =ù B B =þ =—
|
|||
|
|
G 'aÁ G getÁ K�
|
|||
|
|
M‹ Oï
|
|||
|
|
Q§ R™ T« T builderÁ TÀ T metadataÁ T levelÁ Tê T¹ [ T module_path_staticÁ TÌ ^ T file_staticÁ Tš b« bæ bÀ b• b¤ bê b¹ b bÌ bæ bš b buildÁ o> q« q€ q¤ qê v« væ v¤ vê vÐ |> LogÁ ~ enabledÁ ~ logÁ ~ flushÁ NopLoggerÁ ‚
|
|||
|
|
„Á „Ï „Ù ˆ¥ ˆÁ ˆÏ ˆÙ �¥ �Á �Ï �Ù ’¥ ’Á ’Ï ’Ù
|
|||
|
|
set_max_levelÁ set_max_level_racyÁ max_levelÁ set_boxed_loggerÁ š
|
|||
|
|
set_loggerÁ œ set_logger_innerÁ ž— set_logger_racyÁ ¡× ¤× loggerÁ § NOPÁ
|
|||
|
|
__private_apiÁ © ©©©©©©©©© ©
|
|||
|
|
© © © KeyÁ ·« © ValueÁ ¹« © sealedÁ » KVsÁ ¼« ¼ into_kvsÁ © ¿« ¿ý ©Â« Âý ©ÅÁ ÅÏ ÅÙ © log_implÁ É� ©Ï Ë« Ëœ Ë� ©Á Ï� © locÁ STATIC_MAX_LEVELÁ
|
|||
|
|
Ï
|
|||
|
|
errorÁ
|
|||
|
|
Õ
|
|||
|
|
infoÁ
|
|||
|
|
™
|
|||
|
|
traceÁ LevelÁ Ù ErrorÁ Ú
|
|||
|
|
Ú Ù WarnÁ Ý
|
|||
|
|
Ù InfoÁ ß
|
|||
|
|
Ùp á
|
|||
|
|
Ù TraceÁ ã
|
|||
|
|
æƒ ! "ê� #ìÖ $îï
|
|||
|
|
%ð‹ &ò× 'ô§ õù LevelFilterÁ ÷ OffÁ ø
|
|||
|
|
÷‚ ú
|
|||
|
|
÷™ ü
|
|||
|
|
÷ª þ
|
|||
|
|
÷p €
|
|||
|
|
÷Ç ‚
|
|||
|
|
( )…ƒ * + ,‰� -‹Ö .�ï
|
|||
|
|
/�‹ 0‘× 1“§ ”ù MaybeStaticStrÁ –« – StaticÁ ˜
|
|||
|
|
˜ˆ – BorrowedÁ ›
|
|||
|
|
›ˆ 2ž« 3 « 4¢« ¢ƒ 5¥« ¥× RecordÁ ¨« ¨• ¨À ¨¹ ¨Ì ¨š 6¯« ¯ƒ 7²« ²×
|
|||
|
|
RecordBuilderÁ µ« µ recordÁ 8¸« ¸× MetadataÁ »« »¤ »ê 9¿« ¿ƒ :« ÂÖ ;Å« <Ç« Ç� =Ê« Ê‹ >Í« Íï
|
|||
|
|
?Ы Ч Òù @Ô« Ô× MetadataBuilderÁ ׫ ו AÚ« ÚÖ BÝ« Cß« ß� Dâ« â‹ Eå« åï
|
|||
|
|
Fè« è§ êù Gì« ì× SetLoggerErrorÁ ï
|
|||
|
|
ïˆ Hò× ParseLevelErrorÁ ô
|
|||
|
|
ôˆ I÷× J Kú� LüÖ © GlobalLoggerÁ þ
|
|||
|
|
©€× "
|
|||
|
|
"
|
|||
|
|
$
|
|||
|
|
$
|
|||
|
|
'
|
|||
|
|
)
|
|||
|
|
)
|
|||
|
|
)
|
|||
|
|
-
|
|||
|
|
.
|
|||
|
|
2
|
|||
|
|
3
|
|||
|
|
5
|
|||
|
|
5
|
|||
|
|
7
|
|||
|
|
7
|
|||
|
|
:
|
|||
|
|
<
|
|||
|
|
<
|
|||
|
|
<
|
|||
|
|
@
|
|||
|
|
A
|
|||
|
|
E
|
|||
|
|
F
|
|||
|
|
I
|
|||
|
|
J
|
|||
|
|
K
|
|||
|
|
L
|
|||
|
|
L
|
|||
|
|
M
|
|||
|
|
N
|
|||
|
|
N
|
|||
|
|
O
|
|||
|
|
P
|
|||
|
|
P
|
|||
|
|
Q
|
|||
|
|
R
|
|||
|
|
R
|
|||
|
|
W
|
|||
|
|
X
|
|||
|
|
Y
|
|||
|
|
Z
|
|||
|
|
[
|
|||
|
|
]
|
|||
|
|
^
|
|||
|
|
`
|
|||
|
|
a
|
|||
|
|
e
|
|||
|
|
f
|
|||
|
|
g
|
|||
|
|
h
|
|||
|
|
i
|
|||
|
|
j
|
|||
|
|
k
|
|||
|
|
l
|
|||
|
|
m
|
|||
|
|
n
|
|||
|
|
o
|
|||
|
|
t
|
|||
|
|
u
|
|||
|
|
y
|
|||
|
|
z
|
|||
|
|
{
|
|||
|
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
€
|
|||
|
|
€
|
|||
|
|
€
|
|||
|
|
�
|
|||
|
|
…
|
|||
|
|
…
|
|||
|
|
…
|
|||
|
|
†
|
|||
|
|
†
|
|||
|
|
†
|
|||
|
|
‡
|
|||
|
|
ˆ
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
‹
|
|||
|
|
‹
|
|||
|
|
‹
|
|||
|
|
Œ
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
‘
|
|||
|
|
”
|
|||
|
|
”
|
|||
|
|
”
|
|||
|
|
•
|
|||
|
|
•
|
|||
|
|
•
|
|||
|
|
–
|
|||
|
|
¢
|
|||
|
|
¢
|
|||
|
|
¢
|
|||
|
|
¥
|
|||
|
|
¥
|
|||
|
|
¥
|
|||
|
|
Æ
|
|||
|
|
Æ
|
|||
|
|
Æ
|
|||
|
|
Ç
|
|||
|
|
Ç
|
|||
|
|
Ç
|
|||
|
|
È
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
Ë
|
|||
|
|
Ë
|
|||
|
|
Ë
|
|||
|
|
Ë
|
|||
|
|
Ï
|
|||
|
|
ç
|
|||
|
|
ë
|
|||
|
|
ë
|
|||
|
|
í
|
|||
|
|
ï
|
|||
|
|
ï
|
|||
|
|
ñ
|
|||
|
|
ñ
|
|||
|
|
ó
|
|||
|
|
ó
|
|||
|
|
ó
|
|||
|
|
õ
|
|||
|
|
õ
|
|||
|
|
†
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
Œ
|
|||
|
|
Ž
|
|||
|
|
Ž
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
”
|
|||
|
|
”
|
|||
|
|
¤
|
|||
|
|
§
|
|||
|
|
§
|
|||
|
|
§
|
|||
|
|
±
|
|||
|
|
´
|
|||
|
|
´
|
|||
|
|
´
|
|||
|
|
º
|
|||
|
|
º
|
|||
|
|
º
|
|||
|
|
Á
|
|||
|
|
Ä
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
Ì
|
|||
|
|
Ì
|
|||
|
|
Ï
|
|||
|
|
Ï
|
|||
|
|
Ò
|
|||
|
|
Ò
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
Ü
|
|||
|
|
á
|
|||
|
|
á
|
|||
|
|
ä
|
|||
|
|
ä
|
|||
|
|
ç
|
|||
|
|
ç
|
|||
|
|
ê
|
|||
|
|
ê
|
|||
|
|
î
|
|||
|
|
î
|
|||
|
|
î
|
|||
|
|
ó
|
|||
|
|
ó
|
|||
|
|
ó
|
|||
|
|
ø
|
|||
|
|
ø
|
|||
|
|
ø
|
|||
|
|
û
|
|||
|
|
û
|
|||
|
|
ý
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
~¼Û Ù Ú Û‚ Ü Ý Þ™ ß àª á âp ã äÇ 6.s _¡K Øþ+ Š þ+ Ðìþ+ µßþ+þ+ ™þ+ íßþ+þ+ ºþ+ ¿cþ+ šeþ+ µßþ+ ÷ ø ùÓ ú û‚ ü ý™ þ ÿª € �p ‚ ƒÇ ULH‘¸fü íßþ+Õ- ïyþ+ Äcþ+ ÛÕ- ØÕ- Š Õ- ÐìÕ- µßÕ-Õ- ™Õ- íßÕ-Õ- ºÕ- ¿cÕ- šeÕ- µßÕ-þ+ íßÕ-þ+ ïyÕ- ÄcÕ- Š – ˜ ™¨ šˆ › œÃ �ˆ _IZÁ ?0´ « Û’0 Ø’0 ¿c’0 ™ – ˜ ™¨ šˆ › œÃ �ˆ _IZÁ ?0´ 8 µß‰1‰1 º‰1 í߉1‰1 še‰1 Ø ¨ ¨ Ÿ ª• «À ¬¹ Ì ®š 6¨ sXkH « ¿c‘2 ¿c µ µ „ ·¡ ›žUÆHð»� « ³ µ µ „ ·¡ ›žUÆHð»� 8 Ø » »  ½¤ ¾ê ŽØ¦Õ’â© « ™ô3 Ðìô3 µßô3ô3 ºô3 íßô3ô3 šeô3 ¿cô3 ™ × × ‰! Ù• ʶGcšÓl « Ðìˆ5 µßˆ5ˆ5 ºˆ5 í߈5ˆ5 šeˆ5 ¿cˆ5 ³ × × ‰! Ù• ʶGcšÓl 8 ~ ‚ ‚ ƒå þ¼Ð24· ~ 8¥ ~�� ž BoxÁ ¡ˆˆ ¢‰ˆ l }.xÏ ¥çEçEèE GlobalÁ ¿±‡§í# ~†J†J K ‰Jµ �7 ŠJ phantomÁ�7 ‹J¤�7 ·0ØQd�è¾7Ä7 ¿c ï ï ð»" ñˆ `˜ œà¡A ÄcÏ8 ¾ Ï8 ¿c ô ô õé" öˆ T£Áü¾Ã Ðì›9 µß›9›9 ™›9 Äc›9 ¾ ›9 ¼ «
|
|||
|
|
« “: « ¼ « ¿c þ þ ÿµ# {YX) ~¼: å Ù„ ÷ –æ Ù… ÷¢ –¯ ¨¿ »è Ù‡ ÷ž –é Ùˆ ÷Å »Ý ×ù ôê Ù! Ù‰ ÷4 ÷K –Ç »ß ×ú ôì Ù‹ ÷J – »Ú ×ü ôî Ù# Ù� ÷6 ÷O –Í »å ×ð Ù� ÷M –Ê »â ×ò Ù‘ ÷¥ –² ¨¸ µÔ »ì ×ò ï÷ ô€ þô Ù“ ÷Q –Ð »è ×% Ù8 ÷( Ù; ÷¡ ï¤ ôo µ| ׄ ‚ˆ
|
|||
|
|
��’†JÅ þ£ ï¦ ô¿
|
|||
|
|
Â
|
|||
|
|
ÛñØŠ #Ðìµß#™5íß)º.¿c
|
|||
|
|
"šeFïy"Äc ³ ~ ¾ ! ¼ 0Á ¼? 1Á ¼? 2Á ¼? 6Á ¼? 1Á°HÙœ
|
|||
|
|
øOÇ øIÿœ' I¥� „ª� ÷ ' øJÉ�) Jñ� ”ö� ÷ ' øK—ž( K¾ž ŒÃž ÷ ' øLãž(
|
|||
|
|
LŠŸ Œ�Ÿ ÷ ' øM¯Ÿ) Mן ”ÜŸ ÷ ' øNýŸ)
|
|||
|
|
N¥ ”ª ÷ ' ,ôŸ Oå „ê ÷ ' øP…¡!
|
|||
|
|
|
|||
|
|
|
|||
|
|
P¥¡
|
|||
|
|
”ª¡ ÷ '
|
|||
|
|
øQÇ¡ Qæ¡ Œë¡ ÷ ' øR‡¢ R¦¢ Œ«¢ ÷ ' øSÇ¢!
|
|||
|
|
|
|||
|
|
|
|||
|
|
Sç¢
|
|||
|
|
”ì¢ ÷ '
|
|||
|
|
”‰£ ÷ �£ ü©œö Ò Õ- \Åœ e o Ê w $ Ñ ~ t ù ¦ S † _Á 4�Ø – ™ ( – ˜ ™¨ šˆ › œÃ �ˆ _IZÁ ?0´ ~ ‡ Ž D§Ø – œ ( ŸJ 3 ñJ : A ÌÏ‹ ï ð & Ï8 1 ¬: 8 ? Ôó� ô õ & ›9 1 ¬: 8 ?
|
|||
|
|
~‚ƒ—˜™šœž §©ÒÙ»¨÷–µ×ïðôõÀ â ”| ¬ Ä,º| ’ Ä Ô FromStrÁ<Ï| ïy ‹ â| ‹ × ç| ¤, í ì| ë Û ,™ ç \²k ù lâr
|
|||
|
|
� d´v àLÑ| �\é‡ ¢„åŠ ÑŒý� ‚ Œ‘
|
|||
|
|
\ö} „Ä ®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 ü½ " •d ôà Àd üÿ 2 / info!(razor; "Razor located");Á ü²!% ¦e ÔØ! Ôe Œó! ÷e Ü…" Err(e) => {Á ü¡"G D warn!(e:err; "Unable to locate a razor, retrying");Á Œé" ÷e lû" ”g 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(
|
|||
|
|
~‚ƒ—˜™šœž §©ÒÙ»¨÷–µ×ïðôõÀ.& â>& ¬ ÄR& ’ ÄR& Ô ñLz& ïy ‹�& ‹ × & ¤, í³& ë Û Æ& ç Õ& ù ä&
|
|||
|
|
� ó& à' �' ¢!' Ñ1' ‚ A'
|
|||
|
|
Q' „Ä ®e' ¼À Ïy' Ó Õ‰' Õ ×™' Ö ™©' × é¹' Ø .&.&.&D�| >&Tµ| R&ŒÅ| z& Ü| �&�& & &³&³&T€} 4„} ”Œ 4ó (|ü Æ& Ÿ ´% – Š 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ê 4l & ³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 $ ÿm , �n 8ËÉ ‚n & …n 8› $†n *Œn �n “o �n ’o , šn 8 ,›n ' n 8
|
|||
|
|
,Œ• üÞ•& þ+$ ïß $ ü™–C \œ– „ … „þ+ …Õ- ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ¿ßÀßÁß LessÁ Âß ÃßÄß~ Åß ÆßÇß GreaterÁ Èß åºÝÈnûê7 # ¨– #
|
|||
|
|
$ $©– ¹
|
|||
|
|
,¯– ´Ÿ— þ+&' ðy ñy ' D¼— Á— % % ›9üÜ—4 Dß— † † Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
þ+þ+ ðy % ï— %
|
|||
|
|
' ¤,è— Ü¬š þ+) Åc ) üΚ6 Ñš ‡ ˆ ‰ ‡þ+ ˆ c c ˆ ¢cµ
|
|||
|
|
` £c bufÁ ` àB¤GS
|
|||
|
|
‰Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¬:ŸÈŸÈ È‚ O˜éBL ( Õš (
|
|||
|
|
) $Öš × Üš T¯› þ++,-./23 üÀ›( TÛ ¼?ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙþ+ * *
|
|||
|
|
+ À Λ ¬žž üà�+ ( Returns the most verbose logging level.Á ¥ž þ+ * *
|
|||
|
|
, ü¢Ÿ, üÖž9 6 Converts the `Level` to the equivalent `LevelFilter`.Á|©Ÿ Š Šþ+ Õ- * ¹Ÿ *
|
|||
|
|
- $ºŸ ü¢¡$ ü• 5 2 Returns the string representation of the `Level`.Á Ï ú ü× F C This returns the same string as the `fmt::Display` implementation.Á4©¡ ‹ ‹þ+ Ÿ‡ * °¡ *
|
|||
|
|
. $±¡ üƒ¥+ üü¡1 . Iterate through all supported logging levels.Á ²¢ ú üº¢K H The order of iteration is from more severe to less severe log messages.Á Š£ ú t’£ ŽÞ ¥£ ú <£ ù` œ¹£ use log::Level;Á Ñ£ ú üÙ£# let mut levels = Level::iter();Á �¤ ú ü‰¤2 / assert_eq!(Some(Level::Error), levels.next());Á üÀ¤2 / assert_eq!(Some(Level::Trace), levels.last());Á <÷¤ ù`$Š¥ 0 * *
|
|||
|
|
/ Ð[”¥ / / ââ MapÁ åù æ±Å@ Iœóë ¶¥�£�£ ¹ ƒ£¹ „£þ -'ºˆÉ¬g¼? 1 ¼?þ+ ¬: Í켚 ± ùM¼š ¬™¥ ¼šúM þ+\¢¥ ù›Û ˆœ" ™œ / Ä¥ / <closure_kind>Á 1 <closure_signature>Á 1 <upvars>Á 1 1 / á›ü±ª( üñ¥/ , Get the next-highest `Level` from this one.Á ¥¦ ú ü¦` ] If the current `Level` is at the highest level, the returned `Level` will be the same as theÁ „’§
|
|||
|
|
current one.Á §§ ú t¯§ ŽÞ § ú <ʧ ù` œÖ§ À— î§ ú äö§ let level = Level::Info;Á —¨ ú üŸ¨9 6 assert_eq!(Level::Debug, level.increment_severity());Á üݨN K assert_eq!(Level::Trace, level.increment_severity().increment_severity());Á ü°©p m assert_eq!(Level::Trace, level.increment_severity().increment_severity().increment_severity()); // max levelÁ <¥ª ù`”¸ª Œ Œþ+ þ+ * ˪ *
|
|||
|
|
2 $̪ ü�°( üÄ«. + Get the next-lowest `Level` from this one.Á ÷« ú üÿ«_ \ If the current `Level` is at the lowest level, the returned `Level` will be the same as theÁ „㬠õ� ø¬ ú t€ ŽÞ “ ú <› ù` œ§ À— ¿ ú äÇ ßž è ú üð8 5 assert_eq!(Level::Warn, level.decrement_severity());Á ü®N K assert_eq!(Level::Error, level.decrement_severity().decrement_severity());Á ü€¯p m assert_eq!(Level::Error, level.decrement_severity().decrement_severity().decrement_severity()); // min levelÁ <õ¯ ù`”ˆ° � �þ+ þ+ * ›° *
|
|||
|
|
3 $œ° ü÷% Õ-5 ·ß 5 üý·# €¸ Ž � ŽÕ- �þ+ 4 ƒ¸ 4
|
|||
|
|
5 $„¸ ¹
|
|||
|
|
,Š¸ üø& Õ-7 ïß 7 üþ¸= \�¹ � ‘ �Õ- ‘þ+ À‹ 6 �¹ 6
|
|||
|
|
7 $Ž¹ ¹
|
|||
|
|
,”¹ äþ¹ Õ-9: ðy ñy : D¡º ¦º 8 8 ›9üÁº: Dĺ ’ ’ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Õ-Õ- ðy 8 Ôº 8
|
|||
|
|
: ¤,ͺ ü�½! Õ-< Åc < üŽ6 Ƚ “ ” • “Õ- ” c c ˆ ¢cµ
|
|||
|
|
` £cõŽ ` àB¤GS
|
|||
|
|
•œ� ; ̽ ;
|
|||
|
|
< $ͽ × Ó½ „¦¾ Õ->?@ABEF ü½¾. TÀ¾ ¼?ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙÕ- = =
|
|||
|
|
> À ˾ ÜïÁ üªÁ2 / Returns the most verbose logging level filter.Á öÁ Õ- = =
|
|||
|
|
? ü´Ã' ü³Â. + Converts `self` to the equivalent `Level`.Á æ ú üîÂ3 0 Returns `None` if `self` is `LevelFilter::Off`.ÁD»Ã – –Õ- ‚’ = Äà =
|
|||
|
|
@ $Åà ü¦Å$ ü“Ä; 8 Returns the string representation of the `LevelFilter`.Á ÓÄ ú üÛÄF Ç”4Å — —Õ- Ÿ‡ = ´Å =
|
|||
|
|
A $µÅ ü–É+ ü€Æ3 0 Iterate through all supported filtering levels.Á ¸Æ ú üÀÆB ? The order of iteration is from less to more verbose filtering.Á ‡Ç ú t�Ç ŽÞ ¢Ç ú <ªÇ ù` Ì¶Ç use log::LevelFilter;Á ÔÇ ú üÜÇ) & let mut levels = LevelFilter::iter();Á ŠÈ ú ü’È6 3 assert_eq!(Some(LevelFilter::Off), levels.next());Á üÍÈ8 5 assert_eq!(Some(LevelFilter::Trace), levels.last());Á <ŠÉ ù`$�É C = =
|
|||
|
|
B Ðc§É B B ââ ò™ åù æ±Å@ Iœóë ¶¥¦› D ì›Õ- ¬: Íì�· w ùM�· ¬¬É �·úM Õ-\µÉ „¸¡ “¸" ¤¸ B ×É B ß› D ÷› D ”œ D D B í·ü�Ï( ü„Ê5 2 Get the next-highest `LevelFilter` from this one.Á ¾Ê ú üÆÊ` ] If the current `LevelFilter` is at the highest level, the returned `LevelFilter` will be theÁ ä«Ë same as the current one.Á ÌË ú tÔË ŽÞ çË ú <ïË ù` ÌûË ï³ ™Ì ú ü¡Ì) & let level_filter = LevelFilter::Info;Á ÏÌ ú ü×ÌF C assert_eq!(LevelFilter::Debug, level_filter.increment_severity());Á ü¢Í[ X assert_eq!(LevelFilter::Trace, level_filter.increment_severity().increment_severity());Á ü‚Î} z assert_eq!(LevelFilter::Trace, level_filter.increment_severity().increment_severity().increment_severity()); // max levelÁ <„Ï ù`”—Ï ˜ ˜Õ- Õ- = ªÏ =
|
|||
|
|
E $«Ï ü²Ö( ü£Ð4 1 Get the next-lowest `LevelFilter` from this one.Á ÜÐ ú üäÐ_ \ If the current `LevelFilter` is at the lowest level, the returned `LevelFilter` will be theÁ äÈÑ à¹ éÑ ú tñÑ ŽÞ „Ò ú <ŒÒ ù` Ì˜Ò ï³ ¶Ò ú ü¾Ò) ׺ ìÒ ú üôÒE B assert_eq!(LevelFilter::Warn, level_filter.decrement_severity());Á ü¾Ó[ X assert_eq!(LevelFilter::Error, level_filter.decrement_severity().decrement_severity());Á üžÔn k assert_eq!(LevelFilter::Off, level_filter.decrement_severity().decrement_severity().decrement_severity());Á ü‘Õ� � assert_eq!(LevelFilter::Off, level_filter.decrement_severity().decrement_severity().decrement_severity().decrement_severity()); // min levelÁ <¦Ö ù`”¹Ö ™ ™Õ- Õ- = ÌÖ =
|
|||
|
|
F $ÍÖ Ü½Ø « H H ’0I ÂØ ÄíØ ðØ š š’0 “: G ôØ G
|
|||
|
|
I «$õØ ô‹Ú 8 › › ‰1 ü®Ú% 8 œ œ ‰1L ·ß L üÚÚ" ÝÚ � ž �‰1 ž‰1 K àÚ K
|
|||
|
|
L 8$áÚ ¹
|
|||
|
|
,çÚ üªÛ 8 Ÿ Ÿ ‰1N » N üÐÛ2 ÓÛ ¡ ‰1 ¡‰1 …Œ M ×Û M
|
|||
|
|
N 8$ØÛ ¹
|
|||
|
|
,ÞÛ ü²Ü& 8 ¢ ¢ ‰1P ïß P üßÜB \âÜ £ ¤ £‰1 ¤‰1 À‹ O îÜ O
|
|||
|
|
P 8$ïÜ ¹
|
|||
|
|
,õÜ üËÝ+ 8 ¥ ¥ ‰1R ›e R üýÝ3 $€Þ ¦ § ¦‰1 §™¬: Q™ S S ›Þ Q ÍìãË …Þ ¢eãË ŒˆÞ
|
|||
|
|
R 8ãË$œÞ º,¢Þ 46 œˆð « U U ‘2VWXYZ[]^`a �ð üÏð% Ô¢ð Returns a new builder.Á<Öð �3 T T
|
|||
|
|
V «üÇñ) ¬Ÿñ The message body.Á$Îñ ¨ ¨‘2 ¨äÈäÈ ArgumentsÁ æÈ templateÁ ` çÈÀ ` üöMõô]Td « T Óñ T
|