rust #rustc 1.98.1 (48a229cea 2026-09-01)RL.SAwjL-df1bddb45adbe94bstable_deref_traitu9eו'Bg3-41871b6e7daf3e61<%Z>64V`-2d2ab9fb0fe1def5 yoke_derivebnV_ < h-11362969a557d7e0zerofrom̀uqVH^b-07ad24c4244ca270zerofrom_derive:Ҕ«-50f5b0ef1b7b2465,BoxKa$$tests,a$aerased4 ErasedArcCartl ErasedBoxCartl$& ErasedRcCartdEGKpToOwned<  cartable_ptr sentinel_forSENTINELprivate SealedCartablePointerLikeRawinto_rawdrop_rawCloneableCartablePointerLike addref_raw'a!! ! from_cartable!is_none&&)),.0either22226C06C1666;2= = =2A A kinda_sorta_danglingDDDDDDDKindaSortaDanglingKKdangleDNN N into_innerDRRRDVVDYY macro_impls\\\\\copy_yoke_impl\impl_copy_type\unsafe_complex_yoke_impl\ddd'bd\iiT1i iT2i i\ppp pp pv utilsxxtransform_mut_yokeablezzzzz yoke  Yokeyokeablecart attach_to_cart'detry_attach_to_cartattach_to_cart_badlytry_attach_to_cart_badlyget backing_cartinto_backing_cart replace_cartC2impl FnOnce(C) -> C2with_mut with_mut_return wrap_cart_in_optionnew_always_owned into_yokeable  new_ownedtry_into_yokeable  convert_cart_into_option_pointer  CloneableCart   map_projectmap_project_cloned'thistry_map_projecttry_map_project_cloned!map_project_with_explicit_capture(map_project_cloned_with_explicit_capture%try_map_project_with_explicit_capture,try_map_project_cloned_with_explicit_capture map_with_cartmap_with_cart_clonedtry_map_with_carttry_map_with_cart_clonedwrap_cart_in_either_awrap_cart_in_either_bYokeable transformtransform_ownedmake transform_mut            zero_fromattach_to_zero_copy_cart CartableOptionPointerinner _cartable 2 EitherCart    2  2  2  2  2  \     \     \     \     \     \     \      \      \      \      \      \     \     \     \     d d d d  i i i i  p p p p  888%8(8+88888888;8U8X8[888888888888888888888888888888   22g###5mm#2222 2ᬡoh(a  3333g3"333"KK M DU"4#4řǙșəʙ˙G*R{9 2  2ger>8OWgg8888888řǙșəʙ˙G*R{9 4258 2!!! PhantomDatao$z -2   &YK),Ař  .06RK=VK dři p ! g#  " "gcD   5$1uKb  3f*ہ4   Hb4 7*9Q$R[R4>T  5 ==  Q%mVb VbVb  3f*ہ2 Vb  ;0 2@4 ؗ;b2mUb2b@T @$  2!!i5!@D!_pointer5$ #k5#@D#A - L  3f*ہ2U gL !!!9o$z -2LXD(I g (E EVI IÜĜŜƜǜȜ_w5ĤĤŤError :M 2# ggg cgbufcثq1ȡjDK CVD  DHGDHD<E ĤN= CekNa 2D NN#MCC2$MC ?==|?,PP 2DPTPPG 2D QQ$ OP ] ]CPCRbC ]|bCEbCEb2$O2DOCBGA ]GI ]~NeMatchvX]! ]cartable#left_val right_valVK [CC ]]?IJS/ 6 / =O ] -  Cekmމb%މb C$b  C bub( Qމb b  SS%RT C C     CS&CC $SG,SC? = = QWCUQ$C? TTTCTTT M =m { K  CW]uM_     Q   Q    }M_ M_  UĈW  ; I    C> D V%C WW  2X"T X XX(TTi Cq Cm l g c ^ LA_CC"CMM_CC C~  C          5T 2LTCCC? =='QQo?J =N i IV?\ ?b YTYCYY =   Ce k    Qs   Qq  m t  ~  Y[ 2["1Y [T\C\S 2 D \ \\+ YYCC[CCCXC C 2$YG,YCv5:jCiC=?1=5==QQa -\?b( #  3 ( 3?G  3 (# 3?G 33   3339A 9?F3S 3^6f 33 3Y3a__self_05baaZ H  %+<KXi6    3  & 3_^ 33 -_ 5_42> 6^     3  & 3 33     ! ' /7 = E#39@GNU_3333cc66666cc$c~c  __self_discr. __arg1_discrFb __arg1_0 b  j gf  5c!*4( #  3 & , 8 Dt gEr  3 &,8DNm^Eo   % +3 u{ FcG6cD ccD cbZboDm*oDm8$T$ 3L "3 < 3L8 "3 <    ; c,6$cc#5rq&r Ĝ}|͇5}~ 441} 4 5}}-| 4 }|L K4 P}h|44o}4_~44$44 MaybeUninituninitW췜4a ManuallyDrop~$4 MaybeDangling @_f4 S40 8 46[  K4P44u4 (4 4 4#|R 4m|Ӿ|%Ӿ|v @_f44uӾ| 4 |%  | Q T4R44U9}4l8~4EU}|4|4E|45|4U4 4$u~$4Dz$5 { ufmanualdzL#|Rzm͙|TQu{ }˙| ٙ|U|44Eҙ| 4 4,5{~!wz#|Rz|u|%|uź| 4 || |X̹|4|4e| 44 4L5 u#~zħ um ŤR 47$   [4d 4| 45L5 (ނ/ A 5h( 3E5`5  R55G5 5 thisR5:8  R # 5BJ5ˈ`ÈɈ!Q A=h=( / E5`5  / G5 5 18  R #È 5@H5`È!Q A 5h( 3 E5`5  / G5 5 18  R #È 5@H5`È!Q A 5h( 3 E5`5  / G5 5 18  R #È 5@H5`È!Q A 5h( 3 E5`5  / G5 5 18  R #È 5@H5`È!Q A 5h( 3 E5`5  / G5 5 18  R #È 5@H5`È!Q A 5h( 3 E5`5  / G5 5 18  R #È 5@H5`È!Q A 5h( 3 E5`5  / G5 5 18  R #È 5@H5`È!Q A 6h( 3 E6`6  / G6 6 18  R #È 6@H5`È!Q !!!A 6h!ߩ(! 3 !!!E6`!6 ! / !!!G6 !6 !18!  R #È 6!@H!!!5!`!È!!Q ###A 6h#ح(# 3 ###E6`#6 # / ###G6 #6 #18#  R #È 6#@H###5#`#È#!Q %%%A 6h%ѱ(% 3 %%%E6`%6 % / %%%G6 %6 %18%  R #È 6%@H%%%5%`%È%!Q '''A 6h'ʵ(' 3 '''E6`'6 ' / '''G6 '6 '18'  R #È 6'@H'''5'`'È'!Q )))A h)ù() 2 )))E`) ) - )))G ) )/8)  R #È )?G)))5)`)È)!Qۻ +++A h+(+ 2 +++E`+ + - +++G + +/8+  R #È +?G+++5+ڿ`+È+ؿ!Qο,,, ," řǙșəʙ˙G*R{9 2,., ,, , 6@, 6H,(,M,#,,,,M@60,W'6,V'68(#p,`,6 ,, !6,,(,,+,%,,,,j,6,(,(t)$6p,6 , , ,p 565 [/T], ,- D& 3 $ R #  AI ,,z65R>45, 6`,," 6B<>3 1,1 1" 771.1 11 1 7@1 7H1(11(1111M701U,71T,76-(p1`17 11 !711(11+1*1111171-1-n.)7p17 1 1 15 754T]1 1-   R # .711z7551 7`11 7&<>6,6 6" 6.6 66 6 7@6 7H6(6 6-6666M 706'176&172W-p6`67 66 !766(66+6.6666 6 76]26]2@3.7p67 6 6 6 5 759T]6 6-           R #     66 z75   56 7`66   7  <>  = < ;  E C B I  Y R # A   B z)      D  -  N  <?  N  %q%A%R g %RE4%%FT&̝r 1R 8 1 &&  Tt 8!  DR dRE4& _&" & %R dAD& & & r DRRET&Z&3 V5S5KK M DU8uuW췜85  8|5p3  m3 R 8 lr\r%qe88,&3U8w383S583t;88t&F% 8,%G % dd DebugStructddd dd has_fieldsd19Dn 8DD 8O 85b5M5 7<DUDnP 5T($5R 6 ))S(&R gd (*=688Q8M8A6>6R({88,(s6U8<|68w688w6F(,(G (n5b7M79@Ds7T*7R7\*. 7R 87M:J:: :87R 2 R 2228 : : :  : 8  8 WR :9 ** *LP88,*8U8989:8988,*J9U8S98N9:8N94̹* $*,*,*`5^:I:<5:l:<m pS: :2T-( :R; --]\-u  E;R [;C;<<+=?=G;D; R  -#R ĩ-; < < +=  ?= ;  ;  R  ,v88,-,<U8 5<80<=80<88,-z<U8C <8~<=8~< řǙșəʙ˙G*R{9 LessGreater%ӡy,,,,,I 5>><l 5;>&><m p > >T. >R> // \//  >R >><<+=?=?> R    .R /? < < +=  ?= R?  c? TR 7 6  .^4 88,/?U8?8?=8? 88,/?U8?8?=8? .,.,.m)Y5>?<|5>?<m p9>>dV V R|VdV$VR "8-R>Mr?<<+=?=R?c?R?U8?8?=8?qDq>5>?<.w>C8t t,t 9LЁ8 ށ߁=8 ā8$ /b Dl 9 9 9  9 $dL 8" 1R #8 X` Î "D   ;} ;}    :1   ;} I=  ;}  Ύ 8 ݒ   ?: T:99}%1u~$];}>5;}6>J> er>8OWg8\ލ8$ Ч8.Ч-v @_f9` Чb7B078= @R @ +@5@?@S@ 8g@q@@R 8l @X8@8@@8@5 8d 59 8D5 @+@ 5@FH  @ @R @ 5@?@S@g@5 g3f3e3 c3a3`3 g3 w3R # _3 33`3 @X8tޭ@8@@8@3z8333  d 5 @+@5@4444UW  @43R 88řǙșəʙ˙G*R{9 8 ʙ8$Rӳ$ܮer>8OWg88$ n !o9w999 89 899 899 K8:ٷ 85R5 ":P8+:8o9?:8w9T:89er>8OWg85$ʷ8Do9w991lּ X<99 9 9<R< <<<ש+=?=I= \=f=  =Q8d=?:=T:9=====8==8>>8.>6> 8J> 8 ٻͷ$лЧX<ש95<<<A<!o9w999 89 899 899 K8:$  ř8 8  ":P8+:8o9?:8w9T:89$8Dlo9w999D   P87 qx ř8p 8lskcs%8#8GL|*Գl X<99 9 9<R<$ L 8   < < < ש+=  ?= I=  \= f=  8   =Q8d=?:=T:9=====8==8>>8.>6> 8J> ÜĜŜƜǜȜ_w8|$6<98ЧX<ש95<<<\<L|*l ## # B B R=B B    3f*ہ8 # # Q$ 8R!!!9o$z -8u$ 8###5mm8  $ 8l * % *%R 8B% L% S% 8 Rw%  8lrx}$#8# #%$8N%%% %      # & &&-&&B& er>8OWg8!$6T8ud9(#?>=B=B %le"?d*% [G'?d]']']' BBR=B B  ]' ]'' ' ' '  ( ( '  )( =( =( M(ԁl X<  9 9  9 9 <R<$ L 8    <<< ש+=?=I=\=f=   8 g(%8L]' #&(&-&&B&=Q8d=  ?: = T: 9 = = = = = 8= =8>>8.>6>8J>ÜĜŜƜǜȜ_w8|$f8ee]'?>=B=B''(ЧX< ש9 5<<<[,3:?d<$T=>R > lRȄ$ o9 w9 99  89 899 8 9 9 K8 : L 8%R 83<  88   &f>R <? < < +=  ?= R? c? ?R== =88,?U8U@?8?=8?":P8+:8o9?:8w9T:898$,BB88SSA5>?<o9w99~ ȄcA>    R<,Ԉl X< 99 9 9<R<  R!!!9o$z - RR #D!+    TR   +o9 w9 99  9 99  9 9 K:   L   8̔ 8  ԗ   ڗۗev H8 << <  ש+= ?= I= \=f= (R 88=Q8d=?:=T:9=====8==8>>8.>6> 8J> ":P+: o9 ?: w9 T:9er>8OWg8T8$ 8KK M DU83/ЧX<ש95<<< uuW췜o9 u~$w9 v @_f9|8j80<    RTH >R  >   ٟTR  *o9w999  9 99 99 K:  L   8%R . <   8    & I  R& R=R #gq?<<+=?=R? c?KR oIoI vI88,?U8K?8?=8?":P+:o9?:w9T:9er>8OWg8T\ DD$$KK M DU8CCJLM5>?<uuW췜o9u~$w9v @_f9|@~N> >=<  R3,l  X<99   9 9< R <  RRR &  L:: Ro9w999 9 99 99 K: L 8± 8  ʴ    ˴  ѴҴخ  J8 < < < ש+= ?= I=\= f=  R;;҄;; ҄~; ÜĜŜƜǜȜ_w҄{;;;>?  [ls{; x;R6;v;}; ҄t; ҄r; 8 n;u;l; i;h-= mg ߱ TR  !8=Q8d=?:=T:9=== = =8== 8> > 8.> 6>8J><`҄<<<`҄҄ < <҄<":P+:o9?:w9T:9 ÜĜŜƜǜȜ_w҄8$ m[}OD^;ÜĜŜƜǜȜ_w҄n8ll_JH8ЧX<ש95< < < 6@<?҄bAJA6=<҄&@Y@o9w99   i K !  08Y`8m<@Ԑ  R2TX>R >  ;D 8D  Ro9w999  9 99 99 K:   L 8%R. <  8  Ƚ     ɽ  ϽнW YO RgR~R ?< < += ?= R?c?[RY  YTE [E ̗RE YE  ̗=E  ÜĜŜƜǜȜ_w̗:E AE @A [":E 7E R6WE 5E ?< 6E H ̗J J 6E ̗nI I o9w99     f/a>  R,l X< 99 9 9<R< < Rt?R\,    TR  !o9 w9 99  9 99  9 9 K:   L   8 8     89I  << <  ש+= ?= I= \=f= R=Q8d=?:=T:9=====8==8>>8.>6> 8J> ":P+: o9 ?: w9 T:9T8$<ӛ!!!9o$z - 5B 8.8ЧX<ש95<<< o9 w9 9capture "q8ls<   RTg >R  >  TR !o9w999  9 99 99 K:  L   8%R . <   8    &5E h < R#.@R\-?<<+=?=R? c?}jR `h`h gh88,?U8j?8?=8?":P+:o9?:w9T:9T\< ӛٯB 8fk5>?<o9w99d4{l> RBut,l X<99  9 9< R < <  R  ;R\    XX Ro9w999 9 99 99 K: L 8 8     ҄   8;K < < < ש+= ?= I=\= f= R qYxY҄oYvY ҄ZY Y YBC  [Y YR6!YXY ҄X ҄Xip -8 XXX X-u m  TR  !=Q8d=?:=T:9=== = =8== 8> > 8.> 6>8J>Y`҄MYYY`҄҄xYY҄Y":P+:o9?:w9T:9 ̎8$<ӛÜĜŜƜǜȜ_wٯ҄B {yx8vv8ЧX<ש95< < < 67Y}\҄Y^A^64Y҄]P]o9w99x|    388< RD$#Tp>R > L#a  a  Ro9w999  9 99 99 K:   L 8%R. <  8      ҄   U 7Gq< RBD=R\ l?< < += ?= R?c?pRr  r;b Bb ҄9b @b  ҄$b  a a cDE [a a R6a a a ҄a ҄a "  { a a a  a *$ m[   TR   !s88,?U8p?8?=8? b`҄b  b  a`҄҄a  a҄a ":P++:o9?:w9T:9̎\<¹B vtso&F8p5>?< 69a d ҄[f Cf 66a ҄e Re o9w99    <p>    Re,l X<99 9 9<R < R L  8$R - <   R   1RHR #pz      TR   !o9 w9 99  9 99  9 9 K:   L   8ƀ 8  ΃   ԃՃd u   k8 << < ש+= ?= I= \=f= R =Q8d=?:=T:9=====8==8>>8.>6> 8J> ":P+: o9 ?: w9 T:9T8$ >>88ЧX<ש95<<< o9 w9 9=R8[<    R Tp>R > A Q RgR #    ؋  TR   o9w999   9 99 99 K:   L   8%R . <   8  ˎ   юҎ&  qL 8%R.<?<<+=?=R?c?pRr r s88,?U8p?8?=8?":P+:o9?:w9T:9T\ӈ ;;8p5>?<o9w99h]^p>Ffe  R3,Ԁl  X<99   9 9< R < R L  8$R -  <Ę ʘ :RO  `RwR  ՘ )v&vRo9 w9!9"9" 9! "9"9 !9!9 K : ěLٛ 8 8   ҄  ~    m8 < < < ש+= ?= I=\= f=  R vv҄vv ҄v yvv}F֘G֘  [yv vvR6vtv{v ҄rv ҄pv5< ט  X8 rvyvpv mv3f m ATR  !=Q8d=?:=T:9=== = =8== 8> > 8.> 6>8J>'w`҄%"www`҄҄Pww҄w":P+:o9?:w9T:9#̎ԕ8$ŕ ˕8..ec8ЧX<ש95< < < 6lvy҄{v{6iv҄Rzzo9w99,/    s   WH Y8^e8y<Hܣ!ܣ  ܣ R3Tޣp>R >  p RR   ~ ~  Ro9w999 9 99 99 K: L 8%R.<  8     ̗   U ؠ qL  8%R . <?< < += ?= R?c?pRr  r  ̗   ̗  e l HI  [ e  b R6 ` g  ̗^ ̗\   p [ b Y  V  0ܣ! mV  ǦTЦR ئ ԣs88,?U8p?8?=8?`̗    `̗̗H  ̗ ":P*+:o9?:w9T:9 \ ^^1 @8p5>?< 6~ ! ̗  6~ ̗  o9w99 أ     y"0p> R 88ᬡoh(a8 8$Rlܓer>8OWg8̓8$ n* R 88ᬡoh(a8 8$Rl܎er>8OWg8̎8$ n֛*ֆ Ȇ5ц'() ٻ5'()݉ ω5؉'()$XXW @LWDW 1$YYX@,X@$X -[[Y@$Y@$Y .^.$_ R # @ _>F __[^U\5[d[ [%( ^u$eed? :eDe 0fe=:de:$e R:2ff?:$f:$f R:3F hhf5fdf f M MR 88886ɛӛU5$ R )X  8$ 8$  .ݧ %R   *      33-383?F  33-383?F                              2D\xDPl$ZeroFromD 3jg This crate provides [`Yoke`][Yoke], which allows one to "yoke" (attach) a zero-copy deserialized object (say, a [`Cow<'a, str>`](alloc::borrow::Cow)) to the source it was deserialized from, (say, an [`Rc<[u8]>`](alloc::rc::Rc)),if known in this crate as a "cart", producing a type that looks like `Yoke, Rc<[u8]>>`*' and can be moved around with impunity.fc Succinctly, this allows one to "erase" static lifetimes and turn them into dynamic ones, similarlyTQ to how `dyn` allows one to "erase" static types and turn them into dynamic ones.XU Most of the time the yokeable `Y` type will be some kind of zero-copy deserializable UR abstraction, potentially with an owned variant (like [`Cow`](alloc::borrow::Cow),  [`ZeroVec`](https://docs.rs/zerovec), or an aggregate containing such types), and the cart `C` will be some smart pointer like  [`Box`](alloc::boxed::Box), [`Rc`](alloc::rc::Rc), or [`Arc`](std::sync::Arc), potentially wrapped in an [`Option`](Option).  da The key behind this crate is [`Yoke::get()`], where calling [`.get()`][Yoke::get] on a type like a^ `Yoke, _>` will get you a short-lived `&'a Cow<'a, str>`, restricted to the pm lifetime of the borrow used during [`.get()`](Yoke::get). This is entirely safe since the `Cow` borrows fromro the cart type `C`, which cannot be interfered with as long as the `Yoke` is borrowed by [`.get()`](Yoke::get).if [`.get()`](Yoke::get) protects access by essentially reifying the erased lifetime to a safe local one when necessary.74 See the documentation of [`Yoke`] for more details.2D\xP 3FIL85 Types for optional pointers with niche optimization.NK The main type is [`CartableOptionPointer`], which is like `Option` butMJ with a niche so that the resulting `Yoke` has a niche. The following four74 types can be stored in the `CartableOptionPointer`:\ 1. `&T`| 2. `Box`t 3. `Rc`| 4. `Arc`OL These four types implement the sealed unsafe trait [`CartablePointerLike`].KH In addition, all except `Box` impl [`CloneableCartablePointerLike`],@= which allows [`CartableOptionPointer`] to implement `Clone`.d l9\!9!< StableDeref\4  oO8 "d >B  4  4  D  5 \< 4   |:85 An object fully representable by a non-null pointer.d # Safety Implementer safety:`] 1. `into_raw` transfers ownership of the values referenced by [`StableDeref`] to the caller,(% if there is ownership to transferWT 2. `drop_raw` returns ownership back to the impl, if there is ownership to transfer_\ Note: if `into_raw` returns the sentinel pointer, memory leaks may occur, but this will not  lead to undefined behaviour.XU Note: the pointer `NonNull` may or may not be aligned and it should neverVS be dereferenced. Rust allows unaligned pointers; see [`std::ptr::read_unaligned`].\ 49.%K@7LDDA The raw type used for [`Self::into_raw`] and [`Self::drop_raw`].t4(.+ Converts this pointer-like into a pointer.t4D 3f*ہB $074 Drops any memory associated with this pointer-like.d Caller safety:EB 1. The pointer MUST have been returned by this impl's `into_raw`.(% 2. The pointer MUST NOT be dangling.t4D5  <B?< An object that implements [`CartablePointerLike`] that alsoEB supports cloning without changing the address of referenced data.dKH 1. `addref_raw` must create a new owner such that an additional call to41 `drop_raw` does not create a dangling pointerGD 2. `addref_raw` must not change the address of any referenced data.*6+2 Clones this pointer-like.dE(t4T5  <2 2 0 2"$D  2 D 2@B 2R !(D!@5 2A "9 "2  "#*T#@5 2A LB""2 L2L2#$%M$M2B!! #2O0lO22B!! $2MY&RQC@ Returns whether this instance is `None`. From the return value:QR'$ - If `true`, the instance is `None`R63 - If `false`, the instance is a valid `SelectedRc` ?@@>? TT43\3\3 l B CBC3l3l3-/24ĤKudDFu\DGs,"DIDerefMutD"DJLVXFHL;=$& 0 LL 4< 4UM[(*4DKKu&OO <4PQ*44BNN P4 x:#T44BNN Q4b>0SS <4TU""U \4RR4, 4 4BR R U4$3WW <4X"X!L 4 4BV V X4$/ZZ <4[#[$ 45BY Y [4$|\D\]P\]ud\_ \`|T$2 "܆t    *  3+   848 8 L   8$( 8$'84  8$+   848 8 |  8$(8$'84  8$+   848"48 8 $  8$& 8$'84(8$  8$+   848 8 l 8     :88$$ 8 & 8 8$,8 & :7< 8  :  84   : 88$'84$   8   8$% ܎t    , 8& 8*   8"48$ : 8D : 8 , 8   8!$84 8$ % 8 t    % %  %Ă    *  ,8 8 L   :8$( :8$'84  8"4       8$8 8,8$8 8,8$'848 8 |  8$(8$'84  8"4  88 &  8,8$'84    8$8 8,8$ 8cast$  % 88  8ud'8   8$% 8 '8read$  8 8"48 8 $  8$& 8$'84(8$  8 debug_assertd   8<' 8$'84   8<' 8$   % 88   8$8 8,8$'848 8,8$% 88  8ud'8   8$% 8"4  8 '8ā$  8 8 8 l 8     :88$$ 8 & 8 8$,8 & :7< 8  :  84   : 88$'84$   8,'8 ,'8   8$$ 8 % Mefef 2<g2g6hdf\4ddřǙșəʙ˙G*R{9 2uj k mkmj777<l7l7<n7n7o\4ii77Zqrttqr 5t<s2s7vpru 5\4ppL,zDxyPxy|- B{|}~}{|~   d<# &# < zooD$##T K ,xDP9\!9!uds,"\̖/d|m^O+;8 A Cow-like borrowed object "yoked" to its backing data.GD This allows things like zero copy deserialized data to carry aroundQN shared references to their backing buffer, by "erasing" their static lifetime2/ and turning it into a dynamically managed one.C@ `Y` (the [`Yokeable`]) is the object containing the references,FC and will typically be of the form `Foo<'static>`. The `'static` is RO not the actual lifetime of the data, rather it is a convenient way to mark the (% erased lifetime and make it dynamic.  ZW `C` is the "cart", which `Y` may contain references to. After the yoke is constructed, YV the cart serves little purpose except to guarantee that `Y`'s references remain valid da for as long as the yoke remains in memory (by calling the destructor at the appropriate moment).  `] The primary constructor for [`Yoke`] is [`Yoke::attach_to_cart()`]. Several variants of that YV constructor are provided to serve numerous types of call sites and `Yoke` signatures.  c` The key behind this type is [`Yoke::get()`], where calling [`.get()`][Yoke::get] on a type likeac` lifetime of the borrow used during `.get()`. This is entirely safe since the `Cow` borrows froma^ the cart type `C`, which cannot be interfered with as long as the `Yoke` is borrowed by `.geta^ ()`. `.get()` protects access by essentially reifying the erased lifetime to a safe local oneli Furthermore, there are various [`.map_project()`][Yoke::map_project] methods that allow turning a `Yoke`c` into another `Yoke` containing a different type that may contain elements of the original yokedA> value. See the [`Yoke::map_project()`] docs for more details.\Y In general, `C` is a concrete type, but it is also possible for it to be a trait object.l # ExampleQN For example, we can use this to store zero-copy deserialized data in a cache:\ ```rust # use yoke::Yoke; # use std::rc::Rc;܇ # use std::borrow::Cow;74 # fn load_from_cache(_filename: &str) -> Rc<[u8]> {! # // dummy implementationKH # Rc::new([0x5, 0, 0, 0, 0, 0, 0, 0, 0x68, 0x65, 0x6c, 0x6c, 0x6f])< # }IF fn load_object(filename: &str) -> Yoke, Rc<[u8]>> {52 let rc: Rc<[u8]> = load_from_cache(filename);OL Yoke::, Rc<[u8]>>::attach_to_cart(rc, |data: &[u8]| {52 // essentially forcing a #[serde(borrow)]>; Cow::Borrowed(bincode::deserialize(data).unwrap())T }), }/, let yoke = load_object("filename.bincode");'$ assert_eq!(&**yoke.get(), "hello");52 assert!(matches!(yoke.get(), &Cow::Borrowed(_)));< ```$8 8 88er>8OWgLNOQD<"$"8# $ $8$g8$g8%8gkm$vx$%D% 8 ggg cgFcثq1ȡFB % 88$%s& & '8'g8'8g\^ac''(D( 8 ggg cgFcثq1ȡFB ( 88$(Cv)z ) )8)8L)8bdgi))*"* 8 8B * 88$* 6y*l * *8+8+8QSVX+++| + +8,8T,8bdgi,,,B\, 8 8B , 88$, |-n - -8-8.8\^ac-..2. 8 8B . 88$. <9 may borrow only from the argument passed to the closure.>>RO See also [`Yoke::try_attach_to_cart()`] to return a `Result` from the closure.??UR Call sites for this function may not compile pre-1.61; if this still happens, use@41 [`Yoke::attach_to_cart_badly()`] and file a bug.@t@ # ExamplesATF,FFFB? let yoke: Yoke, _> = load_object("filename.bincode");F'G5 (Yoke, Rc<[u8]>>, usize) {K5K$! let mut bytes_remaining = 0;L30 let bytes_remaining = &mut bytes_remaining;LGD let yoke = Yoke::, Rc<[u8]>>::attach_to_cart(|M rc,ܻM |data: &[u8]| {MEB let mut d = postcard::Deserializer::from_bytes(data);NEB let output = serde::Deserialize::deserialize(&mut d);N?< *bytes_remaining = d.finalize().unwrap().len();O.+ Cow::Borrowed(output.unwrap())tO },TO );P  (yoke, *bytes_remaining),PPPC@ let (yoke, bytes_remaining) = load_object("filename.postcard");Q'Q5Q# assert_eq!(bytes_remaining, 3);, C>`, thisj# will return an `&'a Cow<'a, T>`jljk\k§k֧kkk7l!lK Yoke, Rc<[u8]>> {n74 # let rc: Rc<[u8]> = load_from_cache(filename);nQN # Yoke::, Rc<[u8]>>::attach_to_cart(rc, |data: &[u8]| {o@= # Cow::Borrowed(bincode::deserialize(data).unwrap())do # })>::attach_to_zero_copy_cart(y Box::new(local_data),4y );y# assert_eq!(*yoke.get(), "foo");zĪz // Get back the cartz(% let cart = yoke.into_backing_cart();z assert_eq!(&*cart, "foo");<{ܮ{{@= Bad example: information specified in `.with_mut()` is lost.{<{ܮ̄| use std::borrow::Cow;|||&| let mut yoke =}IF Yoke::, Box>::attach_to_zero_copy_cart(}! Box::new(local_data),T}~" assert_eq!(yoke.get(), "foo");~~  // Override data in the cart~ yoke.with_mut(|cow| {~# let mut_str = cow.to_mut();ġ mut_str.clear();  mut_str.push_str("bar");< });" assert_eq!(yoke.get(), "bar");Ğ()& assert_eq!(&*cart, "foo"); // WHOOPS!<ܮ88B 88L74 Unsafe function for replacing the cart with another<9 This can be used for type-erasing the cart, for example.dTQ - References from the yokeable `Y` should still be valid for the lifetime of the returned cart type `C`.^[ For the purpose of determining this, `Yoke` guarantees that references from the Yokeableb_ `Y` into the cart `C` will never be references into its stack data, only heap data protected؅eb by `StableDeref`. This does not necessarily mean that `C` implements `StableDeref`, rather that†eb any data referenced by `Y` must be accessed through a `StableDeref` impl on something `C` owns.gd Concretely, this means that if `C = Option>`, `Y` may contain references to the `T` but not anything else.[X - Lifetimes inside C must not be lengthened, even if they are themselves contravariant.XU I.e., if C contains an `fn(&'a u8)`, it cannot be replaced with `fn(&'static u8)`,)& even though that is typically safe.$! Note: `f` *is* allowed to panic.Պ݊^[ Typically, this means implementing `f` as something which _wraps_ the inner cart type `C`.XU `Yoke` only really cares about destructors for its carts so it's fine to erase otherZW information about the cart, as long as the backing data will still be destroyed at thet same time.d8ō#|ʍ#׍ 88eg`b~(% Mutate the stored [`Yokeable`] data.YV If the callback needs to return `'static` data, then [`Yoke::with_mut_return`] can beVS used until the next breaking release of `yoke`, at which time the callback to thisؔ74 function will be able to return any `'static` data.EB See [`Yokeable::transform_mut()`] for why this operation is safe.lB? This can be used to partially mutate the stored data, providedϖ)& no _new_ borrowed data is introduced.\§! # use yoke::{Yoke, Yokeable};֗ # use std::mem;7ʘ!K<,̙֙FC # fn load_object(filename: &str) -> Yoke, Rc<[u8]>> {7ݚLI # Yoke::, Rc<[u8]>>::attach_to_cart(rc, |data: &[u8]| {RO # // A real implementation would properly deserialize `Bar` as a whole # Bar {NK # numbers: Cow::Borrowed(bincode::deserialize(data).unwrap()),MJ # string: Cow::Borrowed(bincode::deserialize(data).unwrap()),$! # owned: Vec::new(),| # }d< #[derive(Yokeable)] struct Bar<'a> {ٞ numbers: Cow<'a, [u8]>, string: Cow<'a, str>, owned: Vec,,ş͟96 // `load_object()` deserializes an object from a file@= let mut bar: Yoke = load_object("filename.bincode");Р*' assert_eq!(bar.get().string, "hello");:7 assert!(matches!(bar.get().string, Cow::Borrowed(_)));EB assert_eq!(&*bar.get().numbers, &[0x68, 0x65, 0x6c, 0x6c, 0x6f]);;8 assert!(matches!(bar.get().numbers, Cow::Borrowed(_)));Ȣ'$ assert_eq!(&*bar.get().owned, &[]); bar.with_mut(|bar| {/, bar.string.to_mut().push_str(" world");ͣ63 bar.owned.extend_from_slice(&[1, 4, 1, 5, 9]);<0- assert_eq!(bar.get().string, "hello world");Ѥ74 assert!(matches!(bar.get().string, Cow::Owned(_)));41 assert_eq!(&*bar.get().owned, &[1, 4, 1, 5, 9]);ƥ(% // Unchanged and still Cow::BorrowedE;<ܮD 85B <ɧ# 8ӧ3#5ۧ+ 88$8קXU Mutate the stored [`Yokeable`] data, and return `'static` data (possibly just `()`).TQ See [`Yokeable::transform_mut()`] for why this operation is safe, noting that not `'static`. ### Will be removed\Y This method will be removed on the next breaking release of `yoke`, when the callback ofZW [`Yoke::with_mut`] will gain the ability to return any `R: 'static` and supersede this\ method.|ԙB  <լ# ߬8#ˠ < 88$aܮ6MJ Helper function allowing one to wrap the cart type `C` in an `Option`.8B 88) ư8ɰͷ-/Ͱ,?< Construct a new [`Yoke`] from static data. There will be no@= references to `cart` here since [`Yokeable`]s are `'static`,2/ this is good for e.g. constructing fully owned)& [`Yoke`]s with no internal borrowing.߲IF This is similar to [`Yoke::new_owned()`] but it does not allow you toA> mix the [`Yoke`] with borrowed data. This is primarily useful,) for using [`Yoke`] in generic scenarios.lƴ\δ§޴֧41 let owned: Cow = "hello".to_owned().into();ٵA> // this yoke can be intermingled with actually-borrowed YokesA> let yoke: Yoke, ()> = Yoke::new_always_owned(owned);$<ܮ8ͷB 8.+ Obtain the yokeable out of a `Yoke`74 For most `Yoke` types this would be unsafe but it's=: fine for `Yoke` since there are no actual internalt referencesl»ͷ8B 83  868AC+;?@ֿ2)ŤIF This can be paired with [`Yoke:: wrap_cart_in_option()`] to mix owned and borrowed data.XU If you do not wish to pair this with borrowed data, [`Yoke::new_always_owned()`] can74 be used to get a [`Yoke`] API on always-owned data.l\§֧ܙ4AHE let yoke: Yoke, Option>> = Yoke::new_owned(owned);$<ܮL8B 88p1B? Obtain the yokeable out of a `Yoke>` if possible.HE If the cart is `None`, this returns `Ok`, but if the cart is `Some`,$! this returns `self` as an error.B 88H  88BDMORJG Converts a `Yoke>` to `Yoke>`96 for better niche optimization when stored as a field.t<ܮ-* let yoke: Yoke, Box>> =DA Yoke::attach_to_cart(vec![10, 20, 30].into(), |c| c.into());1. let yoke_option = yoke.wrap_cart_in_option();MJ let yoke_option_pointer = yoke_option.convert_cart_into_option_pointer();<ܮ# The niche improves stack sizes:<ܮ2/ use yoke::cartable_ptr::CartableOptionPointer; use std::rc::Rc;" // The data struct is 6 words: # #[derive(yoke::Yokeable)] # struct MyDataStruct<'a> {+( # _s: (usize, usize, usize, usize), # _p: &'a str,<(% const W: usize = size_of::();1. assert_eq!(W * 6, size_of::());OL // An enum containing the data struct with an `Option` cart is 8 words: enum StaticOrYoke1 {/, Static(&'static MyDataStruct<'static>),>; Yoke(Yoke, Option>>),,2/ assert_eq!(W * 8, size_of::());WT // When using `CartableOptionPointer``, we need only 7 words for the same behavior:ĵ enum StaticOrYoke2 {/MJ Yoke(Yoke, CartableOptionPointer>>),,2/ assert_eq!(W * 7, size_of::());<ܮ B 88uW  8<>GI1QN Obtain the yokeable out of a `Yoke>` if possible.Hٳ$B 88%DA This trait marks cart types that do not change source on cloningMJ This is conceptually similar to [`stable_deref_trait::CloneStableDeref`],OL however [`stable_deref_trait::CloneStableDeref`] is not (and should not) beZW implemented on [`Option`] (since it's not [`Deref`]). [`CloneableCart`] essentially isUR "if there _is_ data to borrow from here, cloning the cart gives you an additional handle to the same data".d This trait is safe to implement on `StableDeref` types which, once `Clone`d, point to the same underlying data and retain ownership. This trait can also be implemented on aggregates of such types like `Option` and `(T: CloneableCart, U: CloneableCart)`. Essentially, all data that could be referenced by a Yokeable (i.e. data that is referenced via a [`StableDeref`]) must retain the same0- pointer and ownership semantics once cloned.l(,-!9-9 4l92242  5zgd Clone requires that the cart type `C` derefs to the same address after it is cloned. This works for Rc, Arc, and &'a T.`] For other cart types, clone `.backing_cart()` and re-use `.attach_to_cart()`; however, doing63 so may lose mutations performed via `.with_mut()`._\ Cloning a `Yoke` is often a cheap operation requiring no heap allocations, in much the samea^ way that cloning an `Rc` is a cheap operation. However, if the `yokeable` contains owned dataA> (e.g., from `.with_mut()`), that data will need to be cloned.  88l8,8pr{}, 88B  88$+  88GIRTWT Allows one to "project" a yoke to perform a transformation on the data, potentiallyZW looking at a subfield, and producing a new yoke. This will move cart, and the providedRO transformation is only allowed to use data known to be borrowed from the cart.ā\Y If producing the new [`Yokeable`] `P` requires access to the cart in addition to the old_\ `Y`, then [`Yoke::map_with_cart`] can be used if the cart satisfies additional constraints.UR The callback takes an additional `PhantomData<&()>` parameter to anchor lifetimesQN (see [#86702](https://github.com/rust-lang/rust/issues/86702)) This parameter+( should just be ignored in the callback.PM This can be used, for example, to transform data from one format to another:΅<օܮ֧,PM fn slice(y: Yoke<&'static str, Rc<[u8]>>) -> Yoke<&'static [u8], Rc<[u8]>> {1. y.map_project(move |yk, _| yk.as_bytes()),<ܮ‡ʇ96 This can also be used to create a yoke for a subfield<ܮ!‰ˆڈ,*' // also safely implements Yokeable<'a>lj string_1: &'a str, string_2: &'a str,,䗊 fn map_project_string_1(*' bar: Yoke, Rc<[u8]>>,'$ ) -> Yoke<&'static str, Rc<[u8]>> {.+ bar.map_project(|bar, _| bar.string_1),ƋЋ,؋52 # unsafe impl<'a> Yokeable<'a> for Bar<'static> {  # type Output = Bar<'a>;1. # fn transform(&'a self) -> &'a Bar<'a> { # self\ # },/, # fn transform_owned(self) -> Bar<'a> {܍<9 # // covariant lifetime cast, can be done safely\,ĎΎ1. # unsafe fn make(from: Bar<'a>) -> Self {-* # unsafe { mem::transmute(from) }\,ƏЏ1. # fn transform_mut(&'a mut self, f: F)| # where85 # F: 'static + FnOnce(&'a mut Self::Output),\א # {0- # unsafe { f(mem::transmute(self)) }\<<ܮ\8B  ˒#8!!!9o$z - 5#ӓ 88hsϒFC This is similar to [`Yoke::map_project`], however it does not moveRO [`Self`] and instead clones the cart (only if the cart is a [`CloneableCart`])a^ This is a bit more efficient than cloning the [`Yoke`] and then calling [`Yoke::map_project`]IF because then it will not clone fields that are going to be discarded.ƚ 8B  l# 8!!!9o$z - 5כ#Ŝ 88$,ٚۛخTQ This is similar to [`Yoke::map_project`], however it can also bubble up an error from the callback.<ܮܡ֧&# # use std::str::{self, Utf8Error};,l fn slice()& y: Yoke<&'static [u8], Rc<[u8]>>,:7 ) -> Result>, Utf8Error> {@= y.try_map_project(move |bytes, _| str::from_utf8(bytes)),<ܮ9ˤ<Ӥܮߤ!‰&,*Ե bytes_1: &'a [u8],Ԧ,䅧*է:A> bar.try_map_project(|bar, _| str::from_utf8(bar.bytes_1)),ڨ,5 թ1\,/<\ȫ,ث1-\ʬ,ڬ1|8\0\<<̮ܮ|߮8̎B  ҄ #8!!!9o$z - 5ӯ#ÜĜŜƜǜȜ_w҄& 88҄-8FILOILׯشJG This is similar to [`Yoke::try_map_project`], however it does not moveRaIB ߷ ̗ lʸ# 8!!!9o$z - 5#؈ÜĜŜƜǜȜ_w̗ҹ& 88̗$,طehknhkսPM This is similar to [`Yoke::map_project`], but it works around older versionsNK of Rust not being able to use `FnOnce` by using an explicit capture input.B? See [#1061](https://github.com/unicode-org/icu4x/issues/1061).Ŀ̿=: See the docs of [`Yoke::map_project`] for how this works.!88!!!9o$z - 5BB   88 m^`Y[WT This is similar to [`Yoke::map_project_cloned`], but it works around older versionsNBDA See the docs of [`Yoke::map_project_cloned`] for how this works.( 8 8!!!9o$z - 5BB, Ï l 88$6TnpdfhjTQ This is similar to [`Yoke::try_map_project`], but it works around older versionsNBA> See the docs of [`Yoke::try_map_project`] for how this works.%88!!!9o$z - 5ÜĜŜƜǜȜ_w҄B̎B Ï   88҄cnbdfhjl[X This is similar to [`Yoke::try_map_project_cloned`], but it works around older versionsNBHE See the docs of [`Yoke::try_map_project_cloned`] for how this works., 8 8!!!9o$z - 5ÜĜŜƜǜȜ_w҄B̎B, Ï  l 88҄$eQ{}qsuwy{a  8\<8MOXZ\Y Allows one to produce a new yoke from both the cart and the old yoke. This will move the_\ cart, and the provided transformation is only allowed to use data known to be borrowed froml the cart.\Y If access to the old [`Yokeable`] `Y` is sufficient to produce the new [`Yokeable`] `P`,XU then [`Yoke::map_project`] should be preferred, as `map_with_cart` places additional constraints on the cart._\ This can be used, for example, to transform data between two formats, one of which containst more data:<ܮ!‰,\Y // Both structs have `first_line`, which won't need to be recomputed in `map_with_cart`.0- // They also safely implement `Yokeable<'a>` struct Foo<'a> {$! first_line: Option<&'a str>,,$# last_line: Option<&'a str>,, fn foo_to_bar()& foo: Yoke, Rc>,&# ) -> Yoke, Rc> {'$ foo.map_with_cart(|foo, cart| { Bar {+( first_line: foo.first_line,41 last_line: cart.lines().next_back(),l }T, fn bar_to_foo()& bar: Yoke, Rc>,&# ) -> Yoke, Rc> {" bar.map_project(|bar, _| { Foo {+( first_line: bar.first_line,lT,,52 # unsafe impl<'a> Yokeable<'a> for Foo<'static> {  # type Output = Foo<'a>;1. # fn transform(&'a self) -> &'a Foo<'a> {\,/, # fn transform_owned(self) -> Foo<'a> {<\,1. # unsafe fn make(from: Foo<'a>) -> Self {-\,1|8\0\<,5 1\,/<\,1-\,1|8\0\<<ܮl8B  #8 #< 88ۃYV This is similar to [`Yoke::map_with_cart`], but it does not move [`Self`] and instead>; clones the cart (only if the cart is a [`CloneableCart`]).KH This is a bit more efficient than cloning the [`Yoke`] and then callingԅ\Y [`Yoke::map_with_cart`] because it will not clone fields that are going to be discarded.\[X then [`Yoke::map_project_cloned`] should be preferred, as `map_with_cart_cloned` places'$ additional constraints on the cart.B ͈ Ј# 8 #ܝlŊ< 88$ڈ1,ƈ؎RO This is similar to [`Yoke::map_with_cart`], but it can also bubble up an errorʏҏ\UR then [`Yoke::try_map_project`] should be preferred, as `try_map_with_cart` places'ͻ<ܮ֧͑&,䷒ // Implements `Yokeable`ؒ+( type P<'a> = (&'a str, Option<&'a u8>);l)Г85 ) -> Result, Rc<[u8]>>, Utf8Error> {0- y.try_map_with_cart(move |bytes, cart| {”74 Ok((str::from_utf8(bytes)?, bytes.first()))T,<ܮ8̎B   •#8 #ÜĜŜƜǜȜ_w҄&<җ 88҄!$'*-0ؠ]Z This is similar to [`Yoke::try_map_with_cart`], but it does not move [`Self`] and insteadܜ>K`] [`Yoke::try_map_with_cart`] because it will not clone fields that are going to be discarded.ܞ[X If access to the old [`Yokeable`] `Y` is sufficient to producethe new [`Yokeable`] `P`,ğ\Y then [`Yoke::try_map_project_cloned`] should be preferred, as `try_map_with_cart_cloned`.+ places additional constraints on the cart.ߠB   ɡl# 8 #ÜĜŜƜǜȜ_w̗&< 88̗$;,@CFILO͡+  8857@BBPM Helper function allowing one to wrap the cart type `C` in an [`EitherCart`].JG This function wraps the cart into the `A` variant. To wrap it into the74 `B` variant, use [`Self::wrap_cart_in_either_b()`].'$ For an example, see [`EitherCart`].8ΚB  88BPJG This function wraps the cart into the `B` variant. To wrap it into the74 `A` variant, use [`Self::wrap_cart_in_either_a()`].'8B  88$\Ȇ Ά5\ٻ ߻5\ω Չ5dD9\!9!̮+&_\ The `Yokeable<'a>` trait is implemented on the `'static` version of any zero-copy type; forHE example, `Cow<'static, T>` implements `Yokeable<'a>` (for all `'a`).| One can use_\ `Yokeable::Output` on this trait to obtain the "lifetime'd" value of the `Cow<'static, T>`,FC e.g. ` as Yokeable<'a>'>::Output` is `Cow<'a, T>`.OL A [`Yokeable`] type is essentially one with a covariant lifetime parameter,RO matched to the parameter in the trait definition. The trait allows one to cast1. the covariant lifetime to and from `'static`.a^ **Most of the time, if you need to implement [`Yokeable`], you should be able to use the safeC@ [`#[derive(Yokeable)]`](yoke_derive::Yokeable) custom derive.**RO While Rust does not yet have GAT syntax, for the purpose of this documentation OL we shall refer to "`Self` with a lifetime `'a`" with the syntax `Self<'a>`. GD Self<'static> is a stand-in for the HKT Self<'_>: lifetime -> type.  qn With this terminology, [`Yokeable`] exposes ways to cast between `Self<'static>` and `Self<'a>` generically. ]Z This is useful for turning covariant lifetimes to _dynamic_ lifetimes, where `'static` is *' used as a way to "erase" the lifetime. d   b_ This trait is safe to implement on types with a _covariant_ lifetime parameter, i.e. one where \Y [`Self::transform()`]'s body can simply be `{ self }`. This will occur when the lifetime da parameter is used within references, but not in the arguments of function pointers or in mutable;8 positions (either in `&mut` or via interior mutability)[X This trait must be implemented on the `'static` version of such a type, e.g. one shouldA> implement `Yokeable<'a>` (for all `'a`) on `Cow<'static, T>`.LI This trait is also safe to implement on types that do not borrow memory.QN There are further constraints on implementation safety on individual methods. # Implementation exampleWT Implementing this trait manually is unsafe. Where possible, you should use the safe_\ [`#[derive(Yokeable)]`](yoke_derive::Yokeable) custom derive instead. We include an exampleOL in case you have your own zero-copy abstractions you wish to make yokeable.\§̛ # use yoke::Yokeable;ܵ # use std::{mem, ptr};Ґ,30 unsafe impl<'a> Yokeable<'a> for Bar<'static> { type Output = Bar<'a>;/, fn transform(&'a self) -> &'a Bar<'a> {:7 // covariant lifetime cast, can be done safely selfL }-* fn transform_owned(self) -> Bar<'a> {:L/, unsafe fn make(from: Bar<'a>) -> Self {A> unsafe { mem::transmute::(from) }L/, fn transform_mut(&'a mut self, f: F)l where63 F: 'static + FnOnce(&'a mut Self::Output),L {NK unsafe { f(mem::transmute::<&mut Self, &mut Self::Output>(self)) }L,<ܮD1<' 3,|SP This type MUST be `Self` with the `'static` replaced with `'a`, i.e. `Self<'a>`4+PM This method must cast `self` between `&'a Self<'static>` and `&'a Self<'a>`.ܤ # Implementation safetyRO If the invariants of [`Yokeable`] are being satisfied, the body of this methodXU should simply be `{ self }`, though it's acceptable to include additional assertions| if desired.L  B $")HE This method must cast `self` between `Self<'static>` and `Self<'a>`. ܚ   R!X|!|"B $"%+"?< This method can be used to cast away `Self<'a>`'s lifetime."d###VS The returned value must be destroyed before the data `from` was borrowing from is.#܁$$$RO A safe implementation of this method must be equivalent to a transmute between%" `Self<'a>` and `Self<'static>`$% $%K%XU This method must cast `self` between `&'a mut Self<'static>` and `&'a mut Self<'a>`,& and pass it to `f`.&&&'_\ A safe implementation of this method must be equivalent to a pointer cast/transmute between'@= `&mut Self<'a>` and `&mut Self<'static>` being passed to `f`(( # Why is this safe?((PM Typically covariant lifetimes become invariant when hidden behind an `&mut`,)LI which is why the implementation of this method cannot just be `f(self)`.)gd The reason behind this is that while _reading_ a covariant lifetime that has been cast to a shorter*XU one is always safe (this is roughly the definition of a covariant lifetime), writing+]Z may not necessarily be safe since you could write a smaller reference to it. For example,,c` the following code is unsound because it manages to stuff a `'a` lifetime into a `Cow<'static>`-- ```rust,compile_fail,E0521ܺ--- struct Foo {. str: String,. cow: Cow<'static, str>,,...&# fn unsound<'a>(foo: &'a mut Foo) {/ let a: &str = &foo.str;/=: foo.cow.transform_mut(|cow| *cow = Cow::Borrowed(a));,/`, it can only mutate it in a way that does1fc not insert additional references. For example, `F` may call `to_owned()` on a `Cow` and mutate it,2^[ but it cannot insert a new _borrowed_ reference because it has nowhere to borrow _from_ --3jg `f` does not contain any borrowed references, and while we give it `Self<'a>` (which contains borrowed42/ data), that borrowed data is known to be valid44ZW Note that the `for<'b>` is also necessary, otherwise the following code would compile:55556,66*67 num: u8,̜7 cow: Cow<'a, u8>,,777/, fn unsound<'a>(bar: &'a mut Bar<'static>) {8HE bar.transform_mut(move |bar| bar.cow = Cow::Borrowed(&bar.num));,8,8859 919\:,::/:<;\;,;;1<30 # let ret = mem::transmute_copy(&from);<  # mem::forget(from);< # ret\<,==1|==8\>>0\><><>ܮ??YV which is unsound because `bar` could be moved later, and we do not want to be able to?! self-insert references to it.@@`] The `for<'b>` enforces this by stopping the author of the closure from matching up the input@IF `&'b Self::Output` lifetime with `'a` and borrowing directly from it.AA`] Thus the only types of mutations allowed are ones that move around already-borrowed data, orB introduce new owned data:B\B§B̒CCCLjC,DDD fn sound(foo: &mut Foo) {DA> foo.cow.transform_mut(move |cow| cow.to_mut().push('a'));,D could be obtained from:FQN - a local variable: the compiler rejects the assignment because 'a certainlyF%" outlives local variables in f.GMJ - a field in its argument: because of the for<'b> bound, the call to `f`GPM must be valid for a particular 'b that is strictly shorter than 'a. Thus,H+( the compiler rejects the assignment.HEB - a reference field in Self<'a>: this does not extend the set ofIEB non-static lifetimes reachable from Self<'a>, so this is fine.JPM - one of f's captures: since F: 'static, the resulting reference must referJ to 'static data.J2/ - a static or `thread_local` variable: ditto.lK 5Bʒ K` from a cart implementing `StableDeref` by zero-copy cloning=: the cart to `Y` and then yokeing that object to the cart.YV The type `Y` must implement [`ZeroFrom`]``. This trait is auto-implemented\Y on many common types and can be custom implemented or derived in order to make it easier to construct a `Yoke`.l Attach to a cart:<ܮKH let yoke = Yoke::, String>::attach_to_zero_copy_cart( "demo".to_owned(),4   # assert_eq!("demo", yoke.get());< ܮ 88B 88c ԟz\`dVZ̎DcI#GEB A type with similar semantics as `Option>` but with a niche.GGJG This type cannot be publicly constructed. To use this in a `Yoke`, seeH/, [`Yoke::convert_cart_into_option_pointer`].HH]Z [`Yoke::convert_cart_into_option_pointer`]: crate::Yoke::convert_cart_into_option_pointerI JJ25mm()+L,LC̮LLLD!g2JgC!2g!! 2 ggg cgFcثq1ȡFBI 2!!ܜRO A cart that can be one type or the other. Enables ergonomic polymorphic carts.TQ `EitherCart` enables yokes originating from different data sources and thereforeUR having different cart types to be merged into the same yoke type, but still being85 able to recover the original cart type if necessary.OL All relevant Cart traits are implemented for `EitherCart`, and carts can be&# safely wrapped in an `EitherCart`.EB Also see [`Yoke::erase_box_cart()`](crate::Yoke::erase_box_cart).t<ܮ! use yoke::either::EitherCart;)& let y1: Yoke<&'static str, Rc> =OL Yoke::attach_to_zero_copy_cart("reference counted hello world".into());^[ let y2: Yoke<&'static str, &str> = Yoke::attach_to_zero_copy_cart("borrowed hello world");  MJ type CombinedYoke<'a> = Yoke<&'static str, EitherCart, &'a str>>;  QN // Both yokes can be combined into a single yoke type despite different carts 63 let y3: CombinedYoke = y1.wrap_cart_in_either_a(); 63 let y4: CombinedYoke = y2.wrap_cart_in_either_b();  ;8 assert_eq!(*y3.get(), "reference counted hello world"); 2/ assert_eq!(*y4.get(), "borrowed hello world");  QN // The resulting yoke is cloneable if both cart types implement CloneableCart  let y5 = y4.clone(); 2/ assert_eq!(*y5.get(), "borrowed hello world");< ܮT  3ᬡoh(a33B33BJLOQms 3333B3 3333B3/   ~3 3 3// 33B  33/1!  ^]33 33 31!  yk3 11 3 3B  331 1e5"  3 3 3e5e5e5e5 35B  33e55#  g3 g3 3g55 3 ggg cgFcثq1ȡFB  3355$5X05$H 5 5B  (x5B C* 5 jCth 5È5BÈÈ8#È $#È5 È ,Dsu$5X05$H 5 5B  (x5B  E* 5 jEth 5È5B8#È $#È5 È !Fpr$5X05$H 5 5B  (x5B G* 5 cGth 5È5B8#È $#È5 È Hpr$5X05$H 5 5B  (x5B H* 5 \Ith 5È5B8#È $#È5 È Jpr$ 5X05$H 5 5B  (x5B J* 5 UKth 5È5B8#È $#È5 È  Lpr$ 5X05$H 5 5B  (x5B L* 5 NMth 5È5B8#È $#È5 È Npr$ 5X05$H 5 5B  (x5B N* 5 GOth 5È5B8#È $#È5 È Opr$ 5X05$H 5 5B  (x5B P* 5 @Qth 5È5B8#È $#È5 È Qpr$ 6X06$H 6 6B  (x6 B R*  6 9Sth 6È5B8#È  $#È 5 È Spr $6 X 0 6!$H! 6 6B!  !!(x!6 B T!* ! 6 2U!th! 6È5B!8!#È  !$#È 5! È !Upr!"$6"X"0"6#$H# 6 6B#  ##(x#6 B V#* # 6 +W#th# 6È5B#8##È  #$#Èӌ 5# È #Wpr#$$6$X$0$6%$H% 6 6B%  %%(x%6 B X%* % 6 $Y%th% 6È5B%8%#È  %$#È 5% È %Ypr%&$6&X&0&6'$H' 6 6B'  ''(x'6“ B Z'* '“ 6 ['th' 6È5B'8'#È “ '$#È 5' È '[pr'($(X(0()$H)  B)  ))(x) B \)* )  ])th) È5B)8)#È  )$#ÈԚ 5) È )]pr)*$*X*0*+$H+  B+  ++(x+ B ^+* +  _+th+ È5B+8+#È  +$#È 5+ È +_pr+,*H, 6 6Bdd 2 ,,(x,6 Bdd 2a,* , 6dd 2c,th, 65Bddʒ,8,#  ,$# 5, 2 ,dsu,1*H1 7 7Bii 77 11(x17 Bii 77f1* 1 7ii 77h1th1 75Bii181#  1$# 51 77 1ivx16*H6 7 7Bpp 2 66(x67 Bpp 2k6* 6 7pp 2l6th6 75Bpp686#  6$#֪ 56 2 6ny{65R5R!R%R$RZ$R,Rg+Rm+Rp*RA)RG)R5R!R$RRR(R!&R#R}!R+RRR5RRR?RR RM RRqR %R%RR (R(RR *R:R ,R R .RRR!NKhttps://docs.rs/zerovecBoxalloc::boxed::Box Cow<'a, str>alloc::borrow::Cow alloc::borrowpstd::sync::Arc std::sync OptionZeroVec  .get() Yoke ѭ Arc   alloc::rc  Yoke::getʮ ծ  Rc  ř alloc::rc::Rc   ʮ ծ alloc::boxedЯ  Rc<[u8]>  Yoke::get()   Я  Ұ  p     ѭ  Ұ p   -std::ptr::read_unalignedstd::ptrSelf::into_rawSelf::drop_raw&Yoke::convert_cart_into_option_pointer-crate::Yoke::convert_cart_into_option_pointer crate::Yoke#    Բ  ij #    Բ  ij #ij Yoke::erase_box_cart()crate::Yoke::erase_box_cartij  ʵ ij  ʵ  .map_project()Yoke::try_map_with_cartSelf::wrap_cart_in_either_b()Yoke::into_backing_cartYoke::with_mut_returnYoke::new_always_owned()_Yoke::attach_to_cart()Yoke::attach_to_cartYoke::try_map_project_clonedĶ  Yoke::try_attach_to_cart_badly Yoke:: wrap_cart_in_option _ٷ Yoke::map_project_cloned Ķ sĸ  ٷ 0https://github.com/unicode-org/icu4x/issues/1061  s Yoke::try_attach_to_cart_badly()ĸ Yoke:: wrap_cart_in_option()P #1061  s"Yoke::attach_to_cart_badly Yoke::new_owned޺ Yoke::try_map_project     ޺ .https://github.com/rust-lang/rust/issues/86702  Yoke::attach_to_cart_badly() Yoke::new_owned() #86702Ӽ  Self::wrap_cart_in_either_aYoke::try_attach_to_cart Yoke::with_mut Yoke::map_with_cartս ʮ Ӽ #   Yokeable::transform_mut  $stable_deref_trait::CloneStableDeref ʮ Yoke::map_project()Ҿ ս #Self::wrap_cart_in_either_a()Yoke::try_attach_to_cart()  ř  #ſ Ҿ  ʮ Yoke::map_project Self::wrap_cart_in_either_b#  Yokeable::transform_mut() Yoke::new_always_owned ſ                     _  Self::transform#[derive(Yokeable)] yoke_derive::YokeablePSelf::transform()              3 P  ####!!!PQPPQ P  ####!!!PQPPQ"P  ####!!!PQPPQ"P  ####!!!PQPPQP  ####!!!PQPPQ CartableOptionPointerinner _cartable BAYokecartyokeable T9gH;n6.\M}JfZ5Zgj#Q'Qtʆ0=ۗ muJA6~`.ueaeD UH$c]&ƁaR=BWPcP[ /cEj\>A s C" EDȓ-ҙbL"=qfv`k4C2a٧O'?$r(=hg2SyJ0f ;懧ybmg x#jV@HX'J|ѓzӤtYon.g2v<>YsĻ b,̭}ldh6D5+M_j\ Ľa͖3I򤼆@Gj{H"c^ G◸Nʴ=גelDcnmFp+Vr4Ʃ@aUq*~a; cr'9'3 ~|$1Q Ku;^䪁 A "ntޅ 'dEMV]TbXߍ8p20+pkQa'2eGu|5&ˢpRP#-xvݫ*c CV ]M9j?ۀäGrdVpY.uˉSKf@ٕ=~oPElfqr:Wsյm m ep׏`$Ɗhy(FOE~:.7=YV##G[n۪7w ~smb,iM י܀сS D3arn8j6n4!̢ӣj!!R TXJF`كKF$P@5oSzdC'93P|V*?VdH2wϸ]+'xy{b!O^+=kI*Q/& <0$YtlJr%6p*xdJ0O dc./Iƍ7^r<2ui } *~Y>5; Ȥy{z_]:;Jks/:EYc^%bGPjg`䏥ϫbV\'f5l_Y*Dtџ0B$[r-K=[γ5a sZ`4! M, ,^&MRm2y8 *TˆFOLY @NE*ƱGvUL>_>^y ڗ%<zxX'b}͏V;ʧJn)n8j_tHQ{aیJIwBh;`e:V}sp2t7bE,bSʚ!B2jÃ+8gq{y 2Y ), X(v"(o΅9E}v{##p\'L WKO3.rN#m`mSI/M}Nٽ {r꽇 $iGcS܇r"xHy[vȌKyJ)IWu i)љᲸ\U?jR!qoа Ybbekwn+jG3kbޑOPB(p6Rd\z\ZI#&hc47*"=g_Rc@٪`d10$SߠS- +<*sEi! $ 4wd19C.",UFޠVvlKkF3=Ul .\8-P涘`<*w]G$t]^<l$: bv4U9'PNo/Gc%@Wݓ(@ݾ].wC?͍C9AmIC3vcתs5t1I2>+}YJIiaO5LR~є;}Ed? %0`pEiʧ[ЯV_4zBz @-))ʯ:/V14NfO9L<|BPaIwO`' +щ/Be1znKUyhg&^䍬^ry:~aߒ7^='@!fxmy-C lK2 Uv)Ǖ- 3FEo-lGY :sw6TLIośR,\k!|6}GM-4=ۮ8Rj\[`ol[i{H n@CtDY9<\AVZE"Rd|r2MΐJO'A'P< ojn/stoy]od) nB+9bukU8hF-`Xjo[܄4'd= }OG9SJeཔx+׊O%_)WI;zGRF-%WT;K.N0+Zk@׊TWWPNfn ..@ 9vV}w dv>qgP63o])m,|P 0( 7*W-AUlNOm Dc7Au1f:d"N]rj+bu=ݛBFĆCe20rcȵĨ{&z#NH*$obHNU=dzlU=T3YiwD8 XsY!#K:Ms{C董ˆk/%upQQwA&2ntl-σٳuIe4pZ?۫Bq!$~u0ޘ) l c6}]bD+.D)J25KG-ctoB$OVX3O t[.t@^+,z@W; v @v&RZ-M /Zb8Ƅ< =uZ65/wW!g65sCk5y*e(qTpf:SzKr&SxX'Gd8<~7H%1%TPAN!cP/R0 .uaGDB*1wQj=?@yBRF4խ172oU8u3GN2]1Rn\帍վ8kЋΒ8@B c4j-)Śsjz>rzXW ,u1򩴄E_t!`;|2Ӯ_pUIKQuZ6acVT?Ǐs3qJDlB.!+ r L7ٵ*B8ޙl埘?A|aC?oΘו,i K%p/dR߾1Q ǻGv;mܲ&!-g%lc ɡ0Rpe|u!vh\Bh }8&CP}ic6rJ4ݺJD q1sr145G4.I'"xi5n`wn?ߡ*P tlk 'o3xoH7q%ܹwvQ>_+y'^C41@=p6JE9=k݋p[rT2O]y.%fZ dA:1 $^p!z"9 39-[U 7޿,6e=3Rrh~=;Qz++0z8L<{U9nMxht@=]7z oO/=ETF[GhI'} SSM7p6^[_RO}EZ4'jN9ϛ-˘uKUOpyn Li a]Vw)&t[6Hhlv^:̖!-;+=W*qG+/c9U챂/$VOa>'Jf~>q)iUr9%W}o+' dҟP7|?'*|+8%* B .q!Ω.n 84/ d}s_hԏr^-,ր)'/; ag&s/.qm  c]A;w&#^ j ? Lm5# sg_^x+yN#)1B1$'^'u'''p((L))/**+++j,,,U---.'/C//0M0&1112Z22~333i4445/6K66 7U7.8889b99:::q;;<<7=S==>]>6???!@j@@AAByBB CC?D[DDEeE>FFF)GrGGHH IIIJJFKaKKLgL?MMM&NnNNOOCPPjQQ%RuRTSSThT!Z""3&9+=2(58HIfi&"6&:+[,,-@.00]11183~4558667_8;EFGWX>Z[\]^_snFf*V&&C(*))*+,.?135G8:<O?ACWFHKWM                   +++                                                                     ))                                      !!5"X"e"%&W'(*+,,D--p../K00<2y33&555g66"7M7788D9<=EFGHdHIhWX.X!YZ[]^bhAj^l5mrt{MJҐʔ?h? |D- =''YwbCgDHk&'<'`'{'''()*+,,n--.,/\//0f011*2s223 444546d66#7n78829{99:;;;<<=l==+>v>??:@@@ABBB&CDDtDD3E~EFFBGGGH$III.JKKzKK6LLMM?NNNOP\PPQQ>RRmSS.TT_eh!!!!! ""N"["""a&&')@+#,\,b,o,,,,,'-o----.G.T.../"0/0000 1^1k11112{2222H3U3b3q33334444555~555555555 6=6J666 771777718i8v88(9.92989<9<=DnEtEEEEFFFFFF'GGGGGGH@HFHIIIIIIJJJJJJJJJK KKWWW X&XAXXXXXYYJZWZdZjZpZ([[[[[[S\\\\\\]]]]](^^^^^^O_____ii!ipk}kkkllnnnnnnnrr`t-{.;H -43:GT[MZa m)k٢̣g6CJW^5BIVjw5DSbip tCGTanu|4;HU\c]jq~,9xh0O\bZEKZs&s7DJ %+>!.&&& 'Z'q''''O(^(m((+):)I)))),****(++++d,,,,O---.../"/=///G0 11 1s1z11 2T22d3q3x3333c444555#6*6E667O78!8(8{8889\99l:y:::::k;;;<<<+=2=M== >W>?)?0????@d@@tAAAAAAsBBCCCC3D:DUDDE_E$F1F8FFFF#GlGG|HHHHHI{IIJJJJ:KAK[KKLaL%M2M9MMMM NhNNvOOOO=PPPQ]QdQQRoR:SGSNSSTbT0U=UDUJUPUVU]UdUkUqUwU}UUUUUUUUUUUUUUUUUUUUUUV VVVV%V,V3V9V@VFVMVSVZV`Vb!!!!!!""T"a""%&?'(*+`,d,,,,,,----I.X../$03000`11182222J3W3f3u3344455"55555555?6O66775777k8z88,969:9@9<=rEvEEEFFFFFFGGGGG HDHLHIIIIIIJJJJJJJKKKdWWWWX*XXXXY YLZYZhZnZuZ[[[[[\\\\]]]]]^^^^^___Jhii)jrkkkFllmnnnnnrrtzf0=4"218<IYO_&O %ۢ8HL\c7GK+ly8GVgn|vEIVcsz 9=JZa$_os.z#UQ`_IO^x+y9Hc#)@#1g&&&'$'^'w'''R(a(p(.)=))))***+++,,,U---.. /'/C//0M011x1112Z22f3v3333i44455(6/6K66 7U78&88889b99n:~::::q;;<<<0=7=S==>]>?.????!@j@@vAAAAByBB CCC8D?D[DDEeE&F6FFFF)GrGG~HHHH IIIJJJ?KFKaKKLgL'M7MMMM&NnNNxOOOOCPPRQbQjQQ%RuR222n333K444C555>6667778C888F999v:::S;;;K<<<F===?>>&?K??@N@@@~AAA[BBBSCCCNDDDGEE.FSFF GVGGHHHHcIII[JJKUKKLILL/MTMMNRNNNOO%PpPPZQQRSRRDSSSCTT:U!"7"f"%&')*,),f,v,,,-O-v--- .K.y..//&0d0001'1b1r11112L3Y3h3z3334444555556A6r6667#7p777888m88DxEEEFFF.GGG~HIIIkWWXX1XIXXXYYNZ[ZZ/[[[(\Z\\\]]]]/^^^$_V___qhiRjtkklmnnnnrKސQՔ(Ku  Lsݢ o:NĬ9MUn{F;JY3 PxKXe?LO/au04|(Z Si7$QcO;3VF%n&&&'G'a'|''''U(d(((1)@)P)))*3***+/+++9,l,,)-y--...-///&0{01(11152~22h333=444+5555666.7780888=999p:::E;;;3<<<====6>> ?8???E@@@xAAAMBBB;CCCEDDD>EE(F@FFFMGGGHHHUIIICJJJLKKK@LL)MAMMMINNNzOOPhPPTQQQKRR>SSS;TT4U"?"' ),Y,,,-[--->.../0t001[1116333|445666666/777#8]889EEFGGGGeIW#X?XXY>M??@S@@VAAA`BBBCCSDDELEFUFFG[GG^HHIhIIIJKZKKLNLMVMM NWNNXOO)PtP/QQRWRSSSGT U!X'(+,E--r../L0035i66N778fHiW"YZ[]^chBjbl9mrt{NK@i@}E.   >(xDEIl&=''()*+,o--.]//0g01+2t22 4445e66$7o7839|99;;;<m==,>w>?;@@@BBB'CuDD4EEFCGGG%III/J{KK7LLM@NNNOP]PPQQ?RRnSS/TT!Y'(+-G--s../M003j66O778jH$YZ\]^fhFjdly>?<@@@BBB)CvDD5EEFDGGG&III1J|KK8LLMANNNOP_PPQQBRRqSS2TT!!"C'(+,0--\../7003S66977~8PH YyZ[]^Nh-jJl!mrtzk96+T+h0 ) c|/}B4(''s()*+,Z---H//0R012_223n445P667Z789g99;v;; <X==>b>?&@o@@B~BBC`DDEjEF.GwGGIIIJfKK"LlLM+NsNNOOHPPoQQ*RzRYSSTmT}Mg}S]gqu *:JZjz""%+n,,-S..00j112T3a3p3444555I677u8EFFGIIIWXXXVZcZ[[\\]]^^__i|kknnn:G,FSY(<BVAUvCRaS`mGTi}8`[YC-&&](l(9)H)))**++.1p35 8x:<(?AC0FHJ1MO\QFS @0AnNptvy}Ą'K.ߛ Π87ekQWg}Sko C \yz.K!!/1O55~BB;CCjDD,EE_FF%GGXHHIIQJJKzKJLLMsMCNN OlO@.A|BLptvy}„%I,ݛ 65ciOUe{Qim A ywx,I#1M557B9CChDD*EE]FF#GGVHHIIOJJKxKHLLMqMANNOjO:PPQcQ3RRR\S,TTTUU%VVVNWXXXGYZ|ZZ@[\t\\4]^g^^'__a*bc2ef(ghjjk^mnq| !%Z'[),/l9U<>@/A}BMptvy}Ä&J-ޛ ͠76djPVf|Rjn B z[xy-J#41N557B:CCiDD+EE^FF$GGWHHIIPJJKyKILLMrMBNNOkO;PPQdQ4RRR]S-TTTVU&VVVOWXXXHYZ}ZZA[\u\\5]^h^^(__a+bc3ef)ghjjk_mn~6YU''S W "'),!-h--../{013667*88{IY[E\^A_ibklmrYt'{! $fe]z(_,%&r)@Sk(6(*"+W,G---.//?002N22U3[444566G78 9V99]:c;;;<=>O> ?@^@@eAkBBBCDEWEFGfGGmHsIIJJKLYLMNbNNgOO7PPAQQRhR+SS T[T!U5D""%+=a!R"_"%*',t,t- ./0%1p1162234 55667688DE,G HIbWGXY-[X\]-^T_n&qm ¬!ga1>e&'u''(N)1*-+j,.&1~35.8:<6?AC>FHJ?M5W|&5Wo& !(7ERVpz  $+2FTX_fjqx| '+/37;?X_lpw~7;BIRY]dmt} $).38=BGLX`hp  (08=EMU]ejrz & . N V ^ c k s {    4 < D L T o t |   = B J R Z b w |    5 B J R Z b y  ( 0 8 h p x !)19AINV^f{ @HPX`hpu})@Laiqv~  %*/49AIQYy~ "*/7;CKSW_gks{ #+3;CGOW_gow#+3;CKSW_gow#+3;CKS[cgow'/3;CKS[cksw$+3;BIPV\bipw~ ")07>ELSZaho5W&&9&X&Y&;+,,,-C.D.E.00:3?3:6;6677`8DEFGX@Z[]^____nnnnnnnJKע,,-./0123Z[ %*/E()*+,,,,,...//I1N1S1X1]1333335566 6Q8V8[8`8e8:::::== ===Y?^?c?h?m?AAAAA DDDDDaFfFkFpFuFHHHHHKKKK$KaMfMkMpMuMIENESEXEFFFFGGGGF9<=568:>?@@BJJLNNN  <DFFHPPRTVVXZ\\^`bbdfhhjlnnprttvxzz|~|VXZ([ab !cs#c!cD#dd"Z&<+[,,-F.00]111D3~45<6 77e8]EFGXEZ[\]^_nLآf14\4J(*))*+, /b136j8:=r?A"DzFH)KzM )E,"/>2 D !%=(C+I .<1 B-5 H$'A*G28-0@ F#7;&?RR  a\T90QF RT9䬈>@YXv< b\T9IGu * a\T9,͜gv$crate::assert_nec]]panic_internalsT9:|\>Q b\T9G s$crate::assert62T]]core_intrinsicsgeneric_assert_internalsT9j  a\T9䬀~  yb\T91&Aj!RT9s峪 ld  /a\T9G IRT93|F *b\T9p߻6=^ ( a\T9,&iv b\T901B   a\T9#3= b\T9iRT9)2'i  za\T9z䡀u5  c\T9H`j8XRT9䬩'R3 $ a\T98/xRT9n4 b\T9Hi3Nذ3-T]CT9䬟=&~ ei_derive_eq_internalsT9䬥(  b\T9䬶Ceذ97T]T9䬬67E.@  a\T9䬚EO  ܡc\T9䬷*. RT9ihYT%IT9ۏ " 3a\T9X07 ֘RT9 sfR 0b\T9q pS[L O_T9YPհ b\T92gc   a\T9R歐N ܣc\T9:Æ>RT97ͤ8RR T9䬫XW   a\T9QU RT9;uf-  b\T97e, }Vderive_clone_copy_internalsT9䬢T|Z+ A b\T9ږj)% }>z+4AUf˞Ŝf֗i؟ )ʘ:NR :ҙ¢U+_l!@ښzN~LՠB*™YȟE١*O\p0$1EVʚj>n<VƗ՝N>_m.jқhODHT s@Wfn .J+׊O%AϩVǛZ`4!i'0$R"lǕ- 'r; v Y̓}l,TˆbGPj@3B(p0 .lv^I&hc42v<)5; Ȥʄ4!̢lc HcK%p/d)@&xf\'LP 0( 7QD)Jx+8g-Pon.g(s/:Ehk/ e1Nk,1 Ŵ14Nfw6TLI!707BY9,l$: G9SJ?ZqA sht@=8@CtD+JDlBO/=ETF[:BRF4խUH$c TXJFo ԼLpt*GM-&M0PaIwO`'$P@5qC'93P|Vt6Rd\9nMx7bv4U9EZ4@8Rj\[(V]TbI7p6^>`X:"c6Gc%eaeD s_hԏr_mLm$W 6nkG[nd!qon\GrdVpU>YsĻ*qr:[.t@^+}p*xd}>^y ڗ_4zBw)&tGg`):LZ'jÃI2wC+X0=ۗ m?oΘ Ku;Cor-)Śsm`m- +<*ݓ(@ݾ=uZ6-M /ӣjmfv`4QtʆEdJO'0@v&RZa٧t2WxS!s5t1q{y 2yn LiDBh -g"ځ.A'P1GuNi } *"pm.:̖!-JR߾1u!vhi#t+%<k/%upiH=[*|w0]bD+.v]../ISI/M}/V|r2Mΐ/xi5n`7ٵ*m2y8 *\897MI`/I;zCh~=;Qz8LFz @-)c7Au1U8@B AF= w]G$tuJA = Jjƍ'jN9AOm DTKQuZI'} SSM=AUlNSNU=aҵUaq9%W}UfZ5ZD[zZj\ 0Ჸ\U]^<z_Z Ľa͖31 /cEj*?VdHu]od4u i),\k!#m m ]172oU8u>qN*qGMXsY!#fntl-l.q!Ω['xy{bw~sf^䪁 D uk+ rq!pYc^%?xa_pUI( 39-[䏥ϫmb,iMgޑOPt!`.IWLWsյ\Uv)pEiDtџbC董hxvݫ*Q|$1QB5a s'9'@$VOa>PqTpE_:.a܊(}ðO]y.sE_BIҲnɼpJE9=&yehɡ0va-q%fϛ-˘B WKOq.(љ*ѽch)iS@ٕ=X_Y*ǐ_!g`.u =kIyQ{aی>qR^]-%ʦ}sp?͍.}YJ +щ/ ) n5g x"_)WBw:LeL}0C9AmIk݋pCDotޅ FσٳumbL"=q!!R nY.uVvQ>_ 꽇 $i*Q/&z[6HhH3PUA "nEEMHG3kb|BݛBFZ6~ wn+j]&ƁakQL#jV@#NٽX3O t[|8&CPq*~>ו,^-,ր)`.n 8\q1srI2>+Ie4pn145G4arn8jjT9V ]M9j?S; ;`e:VGd8<~7B8ޙlj=?@y+Zk@׊G<\AV-!B2͒>BEDȓ(FOE~`ZE"Rd.aGDBdA:LBeYtlJr%6|vȌKy3GN2]!O^+xqVpS&[rT2kU88><{U6TWWPHSxX'7=YVbZ#0B$[r-Œ6.\M@aU= b,+l c6}ue20r\y*e((=hg2Syhg&^hF-9lk*$obH`-ctoz+9bu7v"(oJIwBh˨ 9vVL懧ybm!xmy-CGj{H5 {rȵĨ{&z^p!z"9'J|%.٫wD8 e䍬^rI#~oYr4Ʃ<S܇rhH@)ibSʚ|91SzdsB66Ηa<2uc4jYid`كKFpY ), @NҜߡ*P X(GRF-DC<f  C" f:Scnm:|aC? %0`Jn)d10$gP63oOA:WVg^TPAVT;mܲ&!y:~U챂/O'Jf~Q.@KW v>Z ?bgFOLYLR~2t7K.N0F;JkЋΒ1;zRr"N]rjWѓz&΅9E0ޘ) s LzKr&帍վ8k :s ?jR~uw+*Iz)D 19C."3 ~AU 7޿,n8j'd==`x"dp-?VKnRc4c~Fj3;H%1%Q'y[^ G76acx#|k} Ybaߒ7^7PElfZa; cr?c CR M, ,Ul .SߠS< ojn2 aE4/]='@\}J'f5l nvs&MRD5+M_/xGN!}v{##pB$OV{*k !K',$;441@a'2eM lK2 ;|2ӮCk5׽]:f:dV <0${6e=3'/_IiaO5Gcd-}ic6 d}^$Ɗhy_v_^jGu‹۳kmt`ol[i)Xߍ8p2JUrT/stoy3uC3vc5/wW!yOyY,@Azg%?'*|+8X }O>~ur4=ۮ'3.rN#*1wQ@7R+%"y{VOeཔx@r##c埘?A+y cVʢz\Z=g_gH;nO'?$ӤtY'}͏V;ʧ|6$ $ 4є;}3g65sgj#NI\/* _T8m۪7w e++0yJ0vUQ ǻGv t&G%B'ośR"?Ǐs3qʯ:jo;ˉSKfW[_RO}?ʧ[ЯV7[Bjep׏`^bu=YFEo-Z?۫Bo3ۗg('PNo/0zwqoh6.beko+' dVS D3i[܄4<Ƅ< E*ƱG|5&ˢOcP/RҙP0WXJ0O dc~=%+/c9NĆC[wb3i!c]%lc l Mg~Vpfnp5 8/e|n2PpnD3sH"dBb3$Wwj%ruv"!-V1m:@X+FVXx-1dY9+x?h8]tK!-\$7~cai$j:sV0DAy!k6LA96_zcE4>ix,#KK{]>/ V-r;mS;WG> jL@zi,=tD;vG8+x7@{= 50oC2-Sy4U3`p}H6O4:8;[cLvH0v0=z:|cz"-&'8E--KH}[5{ h^:z^T1nv}zz$]-UrGq]sltOWaYSu8Iah|i]T L' t14OcQmF@e8V zP<[&I$8":8H/44V7{1U#?n0n ^-(Ke9\iV~+H6l9xXfM^Y0p5L#i(F6!0l73~d*?p -3, w5IZ=95 "E59)" ?5Y?T_5pX-k{f1/ 39tC0q|%6S/{`8+`2BWkY24 ya[FE$8;C1g XZ y`>Xa:jcwx},^c:}b(`WhCCQ-/l,S`i>{Ka'*aEVv;u!e8v3>+!OAr xzU2ZI)L,1p@!{f1l Mg~VpP/root/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/yoke-0.8.3/src/lib.rsE/root/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/yoke-0.8.3P/root/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/yoke-0.8.3/src/lib.rs Lnz"\BEyyEE/?J@,4; 5<9-J@ / J(]Ya_> O>R=Q'+,DE7.NF1 9FF) 3dG9 3 2I6R ( 7'$$0 -6T4C 7\4R 7 Y!\I)B`)5 ZVM)8!+ ENP[V 1).2/3O=PE6($ha7`bBE05'/^F*% ']!!*$!!$:$!!'$.\_WadZV0U  U6 > & / !/,3  :%6 4A 62 6=5 87 !)!*N/Ya=' KWfNL !0!*,/Ya='% Y + .?E > &+ / !/?F  :%6 4A 62 6=5 I !)!5O/Ya=' OWfN^ !0!5-/Ya='% USGB4)!* !: /Ya=' \SGIB0!* !5/Ya='% YSGF';)!5 !: /Ya=' `SGM'I0!5 !6/Ya='% 9#ada]!d & a5) )( .+,09 .+'0  :%6 4A 62 6=5 :%6 4A 62 6=5 89 !)&*': /Ya=' ^CPaa`,N !0&*'2/Ya='% WaZ, + !0.=5< K !)&5': /Ya=' bCPe`a3` !0&5'3/Ya='% C<ILPJM3I06(FDNTD7-57 :Q<R=ILPJM3J16)HDPTF7.77 L%&^Z_`_Y=^>S#Y]C%"&#aca]M ZS)i3h7"+a@;6!2 0= 24! 29 1 ,Z *+"-OJ*+"-QJ %-'.OQ"-'.QT"_aD ".;"a_b"2VZg&# "2?#C$NH0& c\$7*'G+'O*'*C44 A&( /#"#//&&5(dڡ1ؙU/root/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/yoke-0.8.3/src/yokeable.rsE/root/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/yoke-0.8.3U/root/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/yoke-0.8.3/src/yokeable.rs Ozĕo hhEf3Q[fl)1. *G.US^43Z=16(ZA12F zJ\, jmH6 -L$JO,7X/root/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/yoke-0.8.3/src/macro_impls.rsE/root/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/yoke-0.8.3X/root/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/yoke-0.8.3/src/macro_impls.rs Y!uOnhyE"X.ZSE `%ioV/root/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/yoke-0.8.3/src/zero_from.rsE/root/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/yoke-0.8.3V/root/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/yoke-0.8.3/src/zero_from.rs Xղmt-*!'/ ,E