ghPddlmZddlZddlZddlZddlZddlZddlmZmZddl 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+ejXddj[Z. Gddej^Z0d"dZ1dddddddddddd d#dZ2dZ3d$dZ4d%dZ5ddddddddddddddd d&dZ6 d'ddddddddddd d(d Z7d)d*d!Z8y)+) 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*eZdZddfd ZddZxZS) _DebugInfoc (t|dd|i|y)Nnargs)super__init__)selfr!kwargs __class__s @/var/www/openai/venv/lib/python3.12/site-packages/_griffe/cli.pyr$z_DebugInfo.__init__2s /u//cVtjtjdy)Nr)r _print_debug_infosysexit)r%argsr&s r(__call__z_DebugInfo.__call__5s !  r))r)r!zint | str | Noner&r returnNone)r.r r&r r0r1)__name__ __module__ __qualname__r$r/ __classcell__)r's@r(rr1s 0r)rct|tr#t|d5}t||dddy|tj }t||y#1swYyxYw)Nwfile) isinstancestropenprintr,stdout)data output_filefds r( _print_datarB:sN+s# +s #r $R $ #  **K d% $ #s AATF extensions search_pathsdocstring_parserdocstring_optionsresolve_aliasesresolve_implicitresolve_externalallow_inspectionforce_inspection store_sourcefind_stubs_packagec Rt|||||| | } |D]E} | stjdtjd|  | j | d| Gtjd|retjd | j|| \}}|r"tjd t||| Stjd || S#t $r!}tj d| |Yd}~d}~wt$rtjd| YwxYw) 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)packagesrDrErFrGrHrIrJrKrLrMrNloaderpackagerU unresolved iterationss r(_load_packagesr^Ds" !)+))!F LL9 :  ('2 O KK4L^K _  KK+, /0!'!7!7AQ\l!7!m J  KKNPST^P_ak l M KKG T M# J LL8'5 I I O   Dg N OsC D&$D"D&%D&)DEBUGrWARNINGERRORCRITICALc tj|S#tj$r|jdcYSwxYw)N,)jsonloadsJSONDecodeErrorsplit)values r(_extensions_typerjzs: zz%     {{3 s $>>cR d}d} tjd||d}d}d |jd }|jd d d | |jddddt j |jdt d dc fd }|jdddddddfd }|dd}|jd }|jdd d!d"#|jd$d%d&dd'(|jd)d*tjd+,|jd-d.d/d0td12|jd3d4d5itjd62|jd7d8d&d9 |jd:d;d&d< |jd=d>d?d&d@A|jdBd?dCdDA|jdEdFd&dG |||dHdI} | jdJ } | jdKd dLM| jdNdOdPdQM| jdRdSdTdUM| jdVdWd&d0dXY| jdZdWdCd0d[Y| jd\d]d&d^ tD cgc]} | j} } | jd$d_d`| d0dab|| |Scc} w)ezNReturn 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--helphelpactionruz-Vz --versionversionz %(prog)s )rwrxz --debug-infozPrint debug information.c <|jd}|jddd|jd}|jdd d d td |jddddd|jd}|jdddddd|jdditd|jdd d!d"d#d$|jd%d&d'ddd(|jd)}|jd*d+d,tt t jd-.y)/NzCommon optionsrqrsrtrurvzSearch optionsz-sz--searchrEappendzPaths to search packages into.)destrwtyperuz-yz --sys-pathappend_sys_path store_truezAWhether to append `sys.path` to search paths specified with `-s`.r{rwruzLoading optionsz-Bz--find-stubs-packagesrNFzJWhether to look for stubs-only packages and merge them with concrete ones.r{rwdefaultruz-ez --extensionszA list of extensions to use.)rr|ruz-Xz--no-inspectionrK store_falseTz:Disallow inspection of builtin/compiled/not found modules.z-xz--force-inspectionrLz.add_common_optionssz"55.add_subparsers&$z$$Wdu4UYd]cddr)dumpz.Load package-signatures and dump them as JSON.z Dump optionsrYPACKAGE+z Packages to find, load and dump.)rr!ruz-fz--fullr~z"Whether to dump full data in JSON.)rwrruz-oz--outputzZOutput file. Supports templating to output each package in its own file, with `{package}`.)rruz-dz --docstylerFNzThe docstring style to parse.)r{rr|ruz-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 optionsr[z)Package to find, load and check, as path.)rruz-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.z--formatstylezOutput format.)r{rrru)rargparse.ArgumentParserr0r1)rr;rr;r&r r0r)argparseArgumentParserrrr _get_versionradd_subparsersr,r>rrerfrri)rnroparser main_helpglobal_optionsrr dump_parser dump_options check_parser check_optionsfmtformatsrrs @@r( get_parserrs BE;KFI  $ $e5k`h iF]I8O..5E.FNhvINk)yY^YkYkYmXnMopzHbc< ~&&   'Je (XYK111GLj)3Mop  1   i      ,    ZZ 4   *   E   _  _   *  {#!*]^L 33/3JMy)Bmn  d    X    1   2 t[L]^$45$4Ssyy$4G5tZgwX\cst|$ M 6s.J$)outputfullrFrGrDrHrIrJrErNr}rKrLstatscd}t|tr|jd|k7rd}| r t| ng} | r| j t j  t|xsd}t||| |||||| | d|  }|jj}tjt j" }|rI|j%D]5\}}|j'd |d }t)||j|7n*t+j,|t.d |d }t)||tjt j" |z }|rD|j1}|j2|_tj6|j9t;|t;|k(rd SdS#t$rtjdYywxYw)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. Fr[)r[Tr"Could not load extensionsrC)tz)indentr sort_keys)clsrrrr)r:r;formatlistextendr,pathrrrrWr^modules_collectionmembersrnowrutcitemsas_jsonrBredumpsr r microsecondstime_spent_serializingrSas_textrX)rYrrrFrGrDrHrIrJrErNr}rKrLrper_package_outputloaded_extensionsrZ data_packagesstarted package_namer? serializedelapsed loader_statss r(rrJsX&#6===#Cv#M!)54 %2LCHH%+j.>B@ $!)+'))))- F--55Mllhll+G"/"5"5"7 L$QTTJJ  FMM,M$G H#8ZZ ;qt_cd J'llhll+g5G ||~ .5.B.B + L((*+M"c(m31::K 45s F55GG) base_refrDrEr}rNrKrLverboserrc |r t|ng}|r|jtj |xs t |}|xs|}t|} t|xsd}t||||||| dd }|rt||||||| |dd }nt|d|||| |dd }tt||}| *t!j"d dx}|j%d v} t'j(t'j*| | n| | #| rt,j.nt,j0} n t-| } |D]-}t |j3| tj/|ryy#t $r(} t d| tjYd} ~ yd} ~ wwxYw#t$rtjdYywxYw)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: r8Nrr"rrT)refreporDrErKrLrHrJ) rrrDrErKrLrNrHrJ)rPrDrErKrLrNrHrJ FORCE_COLOR>1yonyestrue)strip)rr)rrr,rrrr=stderrrrrrrWrrr osgetenvlowercoloramadeinitinitrVERBOSEONE_LINEexplain)r[against against_pathrrDrEr}rNrKrLrrrrU repositoryr old_package new_package breakages force_colorbreakages r(rrsD*64 %2LCHH%4^G4 *7L|,J+j.>B@   $!)) K (%--1 !   "(%--1 !  *; DEI }=$)GG+T!!#'FF OO MMI> },3 ((9I9R9R ' hU+#**= G  w'cjj9 45s)E5 F)5 F&>F!!F&)G  G ct}|j|}|j}|jd|jd}|jdt} t t |}t jd|ttd }||d i|S#t$r:djt}td|d|d tj Yy wxYw)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')r8r)rrr")r parse_args__dict__poprgetattrlogging basicConfigAttributeErrorjoinrr=r,rrr) r.ropts opts_dictrrrrcommandss r(mainrs\F%006D I MM,|,J k+<=I P+ #AO9>t.LH 8J  ,) ,, ++n- 0 ;KG9TV W  s!B AC#"C#)r?r;r@str | IO | Noner0r1)rY Sequence[str]rDzExtensions | NonerESequence[str | Path] | NonerF Parser | NonerGdict[str, Any] | NonerHboolrIrrJ bool | NonerKrrLrrMrrNrr0r)rir;r0zSequence[str | dict[str, Any]])r0r) rYrrrrrrFrrGrrDCSequence[str | dict[str, Any] | Extension | type[Extension]] | NonerHrrIrrJrrErrNrr}rrKrrLrrrr0int)NN)r[z str | Pathr str | Nonerzstr | Path | Nonerr rDr rErr}rrNrrKrrLrrrrrrzstr | ExplanationStyle | Noner0r )N)r.zlist[str] | Noner0r )9 __future__rrrerrr,rrpathlibrtypingrrr r r_griffer _griffe.diffr _griffe.encodersr _griffe.enumerationsrr_griffe.exceptionsrr_griffe.extensions.baser _griffe.gitrr_griffe.loaderrrr_griffe.loggerrcollections.abcrrrrrrActionrrBr^rrjrrrrr"r)r(rs#  '33.(973577!(=BII0&9??A &%)04&*/3 "$(!"$00"0. 0 $ 0 - 000"000000fC FX#&*/3VZ!"$(04$!!"![;[; [;  [; $ [; - [;T[;[;[;"[;.[;[;[;[;[; ![;" #[;@&*k  VZ04!$!"+/k k k $k  k T k .k k k k k k  k  )k  k \"-r)