o hQ@sddlmZddlZddlZddlZddlZddlZddlmZmZddl 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)ddl*m+Z+m,Z,ddlm-Z-m.Z.e/dd0Z1 Gdddej2Z3dZddZ4dddddddddddd d[d5d6Z5d7Z6d\d:d;Z7d]d=d>Z8ddddddddddddddd?d^dFdGZ9  d_dddddddddddH d`dTdUZ:dadbdXdYZ;dS)c) 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)DocstringOptionsDocstringStyle) Extension ExtensionsGRIFFE_LOG_LEVELINFOcs*eZdZd dfdd Zdd d ZZS) _DebugInfornargsint | str | NonekwargsrreturnNonec stjdd|i|dS)Nr )super__init__)selfr r" __class__r%U/var/www/html/openai_agents/venv/lib/python3.10/site-packages/griffe/_internal/cli.pyr'3z_DebugInfo.__init__argscOsttddS)Nr)r _print_debug_infosysexit)r(r-r"r%r%r+__call__6sz_DebugInfo.__call__)r)r r!r"rr#r$)r-rr"rr#r$)__name__ __module__ __qualname__r'r1 __classcell__r%r%r)r+r2srdatastr output_filestr | IO | Noner#r$cCsdt|tr#t|d}t||dWddS1swYdS|dur*tj}t||ddS)Nwfile) isinstancer7openprintr/stdout)r6r8fdr%r%r+ _print_data;s  "rBTF extensions search_pathsdocstring_parserdocstring_optionsresolve_aliasesresolve_implicitresolve_externalallow_inspectionforce_inspection store_sourcefind_stubs_packagepackages Sequence[str]rDExtensions | NonerESequence[str | Path] | NonerFDocstringStyle | Parser | NonerGDocstringOptions | NonerHboolrIrJ bool | NonerKrLrMrNrc  Cst|||||| | d} |D]A} | stdq td| z | j| d| dWq ty@}z td| |WYd}~q d}~wtyNtd| Yq wtd|rwtd | j ||d \}}|rqtd t ||| Std || S) N)rDrErFrGrKrLrMzEmpty package name, continuingzLoading package %sT)try_relative_pathrNzCould not find package %s: %sz%Tried but could not import package %szFinished loading packageszStarting alias resolution)implicitexternalz4%s aliases were still unresolved after %s iterationsz-All aliases were resolved after %s iterations) rrr inforModuleNotFoundErrorerror ImportError exceptionrHlen)rOrDrErFrGrHrIrJrKrLrMrNloaderpackager\ unresolved iterationsr%r%r+_load_packagesEs>       rd)DEBUGrWARNINGERRORCRITICALvalueSequence[str | dict[str, Any]]cCs,zt|WStjy|dYSw)N,)jsonloadsJSONDecodeErrorsplitrir%r%r+_extensions_type{s  rqargparse.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--helphelpactionr|z-Vz --versionversionz %(prog)s )r~rz --debug-infozPrint debug information. subparserrrr#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 optionsrxrzr{r|r}zSearch optionsz-sz--searchrEappendzPaths to search packages into.)destr~typer|z-yz --sys-pathappend_sys_path store_truezAWhether to append `sys.path` to search paths specified with `-s`.rr~r|zLoading optionsz-Bz--find-stubs-packagesrNFzJWhether to look for stubs-only packages and merge them with concrete ones.rr~defaultr|z-ez --extensionszA list of extensions to use.)rrr|z-Xz--no-inspectionrK store_falseTz:Disallow inspection of builtin/compiled/not found modules.z-xz--force-inspectionrLz.add_common_options subcommandCommandsCOMMANDT)rryrrwrequiredcommandr7textr"rcsj|fd||d|S)NF)rtr|rv) add_parser)rrr") subparsersr%r+ add_subparserr,z!get_parser..add_subparserdumpz.Load package-signatures and dump them as JSON.z Dump optionsrOPACKAGE+z Packages to find, load and dump.)rr r|z-fz--fullrz"Whether to dump full data in JSON.)r~rr|z-oz--outputzZOutput file. Supports templating to output each package in its own file, with `{package}`.)rr|z-dz --docstylerFNzThe docstring style to parse.)rrrr|z-Dz --docoptsrGz%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-externalrJzAlways 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 optionsraz)Package to find, load and check, as path.)rr|z-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%rp).0fmtr%r%r+ Dszget_parser..z--formatstylezOutput format.)rrrr|)rrrr#r$)rr7rr7r"rr#rr)argparseArgumentParserrrr _get_versionradd_subparsersr/r@rrlrmr ) rurvparser main_helpglobal_optionsrr dump_parser dump_options check_parser check_optionsformatsr%)rrr+ get_parsers ?    r)outputfullrFrGrDrHrIrJrErNrrKrLstatsrrCSequence[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. Fra)raTr%Could not load extensionsrC)tz)indentr sort_keys)clsrrrr)r=r7formatlistextendr/pathrrrr^rdmodules_collectionmembersrnowrutcitemsas_jsonrBrldumpsr r microsecondstime_spent_serializingrZas_textr_)rOrrrFrGrDrHrIrJrErNrrKrLrper_package_outputloaded_extensionsr` data_packagesstarted package_namer6 serializedelapsed loader_statsr%r%r+rKsR,    r) base_refrDrErrNrKrLverboserrra str | Pathagainst str | None against_pathstr | Path | Nonerrrrstr | ExplanationStyle | Nonec  Cs|rt|ng}|r|tj|p|}z |pt|}t|} Wnty=}ztd|tjdWYd}~dSd}~wwzt |pCd}Wnt yUt dYdSwt ||| |||| ddd }|rtt ||| |||| |ddd }n t|d|||| |ddd }tt||}| durtd d}dur|d v} ttj| dur| n| d| dur| rtjntj} nt| } |D] }t|j| dtjdq|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)refreporDrErKrLrHrJ) rrrDrErKrLrNrHrJ)rWrDrErKrLrNrHrJ FORCE_COLOR>1yonyestrue)strip)rr)rrr/rrrrr?stderrrrrr^rrr osgetenvlowercoloramadeinitinitr VERBOSEONE_LINEexplain)rarrrrDrErrNrKrLrrr repositoryr\r old_package new_package 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__poprgetattrloggingAttributeErrorjoinrr?r/r basicConfigsetrecursionlimitmaxgetrecursionlimitrr) r-ropts opts_dictrrrrcommandsr%r%r+mains(       r)r6r7r8r9r#r$)rOrPrDrQrErRrFrSrGrTrHrUrIrUrJrVrKrUrLrUrMrUrNrUr#r)rir7r#rj)r#rr) rOrPrr9rrUrFrSrGrTrDrrHrUrIrUrJrVrErRrNrUrrUrKrUrLrUrrUr#r)NN)rarrrrrrrrDrrErRrrUrNrUrKrUrLrUrrUrrVrrr#r)N)r-rr#r)< __future__rrrlrrr/rrpathlibrtypingrrrr rgriffe._internalr griffe._internal.diffr griffe._internal.encodersr griffe._internal.enumerationsr rgriffe._internal.exceptionsrr griffe._internal.extensions.basergriffe._internal.gitrrgriffe._internal.loaderrrrgriffe._internal.loggerrcollections.abcr#griffe._internal.docstrings.parsersrrrrrrrActionrrBrdrrqrrrrr%r%r%r+s          3  M`n