+ Q(if<^RIt^RIt^RIHtHt^RIHt^RIHt^RI H t ^RI H t ^RI HtHt^RIHtHt^R IHtHt^R IHt^R IHt]'d^R IHt]!R R7!RR]44t!RR4t]!RR]44t]!RR]44tR#)N)ABCabstractmethod)Iterable)suppress)chain)Path) TYPE_CHECKINGAny)definefield)ArgumentCollectionupdate_argument_collection) CycloptsError)to_tuple_converter)AppT)kw_onlyca]tRt^toRt]!R]R7t]!RR7t]!RR7t ]!RRR7t ] ] V3R lR l44t ] ] V3R lR l44tV3R lRltV3RltRtVtR#) ConfigBasezBase class for configuration sources. Handles the common logic of processing configuration dictionaries and updating ArgumentCollections. )default converterF)rTNsource)raliasc6<V^8dQhRS[S[S[3,/#returndictstrr )format __classdict__s"]/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/cyclopts/config/_common.py __annotate__ConfigBase.__annotate__#s""S#X"c \h)z$Return the configuration dictionary.NotImplementedErrorselfs&r"configConfigBase.config! "!r%c <V^8dQhRS[/#rr)r r!s"r"r#r$)s"""r%c \hHReturn a string identifying the configuration source for error messages.r'r)s&r"rConfigBase.source'r-r%c><V^8dQhRRRS[S[R3,RS[/#)rapprcommands. arguments)tuplerr )r r!s"r"r#r$-s1   S/ &  r%c @VPP4p\VPVP'dTMR4F pWE,pK TP'dTpM'\ RTPP4T4pTP4UUu/uFwrxYv9gK YxbK ppp\TTPTTPPR,TPTPR7R# \ dR#i;iuuppi)Nc3L"TFqP'dKVxK R#5iN) _meta_parent).0as& r" &ConfigBase.__call__..>s\*EQ^^qq*Es$ $) root_keys allow_unknown)r+copyrrAuse_commands_as_keysKeyErrornext app_stack current_frameitemsrrstackrB) r*r5r6r7r+key filter_appkvs &&&& r"__call__ConfigBase.__call__-s "&!1!1!3 T^^9R9R9RXXZ[\  $ $ $J\#--*E*E\^abJ#)<<>I>41Q5H$!$>I"  KK  MM   #nn,,     Js9D$ D3D DDch<V^8dQh/S[S[,;R&S[;R&S[;R&S[R,;R&#)rrArBrFN_source)rrbool)r r!s"r"r#r$sA}N.44Z=r%rC)__name__ __module__ __qualname____firstlineno____doc__r rrArBrFrTpropertyrr+rrQ__annotate_func____static_attributes____classdictcell__r!s@r"rrs %R;MNI.M!&t!4H=G """"  3r%rc<a]tRt^KtoRtV3RlRltRtRtVtR#) FileCacheKeyzAbstraction to quickly check if a file needs to be read again. If a newly instantiated ``CacheKey`` doesn't equal a previously instantiated ``CacheKey``, then the file needs to be re-read. c0<V^8dQhRS[S[,/#)rpath)rr)r r!s"r"r#FileCacheKey.__annotate__RsS4Zr%c\V4P4VnVPP4'd?VPP 4pVP VnVPVnR#RVnRVnR#r;) rabsolutercexistsstatst_mtime_mtimest_size_size)r*rcrhs&& r"__init__FileCacheKey.__init__Rs]J'') 99    99>>#D--DKDJDKDJr%c\V\V44'gR#VPVP8H;'d;VPVP8H;'dVPVP8H#)F) isinstancetyperjrlrc)r*others&&r"__eq__FileCacheKey.__eq__\sV%d,,{{ell*ddtzzU[[/HddTYYZ_ZdZdMddr%)rjrlrcN) rVrWrXrYrZrmrsr]r^r_s@r"raraKs  eer%raca]tRt^ctoRt]!]R7t]!RRR7t]!RRR7t ]!RRRR7t ]!RRRR7t ] V3RlR l4t ]V3R lR l4t]V3R lR l4t]P"V3RlRl4tV3RltRtVtR#)ConfigFromFilezdConfiguration source that loads from a file. Supports file caching and parent directory searching. )rFT)rrN)rinitreprc<<V^8dQhRS[RS[S[S[3,/#)rrcr)rrrr )r r!s"r"r#ConfigFromFile.__annotate__us#"""$sCx."r%c \h)zLoad the config dictionary from path. Do **not** do any downstream caching; ``ConfigFromFile`` handles caching. Parameters ---------- path: Path Path to the file. Guaranteed to exist. Returns ------- dict Loaded configuration. r')r*rcs&&r" _load_configConfigFromFile._load_configts "!r%c6<V^8dQhRS[S[S[3,/#rr)r r!s"r"r#rzs""S#X"r%c \VP\4'gQhVPP4P 4P 4P EF pWPP, pVP4'd`\V4pVPV8XdVP;'g/u#VPV4Vn W0n TPu#VP('dKVP*'gK\-\.P0\2P4!\.P04\7VP44h VP*'dQ\-\.P0\2P4!\.P04\7VP44h/Vn VP# \dh\dp\\!T4RR4p\#\$4;_uu_4TP&^,pT'd TR, pYV, pRRR4M +'giM;i\TR7ThRp?ii;i)rVz: N)msg)rprcr expanduserresolverfparentsnamergra_config_cache_key_configr|r Exceptiongetattrrqr IndexErrorargssearch_parents must_existFileNotFoundErrorerrnoENOENTosstrerrorr)r*parent candidate cache_keyer exception_msgs& r"r+ConfigFromFile.configs$))T****ii**,446??AIIF/I!!(3 ))Y6<<--2- 8#'#4#4Y#?DL-6*||#$$$' bkk%,,6OQTUYU^U^Q_``3J8 ???#ELL"++ell2KSQUQZQZ^\ \ ||-% 8!$q':r:C!*--()q 4KC, .--- (C0a78s6G''J<J=-J*-I  J I0 +JJc <V^8dQhRS[/#rr/)r r!s"r"r#rzs)))r%c VPe VP#\VP\4'gQh\ VPP 44#r1)rTrprcrrrfr)s&r"rConfigFromFile.sourcesG << #<< $))T****499%%'((r%c$<V^8dQhRS[RR/#rvaluerNr/)r r!s"r"r#rzCDr%cWnR#r;rTr*rs&&r"rr r%c<V^8dQh/S[S[,;R&S[;R&S[;R&S[S[S[3,R,;R&S[R,;R&#)rrcrrNrr)rrrUrr ra)r r!s"r"r#rzcs\ *,9=#s(^d "P$d*Xr%)rrrT)rVrWrXrYrZr rrcrrrrrr|r[r+rsetterr\r]r^r_s@r"rvrvcs t,DUD9J =N%*4e%%PGZ-24eRW-X4"""""H)) ]]cr%rvca]tRt^toRt]V3RlRl4t]V3RlRl4t]PV3RlRl4tV3Rlt R t Vt R #) DictzjConfiguration source from an in-memory dictionary. Useful for programmatically generated configurations. c6<V^8dQhRS[S[S[3,/#rr)r r!s"r"r#Dict.__annotate__sS#Xr%cVP#r;)datar)s&r"r+ Dict.configs yyr%c <V^8dQhRS[/#rr/)r r!s"r"r#rsr%c :VPe VP#R#)r2rrr)s&r"r Dict.sources << #<< r%c$<V^8dQhRS[RR/#rr/)r r!s"r"r#rrr%cWnR#r;rrs&&r"rrrr%c<<V^8dQh/S[S[S[3,;R&#)rrr)r r!s"r"r#rs sCx.r%rN) rVrWrXrYrZr[r+rrr\r]r^r_s@r"rrsQ  ]]+r%r) rrabcrrcollections.abcr contextlibr itertoolsrpathlibrtypingr r attrsr r cyclopts.argumentr rcyclopts.exceptionsrcyclopts.utilsr cyclopts.corerrrarvrrCr%r"rs #$%L--!3 3 3 lee0QZQQh:r%