From 5e13bcdd08de4c9c75776ed8f5ea3c3a557bfbfe Mon Sep 17 00:00:00 2001
From: CodeWriter21 <CodeWriter21@gmail.com>
Date: Mon, 13 May 2024 16:16:56 +0330
Subject: [PATCH] New exception classes to use with `argumentify`!

---
 CHANGELOG.md                 |   6 ++
 EXAMPLES.md                  |  53 ++++++++++++++++
 README.md                    |   7 +-
 pyproject.toml               |  34 +++++-----
 screen-shots/example-6.4.png | Bin 0 -> 17856 bytes
 src/log21/Argumentify.py     | 120 ++++++++++++++++++++++++++++++-----
 src/log21/__init__.py        |   8 ++-
 7 files changed, 190 insertions(+), 38 deletions(-)
 create mode 100644 screen-shots/example-6.4.png

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d301e5c..1b5b8f2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,12 @@ Help this project by [Donation](DONATE.md)
 Changes
 -------
 
+### 2.10.0
+
++ Added some exception classes to raise in the "argumentified" functions to show 
+  *parser error* to the user: `ArgumentError`, `IncompatibleArguments`,
+  `RequiredArgument`, `TooFewArguments`
+
 ### 2.9.2
 
 + Added `Sequence[T]` as a supported type to the ColorizingArgumentParser.
diff --git a/EXAMPLES.md b/EXAMPLES.md
index a7ac261..45c88fa 100644
--- a/EXAMPLES.md
+++ b/EXAMPLES.md
@@ -376,3 +376,56 @@ if __name__ == "__main__":
 ![multi-entry](https://github.com/MPCodeWriter21/log21/raw/master/screen-shots/example-6.3.png)
 
 
+Example with parser errors:
+
+```python
+# Common Section
+import log21
+
+
+class ReversedText:
+    def __init__(self, text: str):
+        self._text = text[::-1]
+
+    def __str__(self):
+        return self._text
+
+    def __repr__(self):
+        return f"<{self.__class__.__name__}(text='{self._text}') at {hex(id(self))}>"
+
+
+# New way
+def main(positional_arg: int, /, optional_arg: ReversedText, arg_with_default: int = 21,
+         additional_arg=None, verbose: bool = False, quiet: bool = False):
+    """Some description
+
+    :param positional_arg: This argument is positional!
+    :param optional_arg: Whatever you pass here will be REVERSED!
+    :param arg_with_default: The default value is 21
+    :param additional_arg: This one is extra.
+    :param verbose: Increase verbosity
+    :param quiet: Make the script quiet
+    """
+    if verbose and quiet:
+        raise log21.IncompatibleArguments(
+            '--verbose',
+            '--quiet',
+            message="You can not make the script quiet and except it to be more verbose!"
+        )
+    if verbose:
+        log21.basic_config(level='DEBUG')
+    if quiet:
+        log21.basic_config(level='WARN')
+
+    log21.info(f"{positional_arg = }")
+    log21.info(f"{optional_arg = !s}")
+    log21.warn("THIS IS IMPORTANT!!!")
+    log21.debug(f"{arg_with_default = }")
+    log21.debug(f"{additional_arg = !s}")
+
+
+if __name__ == '__main__':
+    log21.argumentify(main)
+```
+
+![parser-error](https://github.com/MPCodeWriter21/log21/raw/master/screen-shots/example-6.4.png)
diff --git a/README.md b/README.md
index 5c2ca5a..b086a16 100644
--- a/README.md
+++ b/README.md
@@ -61,10 +61,11 @@ pip install git+https://github.com/MPCodeWriter21/log21
 Changes
 -------
 
-### 2.9.2
+### 2.10.0
 
-+ Added `Sequence[T]` as a supported type to the ColorizingArgumentParser.
-+ Bug fixes.
++ Added some exception classes to raise in the "argumentified" functions to show 
+  *parser error* to the user: `ArgumentError`, `IncompatibleArguments`,
+  `RequiredArgument`, `TooFewArguments`
 
 [Full CHANGELOG](https://github.com/MPCodeWriter21/log21/blob/master/CHANGELOG.md)
 
diff --git a/pyproject.toml b/pyproject.toml
index a0ca303..572ee32 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "log21"
 authors = [
-  {name = "CodeWriter21(Mehrad Pooryoussof)", email = "CodeWriter21@gmail.com"}
+    {name = "CodeWriter21(Mehrad Pooryoussof)", email = "CodeWriter21@gmail.com"}
 ]
 description = "A simple logging package that helps you log colorized messages in Windows console."
 readme = {file = "README.md", content-type = "text/markdown"}
@@ -13,20 +13,20 @@ requires-python = ">=3.8"
 keywords = ['python', 'log', 'colorize', 'color', 'logging', 'Python3', 'CodeWriter21']
 license = {text = "Apache License 2.0"}
 classifiers = [
-  "Intended Audience :: Developers",
-  "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.7",
-  "Programming Language :: Python :: 3.10",
-  "Programming Language :: Python :: 3.11",
-  "Operating System :: Unix",
-  "Operating System :: Microsoft :: Windows",
-  "Operating System :: MacOS :: MacOS X"
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Operating System :: Unix",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: MacOS :: MacOS X"
 ]
 dependencies = [
-  "webcolors",
-  "docstring-parser"
+    "webcolors",
+    "docstring-parser"
 ]
-version = "2.9.2"
+version = "2.10.0"
 
 [tool.setuptools.packages.find]
 where = ["src"]
@@ -43,11 +43,11 @@ dev = ["yapf", "isort", "docformatter", "pylint", "json5", "pytest"]
 max-line-length = 88
 
 disable = [
-  "too-few-public-methods",
-  "too-many-arguments",
-  "protected-access",
-  "too-many-locals",
-  "fixme",
+    "too-few-public-methods",
+    "too-many-arguments",
+    "protected-access",
+    "too-many-locals",
+    "fixme",
 ]
 
 [tool.pylint.design]
diff --git a/screen-shots/example-6.4.png b/screen-shots/example-6.4.png
new file mode 100644
index 0000000000000000000000000000000000000000..e0c3c05c95e3ce0e9f1abf336a6860fbdbceeb88
GIT binary patch
literal 17856
zcmdqJbyu5R6aNcEOVMJ*inX}Y;t-@1cXw%l;_edMwZ*+qT!Oo6ad&rj4U(Mj-1qZ4
z&pB(IH*o&oB3a40lD%j4?Af3BPQn!BB{0y4(cs|VFr*~ED8s=aKwyuZQITQSI|M!%
z*gtqjWeHKZ@=?+Q*b_uE5jhb!xXPF}Pew?v=dbM~wH)E#-a5Vf!LOQ<yTQSUt4Vzk
zQFYTl$v|nr?_IguTlPH2kcp!~dqowRgKGRolgc=Z?DN-8IqU-@Q86*@GoP3$KMGis
zf>vUUODDcCDMT8JS5PW{5oYqGBg=C?6Wq&KJ05LxOcdN3&aC!aeD(%pfsYp!cvW1X
z{LmEWaNlB`bs9E&!%=y2Pqs)v&;7-gUe*)O<8gIwJiSU!GW$1Oa#2*uK<t-Gpm>7k
zhkqVoi%KFXtM-ytKlhUZTlS}mel=VUGKyyjc`q~m_Z_IO19Ipg3PRvN4Y!Myy?^7V
z#rH-tdfoRjXfxe5!+t75N+f!}j1;loS((|D^`7L}ezM<=lL(h#ZJicmB<+>1SLWGE
zckJOD6QDL7O&{?1_p`TUm1<_cMe}~8e{$R%#%X`rVePFl8Je!t0O@ZAli1ja;b+a;
zD1*t<^e<QmZx_tS+3h#K+?CqlF|J6%g+sOne)TpvAN`+!4MgS8LD<ev=5!sS`211G
zy%aIv#+S1`Is4pJXBEN!;$HJoNq65(DQEq69=5+4_5vSoPY!w9&JCT1gAy1uioe~R
zuFNO}WIQ`AtQe#%Yhd8#EU>1pjev^Y&fqGW9c_dh>0d*?HS_O2-(wV*J>Kx9uR*Kx
z-l!(OA=$El=n%>0n;7e0k{Fs|;o9>E9+i)6oI4}q*6fi(@B6oJ08sE4119S)8o9SI
zLJvPUNPWbVW)S7(kcWM?+H)mh)S>;hf8MCL;ogILLC~x*!L-*)Pe?`&*9V(bLoAMC
zXb6e;>+jF~Z=<RpaEJ118a$h%?T(EG|C+W)mD_gp3GJ>PU(oYbm1fy`sZNdTN_W1>
zB!cJpdaBpw@ua{M{994ryaVBMW?dB{Dy+DT9mf&}H!Mo@gAf7LEIUo{T@u<ApZjSf
zXQ-xz*1ESbRT~{;AbLR&*e5}<R6aDA=<-ja)6FFyYcLl**o|0Us_^QMPB1V}s=irP
zBi|^W(ZZw#0CL#$=ni9?6%T%tx6m)$s?OG`HqB{j(q__YQtjEYpU9ITyg05ND|T#v
zO@w62-Kr;p)m*t=Z;koXmu8of9!5}0PPyyRtQ@KL^@Q=oX0LH?I6ebueB}^pyKbpL
zyMD_>9|;2~&-J)i?`)Y)uRqe8S9z90ohal?$ms8~PaC61xWmOG2#UNZ`=ZGh)j|3h
z!xHU2&pm!9@99j(GMQ(~^-7*P#0mBO491QLCc@@<p~?&FaPe>iYBn3CNe=D4j__~2
zTh)nt$1XaY%q~`2u<QSZ1v`z~mcVt*yZ#85r2%TwbU>q|p;2(!u2!O6<OvcB!L%sq
zo>Bmu1pn8|MGbq&(WWUwNU4I+iKtwbthw`!Q>6Vd_UG$u*YqRF0s5p)<06At)zC)F
z4?lt$jp|favm`_BUr`e8(ta7CR5ps1+Ib)=(v^A3kv4-O)y^#115nksaB1~GkN0#Z
zLu*xSxBxa33(2=Qx4UizPDumKWw_e}eosnTCAF`)c6B;rTS&@IL*;@!SN~?AhjhYa
z0G95pd^g{S<6v4N_2QAxSpZbPLMJs-s{FbR10OA>#C3ruwR5Wc-{97R2=x^=MtQc-
z@y8nXG8rLvK&VEL=V{}f>XOJtZ!7i(J)Iik=gkOK1|*yd3Sfm$VNsFPE*8SudB7`m
zdf3IVV$*Z&F*9{!^rJP2)s<PqojXJPW=v-|0w#}eE#=}{VR{Kq=;Inxe%5@xgX2{|
zSpBL;$^BFo<j){@BZR!T?$4&efBah#g2;7aP;DC305g4p!>e90(?+&8AyVa0Q?eO+
zYNW2q_R=Zi%@6H2vpVi&7q)IoO4;~Fe{!C}1Z>y#lQd87)yOCkfJw#A>1*^*j8L$_
zpSb(CoHykmA7&?bMSm;!KY7Qc0_5uMyO0OT_Lu5G95W$HK<IPAt0)C#i}71HgjY24
zu@`X?@9oEOwhW*TNsmJVZ%T27pN#U!e75?c9K8dR*^K=8QlS{HkTIPyexLvVRXd>M
z`FI5D&^_Wrp44wKg6d>z?t5g;=;3lr){8Yt66jRs<B9(S+gQ85=8o;Kl@eAx$|o~2
zF4pN+CG=yQg3;`iI63F=ZaF0RW{9Xr){I(cOsR)`3ac2oH$H0wIJF73HC`GW^rGmB
z9(!9#&z<3ljU0Zmmjz_;d6>#7uIu;3nhpGB+Kj#L7b4p+OpZXL-559n&oxjD29YOQ
z-_5>xdiwi0O4Lv%+Wl%b%&0rK(QGt{NRdV0suBAS<lpcz5qnh*QA93p*hI4*q%SB;
z0qP`S9v{XmK!1zrMF~(%TRmW!<&zHrkl{DU3BFdcIG49W9x_N5#RItdS+36eo4nEI
zJG2oH;DeMQ)qb6?hqb@`^Y&HmJH0y#J4J}BvogzkB7*Y_EV6HRyv74s-)6l@PzL@p
zKk=O6;PkZ;P+PI-W2>-Hz+@a}?I}AhTcrWhmzy@_i;xs3CMB_c{w9{8#fh^IXX|;0
zI{?{-4I7Tpw;PjxxRsd9LrRo}jmJ;xD2`f!VTb%qRcHuX(I<@$o(s%KP`BfDke4)#
z<6MB^m<fcq!!`wq8;O5L9~KPTUNl+Jt057rZSyxc7Aov?mgHXNen+_Jhd5D|ckHN&
zwP^xtR`-oPd(z_VLAg)guqiAm!~l|DFY?Q|ZU8XoYg*yA=i1l9_ZLNc7+gl(LKsGj
z4WU@(l&7*;kyA$_@Q{E!Y7#ChJ8$An4n%Z{4WBLw;olV_2J``*8_#!ZgwKz6gq|n0
zNqjNdO8pu_zV1+Q@PY6@J9{dzpX&`4LNX?~^R!ZNF2L*Ft`>d~woA_JwUjp<GTaQ*
zQ|zyt_hKGrvX0$FhNXt7QO&9s>Rq>Hb$0U#<%JyGDD;SLGT!;4csXD-Uuc|cpi@y~
zXr9f>XI)vk(aadb*$3Q{9A@J|4>#C9kFOuIuJ3~Ku${4bT_4g7>hAshMF`MKv&)T|
zqV)EE#~<pQ-XszCMG{ea+?|${=L%K`K`#2q6?~#GoA1bhPZtcBx?()TXjr5?iu6mX
zdTZ5rB}Du#r99y6Uo!>Jb9&*k(;JVuC)g%dw3hodN;whvetF3Na+#DNloaCVg<1Zs
zKYH_a$rg4;HU|G)RuVTBdA@@W_({<uSzo7}qd|npS&Zl;URAi({&gM5L5)7v-2`53
z*!=h3Qm}*uLOF7t?(wMB%OU?b*S3U`>5~yLX3%-2=P3@O2A?+XaOH2W-KhavH^Fk3
z_Wr#qwp;_~*q1~32jsA**Lku1d(H2K3}3@Ru=2?5i^ncMpL&{(@fEGFk!Tp;jbHdS
zJ#JadK?+4yMBM{k@xqdqo$PcAwvxxCHHbQsR@Dc0GR|FC&<f!gnO(oTKA4(m@*%^t
zH*SSm*RSjbTYS)IBG&Y!z+xNfcU_*km{w5;doSow=%!s~Rdi{*JBB!DPia~r=fBO0
z`|iWU4H62QVb0jaO%UCL0d2=_^czAJ)%IM(6Q`RQjgmFGwNM=D>DCYq+<&~~l6JPv
zdMSs+t{-zvC0|yldZba=u{c-u>>gl0NBgE$w5Fk0n*QcyDni@K7(S6im~yy=_s{F$
z<BJq2bUs6J|H9X)0ArLzECLi*m}xr_`)8F51mz6h6Q-rIk4AcSm#984#;GU>s*#cV
z+#5OnyCcTt%TC|}y%rg>79hHX#00outl}cW$5I=e4zHMKwQ7FE{r6^+a!EO955Ind
zdWh9I1nu7c8zl3Q@qzzMX8-t`|FnF1{clDWoB!&6U;14Hpy$iwn+{*mskI*qoL4oV
z&D47g@+83Mm8@Rg=e0@Kyty1Y)q(_)kyHM0`ccf0;1Cu2BTTfe0_z=SJa7jEAE@kP
z^NvS0eZH*TlcuN3mMdaww{165T#S8^i54?UNY81}QK9lWPNK(iD!;L<5!b~lFm^JB
zeo%GrvuF-2+CrC*Aw&_9K&$#Bwhqg82w-_>1<&2Gqh3~*VyRR2*Ej2HOc|h2M>2OZ
zUgzR{&+CcJi8yM#tn1|5*1g+P+PdjEm3<OYud9)qei4)~_xfcj0_YBFxh+F8xoi4<
z(^;GGXo5zQ&_QJwD0bhocl*S$9A_xYV^FX}z(PJM?68vkZrCIQ8^aMd$0yheqtx;F
zL*<Ie{kLy97O}YRvjAm4DwfSr>eN3Lh1fG8T)`2nupEyNmwu!8C9D6g(8PiP`ddTp
zqA$X1GuCoh>eCeI>C(j~WT=9v$NJZEg*ggpefwq);0!!(p|Uj52RU38Uu}Op0bWtc
zH2IvQ&C@MyGi%W*<OkoBBn2m#q)+ZhYdW;dE0!mai)3Emd2N&LC=!HIgyigl)WTaB
zXpF9L1Fn~@HsX05dxEh5c&xIS#}9~R`wBi($mt%%h2|@ZH#l+I{Di#kw_6jmx^Nh?
zy<S4zsn!OadXv({-Aop}2I>aC=Ty^o54W&bRsH6Ds*mFw&Zd;#Te|4UxGwO2es<go
zS1=n^JdNO9wewCx-jBB+G&rW)9T{ckv#9zucf8D?RI9^8g!zfTK-ziwCq?=-XLoNC
zb@{a21&DY`3<dkc7{Gqi?{;cqT^7)TV6|1v5)yIfH3<El>ruEQm0;fQq5^p1Z{5^X
zS}fESk2dI<=TF7IB{l33m*IkMqa!*k`;*MYopoD=a>or1HWx(jS&n4LqY99eIr<Qn
z{C5s?gAnb;p%UY_E`ZATq7_eD_WKY39tk0<{Get7-Cyx&lp-?*NMI}t%2#=I4z&8q
zyd>SVe0bBGnv!P5az5RCFQeP{sxhHqn*GyuYpd@GbAnp9@+-xH?an#7XI74aNfzF*
zRJO3o8s|<O%<S!2#k~wh`RThr2ba*21Dy+xd;<NO$~O4|!i<Ia@^Uly3b{EZR#VKa
zES~CLsqr2ur@_tS&h-3<xy!<Tn9Rc+n8zJi*t@|4fGfV8@li$0xO~Y+pXcd|UuKz7
zFW)&-J6eYx0?YJ4nza@Qp0j^nHuCg=UP1$=-LWiCSNF!<2>05tzV&wUw`iO(0Mv_P
zS;w|D4|0UGVJFug#CCrocjt?MIZrQ?-1X>J5o&obnP=Yp9RWIJexT**jhSQ#shTku
zcd{NoiD>GBUXUE<A2b$i>=Cv@0E3!nhSfNwg8t@X?3|`_SLqI~Ooje7%kg6G#x|cS
z8?8rs9kZKUZkdc@`DAa7Z=8GHe@tr7AUg+m>+##_n!Xck`VlPQ^O@_y+-fk+wly0w
zr;kfdSIqsZfvX+|)9~)%_5Mb%ov>FZ!km(NPtcmF;9f*#MtH3~pUHkCeDxI?r>4`g
z@yd#0m;uiWQDR2J{j05Z@vb^jw1wCG#|ATOcLE5CZ{KDOR7r=d1yRj8;k@6O`cpzk
zCtMidK*iK3(wIoJ<YZqq{xZ*}0UD4XjGb7qk3*C?(l@;RrJc}E_wDY{0@SP>Um+<*
zRRby*gE>=jv`{M%-B7XqAV&aOM3$ToN@u=zZOfg1)#Ho|jYE+c_F*IduV3a5N2T==
z*TpdB7+t-?jx@XZ<R84e_h?k{3;L}dAG@vB+Vr01RD&O{4|2Pl52vMq+^<Hsdk+e-
zPW7!3H{QFg`^DdP)XwRbTyC5Ejit<S+#AhtKAIiW6(S^H(u|e0T&OY`RLJUXz2A%&
z#G2n7%ZK>?A;CMwKL_t+mAJ)*T#fRx<_Ri7VF}KfR3`v-K2_6aOIAX==HEc96rWAw
z>h^P&7s7I^WE)aqUFz1sY(f00=bpFE^Fwix2{rP51{5zmCHxMf`CJq~1hd|x7p*d+
z1tj~s2D}yXYi=rqFvX}sA8p^UVW!%Y9$<(|Ucnqfqw}~42nETVtq$BD*4wB#WAAul
ze_FAjmIyyoFH_~2#+n_(Xunpzv-s9pb2up;1eQj-T!{g!wh~j>pfJ&e&5Ty=-cOH`
z^Es@x!VUV}hl~zqWr3}KYA+ZiWH>u5Zpma|TE5%8&>Em#(UfSm!x*EDXC%CgBhh!4
zZcNOqO0cZkri14AI~2BT$1>+Vky>jd@Kr9^%<1*cWqBvYtNiW1bv~Ltt9T4ct#~+T
z(udm=ZAEWh_x~>R36=Zd;Yei>L0Bja0qHM-Za+N2G;j3c*suZnwj;|8y2bK0I?}UM
zCm5s2QKtBujKg)X+S;7V>zMxniGB`J#cwTCn?+DZ^N0%EuLlfbh111fy(Cvs0J;nX
zcP<`b9=gl^fx*vPo-p(>Q(KVbqYXBPTxCH+v4rl0d!M&|DKxcp3iI(X$77+{H_6??
z&UPw5kx7if$Fp|UeEE!GpQBshOsAFHRznlJJ|eRZSH7KS@h7kpP-8C-ZgzdR{Yw6Z
z1Z(T}-3qM>?|Dbn()wQ}l)z~v4rnVT?*}bRRCg;5W19y*I|+g7*mnXZ;o3kXj~H@L
zG)Q`*ekY>O+3KD9CoS5n*F10{L4;9+oam4kGQFu3{)HYCtD)Zmvu(`V&!|_0CJF*^
zvIcVo@pmHQPVD!_i5R)nngw|mC4_pbUXllewehTeuh~uXQ#h`S;kgWpiRrf<%a8vI
zx*8jYU3<1q;MFY)yIVv@gdKVt=lC=N_4aSdE@GA)PGiZmOC2-HTBxZdn@k`3JWxM-
zzRTM4aEl`Y9|{t8)7Hh0Wy=XUhyjwcGgGTz0W!fM&ay7><Nummgcmv1>^{ovcTHCd
znR}3c?(Xe{efbsnSAY_(db@Y_v_dSjk$WXxnf04(s~U#s4@F>ElM6npv{va=_$|+u
zL$!B-<5_e)!oII*hGm_Idt=8Mr#Vrb`^c-O*5g&=l_W6mrbujCCIoS%CxXc1CFr7)
z)r5{Kx~D(Wr4tXwB9ytkDzi)7w@V(7(B%^v)}EV{4%>v6z6pGd`@#)fi19*S!Pv;G
zfod`WdLi}jW*S&*rTgr>8_U%@@E&s44vJpw%&6!@B@K)`m`pii;zo8nS6nx;-KrB&
zz28yb7kIMsnOnCSgbyO4_F&Glo2WURl_Qh$^S7e|5!oDR7!-Z8y(5|u7LM=ASFPI_
z|88l3Y88($=hW;(a&X*|dgN{B2t|^c;~#9(64G%qGJiT0e*^aFke`;~mU8i^f2{;n
zTy7;sFC7RpH!V##F7)B1Ni|UZn3`eGrqj=3S{H1*PTANtL$<8A+k~WPK=MJa+IxZq
zRp%}l_?T0j@z%%qp(@00&GC<(B5z8}^7*d<BeBL^MY=}Q2>13q#usbRY4d)MSiAbI
zr|7OWy!RJGY6_u9625XdQO%?vsRtQ=kckz)`Y!CyRUXuvF{1pK?E^mq)aws7Av8hQ
z8h&qyE*N2$4w|8tc5M6#f|EEwDF_o4k`ONx{6q&-)Hf=R{=BA$S6RN&>_R>$Xu62A
zd)j=aPIG1l&e@ufXI#z`t^3CU>c|Hj%CCmck3OPx2V>yExM}5st<dpjlW<~pPO_(`
zaZ%ZTxS_&}p)41-`;Dja&V@v34GKldFGdc5&Hzo<KxauG%b`I(tCI*q{Mqi`rEB1B
z@}D>9SX_4oZ3l-Ly18Gi|9o$-1=e1fJ(OzEZh30<*{kV#@sF&~StcJ}r!;dX;jmQ)
z(OdFy>a@10sTAJSicHR&ghzAn9UQ9YM<?vce`2z3!8)feD-08rUwoS=5QR2a+m(Ih
zdUE*_h$F(QN*qWJ3I~%e2<$1|@?W2UWEXy41DlNkeykS#VxX4fF2p9_dUi>3K<p(U
zPvlKDgoC%)`uXvYRN}-8ljRF#RxT9`SPzoRUKpjuIB&{)M-q_=q_SiHvC)##+tLJz
zXr5g5M#?mk*feyuYI{}fjMYKHUnA4j4Whi|d|n)eCTQr}gTD56J)X)CnFItF6s;!#
zP7L{w_FOSo4jqKEg<LNO7?@jlxCS1J#jVSTQRy^x0Jvg4*VHCH!BwgMovh7|{y1BO
zeo`d|U9YNz-y!<)n&mGPD<hlM?f>Z-cA>Q}k<fMNW3TYD_3k#Jc{5+`I1=W2aOfh=
zZ-`KK_?qZ4c%)|e{61cNI=(8M$(e4hOJwbAF@Y*xEKel)vN(AxZp0DOq`k>RW<vQE
z<M;KqY<SMKidW-D{Si@ey#AX}taCiMv13YcNt-cpcTc|NLc>$PNk!v&nQmXxrmySc
z8;@thu%Z#Rdb3k<+CYj7d`q&uxdy6=kB-$93RL!n5I^NmJ)raT@o9`7$u?F1T##lk
z94E10S3cR3G*bJMIZ7|d=oztYlY=25yKF3hK4~>eyDkP|2U_+Rjzoh7W616EV@cKT
zQdp)FF!D?&-UN3v^~q=r7o0u9(YijR?$N*N@S*LU`WyZv8IWxm)NJb*kM!@g;E~tB
zXFaP}q#by&8)Zr~UUM0GLH<VJ#@U)|QU)QT!4hL339d2Tc<<yt-698TmG-%*&%yX`
z$Vk%g|M3cga{Jw-ws&^)c<SNMuAnzF6HhH9c*?`KEc(m$D;T={d#hG>lB|nP%U^6;
zT>HsfKg{(#mVFE{Mz>o*G`;lMhy&<~=|4|mkSsmzr~p&ghAc62+&T>dkfEJ@en-n0
z0&?Rl^Y3t8IF{rm!z&yNL_V%lHlzyu=9t<q#DM`7T-_Vhbo1}>RrxjQcK)KA@l}Y%
zDKs&fj;i(}<jc#Ii;%eY;t#S)k4quYSMywE{23O&;FPT`2O1FdUA2jt)#43*wjSE}
z2r0KTJz5ANKGN}9bY9HJQ0CMonr#dg5jyDG<K+)LvW*X@xtSEpw3TOeq{mgY`TkF6
zQkZvOp4)3tRK!%PBOMG;_K4<c^h6aFG7<#D8>H7CET~|h#lLaZsVmH-cOB`(iOTXq
z)<iy9x#!b(S|q$dA0ES}0?z-ye&oS>RigLIo*OZ?Z^V5EkAPgLrSH{+A#r?NuGQw%
zs7wI8t#AK`f|xCA%=}1w+J_1^SHUk3uQW^{7S^L}&zg)8GQi(uEGN)02iGF(E_Cqc
zR}TpIe6+m>HdOO%5rDz@!(~L0qmz?W)cIN=gAzFO$mAV(#oHT9a2>e148~fWKAXC~
zr21<ZZ##t^k8>x#Hg9sDKOVv}y{&kHLjd?7Fn%CCC!+J>uQhsfnOLv}91|CJE<Ufo
z3P;C}2GE4%6SWYX@5u~Czuq}HNUYh3DOU(5i*+1f$iN|HN26Fa!@0E1`n*Hpl3=Ta
z3&@@(nGjAs%+Rvls%8#hrlW2%FTO&$s?{b3=lC_gpZ$fwcQyR|p<_8?COG@R6oFMg
zIf_!gRo$u=2+56Bnml(ARgH-%a(?ijDX@q=4n2vT)3^TAZRIA&@?7%eDxyTSA2S;v
zbOG`pLELSWVR0i_KwZFJ>4633B}S6bPch$Tri00<c@`m0Klq!!0FF$<$)VLSgK;vh
zofM03yKGnWt|!|_o~n^I5kq9^a}lt!DB$qyFIVcBRcV4UYrvn7QY<xA=Izf5`8%SD
zjd60B7IbsU^v;cmM~<1S@nV>AdYB8!hhr0S$|1s8*gwF&M8_=MArWe@qt>X%{ButQ
zcpn5*b0EyW({Hrgq|IWtjA^^1RX#%xw|+Dhvql%i;<-^(TXQ3KCgD{cu=s1rTIV1j
zDX5e7u!ZY5KjHm!e<8iFTwxT@u%8p594|>12!k0h+OK@s>=eKMZlNwk<{Ucj{v6n8
z*kzKWx2rFQWOP9!Q0fVdvyyC$5Qta7h+id#oQE&~`BoCECJW@!@-MfM*18PZeOkk}
zU`Gf?Z$}ga>UXi@JAV8y|5+)y{ja0kd;Mmy%^xEa4eJ+1*fgIhP8f_Zc!sY5Y%=BL
z;U)C-L+?X4n*G^|;!Y~}{ZNz<8HR^V2lkM&L`2^4uz4O%<N5hQ*W1}XPHtS+=dJy^
z%SILzH|W>?=$m`X8HDKz*Byauf56rp`Tj(|HfF4jw60?s&14FENU<~2+zxH^bT*5H
zh`OKUMms;)&7XWm6`87qx8HQ+)MUJUVD<T(Xzm+qy)@1KcJ{TBtF5l{rK*{n^I=5*
zP#`ZiG`i^Wv5K9v6fXPvTU2p=ahju?o@)}^hcV9N(EM&bp&^HRc+Mp}3lo&4=Ba_3
zpPDD6DyHQh{-(*#IsF9)-^*f}@BXwwtHMkdB;2;`K^gWC(dJNqGi}bR8_=ThAB?iP
zR26GXlpYwW70A5u$|iOAap>?jQ5hIr<IW%N9kptR74V8!2V5{fqtK1)fW<-3d_~Pn
zH=}sjdOu*M$ur!%L$G!y%H?0fDpVHbbdkp#xYA~$w|M7YMvA38RtbZJ`Q-VGBH78C
zkC%$Ua#Kz}`4#VfAKx7>Ox+Ab+906w?fWHrH5je4*&EldZgR_znYS0U$qO`dEs`Zm
zI2YnK*E<M3+S{D@7|VFK^4Qow0)&m=IH?6{Vx;}VLto1VUFd1H7@p@)?!4jZA4KHq
z5GkV!mtx;;z=$u%!`jilphMxs69<;5?x+c!^HOoew`|6IK44Rr>p&#SKdXR~<R+2x
z$5Fj#2k)l!{*n3>|M6>+34+M@E6wWjw2?T*jb6zq0vFXVWXtx4EVmrb-Q?0v0d(r8
z#z^U3layQNDTrAOU8S0hiZBd#S#zDO%SbjTf+-F=UpHd?c#}o_^UX)l{Wmdz);98v
zmM6&L8S7v9OSz!z@OJfEPHVh(h>o8K@jUv-<0pTx@)v&zxN+L8H>@wyqE3VzUpS7a
z{>0O%rAWJLdnlI2QGEHI+nSgi{!`$3L8zV_tf&9dOjvPVORP8RKQ(*UrO2@G{$F^D
zN{Np?2YZsrwET%qz$2O@>50JZ-3!J1piQU1NK$9(f(BmQtQK+b3kOjC8R!~A4C>yP
zDu|HxJf%+*x(s!*UHml1?b;O`gZ)-8z90c(iJLRX$M#}@qEWav3olEXQd@VYl&>f&
z6C0yi#daW7<y(%2)nUCUE=f>mdjj?i4Ch6iuym7?;Hm|rpNFvq{czLjqu0Z>py~fo
z+KlZCw1dnY6LO5M7#sIP!%7^t>FY`y$<{i>-2lY;aqeF8VY$60DH^l;RY#YHHJ|Q*
zPrtr!DAe807<g3<&$Yj$s$9N_{mu}QQf}Zyv+A`}2f70mIvOU<jg3WE3nDo7JT0$2
z_ar_%jPr4{Yw;OmBt6hQ(L3&jVvzgL=_d;;++5JAGz8eTX<hT|Q?Q>U>P-4bqh`H7
z{C@#cg|3uODYhT?D6*cnWnj>a(A|QB{M-{b4ZtC^-&0cGcc3_PuKxt#F0&d`26lWc
zN6JS%QyZLGrVkmDukz-^-Sr&W^(GScj2)!CO8XW2N>On7ME0+|gcbMA6rs~(jf@vP
zztdU*8Q+4t6cs<;$Y_}|8Xq4o!!lQqq{2@!(gpCF9!#*^^^Yfo(r>amAd5oJ)fHa<
zdyTJc-`~XwKzn#m78ODQIG?c<;*-sPN2eN4kOQ^M^f#}RySqBaBDf=6^sSb-nTA`w
zm+UR1&4#suAhNtIpSr*FFX73ay|B+2qmk(a5!${Ifr4(DHqk26Q{9V$NTNY+SQ)k4
zc8Y=!oG#V&{S9HAKy4K3&hv&o%E)MuayW=E5AiX6Oy>7aR{pz}F%Jfxq@}Q}>2RG5
z(Jck2vZy{uO@!Sz^U>}*84?JRC8tbaaxy0eaq+*Op*B_)aqX6K?Or)^x-I_N=*Of)
z)<ZCA>+6O~VggxgI2f=D8%xhhE}I04zRMmP(IPl0=<dwBC#u$0GR#+V1?ndJHkGyL
z$LQJ1-+fcQ0q%47(PC6{WxUj8WVD<2?nagYYxwxvE|SfT3~OVXTtND^BQp3Wv+n%m
zG*?^vUC2>e>&k#ZZ9OSJX$XwTj$bOMgrBLwss_D5;jp4WvXt*zjF7cDx?UZZ!B6|?
zaMhf&v%H+d7rm#A%vCD6g$WnL)q<7pPb+i1g=BD&%e!<rxjJq_V|AC3<^wQ-FdL6p
zOro(|x4*@Ni2&~XJZo_R`Az%K@sTCcAB}J^^F#RrPu9(hgD0v9P2EbvrssPKE*L@F
zOtNP77)EiJKDkU{z)M{2FVsF4;2DGY`TPh=y0QJEa+%;DE%UVZ<-!gk|3eZ{J|^wW
zskh-NW13K}JR*cwm~Z68o{_bv6bCo%5z!?+4Sm)Nj5%)AMowpQ%=e&aMQ`7Jd&4wy
z+FE}^-HdYS%EgOlH?j*xY8+&2ce;48<SpM4<87Hw%vBbCKJe(o*}JzMlzN7o`?Hzy
zO#dq9KAD`+tMlO68oX`$@Ij;S{@3QKUTv4+@y2jgXFh^DQ*hlNw`s|<X(?yi{N}Dn
zOmg8NfeM(D|I0r5M|J-8A^c>^uk!CtWR8W+jHeSc!ns;KX-6iG>TU45Sz6fgRQ%*=
zy5IxB(k>r@_3Zq#>urrmY_9srX{Th&AU44h(78Rk60;FypAH(K?5jEZ@$BzzY?~VG
z(g*RD4;gm;^HmNe9LwwE5Vkyht0Pt`|NJHEZAqn-;smsihfeLujU@d;ee2RBb-kuS
zwjcHXVRot1?gH&~mw6Npbgwqa`DE~)65&74Cq6Mw+*$DYnh5FzW35TipZTo&Z61vY
z;U2*tSH{-E{t-yQ-3NXf8&8ULA=4m=9&}i5y(Fc-FbLR&uR^rnx6@HC#rBj<jpt~1
zS3|lJT@LWAI=s^<M|8I}DcPeqlM!`z@i+z#GUF%e1(D8G7XI)3)FU2WoOEkSc=Z{!
zySJfUvzd(F`}@&BbGu8%HoG5|iLiV}RezqGvQrH|b>pLHem;(`D^*}!WwTqAw~M{~
z*f^2nXlCLgbW}C;b9cXb8FPoFs=AoSt&b=t-`TQq{j~Yl#_G@VmGUB&j=GI;_*obM
zZBH}eV%5oiy5?Pe;y+V;nOZm#0&tq=l-$5MXfT>2ez#L4zu`CWLW5gnvNL#xf%FhH
z`NmiWXoUL-R_3Y<#@n#_(vN*4{MqNm-(?6zsQo~RWT|r*m~~y%sClDNd^Y1?II?70
z^6jh}Q$+$U599J|h<nY+JAJQAZLXYtjCFgw?z3h5<>|+zs}lAd{7nQH=leqDSN3!y
z=+nZtnTmNg3EpEwn*8vCcQC{0tX}u^<?5jNn8<2U;5Hhp6sP+02z%uwIr+C_{d*jK
zPRkICQ0%(X%IS>t&&fp!uL11ddrY{B{xioyvNY`7F*li2-3Y|XDe;ADS6CW!)4TGS
zHA-3fEk>#haYY;cHMT0RsGpL1FC6#3cY*Z+u134o(>nL@vZu1QPPir)h??X;`iH2g
zwe~L1&#pQB!131{l^7aK+O9|W(Wa0(uZy76C`<YTbJn3OugT|~c!Z5%kIJ%kiu+pI
z@{|09DvN~2A$T&eYPqLFB>O#tthHgDUC4onW91=edacB0>#oI|P&L!|8yDS#o<yXb
zH)$S*7kF0Z5cT?Mw#}gZyRMrLd-o}ANR?nav5LM(xsh*2<d{0d`uUL2`4b8o-1q24
zu<p16UI5z?_sS!)#o+HusVU!ooGpiD%HvCIWvtVFa<)pYkax{!>pr}6BWBF!KaIXl
z+55C|<n<)&BB?dqqI(9-q7&z5(@q;t$h=<NBT^WIf4tM)ddj8b$UZ%h@*%w7yK@6v
zCyxq!JWIIts}R74ZX6V+aJlg!?ywxl(<1k=%aj3e=v$%o6u(A5X~$&BBVh>)@Ryjl
z{$4Fn!p;{!a;qC&aC_<-W<ow{aof7m{+dU<a&?rT(dZA4h>qN`OwNIPG*H<lu(JBG
zF)<e#mV5U0q_ry-n@xVo-c$$=X~x9K54xw}BsC@V%~a#=+!eKB6YF8}x(P%lqq7p)
z4j!|_pr5_2PqO#gbn=L0DTNys2`A0~o}h_~-txOhFBMSl6UvXV(Z8y*RWaW1zAHNG
zc;qeR4ZLbb4uPhkgC}C9J(QfNM(lc`=?=$0-rY9b!<t67EFAYwrbxRGH^TeWmq86~
zv=Va|4XVI70*CvK7K}^52Ha!7=K$+;{Tv@3cHi^m0osx$;XW(vsxLK#WoiiUK7;M`
z=yqH?bcjavw(RsF0zU_XVKyR$1%zh+i5bqiaK3Zwydr7_vy)ZMmlG~#e#HST9}RGn
zbIicCOu^JI#!7V}J~zr(%SVfxQ3LkQVH`dmA51bXo_0&SRjq;-2$MqgKi~Y#jLj~x
zK?TF#1X02E9Y}gVA?<eak3EiU9blvK;n@rws!FCmJ`^0ocPn`L_s`F#1IMwVT*4(D
z>w&$L8w9XlWM>=vJ5=A{1IHem)0wX=CcZ-jq(*OD9(Tot7Pap*Z1AXJ0>Ase3_>#m
zb^5g9l*vEU{r<xv-`{%yGYJz%M@qprSsW#lCQfQt?rrXS(OT**JSfBd6b5kShHMlC
z_tL1-B!h99n;u_$tsf6T)T%L-r7Fpz#ZN@L#XaxOn!YO5n?&##TmSB}CG=Xd>lFp*
zeZC4A<&dR;vDUMP?GS@!e1ES=J$A=@zV~d-77iE(e;LaaeHvq9yy_BIgJQ+%{&)jB
ztb_uzJfHODme;CDe1vY2us%ZdnGv!j%e~J8CyYAaCfxsG8*l;vyoiSKF$$eK;j0R8
z!sX73j$?R@ri{>YB4IBG^OCTr>JFWn)tYVE^2p8b7(Ep!*ZvgA8Pe~f8BTh=VwfH<
z({s!>R-ll#T>8W8AZFO!8#*;_<3XpY4I+t!a$*L4DsPf85nYCe&mlcuO2uV+*34B0
zOG1XAr;N`g5~UVn$%QGJAC1WZ3t^@Bx6#YBG_&IQ%^{H`WyfC*T8>%uY*TiPQ_heE
zW$24O<Bn@NToPH*KQHovqiYi~`V!=MejT3ikkQyK_!+p1j7(H~I)^II`~*8(A!;~U
zB{0Q%y@rVASB_xN4yhsinn@Noop?vULIe7^?3!`;>!Nop$@x@;E6Vzjrp<l{<G{&j
zQ{#l@s1l+?)OX_cYMO*^zOuXs93W$OP=`bCz1WPk;B50c9NNa$J`sF2>p~c?R6|(r
zqyEl1f2hJJX9*r9^pyH*s159V<RW+}IRWj#ouT=<G*^yK4&5SWSe_e7Dv_5cLtj&J
z`QaHw4iY+<&Jhbq@1h*;n37kS<HvZ<w0LtsZT$JOagtJQyunp8*$n1PYTc!WtGnEu
z%Cjw~wMXNWWwGvJLq($%3!r;V%&%T^wxprAbah-UUOijZ%Ri?}UDrs)bngn27BRK#
zy>~93;HNusn4itcx4AM+(8$C4>qSMz<J9E5$b~57`qzDrUS%bL$TYYOa;-8^XQqH}
zrl7@bcLY<=q)CAjs7XY29M!?bL@ZXY<AK58V|TpRi1JQsG%bDm_h0-D17Tu&oplgl
z#m2-iWp_|wiNK7o{zhXk`eMZorAaj5E!vQZ5~29+ycnTWsz<9#17=Xgf)2=j>&sXG
zmbwFmgKMSgy0cf^B^F7bXr^JxtM3?H7*CM98R4!$LIb>#6@@V*`VgtcI@_kZrCHYW
zR{Waup2=uET3PHBiD<kGWDJMJt<vi6cXTwnt8U+_GOu9CNAaH3nGCB@ElQCW&z3@X
zKr`lq?N@GIgmiPVZN3Gm6k1!u<c}6Zj0YMpRxx6=-ahj!1KK@2@g$Jdl-T)ktJ~Cv
zBPNtJEOW!I3?8oSDyC+A9E>n<MJLDSeQDG5ombZ>b6qjt);5YZi8VP}ex$<AZv+rf
z0~!{47PDz?JoxQ1VMFhU+>jkT(qbOs@*}(>64#RFLT|54g1iiG(iI5xytANA?oAbR
zE<V(Rt*S2^uCcT8!QH_c4VWRdhp;lq-m@yc%g?WST6?%QNfWs+7IZ-gy#Mf)Px^sa
zIMZ<<W1$Z6NfNlxdKaFmUiR~#Tci_H6juKiPG=n){V*HV28l4ByV4)0SmMCu{cCom
zHT=P#D(H<)rgpzs8({e;`_!js`Qa}mE;?dCtk|>3FH7z60!Qi9z1SDh;@}NZC)VCI
zqVaxy<r=@%p@3;*;0qJr<P6t4B8Ah&yWnTVvq!vlqxdMK0}gp1OLB8CvIJdA;~K%h
z*W;DOk0*3SQdDnQ+g<S}A;!M&A3OQ2e{O>KLRMDfZ_>v+8C3+$JPqFdWPIT(9;=#x
zs$BEObh!KD9iOVEi{c&dekqYz^q!Wbk3FU@HD}E$8?Z*FJ*M)FC6FLv;?lYtG5b_c
zAK=>-gK)>nG0X}~Mg8G8*K)rXyv^`NM~l78Bi$C<F*i{eIEi2-U!My5kCrB0NT~+q
z6|k(HMxu`hE9}83V@y`9NQr)jj;3kqx7Pj0F6>mD%C`BT2RS*at3_i<EAw05TLQQQ
z9?!XWIuv&WckKmLhsVU+%`vlp?H9?F<gZ>*b`+ywt}i&Wlw5|b^lcbro%!Eo-g`)<
zM7@3c8HO0-KGxedj@=^&k@O(LbSwW-4N0V5?i26+5AYZy{@<7Wzv0LKL*@0aJQzk#
zRM}MjZ!H)aY@7Y>jg>nUFKGY!nGEm#fA%40efzM*VIUWfudc8B&dmTv6!o>V^VRMM
z$PV~IjN<I)^jyPUgm^X9OX|ZZoc%Xtx~bakQbz0E;;57#2w#odXVndrZwC8yFIRUd
zl{!gXbe8tP-q<_lbIUnbfa86V?l@}iElJ6H`Iovk4|crDOu+n0c>0DkLZr^4^Yb={
zzRIW@+4<?P1T@V~E`0;xG`HCK+$o5OR9l2A-n_7^VN{^A|A=M&S&dg~G+w1yMCjr@
zwOo{NIQ0CMtT$}MquDGdSM%WKCa2{rQ>EL5F}uw&&s;&=Ry4nSsaEyZWta}T9E<(~
ztfeI;na4iI^XsS5q-$N51ruW!lHPpLWP3XlkRCP`B_tio;+>c}8U$sqoB>2p>46P>
zS@8m}{tLhtScid%=`9M@dnQbQbKwh^c(hsQzi#mqS_{*_Y(Q?2Om8*L*rx@TQi9g3
z2>M67M+9+=RYSDxmDc=>zdXtxK24qI^tLhz5daOIQ~2i6=Ss5fjX*2nbGyvb;8a`J
zP_sE7%5sR?Z$7NlatuutxFNqc0565723KIE#?mdrN`IR!rOlI5C5dz>_t*FNPpub6
zQ0RKVg7Iy>b2&(5Hx2oOadCP&^hij*Mnx-tjY6GzG`#jLN>6IZmBL$$P1dlo&6%G1
zL)|Mc=Q1~eHo2N;wXiVu0!#z>W9+-X6_#)9oiVMtPY5k(<Rfd*nf0(uTc5yVK=poD
z6OIa*kvuY^?|&5L50-`y;G%g!(ZcH&B~C;;<OZ|})A_6H!9jb6kxXS}YqSnwFMy&&
zIy!oQ&^usBC#tU#^acbx`9!^y1hD1FXn*O*NcX;7cqup*M~(?STFK91h-?n21KI9+
ztW@|6GjM7kh8B18Fj$fs%_nWOP$j<XwiUHm0C+CipDKt+7V`Fxes6uKu=mn^p<wP>
z!@BwDj0m0L8D_IlxAuALKl=VP5}M#C+0;)`=?;VRhdxM>cRNW21obN}X?%0@t7AX-
zx0_)-7z29;Fbx?V^a=p|Rr;;H>7ov!q9}>(6yW=K2y0SM-}#!_fC6eh<y&(ZqT#k0
zdQ(+v8^430g1InlfNgd92!LF~9P(YF46*rMpEYb@R(e0WB#?V!Ev}An9S|G|)i#2<
z<hg%%Ev%A@&?Tl1-+6B*l}Du`8YOO}m}TO~Br@T=^!VtJqcEijz=X`b3O<*(l|Lq^
zcFfYsVP)GvjI@VpZ(F1?z+ao~F~+IaMc=DzPUrHQzJ?}aN7Pvngavx}NsB*+fz%5f
z8<3RYvvwFdy>;pc?$CLKol4DVG7ajr_0AS@5_o>=uvR)9aS!^1>3M{%Va)54mOZMs
zG(cqVF~d55o?-!RcSjh0leIg|wJW{rTqoj|M0bl#WSarDTmx=8;oW%vyl3zwDZ15^
zeB{Zr+VDb+e(7?h9N4eq0SiCNW{Dx6C;-tg65UgFE;A=ZHJE!A$f&P*m*@HMo!$-<
z6j6&yCZ6CX&oCA7_9n-yRND(woTo{5*h`qBR4G(lT)WTEZ5{7(_TjLH*qxLX|3dq~
zjNyoDBlfhW7&9kL_9*M(g#KWZz}eUv^T5C25XlLqD~lxKS1;9X)wWu!k<xXV5VugF
zZdv~1M!)PdC6`lIr`~ej^~M;c`peO&x7pm!jUlKu8zZosD_7gV6uLKLH|&7BSP#G|
zb{whfe_s-<0C=w9Tl9CD;GOrrTj@OlwU_JX&pW+lZ7<WQ4@Y`KP-y2yuje@OImcuu
zaTBHsPy$bFD6*s@WB_!R8tik!L1tr_o7n-F(yz@Tti8By=1R3VmGtz=%6tFmV7d|Q
z=UtW{_x`Zzc_xUT#k@~CJu?#qzS=ACihk)D%HY?S!Cmx%Y2b_BTOZlR2;M51_`o`A
ze){YmQ<THHXe3%-y()uPI~iQosXt)Bi9<+F-|2@&spjvlh5tG|!v6Q)oOM3W9xz;M
z`(cU~Ruoe?Ratr@%0A(9Ii_oaJXl`9+MYsTdOP|Z3s|IAyTfKXLZ0)yJI$EnB5wCM
zSZ;K@Y?Qc%tpe}0t@mF9LE5#_Gxi~vWU4;30^{KSECkD`Hl=uOE8h5W2sZLIm4fx@
zqwA`>1gYaNdk(BNH}Hw2Vg1$2L5OH%MaQjAom{=<UD1d)zDtwH=G2`?-5rRT>jvFw
zX@p?uPAT?s@$W#zP$f+2S<-U!WN{v8wc4V!470(ZfMgTb4(g;0*A3w|ERBUwG}|k9
zn($F3L{67;2BcUEHb)WJ4*xWGm=JJ2-T8Cs9q(^58v2cG{kKu>PVK72SMtcS<H$w1
z6o7;l;*VjBrxzKa=9_&YpY5|CoUMdQklCNCdxyN#1%T+ofq<dnE0X|c-y|)Px$t^!
zTkNuu;@;t#sN8xHB5M5oa^($(me(&$ss!6{H7i2yu-i>Z_Y=LMA8B4x#67k4W^Cey
zc3;}EZz5Zz>g*)zYeU1<dfRPC(PIx*$&Tpc!)o#7XqKT(^Z6v|t#FZexw*(Fz2z`F
zY{L4MTtIxnq1|igNS#CL3c!b7sXHT|9OJMg39I3g%{_XOMLe!2BzlcP$P%x+-{9s>
zL!b5lGeg)EK-7?=0#{Yy3<g2b=+TD^*VO}((L}3@g=zB3va9Gg@5sb8yKam_0rG67
zeYf$rep|t%8Ytwk<O#71fH4@pkao8Q1mt-u>OZZegFAQ^aULc1wZ4!z6cMJ~qA~&v
zOOM^)9cl0=+G*<Us*$bDgmjX{iMUFY64RUmxWtJ#jb<Zk42J(^>pK+fSsA)IE#K8I
zJIGX>I(u&WTf18?a))0AGlxvhkekA@ZxP@vJ-)wV<2z1{>W!qp!)YOBV>A~csk?I=
z-zyuxD<U#$dSp0u3g`)Wh}e8iE6NlZcd72&^~S4dS=jzQzvFhd;yNSf@Ru^=!<l_g
zh#5QqMk=iC&KS~{zhZT0Yvp^V9_#R9nCG=QT3}OOyXTw!YtK7%>-Zv}<^5>Ao>{km
z{l(!%<hJEXF|wG#6>+l9ipOVK;7U&dvKZjPJW*!{0`jZjCy|8^@_6r&9u|515vT=r
z|G|}MQ69X99W`Oo2jjzr2&+VP<+$J_mFZCCNi2j{`a&|F8rn$-dXM5?oqg2d$tdUj
zhE?rNcMtvpv-FQ~tzIik*(W3Y{GeuJ(f9jFsJ@C4d$<G$O24OW7``N%bU_e_TinL|
zgxlD|qoNV{aIz(0`aI<jR8%n_0S@;;)gN`ddW!)%{<GxBq1ec?l<ThTj~RRxPVTUF
z)RL})dqW!C(96ZTmo1Ns)Co~ev0%5=(i31gj`In8zZIhv!lD5y0B5r6;F@^CIwrr8
zjXb_T!TH?V1no)`J2+&W^Q4e$U4P&E49{tpe81___<XyxQiAznmRq`OZ|%eVhc}PU
zab=kiH>60+wp_eKF1&W_-@baaKi@iflkU9h(EbXezB=x<OEwFKSUw%MFN@VsN?1~b
z>gULF1=pHWvKqJFC3@aD^t7!&)8SmnqK`}+Uh~cXRhBWpsinmzDs^LS5E^=$kpOE@
zyV{vkJ5gS?5gM!~kNDE64a~w=va1UuGvH(E2FV?>G3Xv<2UxdF$J$2PeEW)aWWb(t
zl7Y`Q!731CUY_*Es9)m;Y_4Y6H~CD9*nVs?w}0)=B{Thk=4b60m;i9<887NWr$5Ag
zG&RilWGZ8QzB+c`Yl1ZF=lD^NUyZ@27R20}C{~y3{3@wj-=+<0`uW~hWaII)dF%lq
z<qBBJUz$FhGB(l~t2<F=`19+RQR27N7I*sU3%9R|Sq*os+o?894uLmbh_IcTJ_N!<
zLn#*~i3f#sZnXb;1TrQzYLN9lp4Xc(085t)3TGGV75`6*n<j%{zCjvzZ1tU$f}gJ6
zK<nHyZ)R(C5Yb~Z?gq>ej_)V^2w&^N*##xXy&>^RfXjDvlgimDBdetT@!Xk?GiSeM
zSoV!?xS@tI?=#S72kXXng#7|Iz46j2y(nYNKt`aL&qgA4d|t<_8-Hie_?ME?b`d=D
z#`OL=lDgFEvX@IwSvy{*Iqzjy2r!b#Ww?NleV^u8lMEZy^rg_g=a3F^gVPR-v!+tT
z!Ft>n&zyboS6^D^To(F;;gAt4h;*mjn6aOP^;Z{b^dpa!<>;aB5b1h25aGlZk6Ml%
z(>Rnycs5Ml(kw=*2h{q%tLcz=%PMmcN+xoImG-#KH%nlgIMqy}_^mH5V=Yp$5|tl#
z4>&vzhcP=chH3g)KC^C5fCSQFar$2k8@D9_mcd7m?sjYn_esl*zo*GyJbkf%CM2j;
zprYLu<KWaR%}JzjrC=xAT5zdOrwG@SSKs5{qjNf&k*Kni4+Ok7Ga-`<%PF$3w)=Nm
zcbE}i8a9eH-8Mc^NnYIIP0-xw%W3DZ(2uCS(SEJh8zrpZR&ZV#9?O4K65D=D#o?fX
zCXo0^!h04pI?(*u<#&IdlOlv2H5QXo&(Xj)yEN+KG>+w?oR7wg{1Y94jb6%qUPK1O
z6?eus%1jW5-BnDe!^VL=JW8rB#CF3W;gZB^P#&EOp3JTet<VG!;AND%UK6EFq}z49
zK1~65d}za~C~H^l%7<L@86IO8F(CQuAhA))a!V>oc8!vsx?1(bmx(2gJ(D7PkTD4B
zSE^DEK4N7ZzcLkkq>oV=h*EBVUdD;l-I&S5dWh&`Ln{3Uxo{CZ6tJRBo=Iy2(Y&(~
z`Fw6dJO=LmUGqVDt8{~YJVxPb?Lc7VoW5s~Bj_!u+Vjq&jn56?b*tL`qi?JO^-(#5
zMy8&JzfmmZ(W?2XDx?bJ`ZvV=X<)@OV(1ZrpnJ(x)yK2W284H1(5789+F4At6u-vo
zc}gp^9IgO<U1>SQC9Ra+c8Ke2^OIQ*gX=Bn#OgxNR?lhcPyS0!`^on#b-g4#kdurB
z;&z3RPO6PAJrp`lXur41)m-wyW&~2B&G$PC;}9OD8f-$1TKs^mrG&NhVpC(*1=%s$
zHuXKF^`ukCDMd%_>pcO&mwB%sKyT(VaN7tP{DXl`#-~a)A_$+2x|tXFdHo)J1V&ln
z>3Nu5S4=r8#<Fl_b{5#2JBWKFt93`9RgVzUq5LJ+|1wX3vere$@jcYD_8x`|zcPw8
z3Ba)$wEnW4-&O%?qC~Fz9a-^z9*l4iLqVbmYJ98S8khmtMuPUzglH@E?k$W@aJahH
zwPsn1NXYIP*j5FuWYm)L<tHahpu>RV$RUNEH`K_wAgSVz$TP$+{~c%lu6Il)6|PRB
zk<M!N35mLU_kW_ehSd>L06uDnrx+t=Lkz7#W@$W<9_xRDIPo<vnvRfJ#25&|(F(8{
zfECJ?n3=j*Y*lwUy#35x-KT&h5^Pvbb~S(vbFqYJFFUEB-P?d5O*Fq9xZP?o$&a`{
z`pEN76<4!)wj5pUw)j3rcXbLt+6l(g_&1M^tSu~h&XRzI@jozp*1%wnJjElsP~4+u
z5bR`2QXFS>U~vxS@rofg1*Zs+-!-UiKGs>~Zgxfr{iiwcqSHiKJIQwGr|ezp2#Ma>
zx*_c|Bko!#QW&4TvKr%#Hm&hy-#z!>GJxS}5=o=KUEW8X?LQ_Qe+@pdg+)~+tsGcf
zT!$frRdWTn;adt)K6%uT487;B1z#r|a<0jViwzThEjq_Jt>lCaq(IwcD)g@#mDNr~
zu$E=G!C=Bh7Odq$rQGF`jb94Sl+eG7vs_0+@a>m}E<**l*#EKGlNs!{6$U@)^@j-L
z$lErbaB;^!KU=-wGvX7R26QMr9>}Ne78PVFH}`E3w`Kfa>$Ukk)%;A=F<U+X_9>N9
zL}lId&590h+v9lKd=02kRPs0Rdk(Ov<E(BIp7V;;%lg`nqzgyy9F_OdV9PPESe(w0
z`~LZYw}CHyo4hC%3EMR*2RQpLf8y)jRmib-;k=T_(^l^Cck$r(W83q!{r`=9+nc5&
zzrD5f6^G=e%*$$DXHQt>um-p_wr_5^FvDry1#kE(-b!9qH{RfIK%5=8#!Q|GIPi0k
zq1dP7+JZS#nF5LyxD@ef7;0|)Jq0-Qwow&Wi)*!>v@H)lzQ68aKCc60`=(;c6swRw
z#tpuIH`FNJjbnt3jd-lQyu{}(Vw)vfI-SSax?DT{^LH7h$5kttd<LGn!r<xZ=d#Wz
Gp$PzUz=Wv)

literal 0
HcmV?d00001

diff --git a/src/log21/Argumentify.py b/src/log21/Argumentify.py
index a7e19ba..eccdd9c 100644
--- a/src/log21/Argumentify.py
+++ b/src/log21/Argumentify.py
@@ -18,7 +18,8 @@
 __all__ = [
     'argumentify', 'ArgumentifyError', 'ArgumentTypeError', 'FlagGenerationError',
     'RESERVED_FLAGS', 'Callable', 'Argument', 'FunctionInfo', 'generate_flag',
-    'normalize_name', 'normalize_name_to_snake_case'
+    'normalize_name', 'normalize_name_to_snake_case', 'ArgumentError',
+    'IncompatibleArguments', 'RequiredArgument', 'TooFewArguments'
 ]
 
 Callable = _Union[_Callable[..., _Any], _Callable[..., _Coroutine[_Any, _Any, _Any]]]
@@ -76,6 +77,90 @@ def __init__(self, message: _Optional[str] = None, arg_name: _Optional[str] = No
         self.arg_name = arg_name
 
 
+class ArgumentError(ArgumentifyError):
+    """Base of errors to raise in the argumentified functions to raise parser errors."""
+
+    def __init__(self, *args, message: _Optional[str] = None):
+        """Initialize the exception.
+
+        :param args: The arguments that have a problem.
+        :param message: The error message to show.
+        """
+        if message is None:
+            if args:
+                if len(args) > 1:
+                    message = "There is a problem with the arguments: " + ', '.join(
+                        f"`{arg}`" for arg in args
+                    )
+                else:
+                    message = "The argument `" + args[0] + "` is invalid."
+        self.message = message
+        self.arguments = args
+
+
+class IncompatibleArguments(ArgumentError):
+    """Raise when the user has used arguments that are incompatible with each other."""
+
+    def __init__(self, *args, message: _Optional[str] = None):
+        """Initialize the exception.
+
+        :param args: The arguments that are incompatible.
+        :param message: The error message to show.
+        """
+        super().__init__(*args, message)
+        if message is None:
+            if args:
+                if len(args) > 1:
+                    message = "You cannot use all these together: " + ', '.join(
+                        f"`{arg}`" for arg in args
+                    )
+                else:
+                    message = "The argument `" + args[0] + "` is not compatible."
+        self.message = message
+
+
+class RequiredArgument(ArgumentError):
+    """Raise this when there is a required argument missing."""
+
+    def __init__(self, *args, message: _Optional[str] = None):
+        """Initialize the exception.
+
+        :param args: The arguments that are required.
+        :param message: The error message to show.
+        """
+        super().__init__(*args, message)
+        if message is None:
+            if args:
+                if len(args) > 1:
+                    message = "These arguments are required: " + ', '.join(
+                        f"`{arg}`" for arg in args
+                    )
+                else:
+                    message = "The argument `" + args[0] + "` is required."
+        self.message = message
+
+
+class TooFewArguments(ArgumentError):
+    """Raise this when there were not enough arguments passed."""
+
+    def __init__(self, *args, message: _Optional[str] = None):
+        """Initialize the exception.
+
+        :param args: The arguments that should be passed.
+        :param message: The error message to show.
+        """
+        super().__init__(*args, message)
+        if message is None:
+            if args:
+                if len(args) > 1:
+                    message = "You should use these arguments: " + ', '.join(
+                        f"`{arg}`" for arg in args
+                    )
+                else:
+                    message = "The argument `" + args[0] + "` should be used."
+        self.message = message
+
+
 def normalize_name_to_snake_case(name: str, sep_char: str = '_') -> str:
     """Returns the normalized name a class.
 
@@ -278,8 +363,7 @@ def _add_arguments(
 
 
 def _argumentify_one(func: Callable):
-    """This function argumentifies one function as the entry point of the
-    script.
+    """This function argumentifies one function as the entry point of the script.
 
     :param function: The function to argumentify.
     """
@@ -312,15 +396,18 @@ def _argumentify_one(func: Callable):
             args.extend(getattr(cli_args, argument.name) or [])
         else:
             kwargs[argument.name] = getattr(cli_args, argument.name)
-    result = func(*args, **kwargs)
-    # Check if the result is a coroutine
-    if isinstance(result, (_Coroutine, _Awaitable)):
-        _asyncio.run(result)
+    try:
+        result = func(*args, **kwargs)
+        # Check if the result is a coroutine
+        if isinstance(result, (_Coroutine, _Awaitable)):
+            _asyncio.run(result)
+    except ArgumentError as error:
+        parser.error(error.message)
 
 
 def _argumentify(functions: _Dict[str, Callable]):
-    """This function argumentifies one or more functions as the entry point of
-    the script.
+    """This function argumentifies one or more functions as the entry point of the
+    script.
 
     :param functions: A dictionary of functions to argumentify.
     :raises RuntimeError:
@@ -361,15 +448,18 @@ def _argumentify(functions: _Dict[str, Callable]):
             args.extend(getattr(cli_args, argument.name) or [])
         else:
             kwargs[argument.name] = getattr(cli_args, argument.name)
-    result = function(*args, **kwargs)
-    # Check if the result is a coroutine
-    if isinstance(result, (_Coroutine, _Awaitable)):
-        _asyncio.run(result)
+    try:
+        result = function(*args, **kwargs)
+        # Check if the result is a coroutine
+        if isinstance(result, (_Coroutine, _Awaitable)):
+            _asyncio.run(result)
+    except ArgumentError as error:
+        parser.error(error.message)
 
 
 def argumentify(entry_point: _Union[Callable, _List[Callable], _Dict[str, Callable]]):
-    """This function argumentifies one or more functions as the entry point of
-    the script.
+    """This function argumentifies one or more functions as the entry point of the
+    script.
 
      1 #!/usr/bin/env python
      2 # argumentified.py
diff --git a/src/log21/__init__.py b/src/log21/__init__.py
index 6c4a446..52438fd 100644
--- a/src/log21/__init__.py
+++ b/src/log21/__init__.py
@@ -16,14 +16,15 @@
 from .Argparse import ColorizingArgumentParser
 from .TreePrint import TreePrint, tree_format
 from .Formatters import ColorizingFormatter, DecolorizingFormatter, _Formatter
-from .Argumentify import argumentify
+from .Argumentify import (ArgumentError, TooFewArguments, RequiredArgument,
+                          IncompatibleArguments, argumentify)
 from .FileHandler import FileHandler, DecolorizingFileHandler
 from .ProgressBar import ProgressBar
 from .LoggingWindow import LoggingWindow, LoggingWindowHandler
 from .StreamHandler import StreamHandler, ColorizingStreamHandler
 
 __author__ = 'CodeWriter21 (Mehrad Pooryoussof)'
-__version__ = '2.9.2'
+__version__ = '2.10.0'
 __github__ = 'Https://GitHub.com/MPCodeWriter21/log21'
 __all__ = [
     'ColorizingStreamHandler', 'DecolorizingFileHandler', 'ColorizingFormatter',
@@ -35,7 +36,8 @@
     'debug', 'info', 'warning', 'warn', 'error', 'critical', 'fatal', 'exception',
     'log', 'basic_config', 'basicConfig', 'ProgressBar', 'progress_bar',
     'LoggingWindow', 'LoggingWindowHandler', 'get_logging_window', 'CrashReporter',
-    'console_reporter', 'file_reporter', 'argumentify'
+    'console_reporter', 'file_reporter', 'argumentify', 'ArgumentError',
+    'IncompatibleArguments', 'RequiredArgument', 'TooFewArguments'
 ]
 
 _manager = Manager()