From d7c0432c7f51b2c9fad6e6db5ba29ce3964aa634 Mon Sep 17 00:00:00 2001 From: wreck Date: Mon, 11 Jan 2021 16:04:40 -0800 Subject: [PATCH] first pass at better readme with images --- README.md | 16 ++++++++++++++++ images/hodl.png | Bin 0 -> 6585 bytes images/stonks.png | Bin 0 -> 16969 bytes 3 files changed, 16 insertions(+) create mode 100644 images/hodl.png create mode 100644 images/stonks.png diff --git a/README.md b/README.md index d109f4d..27bfbc9 100644 --- a/README.md +++ b/README.md @@ -4,3 +4,19 @@ note: this module depends on having an api key for the following services [RapidAPI](https://rapidapi.com/marketplace) (used for the yahoo-finance api endpoints, which you must subscribe to in your account settings) [CoinAPI](https://www.coinapi.io/Pricing) +## Setup +plug in API keys for both your RapidAPI yahoo finance app and your CoinAPI account in the config file (either before packaging in the base-config, or directly in the maubot interface after loading). + +update the commands you want to use, by default stock data is returned with the `!stonks` command, and crypto data is returned with `!hodl` command. for example: + +`!stonks tsla` + +would return something like this: +![stonks response](images/stonks.png) + +and + +`!hodl btc/ada` + +would return something like this: +![hodl response](images/hodl.png) diff --git a/images/hodl.png b/images/hodl.png new file mode 100644 index 0000000000000000000000000000000000000000..5b0451f76805a1f876f0a8901954deb43f294b4e GIT binary patch literal 6585 zcmaKRby!nh{Qnf;LkSX!0y;!OkRCc30g(_!NJt1$(hXxw2GSro5v4{*2}q3YuF*)# z=o$kF>Hc1S&+p&w_x^F8``kFsJ?Fg6E8Ztu6Q*>Nl9>_&0^L+mexVHlT}uG2!Q^DX z`S;1RKL~X1qsj|89Yo3>jMsA={ogx&LPA1p)IuU3=hHnjOI~VS>mXw{pZKA|7aq=& z>_Ft2>gO_=Rc~xhDD7-d_$k~$Z(%M-4p*Ryx~cU^lt=po*{uZs#BJIHmY2U{=T|TO z&dmAk;oS#N1JdpT?gM*LUY&hY>e)&!{vBE0gs%#3-=YJK6BIl1-G3M84*@ps{@>Fr zitqma?$Fh6hmpPfcWXJ7?f-b`&G|TGSXe?pW+q8sKmh1?{hX9YB>GxJ0bkZGG2OeH z*q6i;$3-WFxCK9i{}{6qFs^Q2Xn$lQnlwAU>(#MQ-0%s5x$oRm7E=26@0=m#id$1c za<3~l?S-8c>GPMJVd%kd^ z)V*l0JzuGAvv=<5giB`DgwLcrHXz`-jPV(E_~4rf;!d_Ujw!iu(d{%|U|M8;byd}P z(?d#HcXVRH{nUeADf&K?7xMUVEa69vQYQMP(yBUvPK-riTYcvReYNY>I4XmC3JnPwVw6Z(Wh!C+6{URvTRT`=hYb(m^G?OpF ztN;3SM2?n%?YcUMkB_4j59v&ASBAF|dRZgvc}_y<$1Y8mM(5feqz zJKji@Skg&){aHOdkUGD(c!S-1IQw=_F4SUqo^1`Q1YRW!FFDK{-Y01wE3q7wm(eP~ z^$M~*+8LCX?a_dymU0x3hR%^XD*(eCI7+rMYk)zwwzpkE!tL;>Tq5`P|MOuN)qpm$*aqMMQ2S=4e@H&un>IM<6;xM44~0 z$V`X9axDfn#a0Irtt>grEpir?milvw8|4ayMIZuSIU|^Mr`A~N#>`gQdU<#S7A|OI zTjd0-Th422Dh#6^NDk*U<^VGZdGsu#5p|}m>zUkdRQcIdQ`wJ}_N(BBSlWZVFciY%BwHe8gKtxfvP-vaHe4sdzwKMtXxc*r9j>^SX3zCzvk zcR3F{jp||&H2gT)^J#OFwbJiMTDQs>Vty=ir!TFSFnolDAM(|BpU8Wgg272iN!`7@ z+#CoYPbLAizHpl=h;2U5={FtCX&q~<%2qGHG9?}jSf zs^k<241g&GQWA)HyO6+J7&m9dio3TW>7{QYH3h|%3q;t==Z3yW5#>ZrPp_-Hr`2Rh z#_|f2=IhrA>grLNChTY-gyt>TP5jO078Z}7&R_3Uh@%WeZLJ5jyw+$axw#!29Ss^* zNxo<1u*IuNZhjaY#TnNiZ#x(Jzx*3J-?BMXm-cg$b@q58jkG4vc-E?phQ{sFE7c$Q zwKH2LGh=^X+}ULi%3ucPhK8h&ke8st&6&acF1=FEY4|=;8o-~~=A`DV!A0u3$)>5& zciw0vpE$)fm^-&P_NkNnbW`&Wg9-Tty8lfVqAa z7V_}$tjuS$Sz1|JSX*~J@k3qT%40neCCQB2@fNG1c2xM+_q@GU>vU6yDYMe zB0S3!CseC3*GRc#Dn_fXudk}AI#r4K&&rBFPHADeJ#zAHeLb1EnVFo~!p%dl*b85| zYpT}PCdgfJ-X~9{0BmA~M`Cf7S=N>%OJ|tYb=P^2#{2%r%wl=D_j-5qi{DyY*4Her zuI>(ZZTNr9-0i!EJw|*WiN(aVr8b;N;!$u>y)>s|S{a#HwTPro$puvX68H6stx7)( z%GlZ2y*V5rp?)Am{xKoJrnRkWx61FFD!mu$5V0UhBJ>C@q4k<;k7)1gah$?HA49$c zZaZ4QYpe}Fg+e?Cx5oWW6NlO7=)Ap8f}$S;2M4deZkwK_3YPcRD_ALTt|Z^8gV$mxTAITJA#H`xw(|~_V%z;iJ2`VKv*rYcZW7S z2nVuP&$f0MxNV)BoKyBa&d+M({IB^`S>&P}){3MtM8sS-osB57fN}lkf+qmZ%S+$- zivebkldkUWNvArd()tI)t=(nT`$#$!X&ygZ@wV>h`^Y+BBsT_KUjXOl=SSl#M}OE$ z)L+_r@;(t?+5zT@zOG{(LY~moGmv7!Ei}@~o(R3b4e-5xm-p~5r&``;d@44FA+VZX{6!-4w zQ&3YsFP?B;Smfm8eKNgXx}WhM`OZ;hR@Rq*0QvKCAMfP_E1z;FY0}_eR$152JaOE@ z-it42I>GPz5{7M)(sFYCfI5+0?X6DBU&vIV5~QC*|NTq3xpEkJS0?gz zk|E#cpsJXh_*ynoT>uy%uU%$R#KU{wFy6sFJsl51Z#`si>%WdY=s0)tU4; zIyzK4FO!3`2UFHd9gL`x^IKb4{+KIx)pde=P=+^=OxRB!`VTg0fSJTsyS8Qhy^xl= z3w5IYaCHBcWz}?_{>Mg2(#A#^)=wHX`ljsYc>*B}R=foK_|CqLmVtMK!fvRfbUf@X zcmTV^Ejh;HCVyjnT|X#z?2Do+QcV=F8~0P6Nl4&4CyD}%X`bthGM@XOhU}7+RaLom z30RZibtj-xBNpFPUP*Fy8ykQ5^6eYLGbcW}g{4^4?5tetk`LQ5%q%Q*qZvPbB$SrA znSaj|b9wwgvQ8#4hI~!!_mq>TaPWhBca4(onC@dFy^#H_auE^cN2#di5l{aE+Hg2u zeD$l?k`1kVJZ*X<|N1pU+Rv*<01|*Ecwg37-v!e-l|NqhkhmO_-2Ogh2e>x+fWZHj zHa6PgBMUb16`{?|prqvFlhb7WKl_>o+ZrF6z#Sc&Kj(JD2?saG$Xu>kPlAG@toFV- zvP#1PgflYliMxrx;i!`G^5y0h1mK#3PMM=ZyynhsRT%cSQ!FJ)c#5=z(n3Up@~nS} zF{XV43`QzymA1P2F}AEsp=ej*k2couLep z(jh8w>`~N_HHqTR#U>+8!VbOd-4tq(DQrG6u8TS`&t5%y_6#&SI-aC6JCSRZQo1D~ z#2fz!&>dTjI>{ji%KH`W&@&oV%Q^qRnaZcYy490DC8rM$TK=LlaN*I|<_27IzS>$l zKcSK@Y2Y6pA5Tb3#M&(QMBkUiT?U4dQ&L-=l!hK3$7xJs_!Q&=0ItIbc);OsYL;hT zV#W)%D`_3i7XPetR5~|7YG7Uj4+&ohKmYUd>#$U*DDCyW6a&|U#N@bGM3%lMa>Mk> z=D>!r)a%Mu&dJd+DlJV=H5+17>DYzGr%XYX5QLTvhhqnesy|LwTOagfN>jqZga9tV z;c5o*Mr7eegN#VacU$-xl5(}j5J;H`L?ndobEPO0O69}}$VEjT^T%%{J_A2e8X6kV z8rZCI#zH-+=UT25K#B+^O_!9C!e1jy3`R9ITry?a4-D}8>qfn7%Q(LAkHs`K*#P~Q z??h+#`ubk8t6={4s4Low5Yq_fFH`LLZVvcN?L0;nmU~d=@z^xe=Gcc1`AkpQfF4i= zUk6dWdX>3mLH_bi1rBGx2u~Q5j{QF9L1toe>NNX7;{Gd)RU5GwSQrH`*&K;9f5?< zcH`D)Fx(TbxnYP#a;dxEZZmzGC(J)bOjg6mxZHfia$(#Q?k7&2p`qw+-!wA9xrJ=R zQDAXoq~yT?*Ti}>5W9}w@98bL%b7itz(h}#EvktKNe|ohe*pjLDx#$`TSAzRS@`U1 z$K3GxI;!0hG6YG214ICy?{Uu+_j)mOsv}*(V;z%BHnvK#e~J8>Fz&`2eO?t zKoMM0{zdD<(4wF9tc7|JfCIdC>HAV?IzvG|j2x__g6pT5xjyt+b%O5xsjH-r$<2eC zKD%QRf0i9DCLIedv`G*bNP%67PFrNi&s&6gFj-$;Uu{EZOAO^*o@{xvn? z`bCzpNUo@}m(kDjbePAs^PR~qexK?}_KHY&o_4`)3&!5^bvt(T+*+%4U!(aZkR6wr z+5$*2X52A?$71TfW1745V0{fkm6DO$-ru0|zSp^N#~Y?5X3O1l?c5xdy+mTz_eJ`2 zt3WfryDW1>L?woNn*a@DVE_+E8XU(E4U5k5isd!d*8XK1+r;fL8vRgx>bYs~b!V{P zuU`Y6iT>}&&%egUYnf=ZL=4LIUIy+4nEe+tx=A}xv@yyyI#Uyl-4#x=sNT?jfH$@jxi>zphpA2S z3x`>)tbB?87MGmdW$)*k2&lPnHG;ykBI)xl?aVLBfLv=8*t@uSZ2oF~5fqFDUfXIo zyI}x$(OJZWAgdUno1^Nj{yst77g%l`cU_~-8M70OAfR#u!*H>2M4{>&>b=9ZKU{k%vYaQ*tu!S2?m7ZMusQO`O;%hk0v z{CS4U_w@8wAX=3(^8@y-y1JYo5N81K?BM_e2iINw$ymVJd>N5$RrO!G_CZ%mMh8?9 zc&OKO!3DrxSfvYCfqeY@DliqR5&bzAfVZ=>pTrTFfBdjfQQSY;yKQ;x+GQuoQTjqm zLM#@8QGml~4&m?{q+~<6F@-8e6f{m0^Uia-B-36#8hU#0Gx@@hA!GJyNNc{E+|c-Z z*~7y_kUWKY`ocu2qva`2p=IJn2 zF+T*)eLa5lUTKin)V-)kl_2XyW6>1^N1(KqZ*alxI&;|DMVT4AQNA%%lA(}ri*8_z z1?u@hyRWymtIW^uQKITt6NWA(MJRO?VvE@#c7=qv73B92-lDhe($hx*hU@D5Y@`05 z*l%aN>CztPE;U=$ar^t@N>rz%h<@qfhcsN z#Noikc(A{tL(z5_=jsw`;q0tr1!duQmB*>>>9;dTr14f;4VZ z1_$J(`mi>b2=Yw^L!HRS#UM|Tu@>?a6cno`)@gDARZ7!Y9n2dKo=oBKeZx!KVbMvg zOEE4qeZ8eF|{%2&Ch}QjF`CiHBCLemntfG zI7f%s+NgM1!LEskP<>NhoQ+A!rLc;!3xV(Q`aF@?Lp69Yto#+I=$XN1iaEKtnXK0a z0?(nnJ&1QWc2PtA#6*M1-am;l{Ga-M^0mZLv(DpMN%z8HG}80(R3?Lf0#SaxQzmgP zEzuS0)8I{|t6QZag^X0v|i@OiPm2$G&S$4{y&jFBRyy?PyBri}-pIKWMoM1EA`QjNs%Eza1R+h>EFisU5ea z!I?wQG1l%0^uN}Jfkc4gJ_|#k-0V`+uU=98DlSh6aNqmO!{31WWJQa$p7Z77=L1Sx z&kUxf1_0 zC)n`>X4VX-9Rn^iYmH~mNW}v4(k6=_+mXZewd`q1ni`&~u zQMDn*Z4|6qEdjp(K&}?f(X%i_1qPA;;rbB?Nr~%-e!E%(JD|V-tLo_JxGfWe1#(R@ zisf6Xu@*z3&)mco$SW!;SS4LQ=e_2FNOL6tb*0^ooZ|4rI~}pH@9=p1V*!B$7kTrl zbu8I{X?2+DSQ`3K2*i9+NLzbQ)5xedT~3bcsI2~b0D$F=$jNmeV=yu@y3K1!mAxOh z)iXLahCR&GNT6fcb5C-E)0`cGH{slNKn(=3e0YfXaFc^WECF>!E97;^_ptN2%i=N* z9&b#sv)A@I`#L~SP}E69Y|iGw0!&Lwm?B*1cXnWMKw)9wj))Zy+!76@Hf@(ggo5$) zJ~D6WqJd5<{dua1h`Z`qw#*FrS4bYU^9*G$<&9tb%`6LfXKih0oSW;xwA_^98(cVD z2@!U?jvdJz9vW)yc=c^+E(f+8wEO1Gn_CPF>S}7`Y=b>L?=M0Iu@x0^c^-FQ0YJzD zaQ7sR`=toPiR||6_PjVS|6rj;?MF#HGVZS$E62s=A_lYTq6 z?)?5DfzTYMAw|}l-MbFBRtEfOtHtjr_qV#YYeMhhEt*!&1lifI)Y}>Qwi&@-=Nwq- z3xI$7I9KuY-f@{-8gAIQs_%-x#sQLLxH;_KfoEu!Wo7tZwj)eBVi)=T|JH( z|6XQv1h#v#-&pIZMVOq7C^7;L0u&S!vbdO#0uTOj@36dD>T#wGOL^*_E9N_q71jl*~Hi^4)0UrAyYEig*^eVe>V z>IhOGAy0{#)`4P<&CT2mC91Llf`XK7PH)4z9g3vyGKsjkBR)Le;c0Vwqoz-IfHJd~tHWkvUD}pOD9dxpE|G}f=eRSXsHy2WaakDB<}rM}tvFbLnclp1 z_en!nso%GqPOV_&=?;13wVvwUU!)rhsGgEC;tE7IWnIe@MspGxKVoFM?SY8i%z9sGVZl324x)~kdnUdO`4qYuxx6>!~rmEofXKan`N3_|LL^FBo zvXu(NBqdF+Gg=aK8!sTUCPj4iPqg;u{3MC`Wkv0D%*~i;k!|8!&u!=g1R{ERP&G9* zIeDf~a!N`E+{ZgR;Zo!qNuFr_jJexK8_31{> z>i)i@u<$3zA3m}&HUz{S9gCi$TAVIOIldB%3$@2LEmn`29fK1Xe&-+P?2aCSR*H4b zzeT6{e!d?S{55UJ+k)q*ylgw&^E}$s+XHP!%rfkLpnKeU{BUne|L~?oXLS5HsUc9% zpsAZ3F35Em65XLkM43-2%X|892?Il|#>0ByAk=YIUR5+6ji-P#38{h0fEx<_>qL)fAifP1nOdcAtYh5 z)y>mWQ4w4X!```ab0${EaPCu&5A;Vq8yeCO)QvJ<&o@B=9lP?RyBW!TBH3B>^?@Y| zwT^c~>PfsS<@y*E6$~(M-kdI;)7M^Yv_#Bf2+zoiwfy0Su9Z|*Q(*g6@W);!S8&;x zOrh)x8RMI)RCF5bg$msPs|wCASD5di#A4hJ9X5iLlD%<_Z^Ig_*Ef)ECld|D7lMBc z!pr5O4bbUv)M16Kx)~<81!afgK{rB?`D15oLQhu@>#=CpMgIN!4hjJQVcrNLlKtxI zI~XZ)MM3lYa@~T|&;ny%nsmT?PwC5KI>%0TU*0c4bRI>VNw6S51YV+ z1#+26Idae^O1N)k!G(s0=YsXWxIiKyC3U;$xVM|I=pPvQy&fkBgNR7a8N{}CwUEr{ zPGVzYlg8-{>(>zg$7r#6V#1n}o2RI}wHyBM04a1A7C~+TI9&2nq+cOE;#X_U5cwv zhTYuWj@8Mcd*74EgD+MRCdL2ASpL_zzOeztzOwpNTTD9JH2SEkx7(q%ga1{&Ib&F% zNGnlRRrAUCXX{GsoX2qsdt0y78Vy?XuuV3M8%5*{b43{b)uA~@sGFOcpVRrT z+^$mG>1OtvI1?mt&sRQ#e^1j<;9nC4FZ0);rlhiSWrd;q{rmS01s(Ui_Gby<^$@Ac z&CSiY?^RoqsFwcsT%q8Rm>pxRa zB!Sh3lF8&91j`TqZ+2{JzG`P=C8qqfm=ix#pP&aR>fWJ)OyOlW`76!-H%9mda?4Lp zwg1o$f}sQdY|QRU;FGMtG*#e5co^|&#{^yRuP?7TXrgocb+NBofXSzWZa1NHn#^?y z#`(6sN=qnI>YK9AZ+RhiV*)s2QgAQKoihg2&qNvG1@$mC49YPXlOUW8*X)&y2-IZdjCq z71n#Z$F+eepDu$smgCV{gJB*&Igf6k(lIn@#!RhX8cMVR*$+95dPW^B;MD%{@}jz$ zXG|g)|G6ONf*ZZ05F+PAplMD$zRSR7nl`vIe`adc)O!Xb=A|^*&@A#j=uhO zcXc!f(R_1rTR~2)Z$!JveeKqCY|kk$#F>PR{<-l|$oX(x>&fGKagJ^WRFcq8cnZ=^ zhPtft6DYh<-wg$^Lk{t_*IUSZxj;0ecK*Fq$ zm}Z* zJ)eQ@Y0Y0&t;Iz<{Pf9EUT*b7PEb(rFH2Vt29C}OA_C%q(o9V`E*&(Hyr)51LfE4M zIeIRa!b<5+r`JJP?n1s~4s68~N&3t8bkiigc>a?VmFnJ%&mWJT*D2jffI zFl%A&w_ZiH@|Oy*?9xYFK2nReiN8jVadWb&@Ukg2oRYJ%vxCedBcqsfo#;!YeZjKs z>?&w$Beba5h@3EMd@`cbdXg$CECgWH^=XE3GI9qpucoH9`+$Ok&lp;uNY3DV*2OwU zKhA4Dq0l!~G=n}(^&VWk47UgQ1D7U6n)9>sxfWMKr~>o77xWSs==OARK{&SWtX7OQ znZIE5lL-D`wgw_k8gjlXh#D80B5r5*4xpqZ&nulaf7rr8q~u`}(2+;^u1$YDR{z<1 z^UBD0$L`bs?c29k+>gC{avD0pc{;}my}1aY^}jtk3$s>#5>;!=D8I`!Mp+|ZbR&B8 z3SaGENr9T0`sDoFaJm>fAxYQaHm)`}ZBc7PSL_pK;b&iuJ8@9K-y-hAv`?2T{Kwj3 z;R$1<1`hGz*!aTJkmvBC>6PU1y7IX=;#c~?9Z zr1Cwo-8QW9ZAG`y@iLhlo$cQqA<{ZJ(T{K_e4r`jyx1+4W*Yijx6L*f>r#W8v@J}g8g@|D37adHmm zpYIKx(?((xVy6uAA;v!Q%vaY*S!?4TkLtD`@pu;0D}5t^*J^YMJLGaXJEh3v5+nn_ zN`G+LdUA5|=Y)H?(mI_cYgkf5C3xx|U$u@X5n>WxEN52qLub1kOy=wX36JRULW>4F-m`$lu% z^*QX%-n&53WwNrMXda(L&(0A;;ZZ4y6)C1m7yfSZs@)tKxE#-g6T!p4!O4R{z=rsN zV~5-ak?e;CO-P#nC2xq*Mt~AwUjd*%}Dd+ALjg%32cQUzY6}So<=~Te{6FLYA)$HVU-jWYKd2TIvi|_|1M?8@oZ#`} zC}`dP^&kFk`ojM|pWs2XOFK(0CT>M|d^9a4Z6}wbORNwtS<4aFq0@(s#C#u-X?TZR8*5Cj&zxH0rfV0 z4A1LF2d275UFo(~Z!xLR=V%|_c?>~VWHOEhdQhVQbc({`7`Tgsl+Rg>SSrNbGnD%x z91$G7u-Nq-<@cDFb!xh5d2%n^p!RsS{|*_F*8BMQkj!q6x0cSSpI^FtvZgy%YiL?z z)vS@u_WeNw0rNu=QM~x++1W4AYavcp*s~E&!g?nq#gPmyQ8%}bz0sNVZxt6r>Zkss zHR4Pc)O4v29Vixvm$IGeS+g8B?tdle5PetQR+}nqfo!@d@#oFws(%*w4imAYNgL)E z^-UuTW>d`Y3Zzt*^pGzjcplLsX>|8&`M-}z)DcS5zJxau|A{k@Q|nMGl=DQl}<2}HGa1%3ZiN7hw2!x-u8If8ar!WuXgMs zV#Yx}|KKI1tgH+> zN>EtRGh>o1MNT?m@mr4EG;e^IHJ1@vy9CQa?O%WF;GRKE9Gzl0f63Y?OX)hACBu1a z6N)asp1<5ov9~M)nXM_^w_zV#7NI#I8qbvBkDnBy+z-~v7F6PFl;g) zG7m#2NboVixU&qkE0vnwu6rd5`C2*G#haUI*WnPkZ>1!bqa}d)V_k|&Sp$%(&#ZbGL6^q2U=%{ zJ>Z)|Scsj$NG>`PRidswbH42b`b8>bpBRWUO0}DqCu#sLav~r|DCOCkch|^k4<?}e z>Oc~vS;C+$ri9hNk08L&31-RAy);keU(t!@dbtOwE`(-E6RDCrqMaf&;6*OU{FMIr z)#Wi-I7VzXYy3<9q?ew#QB~oge#RI%sc0g#gptCZG6v~2^D6!N9$fwp;F6>)QXN2< zZXp=W?vbhW$9<+u90+|^EOzMP|K@X3qJ_fH<)lPTnp|P2`Ob>Y4WdWOMim~X(U)_+ zhhz^&9$&9@29*-^!TeZKF=;P~8*wSlY?{!z!`arVJ zW(6cp1YX`{t@@aO(W03z=6~E8T@D45l`#i>H276iT*7OsYnlbJ^t#HkE_TQ8OH>4H zYzRK9mi(@-hw*FL9$FvIMez6ML`Op#;al;kQ-`E;i8=sY;&pi`P+93{=jdoSuo?F9 z@^c2;UHytyv-Q|jb3@H}899c%U!j7L@&E8Gdo0}YSPWd=?Uiy=QBqQNjgBUDb-`Fz z?#}|;)O3B|JZ(?Qg>!EK#E_hvi|l|lK4D>DntStZWw_nYP&<)moQ@Dg-mIMJN%!W~ z){OHH3gXg|JFT9_CO758R`bm@-JHcLuK=@2G6b{}h|28G)^!UN8rpxsp>9Af2BKMe`-^s`S$(YGyo|)glT~OHDvS7M3wPX% zIRcj}l{(;6_SkH(6sYLT9 zlCsv~M)RJ%1B63zg@X~gL`BlfOf1~xP_gjkmVUKnS!TsO!@^rsM0i8&|23@}$%Si8 z1<@W0vG;uxYv~rh?r2l3?nW~|N%!^lZxlcE|ERh~jy+0TeO6Y|&Q0e|i8zTTfDGJ0EUycy&%QcAO4M6f za7Udsbxgh;y6fOs!STElO`d$D0rJSY)>7z-w~1=vxtcod0bgn zXm2x$5Aev)-=Z%2(vxS0UGLDZ7L~Pq$~P1>k!pMG2R^skEBX=GQuD}c_802x4AE_? zrtN(AkMM=8I5|}TTf6h28QG^?LOz=Nu$g7I__#O)lhNk$!beU}M5b+Lg~ZLNc$b$K zT}QPa4ujh4z-b<8cH{(yg67_ygR1{gj#|@axehe<`ikrnAY>v44@OPIX7}#KPeK6f z6(d6jxPUl*5L`jm2D%1a-3SqkUJZB#T%@U+ySqj_MEG4OzmaTX(PNL714VPBP>^tQ z!wwG4tC;lo4emT8>RX%s>*mK1&xgwAuT_f0Gmvq3dhcJSNDych5l-Rp#QH9Ty!#YtVZ{f;F0)C3tGj<8Y@-v{AP*#JSu-8 zJ#Z=Ktl*_#F~fxZoFx{$IC1d>89>|Fbt0g7^uhj=n+qhc%H5{it{#`pvi=YD$E}YE ziAj!o3UBgc(%06zN$7HZ>sP4FRvmw6Zf;475|*saeE|6N_GV(VZ+Ng%?@PJsiVv`j zw7T|YPcdFNwB?=AbYFUD?q=^!zm#6wyL)d_3k*V7MDOKGWwiBej@_lye+*&am%^)Qu zooJYpe-~)k6D8mu0LAY7k9pOt+v70Omwglt4(|2e|I|Jk5-zWutL0U6WYpbnSq_U6 z2Gk1d1#PPUUeBp($mq31Zr(5LrHTDJY+&MF5QS+$+klLbjUnZ%6(^ys()}<_mR_RBpk4f1!_Vu7(sN}>4E4*q=$>t&EDLhQWPQdISLr_<{IZ zHP3jUHhQCoixnwXyqb~+zDxYd&Q509m*IW5QKZwMf!3RiA>Q2HY6^5rRRCJ`uWrd? zm)`dxk$6$vRwh&P&cLFs?uHk!{MU?aBev-1=vc9kRazPa8YaYj^lHDj+Rg!=c%kX| z0}y5Q9f}LjdQ^mS2Dk9!DQ`8MKgp{g=Dn8?Nsh3Rvz#k)fOr2UCDS7GN62vLnED86 z=e>kZ(&xVm)=H8&V&ABGIDck{v;21!Ktf}!hV=yom5zUD5I=adsJPN7NSOa2GkX}p zggy6bTyCYOBNq)KBv2|9>?-J1AVr;BHRUWKXi~SKUu7>o?{)dtEk2fhaWSked2GS@ zVM%b5(4uJ1q9UeHZZSrB_1%wY-l%6Pli@UeGqEplCr%(Rf@42yhVXg?Ucf1b}a& zd2b&I%Unx{>D&B3$#asGBKrIpw??BIag;AaBzx_$txZ^;pE&I8shhh8C*f)aPa_5% zURQx)9yrsTGrb{wBWQRW4%Nb%1Z50%LIqA}=Gako{2NTgUCUMiQ_%GbnuOP_Xy`O1 z9x3~`^TPoWVH<-EkU61mQrnEL<}^?!m66O(md}kCM`{?R3Cu8d!8@}pH1z5uBJMz| z@+|s?4#*}|Y=ck1&g9fdk-*-#il6kVS*Mq9qt?iY2dND!1f16rEEuv)9b)*6Nau$_ zB?Yp04AY7jig>|Jy|E7Rn1RS}Pknu2s(x>I>O`5c*}*{!S$bInMEYgB7B<1?qcEDA zUBw*%zmt=4mBhjRe&h2W)@rmW+e3}?4Iz#XLE%xS*SqRA$pA|J#>mVb_@ow(x3h(H_}%;@nvwI6C@> zGz|9+ph6(e#=ig;y7*d)!~wLz%7vIgOwh%9VJt9;u|6O9M6u1y+APUYCqA5_Mstl0 z8ZjQYaJ6_`t-frDfB<)khttk}PST_jzlPkkW`>jjBuubqZ2nqDrH+YuClM@Kd9P5 zs5Exio}4OI$riS(V(L)qMM=cT>gN$wqZNWzS)OK}ZzD?_&(?qRi6M$1Z?o5jWA`P- z49H4Vca<@H43?%$KsZWf44cRsWfw$#HXj%q+?%W70y3*xz2_JEhkDk;l~%_OYis(8 zET&k5zIPlu^f?OJ+MSDYOmp?_i2g)hY=+FLHA*Hv7nhd)mfR5oR763|tzvG$+48=B zVKBTRTh#vKul~d1<3}I}?BlF=msDiaCL|=R@9zf)WD$`vg{Qd6P}FK7?TqLW?OiQ{ zjqwi%C@3x@`SPWmqhL7!v=P8NlX=c%rb{)WwdhFc=zg3UiaKr&sqg%22F3^godK7) zZ1UFmJ=&rj=?pm@swB?P#+f*~kXCQBae zr{7-g2rz3M-KmT`V1f4G6cvh%tqy$3*qJ|Y2<6hbBG3_EuurQO;8`^K;|6bsq<122 zZR88k{3?EPa$858^vUN|Di;Zt1}80vz(M@p&m_AjTI4A3&UkzoQxcVEc^jZKAW<{@ z>EQ(ve%M5)t#wGhdzJg0PDK*Z;$nw{qUy2D;tx{_64eb*ysQowV}Ba@#56c47i-T%~od%#no})wISB zpSFm+OpiFQ#}zJ*u)L2Ch~%=V?S`m)FzrFr%&pJcnmd=^<{4cTV{@O*k~Z`Cesi2N zCM`M412km)=xC%lFSE;xxzc$71%-ffy?DdJrTR^;rZ^gpCz->^Uo?QI2PUa7Qg|F; zMWYA|`^O2BneCxTgHer#=PzZlTI0G`XpR5eRJ^bQAeczC86p4>sz2Q5JYtDOr!h3k zke$NiNp4Y-T3P9!QmV0`)nUM#nmT36oRVKu#x{{3xVDPY>u> z;?hktt4~i)BW(H8lkQB_9{1m#GaK@1Qj#oS1WNNv-61Ggfo{Vq4e|lJHuYC3~vLU!rwW&dC zW9v<%mYTV(+3>{}2!6CuVLmm}?5vrd4i8;m}Px{!gmKc=qMgv>P!WCF(`a7jOfM>_WEhhP( zUUe*W;x{eHsH<}TT+4cQ~AFJ_x`7_{v7!h6_peO zNo>^bfh)G?F6;mUVt~NmxghXc943Ct5K|S@N#61JeRw*f(OK4cp&4xiJg{H${>nX_bY(-m#E_I!RqMJh zOomc;;(^6ntlKu$AbK(Nch9N$V*MP7`}!fAu1QWNoiVJ{JMKlZD4HqWSZ>^=TVUTeiw*Pad>U2?yvwa8-#Qw zvOP%{3nC^=N6*d+r|9lA-Q3+@00W5Bd`XeQV|Uvvxkt{VUG~A&W!lJb)XTfkp%JGk}_W@t#-8 zQJ?~d$)SLrg*GxLXW7Xjj#{>CW@GE{%~vC#dc{TDi9MiEFIJa7XIRZOrnmc{0J&TD zd3_}YBux0p<10*-I02Szh)M04q>BHNDm4Pr7Ec~QK}MEL-=-1TZJ`g|>re*Egt4CY z$&)7)Wpm&CIiG`xZJip;!E8g5Iz$i-RV3Hq5hc~e#s-OixqJ?5m<__B1N<2dYmDn) zvZ_HJEg20DkE(OP%)7dT3`@&)GLM_Vl_3I*9_*t2*XK=>^^A;+Z%a0!*<-86JEDNb z$D$=&hew&6x#r1aLD6v)KeCOFUv;*zfyfRB#hlOMKDQ4`zqI6gR6L zdVI6JaGZ7@TBg?U9c){ON_N(W85uhzJg|9}@AY1RVjLHTUTd=;o~7jbOA!cfE!kZ83*U_zlnc?Q);ZAivbbCM`2@ ztFL4}E<{yRwYNK5*y-To?(9Wd^(57_7j-Rxo3P+RX+iWH37eDJYTn=*; zF*8{pRXha=JT%}|H^D(IpL!y(rJoaw-b=ixadwu1aALRU%p7ngD)dL}xdN#|zAyn) z6uk?|-iKfi=*`IR_|@oSUJ*Ip$O)2wpU=f>i0yKN%2)qPITR{slxnxTIISEbP;yD6S;72 z&;MGf5#%7_xcf_Ddiu(eT0MpNtxZ8+}&@Jr7ppZg91@4P|fG+?U|smMWb_oc1cD~ zZnxPdAB;i}F=eqeG1~gGwstz!#&VeuoBbzWlgqJl?Qz!m>QR#kY0{v2>$+)WWo6kM zoGLk78x~Nsauz&apKQo}WVvi^!*B$QYl%4|pNFCu(L!2~wqheMG@1 z*h9cAKDjz;w3&7TEyHqx+}`*45fvUD{%3wZeD+viQxn%H4^wo^s-A$LfY!K{b9k7^ zNHJH%!Xb)2wY7ROV^t-{&4J581Yjc+0C|8-8nQydB0}2@Tmn&XHXb@UI{Ziv#+hGp z`n8o2^78WLvqVMkfu!x|Rd8F8a_w2#oPC zii%QM0)>D(0?4sX_eWU+dU{i-HSj8*z3;EqI_{6RT2Qg{SRp_ebbR)9b-Xz#!{f6@ zFHz|PRzbaE57-3f9E9+&C=#NduXX9QoU}c0Qoi`mEVv%z98qJh+LBo|hlcjmn8(*k zep2`z{yn|yl!b)_*qs;z1i><{x0ekd?&vz49w|j`2y6#-@9hKS{c1HDpreE4KJxS1 z<0~=AQILEEs~7ff{!PK;T1)Ql2ATDvrEAHm#v)XDl_{k))Hg}3%eZH zs)a)!nxSFfcLVlZItTacaUFn_Bv314$VuC@bc8NjJC{mvVZ*6c{eHs+(b?JA%JSXB zQ-41mw_7rx&^I@3FE!q7J}xo66Ic#p#Jo{2p~|lk2({S1d&Ayx<9(N;DTSFAGZq+B2dyJQj+&J{AQPaKsnWZcDDmm#@ntP{=m2>589GbJ z0Utv`0$uM^RDzB|kB_);d``QeE;1sO$O+Y?BtxZp5Iv zWBTCb4Z0)=7e&(Dod8~V1= z*Hnb{ph{6oOF+eiwS%9(zNtx3PVNSR$kh(O+OP7Lm{7+3aU`%uK};S5fI$tH(bmS_ z8PV2z?2(?Fo?f;%2N|Pzs{f7@bv=R+r2ole{=YIt*DfFjKWttbR1WIzGpn`6&T?|Y zlZ3+ywOPezukhT=57srdsL_y+9GtCkB?J)(a}}HUNh-2Wm)j3PN=anH^bcF=zzk8l zdt@~AKlm+9r{n!N43UZBF};#%q#!T%c@(KVUUVL|bmqi=Ss18Mo@aw9n9;iLvo;J7 zcnoR40HrZu0%y6>VG5_PsK|c8!W}f@8a12YdFPS9PoNS+5OCnh%F2Qan_BCcDL84G zG&4L5-?)BDZ4Wg#0#cQ7UN4eua+VX;1Y_;9qAvj#g-0c#sKiP){qzeTttv{*G z`@U6=o?wMiCu*gnkU5k<`_sNUr~BNNR_6q6>kIN{Or@lv`t;?C-`>P;l0*r}r#=~J zNm9T9(gg(5dM`Y90EzP>-O|af4`I~;o98g`XPE#V71eO$Af;HdEf$Or94z?yZ3b`R z9=Gyk0<^a5v%{0bNS*s#l+gWegQ$m_8imP7a?kg~qP~FvauEDM<#XeEewb;ZYjPbh zV*D+gE(M04BnAgl=NQ2f=Acs%`aDo+l>A6x`fXUF2EsiQP~f<{u*FQ(5^^RcNPd3l zi=EhfegsFyVGE9c50?$)@G{7fb5)VBboVYm03{o`ynHxMzy9(O32dDS*g+6wUX)s# zm|!YjI0U-X!{Y-b744@=Vt&?DsUOHmj>X@(-f-5Jn94>G@QeWL^Ou9s|KY*wMS2iK zU5+k`Mg@}^?>{8fCt&~O3j%{YrUG$Uf+2RRtHdaTx0rs)MKj|yk{|BKmPP<1O5ftX z^jKV6yqRet`~qrfl9UQ4OHNS{FBa_DqKy9Kyt7m$XAmg4hE;RBQ$=ujGMQ_u#Jvle z=IYp>a>gXT^IfVV2bc;sTYCLyd9`6?a=O}0r~HL5qX7*JHo!1@rkF<5A6XgkK51rp z${s{|@VQ{e3lu4VvnRt}r%?h7()G19en6Dd1@PCGZ>W#Aw)(qHH|T6{A+a5)HT&A! z9e`wi{L6<;Pfrg5uCq<>w~@f|tUxFXQ0gaC<^3dh_qNti@lV!~p0!>>dZ~b(jD8)0uw9W@L2a zW%_m`2d9B(?;xVZ zu7tBn=Qo<;uM>R09R#C-qmZ(;KZ_hyX$0QJ#+VDPN9%oMqUpvUCy(;gMaJl0iYwB;us&< ziE>krU%F5VHyZytK!3Zfv0O?-HmdUq2fm7{Q;o@MyRVOlo&aMxBlhhJK>N96A<>ra?wqb2PYJPhML#B z$U>u_Fe`Bc_rD#gR*|~;kLusOA0pHkb7feH$n;Q&i3vFKivR+>% zS_k5)oSajp3LP++b^8X5arX%55CI2H4IAnHFnJoNSVJ8z3b zhQhld_yU+muE_I$am)PxaNS+)_^-JdAC19*v^ zuRH$Jk4FGusGr@ek`j`)GoHtaIyzC&U~DVHCypy`oC0GQ$T;pZ<}cnPcGS|bbssSgeY z1_sPc29BBiSz1cp$w(0uv-<+JcVsbdwJ(>`bUJ4-{ zMb1b99X%P3Wc`=1}&jK{>inE=mU1!dbG#*hfjd6ODje2@?PiVjjNuTK!5?$Nc>wkKkw8KrK zBAQt^Wszjbf`g0|o;!7IQ==wVG&LM$SwlO+WO#?)m&5p@Ol#^N>r2a(fplq8$0}$k z9cYQmD=G@g%QFC9Vb>{%r>BQ(4j{SQ6?#XHHChlJ0H_6MlZz>~EVMkY`QL%e8F``Q zha82sev$~hel7Pt<|?kr#+c{@8$n%0%%{V@x`*e12{F=U&58@a(CR7?5W~{qBdz(z zzgv!vkBcA8B!PJ8+x^KfFh&BZfGD^QNMhn59s`f9{R`&PjPzgr0+;RSh3wlHr|SoI)>pgNT08;8rn^ zxPYIjTX!Tfb_FPk88c_g%;Y39$kzZ38iWQatMKEig5Cr{0n;%qBZJ?=1C|pNwXs`h zWqXh*3Zx;8+d!4S|V83=GVm zq$CP3Es?__g~HbA&5YmdDzR6ha5ix z)%kwRVsr^40(bwS0Wf>Mi4hGVTS9QYz6sQr6tWq=a&ll~Wm^WsCdqVkg&e(w97yb85q zfcEtmQ)jD2i3>%t!+_Z=fFmHWx3@RKmf2%8w}+i{>^(iS7Z@D;ONlaFycFU<%o1sD zC}N0Vl|N+xWT5dTSNb6nrVk4A*9$QnuQ@y})WX}4XKTGFP#0ZMKhR^vg7JivR&h7C z`l{!jq})>=`@t|K?{zs`r+OHDkfv2x<@k~}03j1Um26|6>VmhoaBEn0QZ6%;>;ng3 zvjy|y<5>ZGt8TyNIo)Z22+cYF{)hSz9^oDo)T^79-wOcnA@!54=k@sn^T(c74+|x5 z+xmM7J8F#V5}RT~?|AaM|&R)+<|* z|8e~zLL^&GnZ?ORh|??kBwHtB!D$R_A6~gEvPV|!N01vgK_NMQFaJ{qQmO95l_oJV z#yO&GKw-I7!5?RBEq1=ZjEpMqoZ-2Q5?lZHX0EwWM|X7Amp5Tx;owf3&G-8D`dz-% zq<`-|X_^yyT9f*lN+pio>a8nc??bGVi^GDUoq|+bSLpJeZyTwV2@tt1y1@lstbSBUE>|eN)t8)o0sYxb$`|x zHqN3%n4V$#If~_vYe$krl*kzXTdg#Z8m literal 0 HcmV?d00001