-hhPddlmZddlZddlZddlZddlZddlZddlmZmZddl m Z ddl m Z m Z mZmZddlZddlmZddlmZddlmZdd lmZmZdd lmZmZdd lmZdd lm Z m!Z!dd l"m#Z#m$Z$m%Z%ddl&m'Z'e rddl(m)Z)ddlm*Z*m+Z+ej,dd-Z. Gddej/Z0dRdZ1dddddddddddd dSd3Z2d4Z3dTd7Z4dUd9Z5ddddddddddddddd:dVdAZ6 dWdddddddddddB dXdNZ7dYdZdQZ8dS)[) annotationsN)datetimetimezone)Path)IO TYPE_CHECKINGAnyCallable)debug)find_breaking_changes) JSONEncoder)ExplanationStyleParser)ExtensionErrorGitError)load_extensions)get_latest_tag get_repo_root) GriffeLoaderloadload_git)logger)Sequence) Extension ExtensionsGRIFFE_LOG_LEVELINFOc*eZdZd d fd Zd d ZxZS) _DebugInfornargsint | str | Nonekwargsr returnNonec >tjdd|i|dS)Nr )super__init__)selfr r" __class__s H/var/www/FlaskApp/flask-venv/lib/python3.11/site-packages/_griffe/cli.pyr(z_DebugInfo.__init__2s+//u//////argscTtjtjddS)Nr)r _print_debug_infosysexit)r)r-r"s r+__call__z_DebugInfo.__call__5s" !!!  r,)r)r r!r"r r#r$)r-r r"r r#r$)__name__ __module__ __qualname__r(r2 __classcell__)r*s@r+rr1sV0000000r,rdatastr output_filestr | IO | Noner#r$ct|tritj d?;|d@dAd/dB |dCdDd/dE |dFdGdHd/dIJ|dKdHdLdMJ|dNdOd/dP |||dQdR} | dS } | dTd)dUV| dWdXdYdZV| d[d\d]d^V| d_d`d/d9dab| dcd`dLd9ddb| dedfd/dg dhtD} | d-didj| d9dkl|| |S)ozNReturn the CLI argument parser. Returns: An argparse parser. z3%(prog)s [GLOBAL_OPTS...] COMMAND [COMMAND_OPTS...]z'Signatures for entire Python programs. Fgriffe)add_helpusage descriptionprogzKShow this help message and exit. Commands also accept the -h/--help option.z Show this help message and exit.zGlobal optionstitle-h--helphelpactionrz-Vz --versionversionz %(prog)s )rrz --debug-infozPrint debug information. subparserrvr#r$c |d}|ddd|d}|dd d d td |ddddd|d}|dddddd|dditd|dd d!d"d#d$|d%d&d'ddd(|d)}|d*d+d,tt t jd-.dS)/NzCommon optionsr}rrrrzSearch optionsz-sz--searchrGappendzPaths to search packages into.)destrtyperz-yz --sys-pathappend_sys_path store_truezAWhether to append `sys.path` to search paths specified with `-s`.rrrzLoading optionsz-Bz--find-stubs-packagesrPFzJWhether to look for stubs-only packages and merge them with concrete ones.rrdefaultrz-ez --extensionszA list of extensions to use.)rrrz-Xz--no-inspectionrM store_falseTz:Disallow inspection of builtin/compiled/not found modules.z-xz--force-inspectionrNz.add_common_optionss"55.add_subparsers)$z$Wdu4UYdd]cdddr,dumpz.Load package-signatures and dump them as JSON.z Dump optionsrQPACKAGE+z Packages to find, load and dump.)rr rz-fz--fullrz"Whether to dump full data in JSON.)rrrz-oz--outputzZOutput file. Supports templating to output each package in its own file, with `{package}`.)rrz-dz --docstylerHNzThe docstring style to parse.)rrrrz-Dz --docoptsrIz%The options for the docstring parser.z-rz--resolve-aliaseszWhether to resolve aliases.z-Iz--resolve-implicitzrWhether to resolve implicitly exported aliases as well. Aliases are explicitly exported when defined in `__all__`.z-Uz--resolve-externalrLzAlways resolve aliases pointing to external/unknown modules (not loaded directly).Default is to resolve only from one module to its private sibling (`ast` -> `_ast`).rz--no-resolve-externalrzNever resolve aliases pointing to external/unknown modules (not loaded directly).Default is to resolve only from one module to its private sibling (`ast` -> `_ast`).z-Sz--statszShow statistics at the end.checkz1Check for API breakages or possible improvements.z Check optionsrdz)Package to find, load and check, as path.)rrz-az --againstREFzUOlder Git reference (commit, branch, tag) to check against. Default: load latest tag.z-bz --base-refBASE_REFzIGit reference (commit, branch, tag) to check. Default: load current code.z--colorcolorz"Force enable colors in the output.rz --no-colorz#Force disable colors in the output.z-vz --verbosezVerbose output.cg|] }|j Sr&rt).0fmts r+ zget_parser..Cs555Ssy555r,z--formatstylezOutput format.)rrrr)rrvr#r$)rr8rr8r"r r#rv)argparseArgumentParserrrr _get_versionradd_subparsersr0rBrrprqr)rzr{parser main_helpglobal_optionsrr dump_parser dump_options check_parser check_optionsformatsrrs @@r+ get_parserrs BE;KFI  $e5k`h i i iF]I8O..5E.FFNhvINNNk)MoY^YkYmYmMoMopppzHbccc< < < < < < ~&&   'Jeeeeee -(XYYK111GGLj)3Moppp  1   i      ,    Z 4   *   E   _  _   *  {###!=*]^^L 33/3JJMy)Bmnnn  d    X    1   2 t[L]^^^55$4555GtZgwX\csttt|$$$ Mr,)outputfullrHrIrFrJrKrLrGrPrrMrNstatsrrCSequence[str | dict[str, Any] | Extension | type[Extension]] | Nonerrintcd}t|tr|d|krd}| rt| ng} | r| t j t|pd}n%#t$rtj dYdSwxYwt||| |||||| | d|  }|j j }tjt j }|rW|D]A\}}|d |d }t)|||Bn.t+j|t.d |d }t)||tjt j |z }|rF|}|j|_tj|t;|t;|krd ndS)aLoad packages data and dump it as JSON. Parameters: packages: The packages to load and dump. output: Where to output the JSON-serialized data. full: Whether to output full or minimal data. docstring_parser: The docstring parser to use. By default, no parsing is done. docstring_options: Additional docstring parsing options. resolve_aliases: Whether to resolve aliases (indirect objects references). resolve_implicit: Whether to resolve every alias or only the explicitly exported ones. resolve_external: Whether to load additional, unspecified modules to resolve aliases. Default is to resolve only from one module to its private sibling (`ast` -> `_ast`). extensions: The extensions to use. search_paths: The paths to search into. find_stubs_package: Whether to search for stubs-only packages. If both the package and its stubs are found, they'll be merged together. If only the stubs are found, they'll be used as the package itself. append_sys_path: Whether to append the contents of `sys.path` to the search paths. allow_inspection: Whether to allow inspecting modules when visiting them is not possible. force_inspection: Whether to force using dynamic analysis when loading data. stats: Whether to compute and log stats about loading. Returns: `0` for success, `1` for failure. Frd)rdTr&Could not load extensionsrE)tz)indentr sort_keys)clsrrrr)r?r8formatlistextendr0pathrrrrargmodules_collectionmembersrnowrutcitemsas_jsonrDrpdumpsr r microsecondstime_spent_serializingr]as_textrb)rQrrrHrIrFrJrKrLrGrPrrMrNrper_package_outputloaded_extensionsrc data_packagesstarted package_namer7 serializedelapsed loader_statss r+rrJs%X&#"6===#C#Cv#M#M!)5=4 %%%2L&CH%%%+j.>B@ 4555qq $!)+'))))-   F-5Mlhl+++G("/"5"5"7"7 I I L$QTTJJJ  FMM,M$G$G H H H H IZ ;qt_cddd J'''lhl+++g5G ,||~~ .5.B + L((**+++M""c(mm3311:s) A55BB) base_refrFrGrrPrMrNverboserrrd str | Pathagainst str | None against_pathstr | Path | Nonerrrrstr | ExplanationStyle | Nonec |rt|ng}|r|tj |pt |}n6#t $r)} t d| tjYd} ~ dSd} ~ wwxYw|p|}t|} t|pd}n%#t$rtj dYdSwxYwt||||||| dd }|rt||||||| |dd }nt|d|||| |dd }tt||}| -t!jd dx}|d v} t'jt'j| | n| | | r t,jn t,j} nt-| } |D]1}t || tj2|rdSdS)a*Check for API breaking changes in two versions of the same package. Parameters: package: The package to load and check. against: Older Git reference (commit, branch, tag) to check against. against_path: Path when the "against" reference is checked out. base_ref: Git reference (commit, branch, tag) to check. extensions: The extensions to use. search_paths: The paths to search into. append_sys_path: Whether to append the contents of `sys.path` to the search paths. allow_inspection: Whether to allow inspecting modules when visiting them is not possible. force_inspection: Whether to force using dynamic analysis when loading data. verbose: Use a verbose output. Returns: `0` for success, `1` for failure. zgriffe: error: r=Nrr&rrT)refreporFrGrMrNrJrL) rrrFrGrMrNrPrJrL)rZrFrGrMrNrPrJrL FORCE_COLOR>1yonyestrue)strip)rr)rrr0rrrrAstderrrrrrrarrr osgetenvlowercoloramadeinitinitrVERBOSEONE_LINEexplain)rdrrrrFrGrrPrMrNrrrr_ repositoryr old_package new_package breakages force_colorbreakages r+rrsD*6=4 %%%2L&CH%%%4^G44  '''cj9999qqqqq *7L|,,J+j.>B@ 4555qq   $!))   K  (%--1 !     "(%--1 !    *; DDEEI }=$)G)GG+T!!##'FF O MI>>>> },3R ((9I9R ''>> hU++#*=====q 1s)A A;A66A; BC?Cr-list[str] | Nonect}||}|j}|d|d}|dt} t t |}t jd|nM#t$r@d t}td|d|d tj Yd SwxYwttd }||d i|S)zRun the main program. This function is executed when you type `griffe` or `python -m griffe`. Parameters: args: Arguments passed from the command line. Returns: An exit code. debug_infor log_levelz%(levelname)-10s %(message)s)rlevelz', 'z"griffe: error: invalid log level 'z' (choose from 'z')r=r)rrr&)r parse_args__dict__poprgetattrlogging basicConfigAttributeErrorjoinrrAr0rrr) r-ropts opts_dictrr r rcommandss r+mainrs$\\F%0066D I MM,|,,J k+<==I P++ #AOOOOO ++n-- W W WG W W W    qq 9>t.L.LH 8J  , ,) , ,,s1BAC'&C')r7r8r9r:r#r$)rQrRrFrSrGrTrHrUrIrVrJrWrKrWrLrXrMrWrNrWrOrWrPrWr#r)rlr8r#rm)r#rv) rQrRrr:rrWrHrUrIrVrFrrJrWrKrWrLrXrGrTrPrWrrWrMrWrNrWrrWr#r)NN)rdrrrrrrrrFrrGrTrrWrPrWrMrWrNrWrrWrrXrrr#r)N)r-rr#r)9 __future__rrrprrr0rrpathlibrtypingrrr r r_griffer _griffe.diffr _griffe.encodersr _griffe.enumerationsrr_griffe.exceptionsrr_griffe.extensions.baser _griffe.gitrr_griffe.loaderrrr_griffe.loggerrcollections.abcrrrrrrActionrrDrgrrurrrrr&r,r+r%s5#"""""  ''''''''333333333333......((((((9999999977777777333333555555557777777777!!!!!!>((((((========BI0&99??AA &&&&%)04&*/3 "$(!"$000000fC    FFFFX#&*/3VZ!"$(04$!!"![;[;[;[;[;[;@&*k  VZ04!$!"+/k k k k k k \"-"-"-"-"-"-"-r,