rust h#rustc 1.98.1 (48a229cea 2026-09-01)m6GÂn62-64f5f36fb0927694RL.SAwjL-df1bddb45adbe94b1 Xr*-1ad4f876c768bda9<%Z>64V`-2d2ab9fb0fe1def5G g{(3iF-06449a08aaab5e30rustc_std_workspace_core{`"Ei%G-cb0d4d77988d81b5")pE͗E-3ec41d3a5a80a4a4 miniz_oxide8bž LƨJ-e44eaef1807e5fc0adler29lyA6P/D$UB-dca52f01a59c33e7 hashbrownX {e-143c77bb957d9940rustc_std_workspace_alloc _z%-145a318e0772276c std_detectK(0*8D?-f99feda5ce9e492arustc_demangle%jerV-cfd0ab54bb33760ecfg_if}λ՞Co-360da4ba13154744 addr2linecY\G--09755979c57b7e64gimliQ`Dy-9a1fede77fbbf2f0objectF λv.z-7ff85ea729a864ffmemchr]1<=UO-0e3477fb2664a277 jlToKG-549498e8b2e4d924$e$e$i$hgnu_legacy_test|$)serde_json_tests}$}K$ $ Ptests,Z$Z):normal: : : : : : :: : : )F differenceKKMbetweenNdisplayPPPPPPPPPP P['a[[P___P AnsiStringcPAnsiByteStringePggggPlll style_refl style_ref_mutlas_strltitlerl hyperlinktl url_stringP AnsiStringswPyPAnsiByteStrings{P}PpaintPPPwrite_toP write_inner write_to_anyP P P writeAnyWriteWstrErrorutil sub_stringunstyle unstyled_len  gradient from_color_rgbat build build_all_gradient_text code ANSIColorCodeansi_color_code rgb from_hexfrom_hex_stringfrom_f32graygray_f32lerprgb_addrgb_sub rgb_mul_f32 rgb_negate                Prefix   Infix    Suffix )Style foreground backgroundis_bold is_dimmed is_italic is_underlineis_blink is_reverse is_hiddenis_strikethroughprefix_with_reset)))))) )ColorBlack DarkGray Red LightRed Green  LightGreen Yellow  LightYellow Blue  LightBlue Purple  LightPurple Magenta  LightMagenta Cyan  LightCyan White  LightGray Fixed Rgb ) ) ) ) ))))>r K Difference ExtraStyles Reset Empty KKKKKKKP OSControlTitle LinkurlP P PPPAnsiGenericString string oscontrolPPPPPAnsiGenericStrings PPPPGradient TargetGround Foreground  Background      # 8 8888888888888888888888!8!8!8$8$8$88888,8-8.8/80818283848586888888888888888N8N8888888^8888888b8o8p8q8v8888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888 &F:f=B6 6g6 >.b2k7 7g7 {MfGv8 8g8g6g7g8 `We>99999 99    !!!!!! ! " " " """###r2u)::::: :g::9:$$$jJ (>>>>> >g>%%&P۞/ywr???g??& ''PO>CbҸJ@@@@g@@& ''PO>CbҸJg( G6yG #'@BBBBg& ''PO>CbҸJg( G6yG #'f g9g)Y^GxDD DDDDDg**X4p%EE EEEEEg#EC0FF FFFFFFGGFHHF!FF!F 8F!HF! 8FHFFFHHFHHFHF 8HHHHIHFHHIF 8HH!F!H[_ #8Fgf            ? Kg ?gT  ? ?? !!,(i2i2$)65 6?HR(k2  (k29  gTY gjo\|k2ÜĜŜƜǜȜ_wĤĤŤ :MP  ggg cgbufcثq1ȡgQoQ_  9mSuSQQ(l5l5$)75 7?HR(n5 Q(n59Q(n59 Qlq gvWn5 RUSQQSQSS SQ SQV/(o8o8$)85 8?HR(q8 Q(q89 QHMQY^Mkq8RXSQQSSSQQ$BdB  BBB@64B9$B9d3$L$LL  LLLP7,L9$L9$L99}" &P$RdQ  RRQ@84Q9$Q9d3ttR S'0:u#4 u#4 u  #   4  u #  4  u#4 u#4 u#4 u  #4 u   #4 uřǙșəʙ˙G*R{9 :Y clq cc   u!c"c',d!7"< DIQ^ uHu# SSqxCJQ#]dk/6= c ggsg{  $dQd(vv$)/59ASHQ[J  cc $,9,S, -@  cc$  -r9,S, ,B  cc$  .v9,S, ,B  cc$  /v9,S, ,E  cc$  0|9,S, ,A  cc$  1t9,S, , C  cc$   !2 x9, S,  ,#B  cc$#  $3#v9,#S,# ,&I  cc$& '4&9,&S,& -)T* ř: *)O  c  **5)9,)S,):T)c:"&Q-T- ř: --O  c  --6,9,,S,,:T,c:"&Qx9x9R :'1Hy9*9 IzY f w  zzyOz#GyO z #GyO!z!#G~"z"#G{#z##Gx$z$#G   G~,2;yO%z %#G*&z: &#GQ  ]  kp~ {   ~  ~ $-; y9'zzzz'~~ ~~J~(~~b~@~yhqzYbzzzzzzzzzzz ! / __self_discrI __arg1_discra__self_0+ __arg1_0? __self_1w__self_2aɄ__arg1_1__arg1_2~~~~(z9z9$):5z<EO(|9  IP"XQej g{"|O#G|O#G|O#GQaQWQM!Y !Q,2 gDJ b|O#GQ/;QQl Q "+Q9?MS\bk Qy Q Q  "+ Q9? MS\bk Qy  Q   Q   " +Q9?M S\b k Qy  Q   Q  "+Q9?MS\bkQyQQ "+Q9?MS\|9v|#RzSQQQQQQQQQQQQQQQ Q(Q0Q8~QHQ~~~QyQQQQaI</~Q~QmQ\$QQ3:AHOV]dkry'1H*9 I Z gv~( $9+< $9S  _  mr SS  SS$S,S4#,5? M\i Ʉ (&+>7?HR(&- 5QBGT YafnQ{($9 Q.:QQh*0 R=FSNVSQeQSQ{Q SQ.Q R %%&P۞/ywr@^gqH+: J [ hyx %BorrowedOwned9cgM@ %      ٨   !*2:AOW_٨٨ ٨   Ʉ Ҩ*($x%GOQ/7QB N Q gQ  R'S/7Q?٨QPQ-Q5>seQ{ά$T$\ @ %L,  < @ ^6$,٨$\ R! & ''PO>CbҸJ@py99(- 99BGOV*/ FKSZ# řǙșəʙ˙G*R{9 \ pu   H SSt٨}٨ )ж2l y+k ( Q Q9(Q  Q ) Q#  ! Q *  6  Q g | ,R8ASIQQQBQJSRQ"Q*٨3QQ  жжSQ٨QQ`T 9\  , +< t  ,  1<   @   b , 9٨ж3ed$ Bڦ9cgMB,4t 9$ ř%%&P۞/ywrB B k& ''PO>CbҸJBąB,98řǙșəʙ˙G*R{9 cinputp&\9oCS4, -`f9w yowStrS|9 pM 9T L 3\  4  @4D  q ? @ , ٨z8% *t%A % D%$% D4%̣& @& ř% @&$ &r5$% $9To;8T+$++4++# @+) řt+$++?R +*t$*D**.&1mF|,,$- řVM -%T-4- -D-- ř --,v,4řǙșəʙ˙G*R{9 T,,,ж,, ٨8<((. "Q/"  'QPUQafTs.R ( G6yG #'@SQQ   QQ3.. R&0/"+0 GLT.H.7 DN22  22y1j( G6yG #'|2  & ''PO>CbҸJ2arg55  G 55}4v( G6yG #'5  & ''PO>CbҸJ5d8$8,848$9 ř8u B96IJ79$7B,7$)Ud=$=,=4=l=4= ;$=D=$> ř=~ B> >;ij<:$<B,<9+0k B  BdB $B B|BBABFÜĜŜƜǜȜ_wR777 6wQ?m!؆B ,B  B B$"%_H(|EE<3\I*I4I*+)&DI]] gLH#Q 3 E%]]TF$Q /.]I]  F c)]E  %ÜĜŜƜǜȜ_wR}   TF4F F DFF [ÜĜŜƜǜȜ_w^fI % 'mFLF  F  FF  H  " .]]TF%Q /F [!-'.]I] F)]F P".\GG4G+DGF[ !-'F!LF F}FF" E#/]]G&Q /G[!-'.]I] G')].]I] Hb)]H Q" . \H%H4H%+$ DHH![!!-'H!LH H$}#!HH" #E""#&"/&#$]]TH%Q (%/H'"[!'-'.]I] H(')]I!LI I)'IIDE EħF F /6=F"!(/H]dkH"+E,D  Dж EE ٨Zm[}OD^R_ Argumentstemplateccg@#  $hl ٨,"_ "+j٨v ٨ [     R : R   X R 3v R %! R b' R b      ?  ! wCQ{@u'rTJ 9J4J  +DJJ] #PJ  f6R %O Argumentf0m֔49d  ' G   g   .]I] J])]J% W#/J\J @$J K tJJ[!-J  ". TK9K4K + DKK[!-K] # XK   f8R%O  _ g'w  .]I] K])]K I!J%|J OV J,J JO3PwP69 E`iXX2XJ89S 7e݃nPOX~ }  R $ R   &r 9e OPdP $P P|PPNOFO ,O O O"%g94R_tR,R w_1?=> ?>=!,U($9tU4U(,U.DUpU-.], -#c,PU cK0H/ 0X1`'p2/~12+.]I] U+]*)]U  *W)#3)/3) U4)[\!4-8u|U<=9U4U<,;"DUU:;]8 9:d8U  fQdA#&ee8PU eB$@ ABC) GD@ gCD 7%.]I] U7]6&)]U3 6W5'#E5/E)(UF5[\!F-8u VJ LVKLJK LKJ*3IJV\VIY VH+tVV HBG,"MG.M-VNG[[!N-8t9 POTX P/7$X QOTX SQ9X DY 7S+R0TY' R17(Y X,Y(] W X1!fWY! fZZ2I!Y ZY"[a'q"\Y"[\V3.] I] YV]U4)]Y  UVT5" ]T. ]76Y ^T[[$!^-8t4Y R(!RY8 'QRdSQ X    S&X _  f S    T6EL.5<U 8?FU3OV]VXj ! # Y%gQ,Q QřǙșəʙ˙G*R{9 $Rg D (  P6m9 -݃6   2 < E Ə Ə Ə$ řǙșəʙ˙G*R{9 r  Ə~   > S    S -   T9+ I -  P 6E   * ݃3   FtP5 P6 9. 5  '  , 8 #p̥  9X[ m!P݃kt P@P M PU first,R=   |h&R  h 'R window  ( , /  4x'RV 8b @  F'R N'R Q6!WB"Y )#^%(R%tH VĎd֐ = x > E  d . Ś  M T  Z a  . [ ( *Qp +QF(Q` ,Q F(  4 Q gpu R DSQ QQ F QQ N\gQ^Q/(&+D7״?HRpFF(- FFBGOV`FF(-9>FKS`H״״P ]gS R״&0 RD$F,FC,  DFFF~FqT,\đ  G G G< #G #G #G       |      (D  L Ğ  G G G<   #G #G #G   |    ( TD J    &&D$:,:F[GGGGGGFOGGGGGGFCF7  start_gradend_grad  |nD FT F L  @2% SD$ ״, FFz;FF  D״FEF:($+3- QLT. Q!kp}R ESQ(&E19BLH>CIT\dkr{ R *$T$ (G GG,7(GGG (z QH /QG(QH 0Q G( QH  1Q G(  4  Q v { #R/8S@QHQ:QB~JQQ"~*QQ ~~Q~QQR(&+F7?HRHGG&7HGG&7H G G&  7?GTH !G)G1GGGGa nx R&0 NF$G G G "&Y     FGGGGGG H\) 9 <YZGT  ) 9  <YZGL G9L ? 4*q F$GG%,GhexSto, = A _a G   9 8T  a r   v    EG L   g  G  l tr,   FGG-GDL   -CF$G  -|qw|  FGGGG ܏,G,G: At O; ܴ,G,G: AtL8  ,  G,  G: At L 8    ~  D 1   FGGGGGG|G/G/G^rhsd,G,G: At O; ,G,G: AtL8 ܏ ,  G,  G: At L 8    ~  D 1   FGGGGGG|G/G/G^b\ , G! G<  G\G \ , G! G<  G\G \ ,   G!  G <   G \ G  /  D y 1   ] F  GGGGGG&G&7Y{2 '6299@5 *759<9CJ8 '8299@,O ':2G9@O -:8G?GFGMT\ '>299@.; @-9AH)KP,M,M&4M'4M( ,MI,MJTcte\0w\2 y|3{|4 }T < d    l&(.()D*d#PDA This is a library for controlling colors and formatting, such asE=: red bold text or blue underlined text, on ANSI terminals. ## Basic usage@= There are three main types in this crate that you need to be=: concerned with: [`AnsiString`], [`Style`], and [`Color`].LI A `Style` holds stylistic information: foreground and background colors,JG whether the text should be bold, or blinking, or other properties. TheNK [`Color`] enum represents the available colors. And an [`AnsiString`] is a# string paired with a [`Style`].74 [`Color`] is also available as an alias to `Color`.JG To format a string, call the `paint` method on a `Style` or a `Color`,JG passing in the string you want to format as the argument. For example,&# here’s how to get some red text:< ```! use nu_ansi_term::Color::Red;>; println!("This is in red: {}", Red.paint("a red string"));<QN It’s important to note that the `paint` method does *not* actually return aOL string with the ANSI control characters surrounding it. Instead, it returnsLI an [`AnsiString`] value that has a [`Display`] implementation that, when OL formatted, returns the characters. This allows strings to be printed with a HE minimum of [`String`] allocations being performed behind the scenes.  IF If you *do* want to get at the escape codes, then you can convert the FC [`AnsiString`] to a string as you would any other `Display` value: <  !  ;8 let red_string = Red.paint("a red string").to_string();<    41 ## Bold, underline, background, and other styles  NK For anything more complex than plain foreground color changes, you need to NK construct `Style` values themselves, rather than beginning with a `Color`.LI You can do this by chaining methods based on a new `Style`, created withLI [`Style::new()`]. Each method creates a new style that has that specific property set. For example:< use nu_ansi_term::Style;)& println!("How about some {} and {}?",/, Style::new().bold().paint("bold"),:7 Style::new().underline().paint("underline"));<MJ For brevity, these methods have also been implemented for `Color` values,OL so you can give your styles a foreground color without having to begin with an empty `Style` value:<,) use nu_ansi_term::Color::{Blue, Yellow};(% println!("Demonstrating {} and {}!",,) Blue.bold().paint("blue bold"),;8 Yellow.underline().paint("yellow underline"));B? println!("Yellow on blue: {}", Yellow.on(Blue).paint("wow!"));<RO The complete list of styles you can use are: [`bold`], [`dimmed`], [`italic`],XU [`underline`], [`blink`], [`reverse`], [`hidden`], [`strikethrough`], and [`on`] for background colors.HE In some cases, you may find it easier to change the foreground on anGD existing `Style` rather than starting from the appropriate `Color`.,) You can do this using the [`fg`] method:<2/ use nu_ansi_term::Color::{Blue, Cyan, Yellow};SP println!("Yellow on blue: {}", Style::new().on(Blue).fg(Yellow).paint("yow!"));PM println!("Also yellow on blue: {}", Cyan.on(Blue).fg(Yellow).paint("zow!"));<EB You can turn a `Color` into a `Style` with the [`normal`] method.IF This will produce the exact same `AnsiString` as if you just used theOL `paint` method on the `Color` directly, but it’s useful in certain cases:IF for example, you may have a method that returns `Styles`, and need toWT represent both the “red bold” and “red, but not bold” styles with values ofRO the same type. The `Style` struct also has a [`Default`] implementation if you,) want to have a style with *nothing* set.<!1. Red.normal().paint("yet another red string");:7 Style::default().paint("a completely regular string");< ## Extended colorsOL You can access the extended range of 256 colors by using the `Color::Fixed` LI variant, which takes an argument of the color number to use. This can be!.+ included wherever you would use a `Color`:!; Fixed(221).on(Fixed(124)).paint("Mustard in the ketchup");<"""IF The first sixteen of these values are the same as the normal and bold#OL standard color variants. There’s nothing stopping you from using these as$JG `Fixed` colors instead, but there’s nothing to be gained by doing so\$ either.$$LI You can also access full 24-bit color by using the `Color::Rgb` variant,%A> which takes separate `u8` arguments for red, green, and blue:%<&&! use nu_ansi_term::Color::Rgb;&&*' Rgb(70, 130, 180).paint("Steel blue");<&&&+( ## Combining successive colored strings''IF The benefit of writing ANSI escape codes to the terminal is that they'MJ *stack*: you do not need to end every colored string with a reset code if(OL the text that follows it is of a similar style. For example, if you want to(PM have some blue text followed by some blue bold text, it’s possible to send)MJ the ANSI code for blue, followed by the ANSI code for bold, and finishing*IF with a reset code without having to have an extra one between the twod* strings.**NK This crate can optimise the ANSI codes that get printed in situations like+LI this, making life easier for your terminal renderer. The [`AnsiStrings`],NK type takes a slice of several [`AnsiString`] values, and will iterate over,PM each of them, printing only the codes for the styles that need to be updated-&# as part of its formatting routine.--PM The following code snippet uses this to enclose a binary number displayed in.:7 red bold text inside some red, but not bold, brackets:.<..!/0- use nu_ansi_term::{AnsiString, AnsiStrings};//)& let some_value = format!("{:b}", 42);/,) let strings: &[AnsiString<'static>] = &[0 Red.paint("["),0%" Red.bold().paint(some_value),0 Red.paint("]"),40 ];110- println!("Value: {}", AnsiStrings(strings));<111QN There are several things to note here. Firstly, the [`paint`] method can take2VS *either* an owned [`String`] or a borrowed [`&str`]. Internally, an [`AnsiString`]2LI holds a copy-on-write ([`Cow`]) string value to deal with both owned and3OL borrowed strings at the same time. This is used here to display a `String`,4FC the result of the `format!` call, using the same mechanism as some4PM statically-available `&str` slices. Secondly, that the [`AnsiStrings`] value5IF works in the same way as its singular counterpart, with a [`Display`]5C@ implementation that only performs the formatting when required.66 ## Byte strings66MJ This library also supports formatting `\[u8]` byte strings; this supports7IF applications working with text in an unknown encoding. [`Style`] and7RO [`Color`] support painting `\[u8]` values, resulting in an [`AnsiByteString`].8NK This type does not implement [`Display`], as it may not contain UTF-8, but9OL it does provide a method [`write_to`] to write the result to any value that9 implements [`Write`]:9,:\:```:# use nu_ansi_term::Color::Green;::RO Green.paint("user data".as_bytes()).write_to(&mut std::io::stdout()).unwrap();<;;;FC Similarly, the type [`AnsiByteStrings`] supports writing a list of<<9 [`AnsiByteString`] values with minimal escape sequences:<,=\==#=&# use nu_ansi_term::AnsiByteStrings;>> AnsiByteStrings(&[>0- Green.paint("user data 1\n".as_bytes()),>74 Green.bold().paint("user data 2\n".as_bytes()),?1. ]).write_to(&mut std::io::stdout()).unwrap();; [`&str`]: https://doc.rust-lang.org/std/primitive.str.htmlB@= [`Write`]: https://doc.rust-lang.org/std/io/trait.Write.htmlB  [`Style`]: struct.Style.htmlC2/ [`Style::new()`]: struct.Style.html#method.newC [`Color`]: enum.Color.htmlCC(% [`AnsiString`]: type.AnsiString.htmlD*' [`AnsiStrings`]: type.AnsiStrings.htmlD0- [`AnsiByteString`]: type.AnsiByteString.htmlE2/ [`AnsiByteStrings`]: type.AnsiByteStrings.htmlE:7 [`write_to`]: type.AnsiByteString.html#method.write_toE74 [`paint`]: type.AnsiByteString.html#method.write_toF-* [`normal`]: enum.Color.html#method.normalFF+( [`bold`]: struct.Style.html#method.boldG/, [`dimmed`]: struct.Style.html#method.dimmedG/, [`italic`]: struct.Style.html#method.italicG52 [`underline`]: struct.Style.html#method.underlineH-* [`blink`]: struct.Style.html#method.blinkH1. [`reverse`]: struct.Style.html#method.reverseH/, [`hidden`]: struct.Style.html#method.hiddenI=: [`strikethrough`]: struct.Style.html#method.strikethroughI'$ [`fg`]: struct.Style.html#method.fgJ'$ [`on`]: struct.Style.html#method.on)KP---&,',( ,I,J,c,e,w, y,{, }, , , , ,&,(,(-),*,#,...M.dM$M ,+,2DL`c dHJ:<>/LZ"Tf9 Od 9 ÜĜŜƜǜȜ_wRB     4D $         U  Od 9 B   4D $  JG The code to send to reset all styles and return to `Style::default()`., 2T:X : B 4D $  &X& : B &4&D& $& & &T89B#8FC The prefix bytes for this style. These are the bytes that tell the941 terminal to use a different color or font style.9t9 # Examples:<::)& # #[cfg(not(feature = "gnu_legacy"))]<: # {:+( use nu_ansi_term::{Style, Color::Blue};;;(% let style = Style::default().bold();; assert_eq!("\x1b[1m",;+( style.prefix().to_string());<< let style = Blue.bold();< assert_eq!("\x1b[1;34m",<+==! let style = Style::default();= assert_eq!("",=+<= # }<>D> >.+ # Examples with gnu_legacy feature enabled>85 Styles like bold, underlined, etc. are two-digit now?; See also [`Style::infix`](struct.Style.html#method.infix).XtXX