From a1f31ea018ff78223faad5cd6dd5b03d816f2d60 Mon Sep 17 00:00:00 2001 From: marclave Date: Fri, 17 Nov 2023 22:56:14 -0800 Subject: [PATCH] feat: add scalar integration --- README.md | 20 +++- docs/en/docs/features.md | 7 +- docs/en/docs/how-to/custom-docs-ui-assets.md | 5 + .../docs/img/index/index-07-scalar-simple.png | Bin 0 -> 172822 bytes docs/en/docs/img/index/index-08-scalar-02.png | 0 docs/en/docs/reference/openapi/docs.md | 4 +- docs_src/custom_docs_ui/tutorial001.py | 10 +- docs_src/custom_docs_ui/tutorial002.py | 11 ++- fastapi/applications.py | 37 ++++++++ fastapi/openapi/docs.py | 89 ++++++++++++++++++ tests/test_application.py | 5 + .../test_custom_docs_ui/test_tutorial001.py | 4 + .../test_custom_docs_ui/test_tutorial002.py | 5 + 13 files changed, 191 insertions(+), 6 deletions(-) create mode 100644 docs/en/docs/img/index/index-07-scalar-simple.png create mode 100644 docs/en/docs/img/index/index-08-scalar-02.png diff --git a/README.md b/README.md index 67275d29d..279a5fd71 100644 --- a/README.md +++ b/README.md @@ -262,12 +262,20 @@ You will see the automatic interactive API documentation (provided by http://127.0.0.1:8000/redoc. +There are two alternatives to Swagger UI: Redocly & Scalar. + +Go to http://127.0.0.1:8000/redoc. You will see the alternative automatic documentation (provided by ReDoc): ![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png) +And now, go to http://127.0.0.1:8000/scalar. + +You will see the alternative automatic documentation (provided by Scalar): + +![Scalar](https://fastapi.tiangolo.com/img/index/index-07-scalar-simple.png) + ## Example upgrade Now modify the file `main.py` to receive a body from a `PUT` request. @@ -324,12 +332,20 @@ Now go to http://127.0.0.1:8000/redoc. +There are two alternatives to Swagger UI: Redocly & Scalar. + +Go to http://127.0.0.1:8000/redoc. * The alternative documentation will also reflect the new query parameter and body: ![ReDoc](https://fastapi.tiangolo.com/img/index/index-06-redoc-02.png) +And now, go to http://127.0.0.1:8000/scalar. + +* The alternative documentation will also reflect the new query parameter and body: + +![ReDoc](https://fastapi.tiangolo.com/img/index/index-08-scalar-02.png) + ### Recap In summary, you declare **once** the types of parameters, body, etc. as function parameters. diff --git a/docs/en/docs/features.md b/docs/en/docs/features.md index 6f0e74b3d..f8f93e081 100644 --- a/docs/en/docs/features.md +++ b/docs/en/docs/features.md @@ -24,10 +24,15 @@ Interactive API documentation and exploration web user interfaces. As the framew ![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-03-swagger-02.png) -* Alternative API documentation with ReDoc. +* Alternative API documentation with Redocly or Scalar +* ReDoc. ![ReDoc](https://fastapi.tiangolo.com/img/index/index-06-redoc-02.png) +* Scalar. + +![Scalar](https://fastapi.tiangolo.com/img/index/index-08-scalar-02.png) + ### Just Modern Python It's all based on standard **Python 3.6 type** declarations (thanks to Pydantic). No new syntax to learn. Just standard modern Python. diff --git a/docs/en/docs/how-to/custom-docs-ui-assets.md b/docs/en/docs/how-to/custom-docs-ui-assets.md index 9726be2c7..ca92b9ca0 100644 --- a/docs/en/docs/how-to/custom-docs-ui-assets.md +++ b/docs/en/docs/how-to/custom-docs-ui-assets.md @@ -103,6 +103,10 @@ And **ReDoc** uses the file: * `redoc.standalone.js` +And **Scalar** uses the file: + +* `scalar.standalone.js` + After that, your file structure could look like: ``` @@ -112,6 +116,7 @@ After that, your file structure could look like: │   ├── main.py └── static ├── redoc.standalone.js + ├── scalar.standalone.js ├── swagger-ui-bundle.js └── swagger-ui.css ``` diff --git a/docs/en/docs/img/index/index-07-scalar-simple.png b/docs/en/docs/img/index/index-07-scalar-simple.png new file mode 100644 index 0000000000000000000000000000000000000000..69463b408cf9bdb49b3aaf576007b542a7cb7587 GIT binary patch literal 172822 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

a^)zAp8hD_8=bI4^o_JIFx41QyjXH-dg4#( zw(*zlke)0CF(rAg7flP-6wDN^9f~fu$yy3myFC+hUEE#Dp>=dS`SSHrHaj>C(U~A< z*nWD@BK`CQC#Tgwa~A^aVp!tprIT%A0ME=k72NiwW)hQejlEm)`i*Yut_d21pDg!U z2@}0wOxR!TV_~+|kr+`IfulLlT6egbA*apP2c|3eQ^M6!Qg2I74z0FZW#tK-KOB7r z(^XktoCR<{NR}-i`JQ5Eb(oE4Ej}|AbXQtiEDpQ*HFoVCeyprQG1PmEGN_zpXImfrHZhczF3f$CmfNhar4ZNX|`*g@1R=aH<3`T}g z^4UwXD#Mzxw(@ks`4Woxs<!!Ds>SV4*&b0qr$75lXSBYfHEskj zBl_To4&c13CA>5uy=y5YNARqF=oCDPGazj_5Xht|s-0lU$gFI{6R);Y~ z8f;9Do@su>vnWj1ab{}@Ou}kVXWf)tvt7G%plcW2YZFG<=d{8St_3VeoLcOH6kj0D zriLcNPzExEKu6^+cMz7LbYJmZrFM_^U`L5-l$()Q?|EO zDJgN6M%Zq$lDo>WyUc_5xq8P{G^AVZFSG>$rE_G;&_!xRo4m`y0T3EP!Z<)Ouiwdj zpEN4Mw@~+ND~PA3$F=K>I?F%OF8`woQ%ijE^QyMfOq^; zdRmCkt&W%iNODOOT`W_C5kR_pu%)DKb*u#5_wHzUf{K75zjf(bh@4iDkwQe9iBpty zyHpH9x5PCSSbm|8$_oXi@~X){)DYb@@fJN@L6>tf@p4<0wC^Z|KD<4UWnK9gAUD(- zJ7_&su1e_*Qzmzs?afuXV1mUK?qR1!1P=Qp-}{${I9_XnmM??wDMg z2sDTV*E%YQ$uJ4RAdFd2J2+B4C&v}>lR|4grw0iJ22a>pUNUpA7#8W=Uzehf&jtZn zW21v6hNGjdAj_5jWxAKj9Sd=?oZ5kM^jvucC5rA?@yu&NW8|I`N9hj6su&ri?86{2 zG4X0e=7>+}Ulq()rdT@cWO#c z8mK|{q0}si!CbSqiUF-vi_Ad4`?oSCk+@NhYYh<9EzM0GT)-@-HjKkU@%{?;EqKY` zdnaShUyb>hF=apkXyF&;<{9omi7Xrx_eBxY#8@)Uo*)w>rM!YwI&c^swTYwE-Y)y# z^VhL}VJdfXD2wP5ObGwCbynCVQv?8=6G9$WIidv8n@?V*OYUY{19Q?0cAII*^0}0K z>;GddeUn;-1RU@?i4Gi;_chFi#^A3lV4azL@N`3zL)hsa~KDE)B9$sLTq@53DMdDM1M)yW{eyK&p zz;-ockp*KcAN@b$Q!vA9i|Zn4b)DKEAjj6WsK+=(3P~a^UE?mrIiDjLYrIdE4o|nL z&I4AGSQ#0C#Gi`6Uvj;ODJhq?mg(Is4ZY42O2^8L0~^V=>$md};KPoIS4-!KNtY{3 zS)wzyM}_q_nMC#BJl}(%3Y4ms*kSfLVxu!Hn20K_COuns2hYO(z3}oxaRb*2PugH9 zf!y;kit=|DEL|5=>#SnxCj-*4j7tk?%@*U3ku~4~c(G~~YQ?;P3hR8%;f=zSymM=LE;fQ)I( zTbih>_k>;@t*udt{r#Mt=bo}(0U~coRWT7 zlMH=$OiWb!GaOK9{Uy60ed8E~ubM%%lBI#R3=E_UFBu*|cdXmYdC`NrTNK6h0HDj=_wZ;9D`KbB>jkE^+sIa%zxa-E{YZ9bq{DJ^zdNCt$qG$_-$;!q` zJRYr;{Ofnci?Qc1(ZLaINs`77!ezE}wbx)iSR01a|0V=~f*$o&k9I$-X3j)lGyFYM z#pzLXRv2sN*b})uz3QIu=XazYP@T+QA{^Hg`?x%|hH?Uvl6oL?Otc2{B{b-OJzlfz z?Ywb>gIce44y|6xAnif?DemF|mWjW4DZjmTy0}X16IPwck-h>&)EzAKrzGe%pQDi*s5Z1;>O7ox)K8u3@cw z#S|SUH#357`_?3@8=fAd7drTLqt^UUz*<(G9yO2dhw>~n&dH{PGXMZ95YkG^k?tUX z!vBOz8(yg;p{V7)ITNm2^f>NJI$n`*oXq-LC$Q+Q&k~%M$q>`gPnP`3@n+N*i=pbL zPb;gdt7~f7J~dkE7A}%;o~(lX^ufu`pFfL>i%UznN~&sA zzE#aV0Okyx@LDZz&BdUbLlY8I1O3+at7m`ygh2XB_nm{AfPs{JcmGRH3G^XtN*HKD z81Ac>2^Vnb|Fp9(USXBfXKq5i6tn9EHeNnEXgRAV9-1g5>k0bZpyRzaw8FCx{Z2tr zayeqO^4Nz(ufjI9%YcVX?`Kofal3sjB6g1X(5d1{9&fU4Oj#a?dMbja8BcU^Rke#B2sMlz^s0i|<9AxVI2vFpd%z(n z0WLpF6VOLm^rfU5dZRXX78o`XBV_+;{Va*m%T_`Fek3*v#Azj2Aei?VfW(Ma6v7^k)r9LD#gCQR(k)+mvt~n>+z&G(=YhtJdrn^7sE( z?G{|OHE!VpUf&MHr%*w63=5#h!!wCLK^Sq?a9b;N`Td0wLNNGk8ew*G!6 zp?pn++TAg;i;PCPXw}NfO8Gdh_oIc+2}I7`%6E#_to%3k>qqvNRrLMMivAkOCk(dB zg?n^d^f&-?p(FI+=u2c1;Z&JZrlN}D@GpO?X>d;hl_wvPFf`f11>rbE#*q274Si12 z7KK1*HP9Lo6JoscTvn)}7O`(h0`UTSw_ zgRVd?Pn(zxsi;6d7!>1$$e)?@B59BNdU})?PxrTu*K!Z->QGzr^YfqG`3YmlI6fq! zMw`D;TJQ>Fl=IvF>1~T-01YJbeky-}X0{^H;BYUzpk83Fd17yOcQ9s!`RL@NcISji z)?9u+hFL!`E{1rh==c9c)?0?f5iQZ8cyM=j3GVI$cY?bU+;xE9?he7--7R=tiYWj9=<4d)^8Y(ozC1B8X*V+~b3UH`e@$j)ME)VUh$rY{L3LyZaKBu8 zyk3@SKRPye8cC!YUp(*q==c#Qq{{m3Jo87A@awdHlmZgRSRQg)0A>#0#S4!4YY;1b z%;(3lFbvWKa~3GOyYH>-QBaz;BHg!L81VdfE=`%yQc;-|HuTb0y`yZQ*Q7*<*JrmI z3qskTmoWpWmr1;VIow-SauT;}JBWB}%5aLsAcW=hbsR4YiRkuvd5ejTuKemk_)|dY zNTtGuCYt1RV>>s|NJCk92Za0eJU@PMTjoVjqc%Lex}u&$CgKB3`^J^Iu>ZYS{R^tu zW!{tNG#3epe4g@OQ)X6PkO*?0*0)pc=Nx*o-g}vak!-g%*4NKlbR7VHyW^&K(eeK) zd>euKL?(2CKrQ@w)c<%rw3f1pLKZ~$Nn<1ypKKXsrx5xpqBAeiw$uHhwHnDn>*#>y-af6L$7`(*Xs z`+FE4zj{eIITd)vUOYgG>)UL@sj@}u$E(dxklqw81_o4UaG_&(eFinotxi?e8`P%Z z6*g$8-W`Ew;APZ1-BfDSD#*&V2)!1`?DID{Fmv|43n?vm=ko6BXus0kSk3hs`mc9r zPnx%%mFD>Qo$h&|e@XD1{0aVkG?iUT>^x<>!E(12ACF4qBp=&xKD91!aWXr&Dx4z& zp0rwvuAUH)G$m;&Ykk%i6!!V6R~eApDF2Iv>1&1Qcq-QX*F%?gxA`wfgrxMf{x7RI zvN5-vx~@3w%ZVXHi`M41M-_`UTy|R}!%syqeMX)avysZ>db1!HZ3P6*z&(yusBio6 z`#fa2$X4Jf`)kZNAuQg+Vx>ZmW?op!pEj^s#uaPaA}>SjJ?)8zZ*sP<^C`& zC#{BBu}jri(Wc!mqv`m+P_myOiP}CZNOItfs(hR+11m|+WBvUb-WZX`mV+R*k`hWp zgmg@0R1`i@QrkrId96z3sKi%JKJ3lrs5u@kCPkzegag7w4}c6aqhk0$g1Mq6SmDMP z%IbO&U!%`g873{EG^X2Xr&(Ycc(;cz9Zk$BW~Z!@u7xJybAMAxnM14V`*NT7>}?I1 z;Xo_gVA274AfK1%G{cka+S)Zqcyt($V*Of8sW(2y>Fd0Lm`^0Y*mxJDmo|J|7A}(1 z8Qc3i7BCR1f3tU|L@!DXD&x2Pw>O#J_tiN8B};}z#uMo(vMA?Ec6G=x<(nUG;|}vB z3iepUOe(}T&mUpAW@%79$#OjI7j0dXyV+hDAeqg994dlz;B#9Of^6m8g60@`^yShHod3_4D-Ec?`BL6A*s2@xv z<0^bz<=3va8Z{$gp`o+Anrx@cJ?^5IdlGXiIx{)%FgVK7{PAvYrx+d`=2h{!zK^lF za~U5Vj%$9rXY`IjnB@=?qi3X;ab%gU{+HqqMD0a>vX6nBh9yKyIjp?h#&X%nUo%;c zA1K291UU0VH{*n_`ipoeeVh=Dj+O7OAQ5oU`}o|SlyIGc`fM_sYl*GfUr)Kt zR2nq?V#Em-1P>p`HFu3VEnf-F8Pv`Tz5w6ZX5|GnRFiUiuINDP>um8rSllljuLcFP zgLx&vnids=<3%mDWueb|NYG&r1S9j6iOJyBkaCGav?GJPR=ralf!#u{GI;o+M@iXE zLtNCCEbsIlU#po=QmlVAJsr||y5T6-D~J80~a%-PQ5o8QPds0b&vv)xM?vz3T-d@Q|UCnLnJZUZYXk5 zmS7aMi8s45>{ZynTXC3LTtQwwad=MT>QCo2>{`Z&B@xqEyJc?jO!`6IVXmTh66vfQ zv(ULghPH)ZbizPbWYK~&DmxXG+vzFk{!ehZOR4ttlhq6YA~rQu*D>q$`uBr}VM>`Y-yu2gW*6}Jy^MZofS*gP z=5MiG?eL!T&idAjLdeI!UP{?1vBV4i0}W7hYkcwpizumhn@WQG^xK^7^i?Uj6~RYt zcjM2vy|c9^9f8%hP8!rcvbIi4+GO$}9UWS`^6~ZCr5|#-WdOG##(T!AAweEEO3HvX zbdT1}_ng&EJT3wLncVH-*|s}oa}?VVfwPbZaGyiUzHj5jXfbWZ9CC2&CsFt5~G{o!oq)&5l#3nG}E=xj!~ zbH^p@kDf<5EhY~0kIXpZZ{INgsCDf0!B_csOufi!D&Zsy#s924dN}`jjt=!nEacqZ z^{jL^hYPP)H9vJhbWs7uO`gN7r z9PV1X>nS{9ZT!zC&Y};tz(2tm>z&uW;VWjSHtE2Tj-GRRouCuoz+an{b=2LODZ`!M z{uZP{V-IgPY?-bvgpzG%jkUuH>3l{r($c0#l~xDxIUG5MZ!hbTTZ4$P&Hxs-wkobS z#AguG;C{6h1#30)6Vzz;Dz2q6rVb=IC}!nA@S^AAgMou}e0;1(s$>Pb=>H4MD8=D= zvsq!TL>Ol#B1-v208z$i8-MtdOHM02i<2RU4j6~DL(yd)G&X`ttzYH1PTlM`kZU=e zV@d7i^LR1hHl*X??qmV?2=9dFHzK_c=&MdNCl($aHCq{8c#dhFGvcXaWzq%wp7aoU9qiBVj$j6xAmsFRWmis3ExAF;5u1Hc_y4sLqju-ZdQR) z?D_x9k$+B@JTmYGA`C5Uo!^^q-1@LTF0PIOJ%2`6v8CtC`YC`<$fd8Ep%o7r% z$f6%F*hAmA*~7-n49w0}P*7lmaRJUGL`KR^@tBJU%OOO8Xscvn+W^cPkDZCdPEC|2 z_y9}s#5X8TbTRI*=v55uk}?g8rlihR9PNyh2c)W{dDfncJP*3Awbd3QE0PdpEANlY zt;yh9Vtx3|SNv<9ukoW=LuX{&U#oaK(K!y$i3>rq@A-ZW5qtxM!eCDL3kpTmV)(9j zryI(`^1Qg0r(a(g)H$P2=RFm*3+Y||&^X3$+&74+l$i>nM=J}9$W0Rem&=D`jUD`} z#l|nTmJsjn>H8~-mHAz;AtrS%5-Xm10pSt$mNxqb7d$@-WbPa$wN8cu&cQ5GMJ8FNb6MDJGPuQy`EoI?_BaS^| zaB9=>aWf>{c?~9vfVaruC7o^n)%R|A8dEyW_}?D!`T3$herT^#y9qMrb!(>wv66=W zF3u6QxQFHPlR(;EF643FJ8+p6j4=`PafNh`iSy7PqJj2jsP=Q~6U8k7oar}x1wm@Q z=Ne5J?HMV>RGGfsHxSaPB!ITBPkP-L)ms*BoR+Q;)hcKh+bI{cpF<<=rz!uAu>TIX z8!2GrrVtxdV#cE3=1>E}G2FGW3ONEj9<@2~WxuksU+$0Wp;uwLE#97HcX!cHdo7l{ zY!`_RKEf<#Dw%tK`k+9qo}MjJvCQ~CoHe&q?~S*0@Oj)kgybb5kV^{U%O@to(LY$!e@5*EKD#(!ASYB7bfH(Mxhcd93))d#2`B4n zd-0C#Q=4sdX}553?Q)Z66JGk?GRpF} zofXyS1H@`W2EJXTq^0@4ZYqJA*#Z300=*Y__pnE(Bxu!yT3^4?SK3(H*jTgR%0qeN zObc{_38`~CNSa3Qi9Gd^_yu%>#lN^+>Zq${B>xIDiAnr^EiI_e;l<;?PMbO^-$FtM z05sh%V4V&DtB!Ly^dD?alZ_=i50WtnL@#65`I zO0IlVB-!N;l~$$C?GP|Uk_DzWQQ@2E5FGtU7ixVhEu1ZT;6RpFeMWSy3wb4@HjOP242xgoIrVqDIjgHngG>FL{$RQxP zRpr&?w4=h;!R+G1^-6ZyNT)DAE(B5`MeNe%2m;L)Fq%1=wUPq9^@Xt;SzGVJ^Ppt- zAN6quGH1TM@#p^fqok;4uE{yqRsfvcY>_cG0x(O1RlP9fhMv>Q9UtRF>o z_HFOx4^audZtG=N0bl_IYho<26JtQ3Kb@5V)#DkMu)jjY>6{)j35(Pg&Hx#O`-i*D zKO7_gc-b()6~8gisj5pz0Ka0Pr>|r(g!6hx!678PKwbL6ouLJf)PhSJBrOgb>H2nX zs@rO>;A=}hL5pfLy1L3r!H#fb3I`WKoO7iWuUKevvG;g;Y`8?>#K`dWTs+;@#zXcS zBUNR+^^*jfjFy=j1sh6v#Bq9~R7vUHM}ilpr#ze>VJn9i#Nt#%_rom9F)PK@_Ix0> zkfnbhjOT{zH2b~hDx^pO%n2i7BX~XI+4~d6v6Kh%Vnyo%gKt3Pn*{|&vVI8 z($P|(QW{5J*MW_WiIjp_gz{FGL832>L(lCgz(5bVePiIj|2|#ndItsU>GXcU|8T$9 zi1JjQ32_pJ2%^YRUAx*pJq;ke@8TN0;~jhEqAMEh)3p9nWhxw`J9|xgKv=oOn3K+ z^`1(xZNJiHQmL;h5O%9&<|-lwm+1w6*qGT!R_tpk*cItuXvf>8^T8x-&Da>nr1q1g z<|Y=<<@V8P6~aT&8F-qYC|^0L;$K!?g9x!(YM+5nGmDEtcQW;-pt3i{qx`Lk3 zx1k{rrpO|%;V(H?SFUl0iH!xKQoqW{-Szl-@5c!HzL*-;KG)1*H#DldFV)mAAt7kd zyQv?Do7#CM|G#NEI~1{-8zMSl&dUDMSl<>CGdD?&FUy}mecUJw$dIV|fo#$1tzXsf z{Tm|55vt=Pf;wtM^tENbv)@4aE+Yvrf4qggfqS4Oge*o8>qSErpM-v2l4CTK$CJyk zMD#5&44hWyZxl3) zgvBwIBQSqq4{q**0ZA}ylBb~TK<}ZFImK9HT*eP&uvSTKhatq1?bh;sfY8LA7QTma zPmh80Ks=IxO`%i;A~tIB7mR~(3UI5o^I=AAhE1csFK$Zj!#OFgu1#Uh(3CJ2{cFhJ zb!ekmL}R0qrgK{Cl-e>e%WTckZ_b2Cvu zzuwEP<`EA~3+2xu_eQ~}b1?$2sqj%fy@u|Nj*k9p)!is<86~AeMn#SI)RoR*Pb>{* z)<)94Dv#75u(Or~vO=<&OE(-l@%Am_enilMVFhu^-U1y>=WrL|nR{PgI=I9%@}o=B z!b16mw=X+8I(DMji{Ys1Mc2*YKAP1-oSYgWae@4wUbzlMz8JtfGo}dz&h^-VpZWv< zotrN-H%$5fV^0JZ&9X>rZ0x!#Gtu`f!qD3RD5;xvsCxM3kuK=8_0o+4eXr-lho4~!KdCkx9@1ml)W$DmT2 zEiAaqNucBP-=z7NcNhdp_uqWMj=qKYr) zuLzMiz9F9iCv2MK(LSQEGJvVl5ctFumd{;@tGdnJQNBc*`@dNY@E_B%N(yC)Mp3W; z)!EUKNmFR#_>e%T&p!QGKS6q;@BriEL;rXpC*p|>ErHt@w$W-<-~%;Rx%cLXJ>h37 zaxavY=L(X5iWD^zU73aQh!Gv+jm=BbsD9^50W?&aO6~aE+e%$jlUU8|iNtu9=!iNK z5)l6$CO9@RSK} z92y}kN#EPJC80Cvb7#H`SSJ^GdjQt*%8Di=#@yT6;X*>#L5X8}s#aFkaOv$({7gl~ z6yOnVcb;uMWjkXldh9h*rU10Bwphmw?41=JqH6_Ei{%6$H|cRK`2C_9~$xr z$>5mLr8M=+cCXA0igVsMtB?G{F4>Gw&LNl(lN&=yo?jW!JX^-wd94t;a?M%YStE1C zD)Y9`d{4cua%%%Pf3V8Uc6u7Kp}B)`wugstw$G_BeW6(@@-5mK`IQ-3l1o?Qhjf#?5o=|@H>8~c|OV&e0GaCi$T~FiH z8J({+qxnLyHaZrzxg6)%Ece&-vBhv$ZLx?(%QiJ{w;ymh>g zSMe;6Z`|~8qSLQ(;(OvEJl1n^bax5tAj7ndMOWD-2kT?mWITJa)sk;Gvv7)2j+j(hX z1cdu4{L;`P_B`*SG<)wLF*XS*Y_s3>*3%RR%Tg%8>7-|D&!Z;ACg%56p-bZBFK3W4 zG9O+x8J94^A;+vG8W52ga72VAy$5oy({KBp-<-zvrQu!s!hY%MB;2;GgcmF*>?95hd|^@_PO%(%d+UIpt0{Q*X{GQsEp%H?jfgvO=zR@X9D06vIKC!3-X#zC zv70=K;kW(d5_h%fh?!eS;``R#;W+Hk3V3!2=NWbXf`q8U;*TtM=MeVFLFa01Ii3%; z*xPCw#@RGXQoG8D8Tj1SDo4)qBw%wqgp;b6$%9NVH)TSR#9yiZjRgC-W#+bJqSFDU4%ju&F` z`5~@Wsu*enbw_JTM>B6_%M$gwdguO!8Y(^>ddl#ug}c){L@A{y#t(Z%Vw2~6>btqa zO4{7yY)%ZTh>7`9mD-PNOt8U;MI<1xRmC;v-Bq+?44!7eZrK!5c zMtVBNkO%k)15%ax)cVTO%0}~Z#RvDi$-ZH55Bu&st^WT0$+&*zrbAyz#O12oD&oH~*hhfuRFW}3 zgf9hX^>VQ^jt@@>HF_J*H4G%>iI?74bv-zV2=(Rs)?h4ifO{>dGGlmJ6tu2Wuf=*W zWe3P8|NeJ1L-JUxvf~vK>5MLMe6q5lSZXRImN=f|cYD-W6{Gbc2vxY;uUPRZn97M6 z&#P8}04dP>x}92ogAoqhCOnBtutaD@6X^H64R3R^E}N!8Qjp?C-FRHH1ROxa1`}rq z{D7c`IppTJSCpq63=>1XnC)=CY;by4(iE>TUX|5*l$SVqHHl#E{eW>0tili2d3Wgg zVDopK-g;L%V^DjV(7^gIdB~jfuL(0`PgUP+wIpyA)G9NURt}goGBKGWGfx-pxp_^t zT4bpcgB2iQO+1_y?)02h3)g=-)Z8{H3x|PiNA(NL`q1#<#J z$R>G<38$^1irhS%Cmu*FWO?(tjQKS3SZ~P=$30nYMp$?@^#4G1une}jf4o^rbTpJ1 zrK3CNdYj^&`wlU6`VUaNLP_X1XQN|Z7aB$A9tLEf=`vG~Jj|y5PF}~lh1zA)SO1YI z!SI3bTCj!wFZ-n=y|o~h!jJ2)+yH3`l1@}>xk$OZ^4(JeV!t{mQ>%J70XISl zk^alSxfI?7hfr=;Zj#1Rg&-4AD;&9=%OC&&kFsyT{n|E4Aojq+-BzcAF`Ya>A=hCL51@AnM-XT}x{w?|a=Us(5l zzNLUvRMf1sEw88TM0ldo=z@kD^L8B}F$T)qgd99Hv?0xaYIsCdqj{)a#Be<-Dk|?6 z@3wtDr!z!*+xXv`JXQ4#jn0l~2#~BByZdQ^Z#?OA*fw9>=Gob9&Pn*t;D1NKV{vj& z4DyKcR|y~@q3>bHjgJ}Oz|hE=mSgtF&0L`7kc272)Pj&ri@}Q`qo%-q*j`ojVi~Y2 zBhNEp41zdGmRj+!IJQ>=L^?9o)rAG9NH9R2Vvg#j&*0#&`ttXvK@(}sDoO%XYQza= zXI8`sG!b$N2Mu*ivI8$~Z)$)sK2ve23h}vOAe@6|VB4wfL92<06NR0%iJp#zA8rr_k#?!JoDK;n*`vqs_3X0NAg_P4#Y!YjRahxRni3~!{7nGi%OmYy6u`xIWKDTDt zn$D`f@Kdl1jOWPbLvMAJz}D+XZ1zvi_#nY!^H6y!_ulswa0F-p)}%)HK7OKcww8RB z8e^@dhs$*WQJ7so7?=!8ze#Eqs7f{Px@2Uq`ja_ijb&d`Bb_Vkj~1q7p;n6u{gmS3 zuisin-o2F97v8O=SqY6Ko&wj zvKUqx*@q6ij0_S0aJ1*$gGrch=*#u~d?|SV{bfw+)(|w}h&&*$KJp0&I6Yh@i@&*S z0)Uh+LZicABdQN^=7Sfe8ny{4+`Dmzl@ourd=RV|I#!yVuO*qk0#=dm7f5Iz%%$(@emSrn@K0}_4PNN-v=Uh$1!j56!~A`UE20yRRbih?EPYMXI3FkMeLa(J+V=M(ec=30VFmG0 zsnOJ+Y%}b8HBq&_O2p~W`x*^%Yl{i{p%dilDddTWL7yG3#ymSGYrrG;G+h;0RObeS zdAu_ckFtox)J`yrEvofmwGk@W#Gos%|nsCx&)E-nou} z0luu#6yTLkDoRmFTN{kPj>#I%!{6dWofICC>%UKMcHlUDTUo2x1Q<`k9ChF;fNAfKj)|U_b4c`Rmh-=}s{+IK3c+>1N0FA|!IZDhdQ4!@`UZ z_CW}|3!H|gH3!Q=2*ObV7q{)g_Ytk0gaxaObQO@xEe~2s3KksPC}=VUHkGm_K5hMalBUW;jv6{@tz?mP>JSx$D=!v&d|`yT-h$JWBX!h(Y!l|mr4MRH1RjHza))Vb zffe_1OP}a2fDb!ZM`SjdZ}=tfYv`h8T{MiMAflLz(e5$)5Ij1d zgYutTX8^JiSe&zswNaXyPM}o3wXiS$+izVCk$M>lWOv4j=RAZ2zQ??2kQJ}OS`CnOQMd|xX<2JG|S zkzD_qBs+EE9&DwNwS+1XW_Pc!zZCUPw;J?)pqv`K?l7x?qIm^gig-6hz!7Xb-x47a zpX9%@`8-pQs@r|2FgcbL8z1^#_b*@uRVV8y>%1qg*NFiZ|F|?FA>Y3T_+P{SUnhW*&y2!>P8n5VQHc9rWaqz9 zraU~*sBl7tA*22CS^twp{r3-7XV58bw;1yC6#snr|9$K~|6~;kV!$SU=ZpXEZRClg zqDGy1_=NGGalroTQBIPfD6^e4IOzWO$!2C@K^#b?1jBHdnX|UB@$6(4>nL6M8)=Bx z?){G>O7v<_8l$eMdG{QP{3zJ*1)o69#@gDx)Kag@wYZ~0Qd7zj1S|pYC?g}I{*v%i z<*+;Tr(ab48rKwmo=~9()zDDSM(Q!Lx94)dhfOt9S5L`G^MCjD1VN$B_)B}0YJvX| zO;}Qa-o2$@BM0+;-(f)PHxcp#N@{864530MIqed1EkVgV9z&J+S{?DSbFRn^st>5R!d zD!x(dtPR$@UdXb96^1>8s^7m?RaTzwU-DW^gl~4Dd{@`xt}32oxct|21VcLkKuHsw z1CEpb^{J8mdsJpb;gXY+EzB&89qS-mJUp5knsydhJv7rUE`CKu!h`5?1ER*}<^VfQ zX)D}{-~E+EZG)quXlvM62BOBs-jWtsrI|@tX<1oeXWFZ)aZ0%+c6J$w-kp=xD&PL| zDo~igiyMT%{^JD@X$S=7@ZB+M70!_^}D)&8K6nkQ_%;_BoB0n(*1@ zoDonn^+a3&z)`0GjL0Fl?cVbS@9v%3m@uO@4hixZ+<+Q=Uje~QD)jo;*r}B9eC19p zI!hX!ZBM^&&HYV#Sz-K4C5`+U#QDw{#6_*{C5yJ*n89vQDc3}*=Fe%lLHzmm)uKW zi3BW*1shBd+Xb5&VpxAa1v$CH+L{hOFVFqy{QTC|)j@fq?HgVBkFE!8QDYSwn#Ja* zxGIg3!b&x5ZMTyd6(}MbJB05!|A{BZq(D#_`KkZhlDb4xi6#;F^cGbM0w8#7Pj>!l z_${!s{V242kI0xOD+3`XhB3tI(}2^V;?&gCKPt2bT4g5-r#tcSHfPWrb5E;9g_T)V zZ<9q%WxGuHaj~(2u1{J6;&y+WT-@mB7>6jvEY4c2Jtv#y(U9Abe&Iho!RwcMWqnc8 z{)N-xYbWNoKdfwL-;$(>3HNQQ#*tcOu#|S}>x$XX784r+hH*6_oR>jDUX|E^nOb47 zx{X71(60rCZ(bpPQhi89*_|bjmmq9hL}g0^N_(_3B*>jx)YEa{lI9QFLllfLwbL=z zbuud>44c6X=Bo6XV1CG>olL58aPNj<=EC;r%cdXF^+tJb>Y$zU5LtZ+>G`|FB z75&b?l_f-9)%xzm;{@k`Bl?YM8FsyilAQZX$bxcuYKV3j8#ILdSh+SthWyDDZG1S^ ztW4zB#h6HCT{&0}-hAmiEBSJpIG7M>)%>iWygccgUsEU%O0W+P!F8wNMFbNyO~0ls z;p(HZ`!^)wQ>n(s_BWl|K>NBJAs~S4cS5}zC~KVRld8MAR1*woon3UW+{G%+4HRX<*PtK>JlAqkzOliU$29Hr*b1N~5o96>Fl zvAV86mN;p!2C9a_TwhxZU$Oi5fK0kBsnX~{*ob7oMw@zl^fWw2h~~u= z?KI=>PVs|N23oqLVsm4l7^EPqf8Z^=m%OteJ1e71L~Yi8rc*FwtmEMXDESt;WDK8Su_~h)OK~CyW zZ=niKuoK>&j7yrW2m4rfwQ?4I!*^NGK2E6<-+e`rsUc7Z0_Nt}u%$?D`iq8D9hgzd zOkcdcxww`*gOq-;=x~zd&rD2Ul8qXzQzebp2b=5Y@O_|?+V1=&_4O45xED}Xb)zR` z0vuK8lTJ@hD=-4HwKCRpKY$4ssLLHM-hWS4kpf;8InvbJTn}*5 zN*@yq8Z`zXuu>c0*7+Qvqync55L;(9gI-P#iZ9(Ikgkvi4?o)J&2)-sl* z;GbZoi9OV9IV;=XSQ3@M0>9>brjLHUL)!(4)*u796sHr9x4l*j@OK!IBV(`1xW1 zc-sEWD!9aILiVVkF%TfTEbc$d3;vgKMdsiJ&*M4CcqgaH$tmesTG?>3@4NoEyvJ;h zH*)s9cH`-6s#R3wbMt8G%Uad%;zfjUGxMywo5f5BTPiq2TFaMnMw6x#4LP`_YTD}b z==eY5GA+UktflTJwOQ1I`B~e=N~r4Bx|Ez*(jSA4y_-7W!+8@UR z-(>JQM1sp3jxCSx5m;zzY3G-dhKtjyK}@CEPjS5xC8-AK4$S+ zx|I`ue($}xy>E`NZ|hc2rS008U}o9AY+rjdBkMH6{++2GJxR{G-Y;ylh@K7MfnDAm zvp!ey!=`mps+kPxdxq>7osd63ua~E7dUoqPnNa8Yp5N@XMGyrleILf?zurGEOoyI) zKDEl?Yve@f{fg>Ogs1QgIzVh>UZy{*oQBU}c#j#H8|d@aMXAK+NTIIwUj0~CATKjz zdh}uzRyY4qp{cBDVPQ*%WqH5qAP;A^DDPE~ObUU*2@XXRl%y=GSmuGwaMNgr4~ zSmbDR6g{$`ub&tDaIres-w)XS5NE^t8xIqu<7}V8h`>L*n%CZuo{7ue$W|5cgMqUH zYtnbJ+@ZC=)ECh0^9U>8bX(;uR2=c|8byHbpRx%{{9XbRll=vy_QJxTIM6n#ABY$j z`?~|7zumiaTfq=q*x%B3QW(_KFa+8L?pn{6&qIVnF&A?LI}1%Dy{WOcEQFmF2*M@- zRn8GtWo5c`@hFHuOFJE1-G}paT}>r!(0&)UDX1ZOvz3+}xQi5XgH7d0O1W@T`c%&CT^Yo;o_)FV_9zW5`%$Na#uWoDF=XhgE-U`*nkCCx7m3 zv`2wVCQV0T2cha)xXDdG&Xg!2jEsygkEc{AvY=<5&h3rFI>KCXd0zCYk*^?nTO)Me?(%5pBwBM)n3jw71y6R{?);8)YIp;s= zh99pYj{l|}IeJHG71(XtS&gZuSd|sq?66z(cmXv&l zP&L#x%E}ySstCk#K^iE0@Lwk@t5LZ}`s3qXvKTRbTac)u_9G#vIUysWOp%Bl1&AKD z*eO%?__yK7jz2WN^GEN%>P#@Rp@*kU%!NDl3)Z^s;RL=V(wAw-Qk6XS{+)FtC68`= zGG+{&{fpft#qA_6lqv4LEgj0ZESmrdNXc2nVJX??=cK%VG)D2G5SZY6)Lj zlSNL8t5`acUNis8l9R5nXb!tAvvmh{ETGb2*&cG%?{A7H_d5DBM>#4ymrywMZGloro9(#^&|KqhkB`Tir6Q8l;S^tmNQ{DoWsi0b5 zNV~em(G)WPVw}_kVZKVq09}xG3#b`ue5bn#?3pPIUbctNzMK>GqT6pwvlDugNr<<$ zx5@Z8jcj0rd}wvKm3>xAk^|`LZ)+pes?w|NZ*XH{G5O3r1(9g&4_(D-)Q`F&Y>ED? z%Us2nKNdc6zRK*Xlen(toO@PV5Tqaa$jLB;;RC#u0>yC8G^TPB-}?y(^mM#JHmLp% zRi5RfoKe(*wEI`#q$6>D=n{kdEETq^N!kt!E&4Zj{;IdsNQdq&2n?Hq^TK*H?CyD6 zIT&Y*q)4NnZ7!jy`|`cp7;J2?23|`TvWMEo#73>Lna_@5iOibMG{OHsd6xFP+7_oZ zPV(DeYI|82F#RB5;3l3Ccg=h)8qy#X@lMk`TA&iFCS6svKBy!Z8>;cRp%>NeY`WQ(IzBkq#rx_vNljHcJUG}`_(t#Q_LfJ) zQXZ3{l7F$0Ra_Gh9t}m%=R(DmX=cTlOl#B z!Yz_9ghGCL*}Y(~Zqbt-8)9!_i@0)wTO{)XigZx7YBo7Rgz>I^hBDZev3(8^$B$MA zb>dd=NVh|@vxwjW>6EM!>Oiork|ncc))oK0jQWgQ{IJ1hw)foDinnW~(5zn_s(c;7 z^lEmtlw-`HkHPx8#g0)!*P{61I_LN5$6gK*HIikS=CTK`9=EJoX7Y^XFCtn|& zdG{GwQld#1Vq_981cohW_#B51B;`+o$#~$Wm-_96G=x7Ue;wtaYWqGC(9AR$u}4P+ zafAj&9=Hy)VZN7nN}F!jOUCX_dS-NEEr<5lf7JCX^ zvL0R10>tu~-(fY0YBFQ&ZVBq$5k3csSP8k?a5c>HzAUc|k5wGPg?!tG(Y@k_`+?Z* zsL1i;g~0P2`EnA6ZPf!E<2aVO2tQO}sh_^3PlKwbPku+p=cW(G z2GXXq<+OC%uP+`0cgqAFCU`kLs-O%xBqZrgn$C@VpHZ1P;D2Gx_MM)VN8oJxgJjX&66%%!wH8d^EMG1;R|AJ6w zBH-dL)4}#suD1kNc!gXZ-~Q3rGWB;cenu{hCk+GY@oeuL0}X8vIb{wrsA!2Jv(5A zmL8AO=LoyMnGMEBJ1C(@yM?9X4;m%9FAuA{fBL;4dFZi#`&=&Kym!19bP^+H0sQ@Y zo7PWRl!6dj?OyF4$avS*@$m5NH|pS2^lSCtzTs`e417moHLRzdOQ6`G@crYG#qAIi z9xcYl%Aw$)E|Ve_0Ty8ob^(ycPeds01Vw z8ZTeQ#qd!&jFS$L>xFX%57Gwr_lf&;QhCM;_(q9ur`!!ztPVBT;E5TI7{bxoWg0{( z1;C35HqZ$zXvmyih*O-v-57@wD-|>L2HGAqC6rvn>KM;@FFSl);IBaF4vvJ?fF5D} zwm?MprNm6N8P*E0?}1)7c6zCKbVl0BRjUqzi6Ki_7oI@1$<>__e{*CqFwT8X#vUT! zTwj^FX2zBfXA{v{i8wodQ4Md$sL*@`z&xkl+|yEr8lF>ndj<~R8tZOLxN_D7q*hT*xQ+=G$NV&eCiUr ze*$i-@(Q!6=9@J0MdYsw>t@QK?hbgsrn*$h?r+Ta;N-MOV+-UWlEwTAYZ>+CiNUhb z5h3#YJpWd7OP_#dZLB@_-9$BtTI-?@e{%MHXAFw-KRi=}a_zfCxRfR8oqRx=|BtS3 z46m#0x^2wHwi}~yV>h`3M@M09N-RRwEc2t(A@Ccq}yLuK!wYklWxgwexSXNUM+ zFG7z{xSh82LwGUop4mY!sK|$EjgmwK4QD`qyC#eToOYMJMGH>FQX;gme_fpN7pAnL zM}!`rre&=k#cw&$_%&1*x0hTO+3(}TW2=_*CXmI<-1yj+;3c$4MCBleK&G5s>Ttpza&0&VdD5L;cmpoj43n%HoqBNb00Q`rNFtjVx!FN-A;oyU zv}H?ud0ewJ_&l;wF(uVKjWszf=}UsWKV~jlettf%O5k+SWz!IkGS1l9UAwYCsZ&$K z%Kq8u>tppf%7%YMy$%LvNeWM@O#j^JTmLH$i~xQDpf{LVG8P55Bo5}T(3x=q)uY&? z-C`&p_ci&*b2R`5-4DbYNOQtmUBW&}xmwriEYT>{0f;@hB*uC>dgKYx{ZyMfNIt-@ zDJ?CdkirVD#>ArDV+IciT2B|P5p}TW@Ay&vtVql7^SJ66%!V`aVGOiA!r&J;Elb-CR9h z7FdV2#>C|h?LwsRJCdFL<7H!2(lA~1Y-$SC?|e@JK0l(vGPQ3^WQ#Svf*~Ypc*vGU zmA*kOw)?vzD!FoC_hL}7&R!is1a)Sv*!eZn!}E>p6{>&nDaPELJ)a>G3^iNy5rZo$ zeV!#>4@&^6#x^xk@#bsKE2Wq^14u#88!PVP(9P7ZS zrJ!tnHd;f^wpbw=!$9sL}7@;}lp zWeZfZrwsR@cD+5Q`1ws+5~qrfx*5-|iIX^I5ztRFH!#?}+(c))b;?tDi#7sT@V@ow z?A*Y*U1A~)M#O!cPrWQX-Q)n+B7iW9{NaRdt2Yn)_KfjFa_Ka57maYf<31#A&5DLh zL~};w^)sf$kAZ`Wi*Fte5yffKKJU+bot|RfmCz55aWqXMz_-X&+*LL@7_8KmEfDq? zMY;wEZyOD8f>@oWvqcfkHxNOUqu8KBdN*Z~zAfWmVBBtxpl?r$Zm$_Q*L8x3SJ63M z>@qYLyImW&Nr-3Q;;;*bHrIy-zg429QfsUqNs2yVF3xF`tBqSO1QrfDiN${`j*=Bs zVr|RPR%UWB8B7Q#&8nt|nRMu@VP}W8-O^-j)|h%|jmtpk*XKnlRR}ixs+gcsR-$UK zY%ug-DNgu>c+1ov3IQvo`Cca(mr-O_kCLa5YHen;uh#=!Q$a3_t?X12Qdbnv3>luE ziqlew;1eb6oJfbX%>oS)-Pg{{^7wEzUOzc#V{%NRqyiF(Da zitpovh;14YSyPGi+0~Phfsk<-@qZaOQ9Ba|3RlVjXCl~~1^CR0>(PYy(a&ELJwa&7WN>0K8 z*Jw|CbgPA0O@!=?WxJ_CuHY8<#<6t``gZC#!CKq8>ris0mN4d|6S6=4J4xLQMs6#% z0C3({4sHHVe`!L$UclU{+lFlU?9k!$MhQ8?SSyUKH!F}k*)exA4Stz##%#TB?LJ@ zFB$_!W0D7!eA{BVN_R6PB(2Tmav_M8j)Ae0IX02m*2Bia0uHM(INP^AHioZapZ2lhezT{3R{I)tn~J_3a`)qharo9t zZ7Q`DScw``ArF8qCYNif+UuvHDlF&YSXJ--e%!`_v2^%-Y9_mLGfK^jdf$_jf-`ms z8VNHlEg^b9}j}1sJ-DZ70Y&ZLeu=!#C7^ zpHrhjjvN<&c@TZWZ92VB!#L_A*Qf(BJ_Rr(5VN8JZHD(~9j_9bUMj^ye^}X;@!;3Y zr3zef^{K!Ge^lLC(aQf^ZdGh)S1{DM1XaW@EoJIJiRH2)+sw06%OcT~>~nDWphQ|p zhI4yN5Gu;}|$T<%^?g$T7a!z}A6NnD^TdHD7cXpV}b5WKhKRR8~GE zE9_xFk)*Fq4EqClW1i7&vIrzv!S+|h4$bqwQ$000`^HzGI|KB81 zsPDd(Lo1+!dc!Yw7cH;Pb*TBj$m_mNb5Mj#`kFFG$S?fXR&$6cr;(-X+B!HM9DuW*Aq`qfq>jUpie-6 zp|`Q&lq>YMtv5=^=CxwzYL}Xvx(94}q9UXt^ehgJx8>E9=R4ATj##DLWDK}J-Y>=j zaMRtRA)xLn-v~4@Y95Qq(~=3MZMm3+TanOZ41m*f`xQ*=`s@0@>t+wW-prmR$8-mYPS-_5 zT-}J!$Ih;#r?IcvHg+EqhMJmLSKIgL=w{~T#2du@x@1Rk&E0K3@5N*?WAABqGZ!@} zkhhX#iG8r(s*eWdij5z>_S=2np&mO%WwM`7lRNBx_3Bqiq8SYUjnt2GjE8dpO&a)kOL!jCe;#6h z-BsAjoJe?3QOSBA6*aH^a2%ApE$woXY|Cz5nNuUQS`fEV%(g^0=DGZ!mTrnA83p?unn{q`$~Syz{gkqs^1kg{DX+o{y0!hwm_ zVwweywb%ZaIS%S5mi3zU!}iS@gU&o`M=0o2f~5<-P&1(X5m^|HDKmCCJ>c{_bW_f) zXBvMWDyhye!E|yCwb~cP`~Ct`qF=yc;NXgD)l?%DTVa$ER3hRE&qs6KJhuj+Xq44K z+m1}5fUs&lCeWBpj>8BS`rF4ObWZ|YOHA^QOIzwM@-9|xB(vnEkw3$ zJ^h1S-J3P@>Fiw*UCM{HO7)3RIvj}b4866A#k*lJtWK(?xxw+(oM!uU%61A(3Bzwz zk>SQx8m+`QJ)DgA>-SrCVtGOQ^Aq}uZz(P1-#Y$He)%U4!4FE3-_qRTPP!Nxq8 zeNzjvl9ZIx!9HDQMsF_3u+Y+g24L6|YRhLB3>cL#f34dx>4Qifa&Yy#dJ3H_DKX<* z<{St221#n#?Y{XF8wIgXhLL4v`-;eA8NU#il^GoUh?%L;zC+nMFB|)M~xM$$jY(NQAW&ij*_b2 zN(1Nf<>;ddN>o%_Rc%E&lyKxUK4K;q?+oJuV~C)jklAQo3z+NBhOa3vS25Vw*vcvz zQJn~coS9ik(amO0lCqQEWyD!onR<9|X@_O95Eihy!8R*sM`PzzRvlp!2t$R%Ch32~ zC|)xC#8|`apQ&pTibj5_L&WP1Q+I!uve=3a71HBcDAeJ}-I(jhuTh|und+#YianJ; znI$uS91KgHk z%fP%3V zOQjeUk%Fk1Phs+<={z8*@xtSN2+za-vJ`q1>OknW(02Is}Dd66E?Okx9Y z5@R(#%chr+piAtR2+@;LF1e^UZGWLGzrC9`-iSBD<_oS{5@f#+t87Fs@chCijjcEeV&TP{i7OP0>nD8EZ&U?Qg)&8jUj7`n0p>$aI+* z%5QI$g0f$NiI#w+XQf!p%Bq5vsCLdx&FOe(AlxCaP(D!su1DM?T#}ou=KiJ<8P(Wa zuZ5Qt_H;cHvLsRBH$2S$C=s~*&^P)EH#!_7Xuyt2RPB?17}P+&MA0-CovIRcW-BbK zw6zgEWmWa-AHwTv$#RCuq!XNr{5f?rdugKsi8v1HmF4GF)6cxg5+f4!tTRO9c{mpM zA%PS{RYz|%s{7Duv^w>qq2j=eX7<>&)r`b_>j+&{*5RH9YYiWlc6`VZj54R89~fZh zs~t9`xJs>GbN{Z?bS1c-pR;mUg?-MebN+*FYWgduql(FxfL=!BPgFg7^4t|USyM|& z37IC1F3Eld!BTEa`+hlQcJ!jP#wV{T=*2GkKEwNJ*ou`^v2;}>4x?s3NQ;F0b9`?? zIW8V`-1aD&GFrlxg1{?px+$$iH;&neR7)Ie5PjfToXnr)VbiJ8K9TOFel)&7f=Z@Y z(|<-!*#Su1dc)T~yc`)BuXN$|hdUcK78Yy;UBd?k;;HI~_NCAFnE`OYe-iwlp z6V6;;u5-wse6yqFSJ^m?dAiCyp9{>wT;9mUDQa+nU>$S!gj^ks8WU(KY)u}B=z8@D zcaKT*Ws5X(D%Wkn58&q;TOIH}Pc~FR$*UO9jQ4N^8!UTNuEzenc*vfd@vZyUS}`ba zmCH`#nmJFtVp1EfYUZR0ZxIu3?VW{XVN?dYjS5sPV`%PC9WhEuY{Cy`e zLVk@21kSKN`1X!0#qQu+)rGK?x(sdTT+m;tbTs7UOG3hYs%Nn9YNYc}g9`S~3+(DW z0#5oV*K?qY#irU$yWw{f$e<@(HXAieH2uOmmM8L79+$b#JI8%-DE@`0{(~Fqx(6L& zvQO$VYSxR03<5Mwhz!Q(f7P23sDtjQKM!ZRr*a?z%gojW3~*=%vt<&7@c9fZtKi=& z_Wp6Qf38J;Jsp84z>(#NFo_(L`d^Ql;svL?Q2S$>ukv3}6>wEZ$d~A|HM5<6zD9oV zZ-7ex{wesE*uwwoGJpHwlqjen*Mg|6QsjSgdl^BEjP?Wn!)C>W#=^p?&%sbObNTD| zi|-`@!0rC+Jb(MgFZeGOFXDJfuHS#Jwtqe0zkgEC1)?ytf=|Wz{Xbv*n*{vt=D3zbMXaqy>=wjdc8-fJ}h%SEI5Ng+WUEuh*Ko0Q!`LOa2_u zU$5-n%4dH+OGvknkndbg@PX1a|Nnlil?>p~&!gi1yT|_5DP2tg#`VKgIyDaE|9UO{ zHq@AUkMN9a0c~ykfAS-_dbCVo>AnyxEYv)F{#x^hWMQ3_`>WVGH+R90!O zEJFRae&dHA*gZDe(c1criZg*w*4JmT{4Bk^+>$pKB_qK%F)?3t(t5FSv$(vSq06`p z;-#R-#Q1Q}S;hAsl;v+Aeq!4Ae=bLx8UUAfRCNV~muE~}L;`NxrKz6Fir3=C#zek3 zsh$5Y4#(s5f_2>ON&utv8Q7rq>gsJ(+374jG{E$#$?~`lP%x{gl<}Wo2Qb>b-`vg{&po2>c$RIQ0j!LTiD|jh zp=vPac$NYa9Rr`sPJ^_|%LP!o_S206fU})6d{%Q)PfvY8eUz-(mB6;NvHBs3%J-K) z7%J^P%skCLX`P(}d=Y?HAtpNdZCeH{F-EBIc&hVuZ-PpR!R}DhH_xYLtx8ke$OA5X zX7{J@v}u5mI?jS%XSF;t;OVE`_9#@g??NT;*T8wggyudu!9qGbI2h<3EU9yLbiBI0 zmfFnH)7R(rT#ETsG~s-T@k7trndaM1)mkZOX-EY4nfdt+Z|#Ee8jSLCT0oR8Dh&HL z1-SL{k`j3vY%@>np}|2?WOS#og@td7-B}H0R#x*>Ha6Nk>-qV6W2%B^_9B4m5};TW z5dmK$o#FW+Wvip}u8k{J2PnmL@@@bMDuCb}0}ajT%m5~z^usyd@K0o{BO40~2Y^G{ z7{1sO0LkwQtPdg#06bn&TwGsYf3#YZq(nXbdz9Pf-5#)hrCBReb&*AUY=8BqQ5F25 z>2h+n{Q3$SDvUB$6`j#xWhAm6B&k|UD7fmOcu4Ozt9r$+mfKiL@-Vkhn#;Wiq8M?$ zjyicsH@@9DJ%9q_vV;^X3G@c)9Y1>x&Up;~Ec{B!fJP=}#`3-GZ&M2rjEG=PwLHSp zyorUutQ`L7$^aKLv!-pb>s)RdG5!YS1$eW$bc@w?D3 zm|xE(>C{cljN~;m7J8|;BL=pRzj_UNwrFkK^z5<~0pjqR-XD@k$Tt`rj@`}29TZgv#lLkSit33jOn9dB zJ9yA?x2ABqY&)odc6Cf`J!k1G4i{;Y{LiB1`-vN4)BDy)QqqAtz))jpcv}ea?(+2F zq7=|s-*nmJPhmEh%;Ls}*QD;E=hc4m+kOGugh*8`9A0=DGi@((>+fk(V;jv5@?ZOCw%X5&TNh~evWIZ%d}bM+L&monLs9iH+NMf6?{(jotb^4M0G8Nu>SC|q~zq(_O~oVb<#7r zyea`Nk4Qpx4RczNtyn;gYC~qy*4ZA9)&9ul^y7?hZfI=QV3*Jbpv%G4ak;<7e+VQgOzh8=114#nbq*J%$q>Y?2`)DF`BII^RQ7w? z`-=M?Hq4Fw+1a<6kzIK>#EFj=k0EW7m7`(e4|PpDc`bUKR@in=Yy*Si@|0OEZNO)^Nz>Tb%t;lE&*FiAhoW$F9WO)UVuJttg11#O;<94N}tP>XI zvjN0EMMe0yygS&T>z+;`(y895~262 z(dCAZ_scUo4-dY|*!Z}zrY2mFY{s|Su`1k&^zF_|R<>9*a9Jrem&YT5kj-zuEk8SJ z0tG}zJ6S#mHcQndn(RKF38HHuQqmofS-ioBgfz62mg2idr$AcXYBCdy@1u5OVq&4H zjKLdMpzr4Kv5&YOhMb0_UI!i&%YXl14=4u8#SGjIM1jH_b2@$RzL?JYaD`&L4-(r;9$OTTrm-a;XJ#l55lBkTo${br?@57y*yhk})eU6N^)y z@}<{Cp4Z{EIrgg7Fc)RavUC>ECEU<`UMLt-ZMs-u25PE;ZcXyINuKq)L&Zm2LB~WV z_%edN9{sRs@|b*=Osed>J)ps29%W}$Y*zQIJ76~TthNyPQO>TT2q6#<$fDP4`aRIc zdc{90PuKIEc#p3h?6Tc#mZA^#*z)SRX~VO{B$}ViwOs~_561_nzHKSHCGuwUc^Q%D zKVNCJ!c2YJxkZ%g$jt>M!AE&}xhLSJgoYUoa+k0ff4!KVHDO7hAGmct~o|^I2R< zYVDw_@%h=QssLccPnf+J7 zp&m-Fp@X8Ou_tFj#Mm4L4W#f4Idv=EIlfWwehFsg%Kk@ia>am3w8|tPD7Z7O$rRy{ zcd8_qt1sqody}s~nty(7bxo(EGUzp$l%(1nPT+j=eQ01HDKWA0;UpYz#Q=O8s_XU9 z=XJO1L-_Xi9a>zEVKWnnA_?(akJw!%XjS5tZOzJ&=Hdo-cTfyR6Tq*q=)Qbe+}J?S zwai)U1qFNEVhs%n-pYjOkn-ZjIgZpkDC#>~J19p6cougH84;*P&dIR4ae#w2YeRT$L+L ziut{^``_cTlY-#u^|fB+v~*LUz`}Whko-UeCsLyppF@j@o2f0CJ?y3Pv(e%K`SA6b z>$T2iEoLM1c`0zm&c{7RQ$QvwG8k&9HtnkTvpcXqY5nxZz#;Ub8?a|3{A%bsIQ#)< zh<^${Iqn5qVDvxv=Z5&{yU;khxHP?=UtGMLT>u|zT1$8|xPJcFSMRZ{`_{H{-=J@Q zu4o-hCel;fF4xvOE_q_f>~f8076ASe%JVtb19&hFVNladdyB(Hs~2VvG@tvc;X(a1 zAYF#c8$dBgF>5lh+f+>PWq#s*X+dvWx!rYpKvE@>t7^n8Cl?4k@_~*-*vC2iFGhrSVs3lpe<-*XQ zo%3@ZpNl!W-J&h7-kgnuFrC)RbU14DwpN%v_Mv=njfP`1EG%&O2CG|YEvfib!YAoO z+HYYxYQG!ISDyjNWjuZC#b)^>eAwW#4WXO^Z*GCZSHP{;SE3^TR@t~lKY>!mwL4pW zC&s09GMO#2=yEBq#!ahA%i|o?c>DY5g!UiTL|NBP0ii+u7U~W|0TLqQ80c3}a5658 z0GsC9Lk67g)JyFOmCoS-RBCw}OG{9B;gn?k-9g#G4rHz>b7h+A2n%YE`>qRb0O#-c zgK(7)0hNm~L-SKU;&3vH=I&S8sz$_Zc&4jC zw#+QhB!)J9eeE_C)`bBFz71(1A3V7bvlpY)EB**dvx$ikhrQvSvPZwwZ+VndmZ8Ny z7K@s64z8^l4n~eyB8_4htuC0uA@|Kc;bX*A4TO-X-|^YapM(om;J8r&5A+?J3={<< z)K{3Fh~HLCev7j#GE#Z&huiHzp;;r?*kB%ul&jbL1MtILfB zur4;6%}zkSnTe8^4&+|1H?Z+ZHUvijb&CmS=xbxOXv(z*sTpuB^G+Vj$sDVKyA&s;KgehqzdzEe-7Q7yv%h}Q?YS=?xFabBw zVK9$QZgU2OlOxhAvYofZLNRDhztFx?iDDSwS3qarP@E31gnL1wkurmby1K`*o3)U( zg(EVj=s{xrAtGw@2Mr6p@X|))e_r-Oiiqh@& z0beDOqdPS_1hGo4Sk61Q{km8Ox!cz_gys3>AW)g?wPtH2 zegPspQE~9CPVY@44qx#{ECkT{TZ=?jK?hH)yKne;{Mvf{GHdRgSRtvCO_zCM(dsyp zMo*dDh=hW$s1+IwrFyPGvbCow27`W#kzIStgC6O}%l!!GB~q5g(j>2b$~I2u!M#6*mBw&gzt__zmJeaNlHapn#RYVk?QhPefT+o?+)&L@(c>;I@ODFMV1LjcQl!Rwr7b2-E-<_Mh#+mGi&1 z@0GVZzZriWA_D<=SL>kCevkKGtrQutPuhnHbMH+lZES0FdT?lBhFF!(AK^9dW0$?` zymw>|HKJc)`Xfb;u@E|^EsX6cSFFik@$dQRAM-C3|0ipanpxFwd4}{qa|u^m{(3#1 zBgINNWM(Abzk1Wh$z%XLmo>3yg7OPN8L7?3&L{3tn&%GHR!6(^r+5iLqwRfmiwD61 zQK}>Sc$1o(pWjoTaHS~R?8QWMm>m-OK<-})M>FZ_(pJyC{vh5ak+{`HV9!#WC0|H9 zkC*f#>{2oCwbb}2+?`^47lg>!byj4?PKUbo$>-0096=RRF4;gD47>j-exIlHJtdBO zM6PNCfdMV9JJ#ek`n7|+X~bw6X=X?o87M`>ig4qw60*L3KHSBUXd}c z4O1!5fPm56uhS+}^!k?Tmta%HJn*WhBzdD^VEyP3=uR*>YesTc=xZpC6ow_xq3 zjXvX$t{Z~lrg6Dk#5yRZutiTWf^)eZg>2a1sEj%=qAH?x9)v=UF1AR6;=<28Uhs4q zl>K>J0}Jqf8n8XNYdM_MiOJhq7+-~e-6O@~Yu2{!5d6&w>WL!fFq?Qzl-*E&OcDOKbBsA6N%Ghd^AYySH)(v@?3~Z(yN=c*3GNU4E+8Vi+O7F zCy`eD`ELza`&W?rO}b@?(zLs3--_%>j<7O4!Xzn`t| zCA*oeQ3}m%wgnu{ZU({`<3wBvbabjL7ApreetnT$$W_k+kWLs1=pj)8rSOQX6F0~w zsCuhe__C(87KgjDjab6LCAaIe#K5>_Sd{NgX1ngm(RA9K8lmI56&fP7l|CDPXBdS7&|~vqZI*gGDOe8M0U}rP?!YEKgy42W9ckMh-gfsA4E- zW%LIG3VI(CX`#vlRfVe%&NVW)-9*Fj9b__Ug+ob_L1x0$`d;w{b`bTP83ZD?WtYRS zzQoZc#FuP;4)csWNdWL%aciQ&qV_tI(ImPQE>(n^FG#8~b3Rx1R-2XNyewBm_a_Tv zJe0KgGa?vdpg!!NfcSvT#?vdS1q&OZq{h=w#qcndM<$>3jDD{GuO7my&(W*Ta{cqR za=vYkKg4Y`9?y0jbs>K~g&;pFvXiLJT5SpVaOCuvGIgCAE}^L-nX5qi~? z2nS~f)=lsUb2uvvmu?Li*jeTwP|Q~gSa~b`s3D&VdyMUa;`Vxph&YtkpBboIv{|ZU zW#MjD5bx>EjuOZJ9s-lmU#A0FPt%XuL6m%RI3^AK01y%3CWhD6+V!7jM&dYku5EAT zuor0-6XYFLB~Z=vG8hj?1XFs+Q0BqQ9haH*>Ws$I`E=aI*T#17XGAO(~k_@%@ zPQS~=#(KwL_SHB`wSp3Bv1<62WA0K+^X*G>rK)mx0b)uX_C6qYH^>C=$1nR^dzMoKshZEX{d9cowJ!>U_k#!NMxCoE^;?iW; z?$}t4^EYmiNma!1g&HlCZF`fyC@O9TBQ-+luI>B|uovR?`#hThvBXPfEL-43}^PN^DOssaKB?%(~T^Ok{|gEs1_=c&rq zFK6>6w%}sH_yH7sOLQbR$1~reaX705`W7S({6g;HzM}Z~pn{A zy9Fh!@N&q{S5di?RqnLKW3t0M^5+Ro!D}9*GTQq+1ZcwD@qCI=r_YDp%wCE=&TdS| zdxyJYK7Vm7vCz;fy?F!-zY|Oz<0!J*HY$$YP;6S$g;Lcr2Z?z>gfKsFg%Aqp@2fSY z_9S~OWT5UyPnuRkwmqiPxuKa5Lm_rgS2cZNQRoahf%S5A#tc&l#CT`zEzHJ~DP24) zb)}WQ*3#!1^SErqtNCUY+t@iYS6>#kHm6H=ed-Qrr^fv(esE$l7gj0Pr6P4tgKfsl z7ENYy`AqXCg|NpCVy0vF_V;5UrY4jv@OqtKUtjP^d`*=iZQoa-)LodM@7W=z=|z1i zx#!+CT`e4#GpqAfj~G^xp~7V?Wj8((=IdhcmXg;YB`{H@R_#CNz5KP=U}3Gs)aCsa z?ytQAx6r1lx=5qSZnIID*|lvE_KBxLgN@ZTBauom4q6}t`IFguO<#N%AZA<-2G-J_XU3q-Y3zfN`{!mO}4x5YnQ1s z05b!CBQTA^lFr9&r7@;iX*Q7&#kb~dTZ{sqZl`aCwq5UD9xu<&s0+bl(+-DHvZ+eH zphQna@*h%WzbKb!ET1n}MHgjuxI0H~v6dBx5lH;KQ^!DK@$V6_L4eF8 zMq_cx6kjYfkf!9v_t``}KAf*suK)2=l%lh}JA!$iWBqV->-{L~^uWXbZ!(_`dwaQC zt8@8Cpjm|P(>Jj=JxXTbPMN^}@YuaAlwOtDdloUiXcyTXj5=Dcv&eAAAr(mGFgcuC z>Iz(Z6Pw4)9E`>hIbrhsbe#_d3I-1?Tv3uO`TlUeB9+c!b)R}K2sWq%l)>V&8-sg9 zLH~@-5`s0Pnvy(2f)U8ob_qrY*4S<@{sx{Rc$hk4KI?Wb`VU-{gM zAO>**RI4;7RBeFuI}-0wtI&#}P|kSM>2|)HG%zgJ&Yf;sw@d89K7^ikw70X{EPFp) z$vc%PME&IqSooRQXcTL9?(X-pgJIz#VnOg$fCLb#H9Cr0nq<1WSE|-|d;d*exv^uq~71S{CB!!wwwMJrxQRm;q$glcKi{<-T zTkQ9{o8hA+uaE^Gne0arn4wfQXA7k`T();+3TPUX>}mlbC4DhdDhJ%|kZf;U_*Yu~ zI^#%6U~jlT@~fy%G{Ozr{AEbJOt*_o$DYHr_V>ES158GG)y=-dq;55M_Su=`DZ8Z% z4|Y!~i?weK60$7N7A@X=2ie&~#8uwxjGu`yG6~iNG#ku~^{k^%b91|#&v7_j5eS(Q zQ?GpWdjlZvus^z}##32-CsTQKy$fA#bQGD&!BQy}nohSfS?+>81_L!?wk|%|EZ9q~ zXT<TC-0Vf-{mj$NL+*$l@nX^Y7vKpl9XmOcS3+MUWFg=G~*txOGoMBHrlR*pPT z#-P&?jcl$R##L)GX4T|cwOF*4o4hYO(le+7SEvw}s?ut>SUI%Nbqv%mQ*FXfrN><9 z4U(M4g$K7k99=HZtlG*ZqNMAvP!*kSEsS@s=na5ETy;632HsD1I(U$?v$KXi-pz>Z z))uiqq@C;8QmDt{`dA_z`7)DsxnbnrM}r?FDG?7%9(=~xUnt`%pn^!i>MEye4eD~S z_KQ=p5Sy7|AQCnBIwCT{Rtnfb7g`#j`z*&jlLf9ccwCPBG6}hyZB=Go=j=J|J_~Wb zVE!V7B@MpTaLNXBdA)-OaTysZ$F{j*`FkH!(Js&Zf%T`iKNopo2vj=dA(dF={r=C) z*{e|mJdG|Ne$)vx52vd_A%NMaJAao>vu}k)U1oKgVv*EvI@NCoT7#c=^QB6q@_8$v zzl!+0ZU~u;IpS!|fePKs$;{73o2vulS#oha9*sXgpYVU!vCCBF*c(YsCi8|0*K08M zDBk$&irE<;;`=7x-Kw{`5==yB=({84)cgSX0dC65%$&w$qEVtiK9R}e^Zq&zhCb>S zZTijY1y7)V3qJ(*@W2^R3Nbq$i>HsJR+cC@9vD+Knbh8j88%JFhsB$D+Z~FIzulW) zwYhLy5Iibgb-BF1T&xrN!%fByN8-%gKRj$teUigsv7^pm9sfNJfNS>$dLL&W{tYGmd-f~s3aa4J)OCn z&VbxXnW8<3vFR*UrgBWV>t6lzO{cRku51Pdwn~+T+soVs41-`zu>jbg{zzQRlf?c3 zfG8ukW<0;b(UouI_PzrF@i;YSnd>y1?JXeS2PDV&(Nz=e>1^-mbU3)&ZVWvh30$A9 z?6P#$0pS(d3b}aVqL~8eyz0TQZeYugU2IE?Dc=VQpm^bNz$Ul5R`0Ok$HwnwJJu}R z_R$2I&n8fQV?l$NS$sC%ENe}3Nil7HiQY#OaDiwKgi`b;o1$DAjm49gZ!gzjI$y5q zHp_uPTR4@esC!A9v6diab-9)xJVPC)FpIGP$b>oeDA7SYHTi@7$;()hw%xSy;&AQX zM*v7@w+l(OSJHjPiJ{A106WQ*5E2ooKof!2#oF}JIzPPCayy&i0eq26hBD1iDp+og z@%c}G+a6e{7F3n+lCiaY0v>nI*T4}al;u=m`HkZoRcuhY&=x`z0YNXLA7gDO=3OULZMTv(#yF zr}FEliP=5(k2wfS=>KZfgmpSfnX&_P1K`b9>LZhy2G=0%p;Q@YjT$eP zg7h#!rlk#1t(TeszR`%HaRfe(=Rj>x3|umP&sWL^xheiT|JQH!cggmU9*-AcCEAK<(%+E*G<SLuI9tOsGGY6OR42i?-gti_1;8!jKE3ik+{OUvjF>!E1ejA2P=XkwiM5oNM zKmH4MQli4kzh(ABE_ygJt*Jt%rP(&te@EkJrlqgp)LOgk9s>l5L8qO?`0h$Ntx*uP zl=VwvQ!u!r%c7-C1?FnGTn_^i>~>2kn~lR|CYQceHBA!3o?tSo2XCNpv~`Bv6S|5q zR*Jiahrw^xSJ&idLm;u@bjpgJMaIi(lf5Dq`Ao$zD1)?EnAt za3ZUrPE`J7Z6FMJqJsWmOIFNOZ%})8vM=dMSrJPRB)UxuMF`2kA|T_%+_?l~Gnmea zyV+dE9G9EzPV>YFG|V}@~B zzEii`ePZwp@JI4!3f)|__dXfl98cblt_^1NE7cneNB6FmJWGt?Ykw(90BOi1`ago; z{2@=BA96=^$T6EmvPD8gWUbZwYi!ce24SIY?!1q#uVg|$@4^HNez@ZNyf^*)vb`%7 z(-S8{$)Mc&^tma`Kl_@oxrz&O&tlbe-OLD6on1=+{AFg(mFPl7kn(4U=Oat*g1lt3Y4 zBsH5nnnNoL2j0uun>V1fNA@qQe+yBF-#b(|8ny6wo?Q1I=}Dqi;;RdXC0C{z-)?@p zq~grO3eBdWs5I#506N6_MZbXH(BJ}g+N2qaiFOf{1r>nhdBAlPb~^t#tr3sIR?SQq zR{YnuA12_aAXJdsH`AA-#D@tg1)qq6{M3>r&e_T}{e-X`mv#omf)d1D?#y6l6G%PS zE?#vzJ&g=4``4>xkV!BnL^P zp+8EjqMG%}7X%*c+U3pTe)bXnUG}KwuF$<i=52>w1N$NoF?d-5xj&u~a*M;mH# zmr>b6t9JEl4vOqICsfoyKbbjjNO0=iolbKrtH{an#8ukE@9S@poattsiqYOS;l~2?-9Ktafc*|4#BH689^S!;?yE$|5 zVy>5XFi)&Zw$4_`s;^ydz$rwqB`r(~GGV$m%rjyE3KNXEc*yo(@o)e-AOrn0-mB^b z1_n`QU||t{c(CP%lgD{aQxfoyvM(q^l#{Vuriw!#T}NYnt|wN6Z8jPsFsoVB@Jpp(nA$2K}>WPB$U3h^CeZd+f_uW zDVysvi--iGUd|7;nkDzAEo4YuHG)w2PE<-Y;(NWT?X3t% zcSv_5NOzZXNq09A(ygR)gOqfGba%IOmvnd6yWIQv?Q`}y=k=dwI2_{{aNYM>*LThN znRD5z*SPB#-qCepv?e!0JR_~DAl$^{f28F8K83zDn4qXfv#z7OUxAR=K%G#o&9~=c z6iZ&)=lcn@cOIzuT$;>OFxWlI4o>kWjrH_?b;&xHFqDgh>ujGWJKGC;vJ{S&3YP~lLq%uc z$J6dUNa{G8PVKSepevG}wQf#PlRRd9s6ISrL2-S!4mZJ<<~+{G)ZYIGEAVT>eBH`< zd%q^V`B`TzqlN+K)EYa|qpE*r5@2(7GEC;l(re|BSEJUAB)KlR`1oQDW5cE?-Popm z*dYBC-Ozy3(X5>JF~TV+0fRrrRYH|o4{L{pI(??}hZ%C89fCmjKy2?{D~{INGYdnd zNCD~m>v7%5(nc8`wwR0>J^=yfheXoJWs`zLKC(u?++D$er&n4)B$yam8upwtmGyVJ zvg+y`A+N>bF?9_@*!$BL`j)uLRQ5g2K2#pogQ?ry_i4cLyhYqiI`$P;gn+MsP? z?=CFI4-%fNJt1Q?ACqpj+HyQD=_coej9|Tg{o4oliAoZsK;L`ON~56KC@ENL^q+3~ zn`aTUUnM_!JK~~FWrs=o2|562Qr~Lbq;LukS_&1ueC^_XB-r2^m=B5XF_|`C&sq%w zdN;;Sd-2%6w6AqMDdou+*cu3#2HvWwx?)WZwa>TNtuqU?1|l72@at&Wm1#E!kCQ@m zrAz~ZyWd#~LqLx25gx~A4`K%|-P85T^DM%aGF9NleBBYR*KEA9kfd{ zTaYN^Gx*7>AZ7iB&HVh)$c{```T1H0Oi&EN$V=xUXjn3RX|K6H)ig3!Zixg%#IPGo z^^*XKJV&8Msz;7s@o26A?-@y@#J0CO#L!(jp~TMaW9O!ZT$wf(r96IU*C7x#NqMs3 zUJ79#Zy(w`9soZ>$G?=ePgS02qK~ zKF^gx? z5~>@VaX2jugZm}|M+8#C`>v0tt=fP3d3|*8%^6GK0BQrNzkmriy74yM9QFn3Rk||7 zKrRq5TeC7G8`77$q#C?#kWRd|)+AYKHR4zv$(xqGv3m-X<#IGl;kO}$Rwd0!C<{{( z!IeEXs$>|=sr1_kg;V?2%+`V9MwGv9%;8R;1k?+D4uxs_7?OJG z)J5Krm}oE*D=3TnbT>F{Rl4|Pce!{mRYRG{xU2um$ifwHVNj&{-$n5@kX4M?*?6Cx zqV7ZsdRwVkk*-Dy>hGS8uU5N{JQH9$KOcoXnGG>mtGr%xG z`ca?EMMT@j#6?3la*|6vuH1B`aIAiC>P?Jgfs)L`WFP9E<17?GBVB!HjWj&XBUof_ zUp08_)Zum(H?Cv#Wcdtmego6vyTfDyrZ>`9vZ5T{8Yh}=h^zFmI=?L}4G#lSEnDEi zld_Y=B0OLo$v!Sl$`$Tsw)kg!RxufjcJw!V)^EhZoJ&=&GS@9cwIen2S1Mosyc{g1 zBN073LT`0Flj87i^9v7RBhBCLf#)NF2L~m;P1&&UGviP4f}e4=>g(^{LN~h?N(SR> zso_gYv%jLEBgNIP{P5AgRMk@r@$%25fx_Lu$z)2MK}6a2)5ivuUxKNe7PxtFa}o9} zf-2OdSt!@`XXg~S)jzyv4Tja3(8)ipT@6aZGdKrhL75J93V?8d+;bqfc9+(00~bdl zN$a%bRCcI4xG+}f-AdlVUp4d!o+&oo@X}e*Q8-L;dHo{Ks(cTMcN>7>XFEH)^vQ>$m@B+xhDU{>PE{ zt2+JruigR>lrtd&-Y@i7tlv-saGDsT+6Ux(kRWa+qjk>4lFL)~ki~uN*3`;%e27%~ zhKYFb3gt*qT2SjfPFfG*i&5>z!d4EVs$&0(FN4%GnG@q6#M89s+oKCx*SaS6(5^fnLiW=%9?Np)88)2J) ziFnPcXznjE`zRRrkC%n{s^z0;&t#}8$9xYp`-nuK>GAq#(hE2(IWt9{3O!eN8={b5 zVNLxwJ}*<=;D<~gSl!NQru`d*aBGHC)U99DVw}B-Jt11fFhQ)${?F6=KYl=Rh&Dn$ zpELq8qlK*@HEo@8xLqg$=gs~zE49y}QMlPg!%2CT-``uBRe-cMd8vAZVX3MMYf91& za~1E0-_(K08uXQsB$86M;Phm>R3Gq3FXxQ*(=Wl^u)Tblc2%zIwmjIL`LzEMU;ZDTIru64^a9)4Mk8Kd7OUxkc}0cn7?^B2+&lS; ze5ECSuo+c1f3F+OSDIAF>VKQY%u^ShSXe01?|94!Z}a2|(@?hhshuUNC_iR)stlA9 zkB8%@3L~nxHKBo6uI=IYuI_HY2seFAqSNlDkVJd%^=;puraf6`x!I5qcy9x&4XF%< z_ppbN1U!<&MF9QIcaW;Ed0-$(V6)op4mkp^{rqWZuFIPnmnJtYe6)cAAZq7IVJ%iV z1(BXIVwc34^=oE_VnO(2@UL(+Ur*wd$1$k<;mL6jXt;WkMmCm_G2$|&yWf4(B_Wzz zV%ABf+;1&#cYc~W2;!KEucZHft%QGlc7oMng4-oijsP|V)`#Sq=a9RLokG3xgzy^7 zvvEAOk`x-{z~A?CKz5W*WIxK6&!API-&y-fRV4(p#liUZDp{_mZSonFWF>T+?Ccf?Qh_AbnGIdwtL?1tdbQI;i!93KAG*Oy;v@gTB9cs<;z z+d8%DN6_RtfGLc~F$|d9te1{&<@6~C=Gg#y0v0;gX$tu8P1+)aW(MrWa{4yj!hX@7f@GmUVr7 zok?j?W_kBHK{@ARUJCw2O3SmVpZw>R;f+PhQlwy6BMowyl!xIgp$1&Rpny#)CgBQ# zNwgVm(M;8F-Y{Dj{aML^)l2<@t*T)Z1^6JIdVejvMKS6)NX5v#^k{9%-ot*_--MXcdB9dZ3oCygxu|kvT6>$C7Ef(%;B9SlF{}6Egj0ChsrDB8mC1h*V$2-B&IG)OVJCiLSm7f*V9#C&ou2r{pkI0c5BmDg6HWWw8@3pN>FEf2L zUWMN`;V_(JP+xFyrru~B@9E|!fyl)Fv`}lo*F=a#LWZlDq*zKu4f} z)4jI7;M#7qNaGjVa<$u&0(#}V&EdV+=ZKnql}9^B`u7{0oSf&j#`He=FLqyYh5xnW zPj86ZXZ_FP&u&Wg$Mgo;YFVC#~NGb&dfvWAwuk<>KNZ zg~f%W7dI)eRHG^SOM)qP9F`$?)3-Ps$N`-}E|nKlz$O1|C#GFqCX&lw;*hv5`KAAG zO~C83juzjHM8LiOu)<+L+N5rZ%fh5Mz(W9h&JHg|*w?|wKKoPiKZ(N$bvbO8N;Gr- z1cVykisrgXykYUVKI96rwXIueyU9ht$M8H}Zd$B6ZgzW6eg7Dls3*|8-e}-Z`$K1% zGpVm;VESiKN!; zTN@D}iAkX_rqg(>gyiFDFkBxp*A#u`{1o_08-FB)os_RXXVrieqh>nyWAx)n%fol+ zhcR(_C2&X6$UIjK>%D>?Sr@bKE`Kd5gt}D1d*w>Wsu|$VVX=XIg^`zam4bILT%UFB6Z$_rx|5BI`UMo)~)jGq5u%2I+dRwKm zS+|V)aEZ&!Ux>bF?57z-jq$WxjptNq%_7Z3S})cfP>lrTB#Xge)2n}Y=^sbu54<;h z&hdLj1viTpo0QJ?X#4m-!x*gH%nUg_Z9epIh<)TX6u#Z$_jx8Ytn^9$v^PN!oR&Dp zkBSu?iuE3y*U1lTABl8)27jh%Z8YIyFsafGdyNMbkH=z9&FRrfmoDazn zqC2sTPL%89WEtSP%XD0{nqBXjTz<&Ieo-yeEL1yrokTxfqKH{cfgDNYO1<&T`K0wB z*x(H^J})VZz5khP7kaGBuVZ9F>y^r<^DVkh=apdu0K~_2bJ(d4GjcoFJ_1*pz!2?_ ze0$g$O#aqfVKy4&as3zQNp^m4F7>#=30A=%FwnwfFG-{`b0#y&mQK`WQtu+;`DB6+ zxYA(7XgdpF)xIf=&{~z^*$~RE6M}_0Kb&%nCX&EnSLbrg23J7r)@x0`YX;@TP<&s% z^txGjG8s~9Y7#(Mz~v}IjuiO(Y-rzK|Ciq3@g}Xn77M@U(`jTy+@F<97)C82Mvo+f z&&Ga@^ArG&?N8==px0^$Zk%=z?So-3`{O?ja2oh-+vQdkuU>pMLrl5^fNNV0B^fqSwx<4FMpX(w-6pK(ysDxLo$9l6yk8X9}j*Dq6cK6%t%CnX$A2E}9Iw z5`I5cF@3=rCUrC@cU-) zx%ka{-(y_6zLB`?4d1U)t4IaA#vveuxQ3`v(ck@FOwysQH;GPzgUwmY7H|4Et`5HG zNDNM_@hDH(y~j1dD>}t7_32_Y+v!F!)qz6gTyl=H@9|bsrk#O1*( z0&ZcrEJFCI#j0FJ_g~1w!#93|bAorvf<~2TV4$PPU1(y9cj?);Z4*n&g`eI>Um2hv zAl@Jm@jGwr*Id8UsG4@Z6|Tw)XEqsZr_`wPMxU$np_EN$xTp14yE>TlxF(#du_`aX z&S1H~rr%r0eWSC_Va>1~e{*{620Rx`;NlW=Udhc^m=Nb?(?3?hbcbOMjWUe0j8Xk@ z+|K9`V$l9)-XjfoWqNxZLZI8~N%*reG9)h0oZ8wjcfk0Ts`c4vu|nW1mC5WF3)DyS z)Kq(SVM&HRMa9AtU!5L~itb%#apkZ_6do;Ex(2Vk^2wlb$!JQ0JD**;A5;@X0XZoW z^4VTlE&clMm~^~mqt)C_c#Z-H7BP%^D>Sja>mki12iJ%5RdN~kZLLqx@Ymnt%0sb7 zJ8tb?p1)PRf1ko;7582XOA{yB^V!tLu0tB3_+8jt~_j7IXL8 z?sw?U2v{4VX-%Xg;^6;TwpvfKtzD+Q*YW1zc&_1LvycUxrh0seKEIGiMBsn>mBehq zt5~L5u8Uk3z_D6_6N|@c8DX%uH@Rcyl=HAo)+c&C50YJ5BPl7NaZ;fAsKGJ6OVVbp zAk$RexxNP6TO9sj$JktpN2^5Y=9p(~ceg#9W4qutsUb7;N<(oF$yWhfK6hcDnCo}^ z^!E3B@oxE!O;>5U4DEn~!Ejh<-f`%B#ItJGBu1x*WTb^6%6QnblthJNEuiLkmqDj? zJ%HZV!DqA5jQG|1vLF+jCA6Dt$an zwNg3l6`%~qL`2SuQ5|LW6$c~FS`IgOM z8H;gQ(ktVvzS#U~<|xyf2qLipsR@)ew+k#QdO5=u=n=?{@9bM!e_}rW@n=ecF4t*e zvdevsI>pj%s?5ehRRw%}uABAyIQQZ-_QEtAHOL?U&DM;D zOYKWBoWX%^3e_~jhr@(f`H?YI z0N(02Jf-%lC!nlgJjG+*5x|$bIp%fwo-BL#BEQxYa@E|OU;hQDGnzCdZRZyEZS6U0 zF~&2(6@DrMR#?7QvC9WrTcyXOLob{V?;={$Fjz(lQDKtS$u_+g1UBI85+qPGm1cgePo2HwBH`llh{$I2Qb zVrVvYn|o{VZnU>m^vbcnBFT z*(p716I`z@ErrdU+6kgl$!5bD2A3BDhPXXKh?XRhthS#$v~>QtW$|ai^@%{W#~A-` ziHy;YP9F=JO%%s>VH<1X>HJ>3>(6h3R7=$%-*XymYmrnduosctJS#bQVb}8gTFrJL6Nt)6p0>AXNwnO`#dj)fZcJ!-_j@&es##A z014L<47-BTg%1O>rqgDykt>ZG+X&KD)~k)_3V}oXW_Q8;4oR5l@#`dkn*D|8R}UhV z3cWY@97<>*;L>_|wI;c6`wdE=fZx?72NB6El#0I}Iw@g_>qd1vU^T<-!WGKEv*-+z zE^jXI$Ng4VsFX`;#?p*z_cn+eocB@uiNlb6)k?ILQ7AxM`iuPl<6Oo6BBQk54}!0C zlk55+U@wCQl;5o8Sif-ww~HimMjC!2=_-<>VEWwZj3Uxcc4>q`NokF`m?aet2gd`g zSYx~gXAfAc>%!Pxr=x`m-KRVlA4h)S%o(0b(#-Cpfop=M_)kNYI0%$xW67%x$~-X4 z)MB-W#;NW26&rnWQzeQ4=1(i-UcZ_=@6Ivf-Oe{VPtfv!H^RzdHj+(QYjWuIfb^>a zGEA*ZTc^cA^8SlO1lKQYp7hn&B4WwNk zs+f!tM+ttB1Q21U^#K8-H;k~=Vp5eI+KbBtU$KT+-)q$Yqi~I9XEt_|VMl zxyi|JZ!e;ko<7D$C@>I3(vnwbN1|N@4mc#Hlz^U9RW=f?^1Dgps_F|zmmtB7!e?onuBkm37BE%E>jNQv^3@Y(mwSxSkmY(! z(aa`rC2Mi2Z=gsE*F!?A2-SrQU?f=`cNhzpEMGZq4YJ{|n10kp5BaQ3pShN)TB?!1 z`CFsfRikR#MuRznYwZnNAQZ|B2bbgans$MG@VUbj9ff|@&)x$6J>T3;?oj3xI{-OF zSqUdi)0jB942mXp#ba`)1mqbQx-$MjDWbp$=;{-EBp=3}zL;lWv<((mL{Tgk98tGx z`ig6WAs!U0DDTTs5H{ND+~R=AXK3_>@ihhbk@8`vq2{QC!iA2b`k{(OXoLNad=47~nr{0t(^3m=`qN;*yv6zbPQSkXn3cFbu(n=r7$$f`~;D zvm5VH-`xeaTB*jEO`G`!bW)QE6isENQmt&%8Ys$`nVBioV%w0n$ZbDjJu$8(#!qVG zuQV|Pyd9;3#_n}bQL)?+u4w-sXu=-|me6n_YBI&pa2Bh6BKuM?-ugBDh8pnu_VY`%PlV0hOJy#&s&j(Iib7D`uRQl@PYJFN9uuAr`kdkN#xyVBZP z*biKuAk;)E>38b9mR%O2c^A7%<RB=^wa>+t{=JiL^?$TobXi|&mO@E(V&t*zx0-JmXo2^Cg)JJJWmX#EGl z4kz%Y;WzOr1%w{S=@FxUdH0szf2@X9V&XQ@R{b*`Y2Xm0?G9B?K)ldH0HF<_Jaskk zD*v!Nb`{qIjo&fKx>vxK&D2;?CH+dOwUy|@?pgpr?4K0M-{{e!_N;+#?g@FvUu}q3 zJF)eUVHj?(8_p4X5=ulSztZYsy*|FP&IEd5URryv`1{T$-uV3=)QR7O-LiiEWVDVh zKal``YJ?%k?fWM>K|+#{!NO89mp;!d@%MF&yt?|AT-eBdFz2BqhAZ6rZ@zV_Nl78S zj)hCYouBs>``qz$k3gEfgR(;n%TchS3_c!ttE%;v3c^I17%KGA65;yukS-KCv#@ucXuYyk{~?TE)z#I1;q?$s zs`U5DZKUEV$QDL-C~Ws*s`ApU^jqDdeyd}ltX{?ja@`d0CcviL5aA|-EI zety1V(I>bZ1q&1#P}wMTa|*XQw?o1t)8^sf&rw~H_`e&Wz+cya`RIJ;Lc-V=5A!$) zgMi1af4b%kLPQ_xeif)^T6@wJYt?l=k{U29)YynIOC48)V$sYMnN)#OA6zIhLSMi7 zY=y|8@jwjaFIhp)r^47i9!hDrI6MwpCMI@5HV1P+`=}R!@O-7oP#%g1sszr-2WIH& z{dvq{tgqZc;fRD&9JZwK0YdFhFl9{B#!jEnkzQ8oQ&%H%;M8;ayH7K6j3Q8`s&* z7sn>a=Ml?kS`7^ip)S9!o2rldnTUx1SRRH1Y|t2uzEeD%n!bnstjT((iAwR`3=Z6s z%=u;nnFIo*Jn6Gn|Hg!C*AZn(ka6Md4QeS-F{{`ZfX8TNi&Wm53}RqpJ$8(WY#Uc^%k|u2K+*lmmN`h=<`y2SYuqppZvtcaRoVx=7 zeQMbAeiez43v9;wYof4HbQ2ki1*hG>(eMK`%OB}&yEEC0nS($_YmLO^^Go%OedY*U zGbDO?thHTca!K!H2=tFHRxKr9Hh#r!_yH=GQeHlte)v52??DTjcC*u8K9zU6MMB_8 zU6h(^S$CCx*~NPHH|aZ8r<3`_%TP<4maW^fKRle|wH42U917(*jpwm#K0$KJAvM*O zJ%%44>(MGn%bte&Q@I=oFF5+Y0xmwLUBA1)9)4#`$wh4tOrY%SOgO*GvEvX4-GYz_ z2-w6oE_a^S*8N{(_m(Pj$_aJ2LP8Vh<;~5CFYo7}>N5c!fJnrxQ12+Lgn+}2o1xvZ zVY}FhK097ps&#z~?zbN*Q(JV}E&8SZ1{!I@GaQF4jMybMf4D!LkIq6efN-~m>jJCR zd?v@f%bh|>B}^ZIbD3*RtY7zNBG>D}G~B|Z7F?qEaJW$TKEi9#=coy3ch>Q&ldHM| z3cSdzp8`h~9GDCdi1-7OL*d^pnD-RbuobB&cBi+wa+w`}1ueyfZBRR6x)8Tyg+&hG|g5857*6EMwo^V?5!SG?frGBLPj>?ttu#U~xT2f&d|2>VnmQJ^lcN5853B`=)OV$@096Ty1^Pr&Ydn9cQ zes&Y_%z2XdAN^Q%U&+KVZ8bFgGGKzbPO>6iP@&w?U{FZpop_Vh*vy{eNcctiB6!aO|AKNHY+pYdb3n_ZtFEG6q^ z84EhB;dq3!cUrly=&77V{B_X1gEi0JQQdo;!%ys3N=WqA1pmy*RX&J1l1-(5Y4=qt z5=GZ!-WRdLvw~-FR5HL_p;BjtehU>KaruE753^U6qc>sw?%gZ@2=#RXpZxUF#^K-` zI1?#;e!X!sOPnr~GGfmJrsuD&Y{VhsSi^DBnKAApo!`S{;ZY0C^_vW*?p9`J+cz-{ zoH|bVIaoqX3=NA;OZOuxA3u{u(Yp;wAhT6mZ~i?D{2LC57F%O{Kx3--j;8^c719iF z07@!hIT1iwkoq=AxDIX4U=vDxrc2)L9HI|tR)hSA-eMUq#R&y$g27Cs_IDC=WH}R} zLWv;?ni}xUNe=HigyRaCF1r-`C6s)1Ati}kGAn%PRw&*&I`LL1z4Evf1-(ReP>HoTZ|BH zKqK2hLc$y0v6@UJX-V;W#(qP6#jYtgDFE%6G1*9oaS-o-g1madKSIP>h8TDjFNcMR@QE;@5|AH_ZqzfDRllSb zr^bS(c6x!D#O$;kh?p{&KbwPFfAZ|xAnGV+0t5 z7$EJID0c$A&^*f3R+z#JjYkshLV|X{EpWencZ(!{2-ZA&XRJ`h%Vkig-`CF+v%nQ! zH;auosiwO!#gi|Y#%h74{U8=-xcxS=H@D+Tm^s-vlg9nbYa0qvjL!Sa(piSj-`yse z*{oX$PY$k1c6;q;3lULvU){4E^g_vs%K78qQX=UhyjW3}w*PDgd=OwW$gNYw3YPCa&Wt|aT32vD9B?Dx`p*}y7 zy8%G^j`f$-8;4>-ANZ^=%XFR#AE zOF4mKdV5BgFOY~I1M0qlY3>{w9M!>7=74nA8jSAeA5UL?2oR`DOVgRJq^L9=aJ@U9 z4wjj|c?trV{)1>%=FTeD$vhi4FM8vTNL@rGm6#xmspzA}w}1KRZ_`kemBmDkv;DxB zzu3puw4l*S@NIAv9OfX9+R`8gvwY5tBi`j1Ac{L^1rVUif>6Wb?RX?JO_Af)C{j%+ zi1@!eiwKKcFmKLJ&f3^-ZkmuIN-%9^~F>okCkTNo| zc52PeM}cTXkrKk7fCd4UCF=W6Tt36Gj20LK1X=~+^7L9Fo!k&bbBwNT(FaP1A!g4E zo08JF*Cah3%$oL`he#~Y9QtXm_P*tYK;`TWUpiXdlZj?5ryyrGepNp0SnvY-S)^Ls+!+cT&yyj7~wbij*@8U zO@K{c(#B<~5cq;V!)J(!iPJRyO{qlwqiMQX;Au}!3@o8hRopxus#@6ErgxK^of+k? zwXIbpy-QEm)Zvs#=f!bjzcj^?OQ%ov5md)ukssShDiW$D(W|lS0h#y=cU}rnjgKGS zDd!by%>1WglUNBH66lreBn|#g!bk8EO0WfPtgYtC*JveUTZ04^HRs%+Z$Xj5Upse6 zc=5}%8`2ql2;W$w#YZSob8>U9jhW-Jn3g0lP50W)1*nuMbNeMd+!+Cvrwnxv z5}7pf)H`+)fE1F*fMzB-wN`|%bQ5d%kJXN5jQfo$S>)2SGNeN9w~Qp@J0mK3LGTo~ z%9JMGH@nTr+UM81`YxHR6xDwo{!hFL2>ReF-pApq-TL2KX?wZgT2~M89sq zlCnxl7$VAnSL35Fy*! ztU2Jg9JO4WNo$nJI`LQqj?P(7XJ>#maOaxsv%`4uumv<|{^#8%BFJMbxalr!@qa#g zKSLUp?^st)de;i$Tiaitt!L7B5}EIx@L(wi*h^=@&!J)ySbseBSgpt zw|G1tW&Z-cHW9yT9GA3s=czI>x~Y|w$4ME_0L5LC&lq33z^hi7aZhlWD_HjFJRThk znFOj9QZ4Jkqp9;46yyiZ9w*+O#kakgWVpxFTL0m9Ph}x?t>uvnUB|^HbEZs z<@XO2X}0f}EaC~QC-_HiWXW7~lAxh`y&ma%;}=PuU(4(N4xgyb;C=!>oX}&TY9Fvc|Q*>(q#joJ~=XSC6 zym=#8820h?1%p`Csze(=H7%~bBC&ioFt#=v{@lZ9zp?uxU#H%+(6UAf)C09SY-#RK z(Et@tE{$6R#VeD_wz*!eFqJ{4F-!H~w&Lv_WdFwBP18Q>6C~OkM^C&L5!mgQNvlIM$?v}yjq1*O_-0BFOf|Z5iC7w6Ur-HW}@6%-{ z5l0LQBKpmD)UL-7o&(H9BLZ$bHpI%=G4b}f8E$fF>dh-H6XMvMkgqK({{E(MYP2Sx zL#v#`Hx@$=?k^TMi^VWYhkE-SM(_>6oDVfH+96lIqvD2pueN?0)AQ#N?&MP`QCCf# zD@*ghln_(Ip^C`WT-!XGtg~HJ+!TAALNC#mqrISc6^LB5(?6II)!?|Za%MzTv#A5O zoehordzPP{NkrWBWqP~HFz45L-IJQ9YvbaKJp85HC%PVf5XTtzE zlRF*vhijeEJdp3FV^hx{;Bt68oQLPk!um2Gam!+Qep$G~l;%dO^H25h-;W|%xczTt z;G!b|=MvNc~J z+dZCK@-SaE#yK@9k-qpjS)1?DvSLdOniA(m4BK zD0-#Qn41d%MQLi~8bpPxmW?dy4T9ioGm>7l7StC6T*Zx$STnhdnJ!V6!{4=_<23w7 zHR)W{aa^_K?e6hp(_*DbalcpIGzJZyrdPJ7xq(5&f8apYK`GK{rik3FB&IIV)GBtF zF=0}Sa<*XS@}?gTEd6X>LD1j?P*jB%{*bRRMAJ}hZG_7_F8dQA-O1nU7l>-i5VT8C zGlu2kWfFL|vV#^f$O9$15x#qdik5KDQ)*q2qVPCd^H+Wu8M%ZTlKR&chcbd1+?n|C zi*9s?3dVam?}w}~p9h4jBS@uuIWck=AWVZ!3_$sf4D3mlKw4Q9gPmA$?=V%9&nIkR zD1k#kKi;!(@7&KVd=`Q~OvXHWXpmZ!H8*I_R zRH5JNM9qBaSn?)?ObDlg832uuLLX^DfVo#(AUlpx4;nF3qt%r$QkF+(673f>>r{kd{Bb!NHVj40Y|p+q2EsJCx}f?-otpz&Bra3%G<# zr2WK4ey9N2RgMC^OsN6F2%r$s1mhz8K{vLWaZ^>^V&j(h?=XChY@bVzGs3SFH)2p$ zk6NGpjIaldz6;nktK@g18Tg8*ns^!*jOx?HPcq!pbD<{urbvN$@O&9qd6l_0((&}X ze!i3{5V+nwYTo!WB;;-B(qz1dnpeH5_N(O5*3MfAN<^vi^An3ZjM=^FY2#IDrpOt+ zFcAu0%%BjRI)>?0?;K1H(J7SF#B-K@3Z-R=+|$MUvfd?ut5QO*5stv0SEbi#5AvO8 zajnQQrc*|m{(C$F1%k?2bOl;9gS*CogA(5xRZ6JP>S{vC+7n#I@M5DrI3!Em|gKbd3xn>m$UM|Cqc+UnY9ShMJlu!S^b~{hpA+DrUrz0uP;Yp zD3n3_>9=npAl)=opgW)I+w1%^G}K?v$gMx(B!O%4*cu^8a)~lQYAU0QF;l9HeoT{BNOK7qZxZji zgEN~LG%vPB(m+C>z5VAz?)TXOMX`P(Ljc!_L8#jeEw}0%eA$~QxKglPEyEo0xqcK= z3L=L&g`bnZ@KC&%@WsLpgZ0W5cY<%+^toB#NX`~%axR55>4p7j)?J0^x3>1vANEKP z`qSOr=zG1V#+n*vxRX=atv_}NS<~dy{gzL#%sFsowiUr zpsV{+x_tE6%!tj&?GdbnD%abo{kQ|QAK_uFa9altD5q6bXH|&sH*~Bm@(G;OWhQYo z(57k?j4X1|XE<`#id2a_(pk6|9JBrNG$I(gOVT~7FIW$lO> z!P`T(?qRHe#5`KXb3`QWV@uY$Fe%&1F0tp;{uP6c2hDMvA`j}g0f__BKknwgj~|^P zYoUJfu4pd~Ee#Fx5dM9f)KTmK;yVVoX&`z*eWzyzq zp{=u<&IbA2?|jhc1_;yl2Z!&l2<^9r-TGadUtX<*?~?mKc|L=A71iLaGeSpXDAsUq zHm=5}6uRr%0p%PcL0JG+fr_&0{i~Gbz$Ui?hPg7cF+C|!Rfn3)Fd3{(E?E^7g;q}u zThq588>9r$Y#X5Ai5lF*F}SC41WT~-&a`?QtRL>aIuG>?)Gn2aK(d;#?IziPbvsO2C*Y}FuG%5K+z_>1Xij_7 zC1UdI&mYqR-0}B&wel4iJ0e-ZuCmAXrNYOJa-_BIE>$B{Ju?KmOn7QKvv2bPQFXLV zW0b2PgrO4hXrbNhM=bN3ICJ+8^1j$G)IWXNxbx_D3|gbzoT;j0g-9;jis5EeRaD;c za6ceyBA1a3lIc7|g&lPUMnUsD+0;qP?@OfMgIN+u39Y%-idrp`C$gQ&W(a0(wt$>{ ztFhZr*??_e(hxtP&-#}=(V z4$Ae??fY^1d#wf9RwMMx02;;*pHAj-!)C6kJiktTHj#ib zopF}5)RZnL&AlI&-tkfULxn{CmU_QmS@N?cPp%whW

)odULqM9=qqgJutbtHrU2 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%0As#PbNbPsA%YrYZ!9@X7~d#uKFmhVOiqfLSt_nV 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

x=7Yi$GqEO6vBB%sUEja!}$K9f{VWt&t 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 S@_*xQ`WK9J^M1ea=YIjaCJ8?P literal 0 HcmV?d00001 diff --git a/docs/en/docs/img/index/index-08-scalar-02.png b/docs/en/docs/img/index/index-08-scalar-02.png new file mode 100644 index 000000000..e69de29bb diff --git a/docs/en/docs/reference/openapi/docs.md b/docs/en/docs/reference/openapi/docs.md index ab620833e..baa4d5550 100644 --- a/docs/en/docs/reference/openapi/docs.md +++ b/docs/en/docs/reference/openapi/docs.md @@ -1,11 +1,13 @@ # OpenAPI `docs` -Utilities to handle OpenAPI automatic UI documentation, including Swagger UI (by default at `/docs`) and ReDoc (by default at `/redoc`). +Utilities to handle OpenAPI automatic UI documentation, including Swagger UI (by default at `/docs`), ReDoc (by default at `/redoc`) & Scalar (by default at `/scalar`). ::: fastapi.openapi.docs.get_swagger_ui_html ::: fastapi.openapi.docs.get_redoc_html +::: fastapi.openapi.docs.get_scalar_html + ::: fastapi.openapi.docs.get_swagger_ui_oauth2_redirect_html ::: fastapi.openapi.docs.swagger_ui_default_parameters diff --git a/docs_src/custom_docs_ui/tutorial001.py b/docs_src/custom_docs_ui/tutorial001.py index 4384433e3..0af2c6760 100644 --- a/docs_src/custom_docs_ui/tutorial001.py +++ b/docs_src/custom_docs_ui/tutorial001.py @@ -2,10 +2,11 @@ from fastapi import FastAPI from fastapi.openapi.docs import ( get_redoc_html, get_swagger_ui_html, + get_scalar_html, get_swagger_ui_oauth2_redirect_html, ) -app = FastAPI(docs_url=None, redoc_url=None) +app = FastAPI(docs_url=None, redoc_url=None, scalar_url=None) @app.get("/docs", include_in_schema=False) @@ -32,6 +33,13 @@ async def redoc_html(): redoc_js_url="https://unpkg.com/redoc@next/bundles/redoc.standalone.js", ) +@app.get("/scalar", include_in_schema=False) +async def scalar_html(): + return get_scalar_html( + openapi_url=app.openapi_url, + title=app.title + " - Scalar", + scalar_js_url="https://cdn.jsdelivr.net/npm/@scalar/api-reference", + ) @app.get("/users/{username}") async def read_user(username: str): diff --git a/docs_src/custom_docs_ui/tutorial002.py b/docs_src/custom_docs_ui/tutorial002.py index 23ea368f8..94f05dd35 100644 --- a/docs_src/custom_docs_ui/tutorial002.py +++ b/docs_src/custom_docs_ui/tutorial002.py @@ -2,11 +2,12 @@ from fastapi import FastAPI from fastapi.openapi.docs import ( get_redoc_html, get_swagger_ui_html, + get_scalar_html, get_swagger_ui_oauth2_redirect_html, ) from fastapi.staticfiles import StaticFiles -app = FastAPI(docs_url=None, redoc_url=None) +app = FastAPI(docs_url=None, redoc_url=None, scalar_url=None) app.mount("/static", StaticFiles(directory="static"), name="static") @@ -35,6 +36,14 @@ async def redoc_html(): redoc_js_url="/static/redoc.standalone.js", ) +@app.get("/scalar", include_in_schema=False) +async def scalar_html(): + return get_scalar_html( + openapi_url=app.openapi_url, + title=app.title + " - Scalar", + scalar_js_url="/static/scalar.standalone.js", + ) + @app.get("/users/{username}") async def read_user(username: str): diff --git a/fastapi/applications.py b/fastapi/applications.py index d3edcc880..264fa8cb4 100644 --- a/fastapi/applications.py +++ b/fastapi/applications.py @@ -24,6 +24,7 @@ from fastapi.exceptions import RequestValidationError, WebSocketRequestValidatio from fastapi.logger import logger from fastapi.openapi.docs import ( get_redoc_html, + get_scalar_html, get_swagger_ui_html, get_swagger_ui_oauth2_redirect_html, ) @@ -444,6 +445,30 @@ class FastAPI(Starlette): """ ), ] = "/redoc", + scalar_url: Annotated[ + Optional[str], + Doc( + """ + The path to the alternative automatic interactive API documentation + provided by ReDoc. + + The default URL is `/scalar`. You can disable it by setting it to `None`. + + If `openapi_url` is set to `None`, this will be automatically disabled. + + Read more in the + [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#docs-urls). + + **Example** + + ```python + from fastapi import FastAPI + + app = FastAPI(docs_url="/documentation", scalar_url="scalar-docs") + ``` + """ + ), + ] = "/scalar", swagger_ui_oauth2_redirect_url: Annotated[ Optional[str], Doc( @@ -833,6 +858,7 @@ class FastAPI(Starlette): self.root_path_in_servers = root_path_in_servers self.docs_url = docs_url self.redoc_url = redoc_url + self.scalar_url = scalar_url self.swagger_ui_oauth2_redirect_url = swagger_ui_oauth2_redirect_url self.swagger_ui_init_oauth = swagger_ui_init_oauth self.swagger_ui_parameters = swagger_ui_parameters @@ -1047,6 +1073,17 @@ class FastAPI(Starlette): ) self.add_route(self.redoc_url, redoc_html, include_in_schema=False) + + if self.openapi_url and self.scalar_url: + + async def scalar_html(req: Request) -> HTMLResponse: + root_path = req.scope.get("root_path", "").rstrip("/") + openapi_url = root_path + self.openapi_url + return get_scalar_html( + openapi_url=openapi_url, title=self.title + " - Scalar" + ) + + self.add_route(self.scalar_url, scalar_html, include_in_schema=False) async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None: if self.root_path: diff --git a/fastapi/openapi/docs.py b/fastapi/openapi/docs.py index 69473d19c..c5f1454db 100644 --- a/fastapi/openapi/docs.py +++ b/fastapi/openapi/docs.py @@ -157,6 +157,95 @@ def get_swagger_ui_html( """ return HTMLResponse(html) +def get_scalar_html( + *, + openapi_url: Annotated[ + str, + Doc( + """ + The OpenAPI URL that Scalar should load and use. + + This is normally done automatically by FastAPI using the default URL + `/openapi.json`. + """ + ), + ], + title: Annotated[ + str, + Doc( + """ + The HTML `` content, normally shown in the browser tab. + """ + ), + ], + scalar_js_url: Annotated[ + str, + Doc( + """ + The URL to use to load the Scalar JavaScript. + + It is normally set to a CDN URL. + """ + ), + ] = "https://cdn.jsdelivr.net/npm/@scalar/api-reference", + scalar_proxy_url: Annotated[ + str, + Doc( + """ + The URL to use to set the Scalar Proxy. + + It is normally set to a Scalar API URL (https://api.scalar.com/request-proxy), but default is empty + """ + ), + ] = "", + scalar_favicon_url: Annotated[ + str, + Doc( + """ + The URL of the favicon to use. It is normally shown in the browser tab. + """ + ), + ] = "https://fastapi.tiangolo.com/img/favicon.png", +) -> HTMLResponse: + """ + Generate and return the HTML response that loads Scalar for the alternative + API docs (normally served at `/scalar`). + + You would only call this function yourself if you needed to override some parts, + for example the URLs to use to load Scalar's JavaScript and CSS. + + Read more about it in the + [FastAPI docs for Custom Docs UI Static Assets (Self-Hosting)](https://fastapi.tiangolo.com/how-to/custom-docs-ui-assets/). + """ + html = f""" + <!DOCTYPE html> + <html> + <head> + <title>{title} + + + + + + + + + + + + + """ + return HTMLResponse(html) def get_redoc_html( *, diff --git a/tests/test_application.py b/tests/test_application.py index ea7a80128..cbb45fb31 100644 --- a/tests/test_application.py +++ b/tests/test_application.py @@ -45,6 +45,11 @@ def test_redoc(): assert response.headers["content-type"] == "text/html; charset=utf-8" assert "redoc@next" in response.text +def test_scalar(): + response = client.get("/scalar") + assert response.status_code == 200, response.text + assert response.headers["content-type"] == "text/html; charset=utf-8" + assert "@scalar/api-reference" in response.text def test_enum_status_code_response(): response = client.get("/enum-status-code") diff --git a/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py b/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py index 34a18b12c..6242a6efc 100644 --- a/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py +++ b/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py @@ -37,6 +37,10 @@ def test_redoc_html(client: TestClient): assert response.status_code == 200, response.text assert "https://unpkg.com/redoc@next/bundles/redoc.standalone.js" in response.text +def test_scalar_html(client: TestClient): + response = client.get("/scalar") + assert response.status_code == 200, response.text + assert "https://cdn.jsdelivr.net/npm/@scalar/api-reference" in response.text def test_api(client: TestClient): response = client.get("/users/john") diff --git a/tests/test_tutorial/test_custom_docs_ui/test_tutorial002.py b/tests/test_tutorial/test_custom_docs_ui/test_tutorial002.py index 712618807..90ea1004a 100644 --- a/tests/test_tutorial/test_custom_docs_ui/test_tutorial002.py +++ b/tests/test_tutorial/test_custom_docs_ui/test_tutorial002.py @@ -35,6 +35,11 @@ def test_redoc_html(client: TestClient): assert response.status_code == 200, response.text assert "/static/redoc.standalone.js" in response.text +def test_scalar_html(client: TestClient): + response = client.get("/scalar") + assert response.status_code == 200, response.text + assert "/static/scalar.standalone.js" in response.text + def test_api(client: TestClient): response = client.get("/users/john")