From 2a48b10be3ab433af91540f98923efa0f120780d Mon Sep 17 00:00:00 2001 From: =?utf8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= Date: Mon, 17 Dec 2018 22:27:26 +0400 Subject: [PATCH] :memo: Add Python type hints tutorial --- README.md | 8 +- docs/img/tutorial/python-types/image01.png | Bin 0 -> 17722 bytes docs/img/tutorial/python-types/image02.png | Bin 0 -> 47799 bytes docs/img/tutorial/python-types/image03.png | Bin 0 -> 42872 bytes docs/img/tutorial/python-types/image04.png | Bin 0 -> 18604 bytes docs/img/tutorial/python-types/image05.png | Bin 0 -> 42637 bytes docs/img/tutorial/python-types/image06.png | Bin 0 -> 29581 bytes docs/index.md | 8 +- docs/tutorial/python-types.md | 289 +++++++++++++++++- docs/tutorial/src/python-types/tutorial003.py | 3 + docs/tutorial/src/python-types/tutorial004.py | 3 + docs/tutorial/src/python-types/tutorial005.py | 2 + docs/tutorial/src/python-types/tutorial006.py | 6 + docs/tutorial/src/python-types/tutorial007.py | 5 + docs/tutorial/src/python-types/tutorial008.py | 7 + docs/tutorial/src/python-types/tutorial009.py | 7 + docs/tutorial/src/python-types/tutorial010.py | 16 + .../tutorial/src/sql-databases/tutorial001.py | 1 - 18 files changed, 345 insertions(+), 10 deletions(-) create mode 100644 docs/img/tutorial/python-types/image01.png create mode 100644 docs/img/tutorial/python-types/image02.png create mode 100644 docs/img/tutorial/python-types/image03.png create mode 100644 docs/img/tutorial/python-types/image04.png create mode 100644 docs/img/tutorial/python-types/image05.png create mode 100644 docs/img/tutorial/python-types/image06.png create mode 100644 docs/tutorial/src/python-types/tutorial003.py create mode 100644 docs/tutorial/src/python-types/tutorial004.py create mode 100644 docs/tutorial/src/python-types/tutorial005.py create mode 100644 docs/tutorial/src/python-types/tutorial006.py create mode 100644 docs/tutorial/src/python-types/tutorial007.py create mode 100644 docs/tutorial/src/python-types/tutorial008.py create mode 100644 docs/tutorial/src/python-types/tutorial009.py create mode 100644 docs/tutorial/src/python-types/tutorial010.py diff --git a/README.md b/README.md index 2be4bf7316..00c51f8e2e 100644 --- a/README.md +++ b/README.md @@ -18,9 +18,9 @@ --- -**Documentation**: [https://fastapi.tiangolo.com](https://fastapi.tiangolo.com) +**Documentation**: https://fastapi.tiangolo.com](https://fastapi.tiangolo.com) -**Source Code**: [https://github.com/tiangolo/fastapi](https://github.com/tiangolo/fastapi) +**Source Code**: https://github.com/tiangolo/fastapi --- @@ -90,7 +90,7 @@ async def read_root(): ``` !!! note - If you don't know, check the section about [`async` and `await` in the docs](async.md). + If you don't know, check the _"In a hurry?"_ section about `async` and `await` in the docs. * Run the server with: @@ -290,7 +290,7 @@ Try changing the line with: ![editor support](https://fastapi.tiangolo.com/img/vscode-completion.png) -For a more complete example including more features, [see the tutorial - user guide](tutorial/intro/). +For a more complete example including more features, see the Tutorial - User Guide. **Spoiler alert**: the tutorial - user guide includes: diff --git a/docs/img/tutorial/python-types/image01.png b/docs/img/tutorial/python-types/image01.png new file mode 100644 index 0000000000000000000000000000000000000000..963dcf4d80b21620c49f00a1868c1b02301cc46c GIT binary patch literal 17722 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�bQ|eSR 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 G@IL@BpS6zw literal 0 Hc-jL100001 diff --git a/docs/img/tutorial/python-types/image02.png b/docs/img/tutorial/python-types/image02.png new file mode 100644 index 0000000000000000000000000000000000000000..1477ea10f83ac866eff40c2b1dc371d035134ba8 GIT binary patch literal 47799 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

qkW{$2F@^-!cmH1V|DsS>2 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 literal 0 Hc-jL100001 diff --git a/docs/img/tutorial/python-types/image03.png b/docs/img/tutorial/python-types/image03.png new file mode 100644 index 0000000000000000000000000000000000000000..d8228a3a127cd5962626a7bbb112fcd9f154be9d GIT binary patch literal 42872 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 @Gu%Vwith+%9hz0ZM?CflJ*EUmSYDM;W zVt;tJLI7@X8?4HrCO%#h#Eqz0kJIhAAE#4USu`}!mS)`Ro4-xaGLbRX4V!%)q`!Jf z^U-^`-2u?a`1p7ws_H*>)Fe=*Dgn*<`s2sD|J!1RnxsI~5QxUViN0y#joEm{cMSSy@mWo!Wwef}9+Ql#-}_)OZVOBvU6DAKzE^ zS3RLt>;#mA9Y!E)5;nzcLZziQE{;qtoZcSx1_hxMB3YDP~W_DT!FdL+dVi-D1T9{=(Q?l+h%xgs)kPD#nXg>{(o!IOXA zPEu4*@Cg_21N+mb@#s%;NXf|~AM+oJ-iO@oG>e1)+h#x@TU+jKKf}(m%gQE9^r$sF z6c}O$?76tOx_f$zI7m%8wd3RBbhNeGySfAg1fB$dD29%Kap~1mSjZeLgNZS7If=vK z_Y$xyp&V7EET2(pWDtP?qUGV01A$d*NX2*SmC?@nJ1u$ zmY|6~`ji#e7pfd(xm;;Ja}nGx5U>6?K`rs45j6AAm!el+S9fP=sj#$^0uOKA1QD|h zbnI(g-Q0

1q3^Z$7`XI$~IGC~r;|TMc<_r-o;iz;!Nh8!b9BFfsP^1lg~>zA2Kq*mc)kDKwM zm_W`wJWZga;27g@t^9gm$-_>4Z;VIl-?ihF&)>>X(iI=fdy;;y=NE<{Vu303EXatM znD{nvcf7lsiJ6(~APW9;GZQ_rY%CCNgx@YcnU@T1vuc~198>o_>L9uJ{Gg{^m!6*f zC>=Ne&;bxLycdjU0|W#GL7Ng&Qt-*#M<&iN3YGM3hloIaEhu>V_FFoam8$xfm5@w9 zX(^c99nzlXJ_%6?l;TW;q4LUVYHEs#M84|L@$u{1+sliKpA!-m#>X{ORY5AsDlSe= zOY?L1Wc0PJPU^l(xsN!*&rb}9nSw%z?J^0w!R~+FVgkGWXRin{GD@R;!?9Ve#K$QA zS zPA<;MT8?E@rlD27-MMeDnY`QnMhC;`ZEXeLd>ZrcDGN*UrMbyM{nb&IKIllaOpr-r z&-|x>vqW_R+5V| z#M)R}52Xo*;XFWovuNY6F<6DiBh`1W>*Ok4u=z{|@^KtQAU$~Kk-`M=eVPfi@>8~9B+ z|CH*AAI#OW(vncrC6}Nj$+_ zbT*(4SY9a)3a|yHIXE;#8_RrrdCi z3TUmGT5NLi%-!uZ9+ZrX%*V$E)YHJg02(!Ru=ByZu%RK9yE}TS0k>)QXD}8UL+R&^ z=#|LY`ud7A(d$F$>9Mi?HGN-zFz`;@W@(Nt-{l^jj<+a!;HS4Z!z%XDCQ_-vAK3UQGo4!o(V9?fP z^MRy{j5nBVOoYAX3%&`dsZ~~^=1=3u2?;k34qT5->7bTJ%aX5OCm9(n0C-9IO4`?h zmr?W~O6I@EcMo~@t3QcxEdGEmKKGbn2ggQ7QzuK&;qU$Xh63Un9Ut)rHrHnq2nYz& z)YM)gqTp9i(firjlbwlDEG#TLd;7AoG9N&oAgO%(h{$Vy6V$b$rSaQguI`y2oj92F zZEYsQ8Dd}{Cd>5u`undYop+yUp=EygLTG51o|9vGekuW{(%8*A))18fni=E3qwN*&`eW{jT9kw{Pc7=I{e(6oS$`d>uYPY0V5-6 zY`WE$>BpxB#-amDZ)fM`K*>IO^e8*q`G#E|2R zZnbTmDiQo36Yj{^n2_UgO-suYo@8N@&TxKb^K$)q>;ri_qvswQgQ;P}&xk`LjEszI zd3I_RlwPhOJV^BO6M>?k5F#AP`qW>)NO<@e>3=!`H?@P?!l*nlJ3ITUEeif*)t^5v zerI>ZC{vMPqBOObaspkIp&NO*dDmxtKTbFbgZ+&}=2ft(tE;vkta^`As%KBRra!N* z#{)*Oo4tqtGV18)sHC)CWigcT_e>mo*4*j;-G%Y1v*k{6@Uls5Vtl;x^$(BTsS0A^ zY^@UQ=Z?!cbM>xaq8*HhVrbDa?S9VhRTWv5%Md~67QMU3w!O+%PDep4{|=<1n(}(D z#t1~u%?dR>_)kDV`y1+|geW)q^YQ+*7l2(@`1a4%i=`#Jm98j)E_^ggojWpx#64Y?4oKW%hMcwX_%$6)vfUJ}Tvd!g*CVMkxyF+XqaWR{!StT4#%2 z0T18)hHra--%DuZ{O2J$)uzT1QguU}a@i zp*@<%k3%8g0%pZ+kFGvNtO5gI5Y<9;{4J`1WOl=*@87?3@bGB9%8c$=7DuWNo?>$MH`;26GRuGV7FD;f$WKVHc=HAlWR#nmdwovz`G)KHQR~^B zAR%Ev6qP9a(GG5nGIRnU2lmDl!`Be=M~`GpK>vXmafsx3wkw6Uw!Xgfpac(!iSmMh zfdSyH)FYbt)q~GZI%a2Y^3#2CR13lPDJm=1R8(MNV6=%+JU0%Aii&#qMElztBP#lq zm7}KnJ5OKV`-A3tB_*Y@>gu!B2S;OUS!R9lAj3J=&i42B1M3qDgm*d$=T{u`59gU( zml?P;xFI=Wq2CM54JNM6j>zyXkW^+&hy`>8(@nRX`1jtpi&Li$#d_!3M;%^fczNGW z&&*`@Be>zb5n+OeEIIJ@qn_6NU9ph~F#0%g*7>N`B8*h0Ow)%zx*v*Gnp&IxBl~DE zwVa>g87adDe_ZkUu@!`-%1@b`||Bt_iK72K!g&H5t4RP}v2{P*rfwV}YttTS? z{g}T;KL5ThhBK%LArFxJBxvwL=#WD>Yl?|F|8Cn@TtNi08#Cb3M^<*_+h0@srV|wr zFQWK#S-&LY$HrEK;f;?) zIw*%MdT$=x68&Q_Rq-D4Dcz+4%(U!Nu&4mS*lR) zsx+Nqb*jw49|HqyE5DK6u0)B_1Rx={eniITczD%)7>Kd4vb=0(TOu7nE}1{-dwZ$^ zCW<;8$1o}BW}8qIn3(=&=n#=_|8L|_w6xRq_XYGZGdK70WT;ujJ}W1Okb*)@Lj&%9 z#vP%Hiy8i?zHyl9H#c6s*LxBg8gaF?WI;wfJXyqfG62tG76{}@Hl_tyYuf_@s zN=jJCBY4ci>7fPRzpLx&>VoTiT=pbDK_OgT-tb8PI!3yun;WPbVB;E2THdCl)T`_3 z9sn8u+QK)VbXkO$2K}v0_+4o#r>ClES{8~t&X*pYO=Fe1ur=nv_>=Il0f#jMrlOvk zj{0D~LEyL`)ksQq%+1Y3L`2;3%elCGcf0J2c*LSr7IUMnq{PO+P+d}j3Ew|Gc@A%G zh=j3}loVi46O)x`ywPo=>KeC2K)c<1o*StSVk**d;6uOu5@8fO+CFEfFGD`S0Vv`A8O8jEwu%+ zFf&sJ1VA&@Ki-|Mxt(rn$jbKo&XxvjDkm>bCG0UfJ^l3W@f*;6kI2b)_x9X{e9X*p zBO{e$dy-x8K>ocz3?9t`mv)K-8bsO+mm!o;O*WQ&Dug0H*m4 zkPpZ(hCcj-MMZLzRD`iTT%4REzkg?{FuAD%0+FQ~`MVJb00$de)m36mod83kLiLXy zxvGWBy7zdrQf}_<ETVVWx_D7<~k z5y2Cnl)rM)55OG$#JN;K0J7>@lOST&fVpaDsIRZDBTEt@QCnLJSd=&lHdXIB^a+pl za1GQoO#qvI9U+zPj~YzzxxXhq1rG1fA@jkM3xCzTU5QA3|v7(Yx? zRt@(!-O;Hf^jV?yJwm_qqJ+{gi9=AHzz?=VKH&vpk|E|oTI%!i@+L+`p4J=CZLdG9 zGvE;_w({XN={J^d3=xmx>UZfoctxe`J6*V70d;XXtX z@`LpL{R=9puNK7ra6S0M{rg%J_Xn1Vi3{JKLKj2G)H_?INot7j_Ynga@TV={(x6v1 z2%Tb>Yyk7(85CN!txz#YlcR~oqiINgtitpK^x`u6>fa)Cd+?9Wo1Zrnql;l8ynHC7 zMxuoP28|x?cBdS9lCcu-A+jhaS1}9Zz~WQHJdq((Q~tkLPHeT} zszUck+J89dT*&?Fc*4*CVJvVie&=dhuQGV> zN=dT!WV@utoXv1(D&h5emU^KMm{VGG-DT-4h9q}lvs+iMeO6)NZ{P;%>LC2xzV@z9 zR4}*Q^*vm>v;F$@YqxO)E)?VvKma4d!xU) z68`4R2Y>t#7qi<}j{fm9w{%hV=>~TK5QR7}?`59gewK0AC@w88k78dW5Lzt#$1H*0 za9t#|{(8nr=#$H>wqP6(q3c}_DCz0xd)&=ESO2aI`~9!> z&NHg1HQnPu1sp}-97I$=u%Uv2sPtw;Mf3oI6p<1EIS2>=0#cKBK;;M`Qbk%0Nbfz= zARt9rq()i-gx&%KNFXGcH{LaK=d8PC&D@W7-N~oTV!iz-zkl}LPvj^=rJ|g)j&&x$ zsG4IqXsPH~z-L7XMvKBX3rJh8isGIMpMefpWJvKjr1^ zt-bvt7JY(%$mb*BH_v;Pi98c^0U$Xipp6G@AooCOkAP4Bf!O|;>p5{suvSFi-wta( z^daEcI+Esspv_C`+hXh8nJjJic zto{Da5ncbh?BArv+;53uCqHZEz3I4nvGx?dw43muTZRIt)sH2PU(>?W$RfHfz$%Zh z(f;1YVJ5!k{e0}t{4Drnf7JWG9K3l0Qk;EQAZTx3h}m!Pd-T(8z48;(-8e6tX8Jl+Qux#!9-%XW8P^*h3Q0C~<0PKLQDQg6a=7d8RL5x~!P>ug z@SPTW$az^~GMLGrX>ImD@TL%%3%P|j)=nT5uf<;PU=zZWSW|5ZyoZi^vbJZ(JUY@& zYQN??`mNq1*R;I696)Bk&b))Pv~-|kFDZ8Qi5AEoBTKC zlB1%c;^Q9~8diBs*YssDF_QZqVO^2SD4+@p7o>Qvd)^nWiu5cN-1}C1{AK2K~sOU0$ z&8h$V&wM|Lt7V8BIl>Kn9~YKM6+LzsX&xu&`d8b$8>Ll}se0P)+#!P>!z_4W1+=9ynb?N+`zC?b61$n&M| zYttWK{DGW0teXNDHSd*5ck&`yJ%GO2A;meyun-t(v3&pM1Q^o_Kw+^vuEq*lZkgOKO^DlSQiRv*W0yNYvH-3`3C|Yvvvvo z0QEBQG??GK{eP_}COaoT0I{4H(;O<-CWcx}53jSjM(NqcnhcnthIcw*FV#;)-aCQb zEe0wz4@lPeUhIvO`^sWOFna5|d3$?%AW8Fca)`CQh??iiry|}1wGoA|XKXDC2?+&B zX65JSlZHV?&CSg{-I1QIR^vG@X0ETVZ(Zp&aSo$#@}$jF+fPG7LtXI-p>N*2d3!Ts zrYpg_Pfu%^PzX0P>=}W}aZ2h4?gOGyWw|UvNNQBwrm<^NRHZ}}0u;(|9oyA?v zceqO;tYg$z@n8?dv{dZJt7Ovl3aAV2gBlvzfUqtjBf#3m7j7;Moz~E( zOHH+%?M?#pP|w^N@jy^l>e*(Tr?iKLqRtuQkRCAy?m`7`s!q^vzZ2^Lnij_1Q36RJ z<^J46aONOZMMSUBdx2a&4HRIt4| zt~s|tkAxjRdpkBNN{#arUWuiVQDlVs%sEUo$i_g*%F4>}zq)bg__e14IRg=;z=uAn z(eU15UbL;{5fBP~+Sl;gUS4qhAtGWTkBj5Fve~+r9j(zrwnE`5#CkNFYcEfk%SeS@ zf+C5HqFl15076l6e@IA3yb?S%HntkL|3EHDLfP#x*hRs8>FMdk#l=AN90-(DQSn_J zhqB4_dwO~ZFfpBTs%!~Zf>TL&}e=A?)N9Pfw!CH zw}-#Q$H|jhMBzRQ*_k=Hxv>|wM_R%}Pm{s$j(vTuRra=kI=7aFsEr3pfmZ(MW4so7 zb8arKL$2Ny%z#aA)jDwC!1LwdX^?G6QikHHo^FT77YDN+WOgOo)7(CIR7hx~(x#8g z>h;#0l>{2iF+$))HTjhczC(=2c-w%N!x&js6jWDB?{9?ly|a2gWDmeJ>9S2KVjt|r z-Mb!XM6Oj7cjEPl`&l#Bo0F?38Wu%%)6M2)7-|v}D!4n93X@Q-bZB2xLI${@&l{63 zb3v;2(DN$x69)Q?UCvuEA8zx`+VjC<gg;5hBqOg~f^4+byocRRaa(}*#-dMbH?PS5k zdiV_6i+PXH7`Ao$EUK#7XN8ElXuaJ~iV#80#0%^``SKZ2%?rIugUg`hnYS|cLg*g5 z(8Ky^51M!%G){|1(GmlCPLHYW>JUR5>tSxr2~uC9ExJ(nEG z-VL%c8WBfqJ-ejgRD>?PO7h#med2+mm+JlA?c#mm(`q7M{*7S%jcKo+BQxzY zW&FZMVCKnK+u@9oz&1K2Rx>(2+TEHk!K~p+V6!@D_ozy@usb&_Pz%#a;?|JsW}n$2 zlb>#At@zW3?dwW}uI%uT-}UUd(GPtnS%`CCOB(J-qCj|}(?H(WT@vY-Ig0f`EA--q zI5jj}Mt~c-I+bMSZ=c2sU1f;O5MaCtl?Hg&JN%oAvs&!Og8OcrRr6S(kF9yjoz!$~ zY`fRZcEx^=o1-02(oiPHh)**T6*zPF`gEdNrKzM<^x)ji?hz?=AH9XGM~9#*twy(6CZCU#Hy>ZE0{4g z@Zaqn)2gwNJ=bcL>! zk-j$$^1^N%*qVeA6S=rTGPz_ECJYhLLN1nJ}8)pUyUHa>}ufvC)>riHI~SVLamn}DH*8CyLN-3PUN zwj|yN185HMHc{b^k(1>@Dz(YH=@?hYCKEy@Vzw z(a^q40{-5M{RQ@=6bG-Jw3D3;m z-LW_A4X4K=mmWnMqb7;3v$C`e4{Z%JM=x2HBj6LCT~A+8OYFNSpWQKEH)$uT&cre_ z^XQe=GR&=_7lkLz#6&&>n0BI-OVSNw61M?E_YvDi#!JMCwL&cHy?mLuZSO*4dZ^N_ zy@O|;cF&3fgcGT%mcv~=B}Z4sceLazG5(Uu_GX?PMc4~JxWsTGYfjv-ONzsMsXP1w>Dv(LJxq!kqvrKGl^>9=Eo1^WB@_d&lyxj4NyhfL;0 zqnOovdcQkY?ta=nc+f*TWf**-iex!?1EYxylzdqBwC7Vei@3cPvWEoYVxPG5sO)<^ z`?EZ1ubnNKESi|4`1p$o_L|H0^>SLWMF}gW)QDjnr;@7bSy^lAZ)|LAWi@tA;(M0i zr=e2VL!cCJNCvBm9SeXPAaD)9feAOC=8$@Hw@%V$@z;e0eHnU4H23wFG@0?2Z^E_C zUYhUxSMe-R99@{BI_1W3Bjwj~b6FC!I)AwRcEaLJzs{{Mppn+aTJQdVw1Cue7~0?X}W?I!gcQ1=vyr0M3O68B%A@0*v7K=W56Uz{=u6BLSu*b^0`! z=ua^RSUH$)5hQt3eli%KQ8i-)12`wku5|-!HJPmqX!J(PFsBSBp`Zll5dAneDmZ14 zix1rr#ovX8*Uu)y@*c%#IregX!9m`xpnfJkH`4&!oBJalH&4MItv3wDAglRsj^jaa zxQ~m;S|s&qaC&*C&vM-{?hzu>q_5Fd7k&$g}dFG`H4gjsyzzTOH zoSmGk{pQo}pDzO}19l-ZGxJvUsSDXA?(XhS4gwv4*-iuE)<9ieqr}qGbZct_?oCN9 zf7}pAR!>8-S)BiAY#J+z0j)IC`4ONkAPI|>%b`KCckkW}2@e+te7w0Z&+Vig_cdZZQ{L6mgiA{= zU~uY@40WRtKJG)>^jCu4StCC1zeScJw&>rpr8O1{LHd#o5Qho79B9it%wJ~0umvip;{hkh*|wb0-C;3L%Ho*>q=s6;72FGscvkP zy?nXv++mJg$m!~})624Xir-)qO-xM6y(vTridJ(-RPn8)r>EHe6bKlHRu2!4Zq>!S zw6xgy`FX3FUtNio9#cy?63FO}Lkb!i%(A}t+fFu&E%C2k#ZSTB^ko`g3an~SGyHPa zwUs$Je!XcH-OA**z=Sw;UjbHcL_%J`PZ6LEe|cagfwilg259@V;-hgF02lG{3lak6{*;#};0yPLM4%ztfFFiemHQp4|bc|VHwNwA> z_l8w3g4IZgeMftHyEh3*GeGb3MIeCG`r6h;pO&NCyK{%WS%@yRZ4LqA3@lb-ceNh` z=f=iHC8EzKU>vQa2_X9XSE^>?oeQdfkKNSK;k*(z(Rj=HC}dUd@IZ<-uMQW^73`7f z0)-g?1M%s5%b^7RxhrKl9;DiOgU|p-|DRLfWQo_nfC+S*8ZrJPIx^Do;lnv)$Udl` zP}Nf|`lIrvJ+^GtUW}MP@M4Y=KiatB*AZOU-kPwsB{%)jFKM!ww2*L@)eX{$%$S*x zg~jq*gKjPmcK%yS?qZNVoNW~0|97!ou*%^$eG4eB7o75)xZ|3f`yJl^tpE7i6Udc6 zWd8BOiVFfF^-Zi8zC89cZ{aCaCSg1b9|JA(}F za+|#Wea_zZ>~r?Lzk5F152wD=OjmVRchy?YdY;ua<0mUEiuIJ}DH<9Yme^;AJQ^B$ z7aH2VfXDZNBd#f;-+&4oDkP@(`0-=JqRayD^|{?ARXYVMLp#T>wgzYl#`bo02DW-X z2A`mzy+#v*d{lIr-kx>+pkRNCv4_+Ah+F6p>xV}hzhhqgUV2#fjmTfu-$d1iT7N+y z^~w1IgERV^_0TM`y02@iV)>m9`ZSiXIG7)3e`fOkZGN9P+J?B<$NJIPrQWyn`{-?> zb48x7jQG}F8|DvZPXy=P9WxCqETqux%3kNi?$j{XD7&Qv?!s9Y^`QrmfO3y*;oh}Cnlh=q z*0HxAXU#_fRlRF$vSad|;gyt=WU{MMqN2u|gdlMB(r}GB21#9(&b-`@s@rAoMT#zq zjwSQlh64d3Ft45CGBL3^6ITrx8my^nn*JAcr8z3y);GpuLmQxk_0)RBjMT#{+g!x~ zX;L+;o^>wGDT`m%`5pbIjn)_Dqfn2NtlZpsJ1x0_{pFzc>9*_S)c_nz-+E{A9=(q{ z@9PTD(f;UURkjlt^~G`Mwmv2%j_>a7UhRnn8&s?ziDli}SA8B)xqK6W*gJ<9NDR+Elb_FVF>1x+J_2T^&cKW_J~1IdQ&aP5Sc3W3 z^q~{9a(^e^4p|hf^9!z1I5yDYa^V*KU71%gqt~y|{)?v;9;kZK$HT<*0|YYSSS?MH z+QZd&ReqRa7BvR@^%y1QaN%E<=UNs-5KM>dYG(Ba1d0th#(qM=GCKV$w|h8bH)xtE z3@_-Koz*r>5Cp1s-WZLCDB9Z{Zry_Hm3?-4C#B$!% zrmcaKE8{6!Oi1IagM(M790%t28Py01PyV;2+efb)WJQm)Q2jXZCT5ZqQy2;_6tZ4z zU-2Kw3V=%TeVCravUYtp`oQ75E>ooCx_eQNm$61m=J;-ez2f>q?M^hxiYTg)vGz8B z)=f|A(}kleWvag-MBkJR)uU49bIipx_O+XS_>?5rpH3dPMB8&qHb&c}dPufmX=BZ7 z9Oc9yrd2CKz$qgfu&#Myw<88{TTwyuu0rS0zp3=H|MOc{-2p1+gmvTjrGyQR} zj+Hh?^~cjv?H2b>_Nd>0UmwX@^*!+m2?5)#d{$Favr_r;yBbn@I2$-iQ=TZmZDI7Z z#`4D}39OfwmgZ_P`;CkoB8T3BWYZ9cN$N&UP9B&p$IujeKtfA^!~Qr+tM3Wn^H)4Z z2}_!-&9`1V`N`Z}KC>s5JNz_sy6>RIr(w=IOnx=3Nl0>*pAwKR9f)LHImL=GR`|_f zpcp;1l={%8VoM&<5)!V`ccx!kN1a^{w==!!`jrTDdkbXd2nle{R-1pJZ?=b1P>NV< zC_8;;J@K)id!NkHwtIB)D{<8UI`b%R#CFB?`}jiyMe6!PON5#+9`5S$%)X+Dv%|-n zk_^&Q86!>XpU(c~a4I}+4`F3QL zluDpsgAtT>!;>%LipRqc0)h93^3~^;$%xd!1>bMzFTPLCX13U^c;CZlE^2NbL!*+0 zoiE^A*r%GSPGEn0&3p*I&Qz?hTbj0C+-&HvOei#IIMItjmDJq;<<>UBz7OY;92}Bqhxb zk)%$2=y1`;QU`Zf%ycf=nbV*Qoa7x>KAlsGb%dC22g`CriL~Y2RIS!BxG#oq^a{Ip zH+{a@DQf6F2%#&4FE?^%#>2Y9EiafPaApd=(Di`TqIPQ;W-GOdsVRoL@yqNih{6Fwi%}3zkxx35Ft%<;#c?$+jLvn|S5w4l+HD?Xrd42TGshp-(J8GvW{N99 z4)QvNi3>1rzJNeuNjHY5!V!v42os(b0<)UXw z5Tp!;Sq5My&bWT+Xo{R4ZeBg#RM96W%OlL$Sb90tM*mc=0Tf`o$EQaMF``h>?&)k` z6sw0jK$E`v9?H%pRYV5oJW(PT%Z%oTQkfNNRCP%GFv1bwL4UQ$t1#hIS+{VKL6+32 zOs4MahDxCb-GIM6o`!ShG`-j0)1qMAcS+Q--`Il-v#L2Xon#+1!vm2l4%lE%#PG_> zD57-xM}1!S;aR_S{XyiA51y!HG*?(|K5sSb5%y@Ydj_rrtJzA~-ZVBEnrD#F4UwB8 z-3pReDkIFNJ*q@oKq61@8iTLErC=8Q69alGVs=ijBhKjeyISqso1&7vngo+4xOGkA z49jxgJ2K%ok(zoGY6GUtqusgc;$L6AB;2T6=`3Lr#>ciV=46+}iD6U0njV*Z&Jy&D zgY_9`~L_GanxLAn{5(3Jxib)WyLg7x~7sy( ziDIvm$ucF_z1-ruE~<{wuGqrFnXc#yUZ|y~nTOt{<4Z=@Fh+Wd>t}!5Vya70oF_As zzMgW*>zGbEXn4FHz5Ju+Y?!Aw#<*T0CH}JHxS|&MiE*dP7&Pnt8s_*nYFxRO+1Iw7 zWer5eAKtibX5rPl@h~aP!EYbzgnl0fr$NiVIGGvgC9h5tQ5p>tfr*KGHERQx~Ms6GE0O%H1v40o`*Wff4O%3fgf4V=-so%ZG5_{$6JP`dqGf+dMxup`Py(D-|g8{EKBYvEtfG zB|=qRgne2>b0CFx#dSic%T(3?6&sw58vFgb7Y1gyB(9agwsN$wmAyf4Sl84l`z!nL zB10>#2ZIGqRZ1YGwQd?gBK8$KB)zetD~TOe^u(}ELn6<9% zJIz@3if8BLUJ6ui$6G-w4Tl4Q-7n!q0sh(Xhs3HRg+6Ui(%zsRs6*S!E>jq6n%u4Vnkm! zri$`jex`xS23KsA>SoKVTnb}o*c3cMNGF`OXC3Av#_1zR!)AMy^N&;+63H6V@}B02 zPeoCZ9>HJ+TQ&N*1`}JF;7a;y@7S*%P!a6+Y;5*qTNgJ-9z4El-V{2%%E7bMobk4< zse>cCM6qxu@2Q7znn}gcTdJ-%F)$G+oLKHZy}d5&Vfz;An5Ai1Ov62ILh(ALZTs@` zMO~adFGBN_YDw&`SOZX_eu*gOy?r zL+mKM`PlM{o)eu6JItxv^NBS(ngMtWzv}$aLsA9eT~&z!WT}rsBYXFYvEdIL9_U9E zs&O8zt+tr6AY$Uhf{*)8O)8orz~dj|Vcdm!=vl8S<`kUGLq?taCoUBvd(AD@ys#At?{=QocD`SqAr=1$G=q0JuAtj6UiAMG|Orkc7FXekN*)@ zfX76*;3VBF&pW_%1;#a?LKml~fko@Uz(6}YJ9Be$SoZJVzqy{$DN5pda7QBzIGm$V zF_j+S#fyQ)G-|GWm0CyG@h`B(mg36Glcc2?=kQA=xSRP**I!VhkcA2l9nut$A=^rX zuEG>31~qOr)66&VIkb!~60Nwv5C?Xffli+9h=#{s&8)E+f?>g;7Hrr7s?NW5--%hUg;_o37jv5Lkxm_l0~YyTC5dNXxFhN={2GUu9#XALkg$x!Q0MHar50|QU(7>7;jNiD_&S{ojQ^60Mt|LxjTo7i?(BNHg6K1@mMC?$dOJ^}zZ@2e z^^$-qD+`CXNfr+z_tX5cIkB6$9^X=v#PGAy@NgX)fw(I-7y{nA-Oh?BzdAhkxq;YO zIF1{2X=zrA+Seatfz9V!P^+~0mqkr9*@p|rw#30EdOiTAmCExA3S9MSd!iVL*$gES zjZ#ul9v&Vcl`#9Q3EZIr9HAtA*Qtifq0AIo%%1~YgN{k>#|Ot;*WZVNbTo%ohWgk9 znVy8lHykk5E?SLC7JjwKd*Ig;pw|{+5$_fq6P{K!f3+4*FXK3il0L7}k8ECv464C$ zYCr=tcY5U`CruEu~?KRj+Fs8MxF1L;5oS8Z;6;OV%qHOs|+=bBMC%Ggc z&yD7N;n=*;O`^i7^}$N&t1c-wilO2k_t}*4mv%&-L8pBMiu|S!|0)EDq8)5H9BoYP#ls zl$BPsW(iA9!`7nLer;I<-x9-Bl_mdNb(FplFaj4*mrT*$T4&Tizxz~rJR<)3Ijl{WMCk6Tllaj`yuV4A*Z;Kt$Lf#parbcn z78aJ4rskt(uYPA`IbNRZ(5n=}AQa^s|8#UD4(S*fAD0#rlcS5|HG*C&yG9TAxI59Di_D@P^>LRr6Xjp;)e`~tJ z%-HPi&)zuYv zuy5-!mX=IJ_t1V7pceO?Mlz-NJa6h$8FuUI2L_n`ym^4;)c=gc_@~I-%(zNQO4ila zLv3wWY^(kJo`6`MDQIW}tUdZ?;&w~Q%SXq?>>cikGIOYShA$4e2=t%Hv_I81yep|T ze{aev11Ik9WTH(G{fFuzw%Fsk#{JS`suD$j?R)4IaB_5{NN_!_VU^-)-*d8qpq7d| zBT;M}8G-ghStTE<*Bwg#Ih{wjJ$1E}m0f7|wgR8Z_^$SVRcq`vDJ}Jzew^nie>$3z zHZ?QzJnYMSBkZ%Viix(sGcXP*w?M!rwBxT=JaJfQX*Vk-40Y;Vlv+Aah|_?qEF(nY z{(fzJeU?CNUxV=wU$Wc5lO&Y^7w8lMArsGOag6LdKO}hj_AS2vALo}p-=5%6ZzC!j zubWkL+&NfnD=yO2TSnNheao!onc;AF9KrQ+2>2NxYinQMP7bdP5xen1gL~t1xi4Q9 zeyVA{#Wm8`H*TmHN)x?3QkePK!)LmfnVBizdUA2e+zKTG7II)5ZBTD*ZLQL3Vr6xe zHc~uNd`u$a85#d%e}ADyo@6}d&cSMVTpSSzrPS5UB?<$ZWP6MvEIgc%k#Qfd8V$|D z?uPm}Fi^8V_8kTe{#;!wU~F9OHK(Y?EVs*@%H{STcU1l9)iwI`{njYPc`|;djlIPd zK|wYe>4ca_`>|PfHwA@}Bmq}kypZQ|G+R3S@RL41`N+u0=iyeE_`Q`C z6_?kiE5HS2J3HU;U0xU^yTkRnE-ldakl)L7Jg<*EZ!d#kcJ}ty*95_YY$6&Od_XV2 zjC#7eM?;Q|kKK>QHr+3dc&rz``7pBCEO}K!*H2LMjp^y^OuHSJ1WdT01qD0602O+o z+j&LOC`6@|?Ewk_w=gp|S1dX}0>_dC6MHzqKELI2^q4=%xgXHxA2NS^JaL=&{_Bsl z@rAIW9}suPCY(43K)^e zP2DT7M?#H)iO}ok4C>{^gTKEA1qD%rI?dMDS6a<;van1wxW`}I1EwR=G+dkC~9n1yOCp|J0U1x ziPOD3)rPB|Cmq-01y_TEgG`vF#>SnUopz3n9WoK693T!ZF87=Bb>NZ4#twkS z?Ck8bvol~3n6&GhMziI*y1F3j`mmoRCHufKjpj{GPF~%(`Zs$131FW7BqHJuS(=%d z=~r>C)6~>d&Of8^9XSQxo)36E!3!n_OGB*cIR<)r-NtfnYoY7G1qB6BQ6l7mk}(VW zT{QH0d3oToFKX6%VFO^DSus+3dwcNtN_csBIk0@wlamiHm~*nTx$TjPh;eiCeAGy#`d z1A#qFH00pe-F>+|=IZL|AtwGSLPC2rOg_Hag@uJXJMWG>0<6D4wM2KS6h~ZKeDsu; zkMAJ{^Vr11?LiN-o15Y8>?I~hDwega!)UE?-h)0;+!u?u!FH8~+^x8d(FJ$t>fB@A z^H$i-jva_OLql&Uu(MDD;9E^u+0I4lId?}nSy@>-yYh=Be0+RI6eq@`M_7ccD~AJM z390(mk>Y+EEjYrfw&%X&g~cT$9=F%0wO22PgX8i_OX(;n^_m~x*vk(ASZ{By)#xFN zKqpi02v(nLZFQO|H2@r>5rBb44-q8gSaoYFrJtYZ9cTj(UVmx%1#v)T=hqQDP`N!( zl>GT^jg_-jVrg!!Kdif_XA6m(j$+nn;OF8py1qDO!0(xw64TI#htbi~>$qBQ`nH_! zcaQ@MyZ%$d)j0Y!MXY3|Jj?O%@eZF1O${Od;K@Ma-a?ab5m)ZBI{6=jZ1G0Cu~oRPV4eU7&Fu85tQH8_Q+2 zHa0#U7Z<0jq(ntSBNMZbg5AB`QF{yAxkWNJ5W)cnK>>qvSYI=J3%a<=9j-6=;`xPQ=7-fmFXg3xo*f;Wu8klHlLqET5 z@xk&uUrq9?-5SkN`1tYT?d7~908MEkL5g?asbg7t+QjQH+)PbP&CAP6z^onCvl+!2vNJwnl0qiqVGWi>Ph{ktQG91Tf$mg01 zXuKl%$#77aXlV5@1(!#g3YwY;p`j`AISdR8?Lov7gM)kTP+K7nTe3${^hjd5NO2Vv zm23F^YP8NPBBJrJu^_@_I1md@P=pqEU~vfvFQKmpJ}J>Wer+VXB*bxdhJ}+;d0xt2u&AhUAlxCCSN5F%iz_dF4|c!cIu0u>Wt9@V$Hm1pFfd?sS^4|-pXTP& zo%yAuuyNifzHlEGqVEyNdgGvCE=|}G0XtSQbIz) z@zz8}meI=ES`wdQVF%6kkP-<74Y*{zWwM|lotYVM9q2n9Iks-kmr9E zwI3a(NUcrWcF@w|GW@~G&R%!ER)-M{fK6qI+?bdG|MoAFS>Q`}c#ZEk3j@P8@F+y% zZLO_m05hB`Ga6{TIkxf^VsSaz@VtSx35UR3Jk{xkCwCun3W`@MdcI#;T(kjjF-17B zrP;w=4Zz&0oE($YZW#<5vMV4m$RzIym_-eg8jv5EMpacyjDE>BT3sa*4J3OR}- zyhrpPd!B&I9hOIr9s%KfJpDJ|(>F((BmDq{EKGBE*8wcdfM)i0$LwW_%U}R(H&-!e zCkb1s{-|c+$>mEB!3GO}I3?XAee z0I@J#_{+k=LP4Ew%QkXX{@n}YB9vly=&s}xDA`pFWqCrGC+S!V9 z0GK1xlX_O+I&JOknb$$^8vgQNDyj^C_ge6AS}%M!PLP(eeG_n;g$Mufbr0O*v z_DGh@#K?$QV^r2UJ*7w>5dWPocODWF#>u^PjoM=hOTeRcK( z3oquw>*Dfq{SsB=_c4I&udJ*98tfIPc}y&!)!E)6x%*M*1<69IAD&)&U`cWD;P5a& zfwaQ+%Yggj=H-=6-nIDpmBn#a69@_E>FIFS>#Hks3kyoA|fJ+Rr3K&2QV8`vQpn?HdVH(IQP-eD3D`YUUxbj044yFT6}Se zva>h#<1g@Jm6QM)(Y3t4TT7z)@#EqSpeZkqV8Act-A}bHM-fAGvlSMIlZTjV%xVV> z4GkV19yfsOnOjAho2^|zp$3-sBg9wR0-`;xN>(e$00&rFS`xh2NCtEWjZ9LFm9mYl z?h?X^88Fk%{{Fct8@+XVb7SMP)5eLq!+yT4aex>X0QyA-Av)PVAn${1AMCH*vS>YB z*hGL=W^!|NE)o5R_|>b3=xCklutGA9I=jtb02ptsQJ%8^FTXn1KUUf2bzE-mi;0nH zXeeUVtSZjWXW(_QxHL`TcLr2}%+b+Ne=>OfjVY|1XSz;Wlod4K6OC1u*x)qSbLCL=vPJwV%bQAwep z-BAC{_SFXNFLywzXMSRkAIiL%L?G7J3HXl+fzSwO<@_D_zBtudPC!3b?+BGaR+iaD zTJ(fyP)s<5!_=&{$H!Yd$h`YtERPFX%j*lQQv*yXZgD+x1053 z&l{475{&YSiitukK=kyNm$TQofw7{Puz;|5v*=4sjxxl+E^m5Rc5i|3*vlijoY@z6cq5!U#5YT)A%gBem?h(FKttQB9HS3)?ELlS&S{y|W8>q2 zlfd2U@dASd-zNd-lPsSzQ|DYp4aKd|%-9hsMiaop$LDk^eowo3$3BC{od$s^uSr0l z$%sIqY(F^A{&38Pp(UihxlX$v>A17zPl9h-qwHkC)MUr1HgOT z$@KOK_}gjpohUae>J!m<@VD`ALJTccyXMh+*(Vj1iFwaO04jks02rLrd_#SHzNGs^ z@z)mR!mE`L8A>3G73Ajw5(j*)Z=j^~67=a)LACAbQ{R^Ty}iMqAs)Mp!9p!C-VlJE z00tr&J#WLphO4T`0l&(gd+|R_H=ys}-0cT5zrIo})%Po5ISpWLkfqzwcC{GqAond& z-5zH{?fG87mtZa^%Dcf(%jr!V+asqouO$>O%iGhq-JKs6s2WlnAq4i zyS1o7O)+wSN&3H}k7B(14PdoJLpDbE)-`w0_ z;xjmzZdn1b$#Q10!fax$E>=ZTv(BJLSuokkjJ|5(gZstyT>a%*UmZX<0c-#WD7@A` zKw@cm+04|Gjy|tYvswu9-$aQnz-!#x+~nkjR=UCw1OQd829TD|arecG7cdCL5%})8 z*TqoSiP8z&CAqn|I*lGO7S|T$=75?97Ix0#O-Kizj0_Qtq}NBgKYRN6`VhCT4L*MS z?(O|)JrC`loaF>SR3pTJC5a3lQE)e@2JVe(K4D_09?EaTK~^(WR`MgcMRFRLp> zB6oie+~qgp%k6A0MDXIXj!vVI2A|E6S6bTg z(dHbW-vO_#C@lqiOo-+#*?Jbg5y|rgh}_wQg$;m6WE*RP)*b=) z!qo`i%NYIgIKa29YMsht-??pOL}Qcjs{)T5J#n%-y9Pi_dk5;~c%o(A^Y&W7_Sui0 z(N(pzTpS!6T=Sno?tIJ1;kdiX-W6c0($do4tGyPzd0U+Jf_rESo4z(?cg_Dw((~ij z-;^N;{}yB8zX|-^uQNpdnYaH_kx8$|&Ru>-x3GTvuLQds?JhDpB7(oFu3Fh=`EFk+ znhe>R7ymMMlG(}atL^L|J!iq8OUDOOX+udl==`ot#Ac#IC&MG2!`oa-bquPWa+}L; zbCb7=8kb-G9qpffMV{rQqZW9C7z37$LCuS6Qwn~ZH)>#-CzI?s7P8bj0 zQMxd?ZuZ4+xelRGq-q#>VpS_bQArK>n3>qg`ePvyfpxh{qnl;m&+&Xy&y700s&ddr zE5SE|KCo;$0e#Vvf~X0!{61MsYa&U+rUMlJGIo18PzQ#p!huS$& zd@O$8YL`SOIL*rVTb96lZ%m(}SShx7kaVX!SWfjsaFJ1_DjgkH6#P+sZ};k90#yQ)qy} zM;0|wpVv{Y5TPpK%Z3ak8j7_dsjZ`!$(owCJ{Sd&L{*~Z&#;mrQ?VIHcddOfGHUr| z6oR@-i7b@xa*z?W7E*>EN6Dv;N8T*;YVRS>z>Fw1m!(NUl6}uca4e#AO+!^Rj8o2N zO5J&>i9~O%%0p|tpHL9bXk%t(Z^Ww7PI4{*d9r`RC*eW6%^nh8C(yIAiZID*45tes zjjA_oQC7and6;>TUz|5tcfL}>8#Jw*qo_z9?-zq4`h;p#;f$u2@e2^g>v>_`l)o?t zdw;&9Bxb8y{Xmoff5p-dCaLG;k9R&nhW?zDYP0uIY6O> zerG7g7e|`_uNxa1Gchs2^;?Oxq?Xg2nPPnz%Dx%M{bxY#gP0m5!u5-V*?UGlTt`FY z@^HKmTR&K6W`-ZMT9>CqLLzkSUB*+#2Ex#pwuue~8qU|8N@9>F@P^$eAKquO=VhP~z%8pd zc91tut?XbRxRd+UAA%kRdFWcWx0I=V|4g863>W zI6emrRWCP%;4eFoSQw~vksr9c98;MX)pSoUFi}w3T?2RL`dMBlaa~%(M?c#X$}(!z z)N{`b*ZM`*1IykWXEafvvbLbcs)CxHlCSspeXd^2SK7{F4n}D>WrwTw5(KhEB~K^2 zDoMYUx#S7CEon;|Eje#4X(52YOmFJbiXFAztQb|cm(MXFO29pQlb`;Gi&Ju0asBKi zWx*(2fegnyaIBQI?BU5i)#Nge-H&nEXI_d?q0-jxM|l zAWL3Ci{&OG*d*Mq!v$)i+x1osq7scFo|R0I;D`Fd^iX(pPEi4WdVd>CDmAmbmVXXv z$%ZLD6Q&cnj-E8fk9~61{s^A(#4qKPv*4G_7_sXsgJ9L>mrtu0;J%gd@j}#}bsyYE zx6v)kUFQhxR-dbj6sNLzR&ypzDzQ+_-8rFTY%n9=M)xEhrs_t|CIZ))DJ2ghAx!HZ zC;9#-kWrH)zN%_ggbB(=FQi6|AAOuo&FXCS-00O(G2iT0C7v)S3NQD%_lTvzlR zGrW2~c0yxMb0o9=i-9C$LnKYDy1WBN(Sl;b0jM86E<&k0ifri5JHNJFB-P@$(mobV zH1ph!r;@yl1f4*Xg7Wz0JN`WK=!tB8^*NVmMJDEvlCo{lQ5*Q$5!=f6#EdadLtmwM zL~nAb{atJxI8{D8**iPX{Q2X0##_0ak@=D2Q(su`1AaKa%8Wc-hAN$272~zyA0v$? zdbmavVDEKX*xheFfK^DB&tYX{9j%lQ7q8OX{q;sTY1MqT$<^8#^6fP}HUB}NY9U3# zZTqWAZ1R~Xl)m5Bdo0y)QE&Qi>G>149~z#NroV*`4oNbYCxQ+jlNgW(wf>Hfhg61< zIWRU0sRW&g6cwAbrs{Wz?0PusUe8%VYFf6*c8clDB#f;|KqVyCl9 zhTXOU55**Xa9D{AjSf#pI&zFcyft$@Y)N&JE;lQOqjwm5)b>SX_7ZsCQoX%Vo?2$| zN^$+3XyO(&uti3y(_jUu%ChxTw02UD4O1-yJy|3gWnr6UCRrZ+yYT_g-BU$6jq8P* z`Cj+Y#pE@^Tx9**Dp~a$OME054606~`Mbxs{a5t;u-suuXsW(?l+EOSb`uJJ z(eb=wYFjj)Lgn2`x56@xe$J`N7qfP1LQtqUU1*7b`9p{rGV{G&cm(V-Eq)KyOu~bF zMX8Q)SALpw4ZfL_U6eKA17ASa+emo|{D5S)b%ik{?J8yGMfDTsf!Mt5UZ?0>jt%*~ zbYTXIRMEy2t?&a=%ek?cx@4=MAosB~gB^`5-nmR9T(eM*t1~9s3kEajUge;ZnQf?4 z$!({O>Q8Pc$ga~$8)aEJwje~T9Ukp&bunmRt5k|q1V6Ujv{UwBrIFBGU2N(S3t!8G z74XkiElElV{mzx7*2A2caU#JF7+cQMq)*3vI58*nhk_!w-t$|n+Lpj@dMinx>xW6tyxgR@aUWqARbmtOD33kekz3aA<6v0`sF2CgOwjaR2B5W{zZ1pQ8DKw=kJz9#p zo5*DStCqHPuBvC)`kqZDiG;$I!LC~vY@j0kxvhk}uv={oK1o`G3yFPu)EvLg$h=v^ z6JMACw=sOyU8X=VEvuo1!+JZtL8j-8oLB}c{EOEwVF*K0`D+=(IG;SO!i(nWrjc!D z{_n28iWCrHLTd6tMAZ*P&uX4J@i){5WO=G~vJ1|IqM;?Z*Rxt$SXmWiWvOUudz|jh zMr*rtwYI+H;W@81<28_%41CZ3nzuhhjxK}NPmCgu$&*Zuq?S&I@WlcF2+#C`6009K zpwiq9nzMRwJ$t9>4!ET>HMd@Q9l936U{A^d{(N{1|sRHS$Xl z3?Nw9u6#yEN2dUUe~sI@t(@GD9&_74MhX=b6%LbCVdP?!pqgg#25FgXb4^te`Jed& zz0Q!(8P!Im7=0|XJ(8_Ro2{$6;>Nyvn3zQ>pf$BLO7f(|{_qsPQy%_W6`lXX!fs1+ zhJl~K+l1Bi_WqeTpD$Q?nYwOUlf#OPcbi@WaPG~a9ElGuB+ zfXs;LB!!Km;poOzpFeyULs*t09uf7NFwx78{BEn4b}Zh3{@Y0$kIM9J;SkbknOpLg z{?V$_huVYJqRu-zaYp9Sk0-|F2ZAnt6-CpI;KGw41t&7l|L!pZzr?RQIw0=DdIY)6 zR-7|7r$|*fp8DwHQnWVPYV+`)om!U9A3yNy%JBXxbjfo6hb-6){NE&Qm#|t=-f4$# zb@8C_Ke;3>E~hJ>#5ugn)Hk~=f7L5l6*ggyfUc)o481M;o%HT;*}519m|&V{2>#;- z=A5-PH5a2f3bs6jTTdbXNY8(6*0E)!D?BJLP+nf%)XYrBY0-OaZOy1UlEJWnY*V{# z2UZw8@WD*MLP_rA;$`Fdb2-nvYE&>8S5+fu?4`~?AR-~jK3#cey4}`%H)n_%Yc00Gp@Dj8sqqehd51sb~E8>Dcu9~d~XwN_!?asQ(o}`-8 zDs2`e5V*B2PB28O_s7ud5~MEVEXE7<<`eRj?crq%(ZyAdEr+qIml+7?nYxA@AO$=W z${^4L$Gg@6sV{9D)FRZnx=Mbx7Lsqec)=+BdmB-h054+1_iaXO;0WbyB z*sqYZNS64})wdRYb8+h9Ux(ao8CjUbK1$$CgCWn$snmn@BupA{ zf@F2+UaYuhg?@W-)a?+6 zU!-Q`x52%~)OIH3qAG$B2CMJtyoK;1XL~Y9T))RkCeYKQmgUtA-~tnx;CUGtA+|Ut z)@mE_`LQ7|OBpvj<3v?`L?D7PI@LFOm^fJ2pT(+g@11TI2fHQjSvx8(#VuUR7dl#Z zYI0_jLv~F-X7?w>SVD(*Y=gtCjICF6)np~{hwrv~+UXSaR>I56^YimxJbvKe;bB#` z-<~a(c5&o^J9BrmS9T%*_cQrSq-_@JXh|!7JQeB*W{a$ zzFLU{myK6pHPmA}-C!ma_)6`S*`>Ux(x{@Xh~npK41{qp)ju*TCtb{_^{w@b=b+G| z&%NX5IcmBlvFu#5oO0%`?d0Y^2C_3sCB)N4v4xetFp-W^Y+8*6m1w%T_uA@G>M1}o z42JUorPZcvne+o<OdsZ|Z)^H`wY1F+Qi%2Z+#{WRQ`#i;KAM(lyHy6I~Na`5D3| z8n4Tdy57Oa&eJ3O?g7i$P&%gY%r;8_1YG!}Z0%`=jTt{Xv03KQC+uMc3-6Hd3@hjP!5c0Pm^S2i>{p2 zFb|ah^X6sRjf6R8K<@)LJ#@sNSL>i_ymDt1Ln^k2eI$?W6P0%hrITcH zmX=RrU;BX`KWp`?79f3S_<}Vj)c|2jRWhaJJ%^3#T+)bTDZO5by8gA&`AUX@V(IY% zL-WO@$=0?VPTSZ3mAl-(lW8djXcLJ{5_GRAEG(?6n`v!b$pCmmdl?6d6waD3HJImW zIp0!$vydWFd~DPe3fe}e_@ULtm-+*@tXr`)7Eaw?w2V>dZKr)vT zz=rD?X#E)N*zqtmjJ)_kv$=X29^k_T%@=p*Otul3LxhEe^{i!dtfKd6VNTAXHTQtl zNaRdJcur)oPL>hVDOOqTD~g?Q19zz)yQGC1TW_I4evX?DQ7)|If5ro6$LLr~B7j)6 zUn3_j9X0t4wYHNkj_{=LU1sf(`ViOm_$zGE+`(#0jw-Tq(hy!SqL%Mf;P|dhxBB~_ z*f+7)e*wjC%isSgXM90XQPIt*H-WY+T_kW9V;SkmMZ^oIiyK1@%tz#3mNwR2RgDh8 zcXkhuPg!jUzm7&{^qFE==DMl9G5d1{x`2$%yH6UA&{Q`*&4DykIN}w<0L4kZU^%`@ zms{=yc)Jw@mPMJ|LBL&e`9So6{f!1wcLIZ7q%Q^yjZ|Db1^mEn*`JLg7L*Ez*~$A{ zTx7m&x+P?uq#0s`abL0NKwdm%K|c8T~eK->LI^mk$E z2vYPcK|Eu4S^dov8rtLccY6V*r_~)DPXh>;ZMhTP2>Yz8tnhnUWYGm{x##ch40$XD zi{xh_4@`$vdrsGU6<6BHOP(g2UR0uxO=t`GQ)ax5Ntqu_t-h@-0Gb9^l4;;A| z9d>St7dUL@0_C-%s=>4h3v;XDOOr~V?%!yQuozkN+%U0LlP9J9;ic@N`Cp(=`Bq4N z1c_nkZ+j7#`(ALx9AoG>E!|K&jFs!co7^OpnL>Ip^qnRNN&ItVKbr%;dp`YzGhchxWGdncAKD>S&(8ldG=>9J*bsxT#%6RwYfCX9bq;YI)%om$f z=(2ev{6Aw*XlQ@f!V2ysHCXSEJ};l_1qiE+xa0~pzaL zB>V51?qg$}57+wOo-{H^Zd>Dw|82XzhSpt4yny@p`K6?Mm6pby{>zY(tm*~lr<h z=^wo-FYtu^_3BZMhnqVhI$A|pIW_X17ZEk(%G?B_=b_e@U{75wv05gY%v ze~S2z)qnn`<6qT(ddC0q#Q*na{I5>@KR5S(=HY+y&D}K4^5Wlpe709@p*;qQSuj(>XIHT;L3cMbp6^PdLBd;h)bUCV#y z`oDX$f8X=J9_-)u{I3W5_dWmX!T#eU{QqjO|K)`L4}<*|%Zv5@Wp%$*Mxp)3(f&Mz X2@n>4=3D&x>oT!V(vU)-FF*b-Zk(IL literal 0 Hc-jL100001 diff --git a/docs/img/tutorial/python-types/image05.png b/docs/img/tutorial/python-types/image05.png new file mode 100644 index 0000000000000000000000000000000000000000..d2dd08ed227212bc5b2cc0da5df91e9f9b2ba8af GIT binary patch literal 42637 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 d|J!Z4CSl=bgJq});j5=_%1bLrhttps://fastapi.tiangolo.com](https://fastapi.tiangolo.com) -**Source Code**: [https://github.com/tiangolo/fastapi](https://github.com/tiangolo/fastapi) +**Source Code**: https://github.com/tiangolo/fastapi --- @@ -90,7 +90,7 @@ async def read_root(): ``` !!! note - If you don't know, check the section about [`async` and `await` in the docs](async.md). + If you don't know, check the _"In a hurry?"_ section about `async` and `await` in the docs. * Run the server with: @@ -290,7 +290,7 @@ Try changing the line with: ![editor support](https://fastapi.tiangolo.com/img/vscode-completion.png) -For a more complete example including more features, [see the tutorial - user guide](tutorial/intro/). +For a more complete example including more features, see the Tutorial - User Guide. **Spoiler alert**: the tutorial - user guide includes: diff --git a/docs/tutorial/python-types.md b/docs/tutorial/python-types.md index 684e27f7d7..8938e81e7c 100644 --- a/docs/tutorial/python-types.md +++ b/docs/tutorial/python-types.md @@ -1 +1,288 @@ -Coming soon... +**Python 3.6+** has support for optional "type hints". + +These **"type hints"** are a new syntax (since Python 3.6+) that allow declaring the type of a variable. + +By declaring types for your variables, editors and tools can give you better support. + +This is just a **quick tutorial / refresher** about Python type hints. It covers only the minimum necessary to use them with **FastAPI**... which is actually very little. + +**FastAPI** is all based on these type hints, they give it many advantages and benefits. + +But even if you never use **FastAPI**, you would benefit from learning a bit about them. + +!!! note + If you are a Python expert, and you already know everything about type hints, skip to the next chapter. + +## Motivation + +Let's start with a simple example: + +```Python +{!./tutorial/src/python-types/tutorial001.py!} +``` + +Calling this program outputs: + +``` +John Doe +``` + +The function does the following: + +* Takes a `fist_name` and `last_name`. +* Converts the first letter of each one to upper case with `title()`. +* Concatenates them with a space in the middle. + +```Python hl_lines="2" +{!./tutorial/src/python-types/tutorial001.py!} +``` + +### Edit it + +It's a very simple program. + +But now imagine that you were writing it from scratch. + +At some point you would have started the definition of the function, you had the parameters ready... + +But then you have to call "that method that converts the first letter to upper case". + +Was it `upper`? Was it `uppercase`? `first_uppercase`? `capitalize`? + +Then, you try with the old programer's friend, editor autocompletion. + +You type the first parameter of the function, `first_name`, then a dot (`.`) and then hit `Ctrl+Space` to trigger the completion. + +But, sadly, you get nothing useful: + + + +### Add types + +Let's modify a single line from the previous version. + +We will change exactly this fragment, the parameters of the function, from: + +```Python + first_name, last_name +``` + +to: + +```Python + first_name: str, last_name: str +``` + +That's it. + +Those are the "type hints": + +```Python hl_lines="1" +{!./tutorial/src/python-types/tutorial002.py!} +``` + +That is not the same as declaring default values like would be with: + +```Python + first_name="john", last_name="doe" +``` + +It's a different thing. + +We are using colons (`:`), not equals (`=`). + +And adding type hints normally doesn't change what happens from what would happen without them. + +But now, imagine you are again in the middle of creating that function, but with type hints. + +At the same point, you try to trigger the autocomplete with `Ctrl+Space` and you see: + + + +With that, you can scroll, seeing the options, until you find the one that "rings a bell": + + + +## More motivation + +Check this function, it already has type hints: + +```Python hl_lines="1" +{!./tutorial/src/python-types/tutorial003.py!} +``` + +Because the editor knows the types of the variables, you don't only get completion, you also get error checks: + + + +Now you know that you have to fix it, convert `age` to a string with `str(age)`: + +```Python hl_lines="2" +{!./tutorial/src/python-types/tutorial004.py!} +``` + + +## Declaring types + +You just saw the main place to declare type hints. As function parameters. + +This is also the main place you would use them with **FastAPI**. + +### Simple types + +You can declare all the standard Python types, not only `str`. + +You can use, for example: + +* `int` +* `float` +* `bool` +* `bytes` + +```Python hl_lines="1" +{!./tutorial/src/python-types/tutorial005.py!} +``` + +### Types with subtypes + +There are some data structures that can contain other values, like `dict`, `list`, `set` and `tuple`. And the internal values can have their own type too. + +To declare those types and the subtypes, you can use the standard Python module `typing`. + +It exists specifically to support these type hints. + +#### Lists + +For example, let's define a variable to be a `list` of `str`. + +From `typing`, import `List` (with a capital `L`): + +```Python hl_lines="1" +{!./tutorial/src/python-types/tutorial006.py!} +``` + +Declare the variable, with the same colon (`:`) syntax. + +As the type, put the `List`. + +As the list is a type that takes a "subtype", you put the subtype in square brackets: + +```Python hl_lines="4" +{!./tutorial/src/python-types/tutorial006.py!} +``` + +That means: "the variable `items` is a `list`, and each of the items in this list is a `str`". + +By doing that, your editor can provide support even while processing items from the list. + +Without types, that's almost impossible to achieve: + + + +Notice that the variable `item` is one of the elements in the list `items`. + +And still, the editor knows it is a `str`, and provides support for that. + +#### Tuples and Sets + +You would do the same to declare `tuple`s and `set`s: + +```Python hl_lines="1 4" +{!./tutorial/src/python-types/tutorial007.py!} +``` + +This means: + +* The variable `items_t` is a `tuple`, and each of its items is an `int`. +* The variable `items_s` is a `set`, and each of its items is of type `bytes`. + +#### Dicts + +To define a `dict`, you pass 2 subtypes, separated by commas. + +The first subtype is for the keys of the `dict`. + +The second subtype is for the values of the `dict`: + +```Python hl_lines="1 4" +{!./tutorial/src/python-types/tutorial008.py!} +``` + +This means: + +* The variable `prices` is a `dict`: + * The keys of this `dict` are of type `str` (let's say, the name of each item). + * The values of this `dict` are of type `float` (let's say, the price of each item). + + +### Classes as types + +You can also declare a class as the type of a variable. + +Let's say you have a class `Person`, with a name: + +```Python hl_lines="1 2 3" +{!./tutorial/src/python-types/tutorial009.py!} +``` + +Then you can declare a variable to be of type `Person`: + +```Python hl_lines="6" +{!./tutorial/src/python-types/tutorial009.py!} +``` + +And then, again, you get all the editor support: + + + + +## Pydantic models + +Pydantic is a Python library to perform data validation. + +You declare the "shape" of the data as classes with attributes. + +And each attribute has a type. + +Then you create an instance of that class with some values and it will validate the values, convert them to the appropriate type (if that's the case) and give you an object with all the data. + +And you get all the editor support with that resulting object. + +Taken from the official Pydantic docs: + +```Python +{!./tutorial/src/python-types/tutorial010.py!} +``` + +!!! info + To learn more about Pydantic, check its docs. + +**FastAPI** is all based on Pydantic. + +You will see a lot more of all this in practice in the next chapters. + + +## Type hints in **FastAPI** + +**FastAPI** takes advantage of these type hints to do several things. + +With **FastAPI** you declare parameters with type hints and you get: + +* **Editor support**. +* **Type checks**. + +...and **FastAPI** uses the same declarations to: + +* **Define requirements**: from request path parameters, query parameters, headers, bodies, dependencies, etc. +* **Convert data**: from the request to the required type. +* **Validate data**: coming from each request: + * Generating **automatic errors** returned to the client when the data is invalid. +* **Document** the API using OpenAPI: + * which is then used by the automatic interactive documentation user interfaces. + +This might all sound abstract. Don't worry. You'll see all this in action in the next chapters. + +The important thing is that by using standard Python types, in a single place (instead of adding more classes, decorators, etc), **FastAPI** will do a lot of the work for you. + +!!! info + If you already went through all the tutorial and came back to see more about types, a good resource is the "cheat sheet" from `mypy`. \ No newline at end of file diff --git a/docs/tutorial/src/python-types/tutorial003.py b/docs/tutorial/src/python-types/tutorial003.py new file mode 100644 index 0000000000..d021d82113 --- /dev/null +++ b/docs/tutorial/src/python-types/tutorial003.py @@ -0,0 +1,3 @@ +def get_name_with_age(name: str, age: int): + name_with_age = name + " is this old: " + age + return name_with_age diff --git a/docs/tutorial/src/python-types/tutorial004.py b/docs/tutorial/src/python-types/tutorial004.py new file mode 100644 index 0000000000..9400269e26 --- /dev/null +++ b/docs/tutorial/src/python-types/tutorial004.py @@ -0,0 +1,3 @@ +def get_name_with_age(name: str, age: int): + name_with_age = name + " is this old: " + str(age) + return name_with_age diff --git a/docs/tutorial/src/python-types/tutorial005.py b/docs/tutorial/src/python-types/tutorial005.py new file mode 100644 index 0000000000..08ab44a941 --- /dev/null +++ b/docs/tutorial/src/python-types/tutorial005.py @@ -0,0 +1,2 @@ +def get_items(item_a: str, item_b: int, item_c: float, item_d: bool, item_e: bytes): + return item_a, item_b, item_c, item_d, item_d, item_e diff --git a/docs/tutorial/src/python-types/tutorial006.py b/docs/tutorial/src/python-types/tutorial006.py new file mode 100644 index 0000000000..87394ecb0c --- /dev/null +++ b/docs/tutorial/src/python-types/tutorial006.py @@ -0,0 +1,6 @@ +from typing import List + + +def process_items(items: List[str]): + for item in items: + print(item) diff --git a/docs/tutorial/src/python-types/tutorial007.py b/docs/tutorial/src/python-types/tutorial007.py new file mode 100644 index 0000000000..0b7b146e25 --- /dev/null +++ b/docs/tutorial/src/python-types/tutorial007.py @@ -0,0 +1,5 @@ +from typing import Tuple, Set + + +def process_items(items_t: Tuple[int], items_s: Set[bytes]): + return items_t, items_s diff --git a/docs/tutorial/src/python-types/tutorial008.py b/docs/tutorial/src/python-types/tutorial008.py new file mode 100644 index 0000000000..9fb1043bb8 --- /dev/null +++ b/docs/tutorial/src/python-types/tutorial008.py @@ -0,0 +1,7 @@ +from typing import Dict + + +def process_items(prices: Dict[str, float]): + for item_name, item_price in prices.items(): + print(item_name) + print(item_price) diff --git a/docs/tutorial/src/python-types/tutorial009.py b/docs/tutorial/src/python-types/tutorial009.py new file mode 100644 index 0000000000..7d5b09cd46 --- /dev/null +++ b/docs/tutorial/src/python-types/tutorial009.py @@ -0,0 +1,7 @@ +class Person: + def __init__(self, name: str): + self.name = name + + +def get_person_name(one_person: Person): + return one_person.name diff --git a/docs/tutorial/src/python-types/tutorial010.py b/docs/tutorial/src/python-types/tutorial010.py new file mode 100644 index 0000000000..aaaecc3ca0 --- /dev/null +++ b/docs/tutorial/src/python-types/tutorial010.py @@ -0,0 +1,16 @@ +from datetime import datetime +from typing import List +from pydantic import BaseModel + +class User(BaseModel): + id: int + name = 'John Doe' + signup_ts: datetime = None + friends: List[int] = [] + +external_data = {'id': '123', 'signup_ts': '2017-06-01 12:22', 'friends': [1, '2', b'3']} +user = User(**external_data) +print(user) +# > User id=123 name='John Doe' signup_ts=datetime.datetime(2017, 6, 1, 12, 22) friends=[1, 2, 3] +print(user.id) +# > 123 diff --git a/docs/tutorial/src/sql-databases/tutorial001.py b/docs/tutorial/src/sql-databases/tutorial001.py index a847c5c7b9..3b4336a86e 100644 --- a/docs/tutorial/src/sql-databases/tutorial001.py +++ b/docs/tutorial/src/sql-databases/tutorial001.py @@ -1,5 +1,4 @@ from fastapi import FastAPI - from sqlalchemy import Boolean, Column, Integer, String, create_engine from sqlalchemy.ext.declarative import declarative_base, declared_attr from sqlalchemy.orm import scoped_session, sessionmaker -- 2.47.3