o iX@sddlmZddlZddlZddlZddlZddlZddlZddlmZm Z ddl m Z ddl m Z mZmZmZddlZddlmZddlmZddlmZdd lmZmZdd lmZmZdd lmZdd l m!Z!m"Z"dd l#m$Z$m%Z%m&Z&m'Z'ddl(m)Z)erddl*m+Z+ddl,m-Z-m.Z.ddlm/Z/m0Z0e1dd2Z3 Gdddej4Z5dZddZ6dddddddddddd d[d5d6Z7d7Z8d\d:d;Z9d]d=d>Z:ddddddddddddddd?d^dFdGZ;  d_dddddddddddH d`dTdUZ       rg)DEBUGrWARNINGERRORCRITICALvalueSequence[str | dict[str, Any]]cCs,zt|WStjy|dYSw)N,)jsonloadsJSONDecodeErrorsplitrlr&r&r,_extensions_type|s  rtargparse.ArgumentParserc s6d}d} tjd||dd}d}d|jdd }|jd d d |d |jddddtd|jdtdd dpfdd }|jdddddddqfd%d& }|d'd(}|jd)d }|jd*d+d,d-d.|jd/d0d1dd2d3|jd4d5tj d6d7|jd8d9d:d;t dd?d@it j dAd=|jdBdCd1dDd |jdEdFd1dGd |jdHdIdJd1dKdL|jdMdJdNdOdL|jdPdQd1dRd |||dSdT} | jdUd } | jdVd+dWdX| jdYdZd[d\dX| jd]d^d_d`dX| jdadbd1d;dcdd| jdedbdNd;dfdd| jdgdhd1did djdkt D} | jd/dldm| d;dndo|| |S)rzNReturn 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. subparserrur$r%c s|jdd}|jdddd|jdd}|jdd d d td d |jdddddd|jdd}|jddddddd|jdditdd|jdd d!d"d#d$d|jd%d&d'ddd(d|jd)d}|jd*d+d,tttjd-d.dS)/NzCommon optionsr{r}r~rrzSearch optionsz-sz--searchrHappendzPaths 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-packagesrQFzJWhether to look for stubs-only packages and merge them with concrete ones.rrdefaultrz-ez --extensionszA list of extensions to use.)rrrz-Xz--no-inspectionrN store_falseTz:Disallow inspection of builtin/compiled/not found modules.z-xz--force-inspectionrOz.add_common_options subcommandCommandsCOMMANDT)rr|rrzrequiredcommandr8textr#rcsj|fd||d|S)NF)rwrry) add_parser)rrr#) subparsersr&r, add_subparserr-z!get_parser..add_subparserdumpz.Load package-signatures and dump them as JSON.z Dump optionsrRPACKAGE+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 --docstylerINzThe docstring style to parse.)rrrrz-Dz --docoptsrJz%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-externalrMzAlways 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.cSsg|]}|jqSr&rs).0fmtr&r&r, Eszget_parser..z--formatstylezOutput format.)rrrr)rrur$r%)rr8rr8r#rr$ru)argparseArgumentParserrrr _get_versionr add_subparsersr0rCrrorpr ) rxryparser main_helpglobal_optionsrr dump_parser dump_options check_parser check_optionsformatsr&)rrr, get_parsers ?    r)outputfullrIrJrGrKrLrMrHrQrrNrOstatsrrCSequence[str | dict[str, Any] | Extension | type[Extension]] | NonerrintcCsLd}t|tr|jdd|krd}| rt| ng} | r!| tjzt|p&d}Wnty8t dYdSwt ||| |||||| | d| d }|j j }tjtjd }|rq|D]\}}|jd |dd }t||j|dqZntj|td |dd }t||tjtjd |}|r|}|j|_t |t|t|krd SdS)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: 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 extensionsrF)tz)indentr sort_keys)clsrrrr)r@r8formatlistextendr0pathrrrrargmodules_collectionmembersrnowrutcitemsas_jsonrErodumpsr r microsecondstime_spent_serializingr]as_textrb)rRrrrIrJrGrKrLrMrHrQrrNrOrper_package_outputloaded_extensionsrc data_packagesstarted package_namer7 serializedelapsed loader_statsr&r&r,rLsR,    r) base_refrGrHrrQrNrOverboserrrd str | Pathagainst str | None against_pathstr | Path | Nonerrrrstr | ExplanationStyle | Nonec  Cs|rt|ng}|r|tj|p|}zt|pd} Wnty+tdYdSwt d|p2d}r| dp>t | dd}| d}tt |||| ||| |d d d }|rt d|}sltd |d | dptt | dd}| d}n|}d}tt |||| ||| |d d d }nZ|p|}z |pt|}t|}Wnty}ztd|tjdWYd }~dSd }~wwt|||| ||| |d d d }|rt|||| ||| |d d d }n t|d | ||| |d d d }tt||}| d ur tdd }d ur | dv} ttj| d ur| n| d| d ur.| r*tjntj} nt| } |D]}t|j | dtjdq4|rHdSdS)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. r&rrz([\w.-]+)?((==|<=|<|>=|>|!=).+)-_rTN)rGrHrNrOrQrKrMzBase z% is not a valid dependency specifier.zgriffe: error: r>) refreporGrHrNrOrQrKrM)rZrGrHrNrOrQrKrM FORCE_COLOR>1yonyestrue)strip)rr)!rrr0rrrrrarematchgroupr8lowerreplacer ValueErrorrrrrBstderrrrr osgetenvcoloramadeinitinitr VERBOSEONE_LINEexplain)rdrrrrGrHrrQrNrOrrrr match_against against_distagainst_version old_package match_base base_dist base_version new_package repositoryr_ breakages force_colorbreakager&r&r,rs"             rr.list[str] | Nonec Cst}||}|j}|d|d}|dt}ztt|}Wnty?dt }t d|d|dt j dYd Swtj d |d t td t ttd }||di|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', 'z"griffe: error: invalid log level 'z' (choose from 'z')r>rz%(levelname)-10s %(message)s)rleveli)rrNr&)r parse_args__dict__poprgetattrloggingAttributeErrorjoinrrBr0r basicConfigsetrecursionlimitmaxgetrecursionlimitrr) r.ropts opts_dictrrrrcommandsr&r&r,mainAs(       r)r7r8r9r:r$r%)rRrSrGrTrHrUrIrVrJrWrKrXrLrXrMrYrNrXrOrXrPrXrQrXr$r)rlr8r$rm)r$ru) rRrSrr:rrXrIrVrJrWrGrrKrXrLrXrMrYrHrUrQrXrrXrNrXrOrXrrXr$r)NN)rdrrrrrrrrGrrHrUrrXrQrXrNrXrOrXrrXrrYrrr$r)N)r.r r$r)> __future__rrrorrrr0rrpathlibrtypingrrrr rgriffe._internalr griffe._internal.diffr griffe._internal.encodersr griffe._internal.enumerationsr rgriffe._internal.exceptionsrr griffe._internal.extensions.basergriffe._internal.gitrrgriffe._internal.loaderrrrrgriffe._internal.loggerrcollections.abcr#griffe._internal.docstrings.parsersrrrrrrrActionr rErgrrtrrrrr&r&r&r,s          3  M`