JiXddlmZddlZddlZddlZddlZddlZddlZddlmZm 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/m0Z0ejbddjeZ3 GddejhZ5d#dZ6dddddddddddd d$dZ7dZ8d%dZ9d&dZ:ddddddddddddddd d'dZ; d(ddddddddddd d)d!Z>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--helphelpactionrzz-Vz --versionversionz %(prog)s )r|r}z --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 optionsrvrxryrzr{zSearch optionsz-sz--searchrJappendzPaths to search packages into.)destr|typerzz-yz --sys-pathappend_sys_path store_truezAWhether to append `sys.path` to search paths specified with `-s`.rr|rzzLoading optionsz-Bz--find-stubs-packagesrSFzJWhether to look for stubs-only packages and merge them with concrete ones.rr|defaultrzz-ez --extensionszA list of extensions to use.)rrrzz-Xz--no-inspectionrP store_falseTz:Disallow inspection of builtin/compiled/not found modules.z-xz--force-inspectionrQz.add_common_optionssz"55.add_subparsers&$z$$Wdu4UYd]cddr,dumpz.Load package-signatures and dump them as JSON.z Dump optionsr^PACKAGE+z Packages to find, load and dump.)rr$rzz-fz--fullrz"Whether to dump full data in JSON.)r|rrzz-oz--outputzZOutput file. Supports templating to output each package in its own file, with `{package}`.)rrzz-dz --docstylerKNzThe docstring style to parse.)rrrrzz-Dz --docoptsrLz%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-externalrOzAlways 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.)rrzz-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.)rrrrz)rargparse.ArgumentParserr3r4)rr@rr@r)r r3r)argparseArgumentParserrrr _get_versionr"add_subparsersr/rCrrjrkrrn)rsrtparser 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]^$45Ssyy5G5tZgwX\cst|$ M 6s.J$)outputfullrKrLrIrMrNrOrJrSrrPrQstatscd}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: 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 extensionsrH)tz)indentr sort_keys)clsrrrr)r?r@formatlistextendr/pathrrrr\rcmodules_collectionmembersrnowrutcitemsas_jsonrGrjdumpsr r microsecondstime_spent_serializingrXas_textr])r^rrrKrLrIrMrNrOrJrSrrPrQrper_package_outputloaded_extensionsr_ data_packagesstarted package_namerD serializedelapsed loader_statss r+rrLsX&#6===#Cv#M!)54 %2LCHH%+j.>B@ $!)+'))))- F--55Mllhll+G"/"5"5"7 I L$QTTJJ  FMM,M$G H IZZ ;qt_cd J'llhll+g5G ||~ .5.B.B + L((*+M"c(m31::K 45s F55GG) base_refrIrJrrSrPrQverboserrc |r t|ng}|r|jtj|xs|} t |xsd} tjd|xsdx}r|jdxs t|jjdd}|jd}tt|||| ||| |d d }|rutjd|x}std |d |jdxs t|jjdd}|jd}n|}d}tt|||| ||| |d d }nb|xs|} |xs t!|}t#|}t+|||| ||| |d d  }|rt+|||| ||| |d d  }nt-|d | ||| |d d  }tt/||}| *t1j2dd x}|jdv} t5j6t5j8| | n| | #| rt:j<nt:j>} n t;| } |D]-}t'|jA| tj(/|ryy#t $rt jdYywxYw#t$$r(}t'd|tj(Yd }~yd }~wwxYw)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)rIrJrPrQrSrMrOzBase z% is not a valid dependency specifier.zgriffe: error: r=) refreporIrJrPrQrSrMrO)rUrIrJrPrQrSrMrO FORCE_COLOR>1yonyestrue)strip)rr)!rrr/rrrrr\rematchgroupr@lowerreplacer ValueErrorrrrrBstderrrrr osgetenvcoloramadeinitinitrVERBOSEONE_LINEexplain)r`against against_pathrrIrJrrSrPrQrrrr match_against against_distagainst_version old_package match_base base_dist base_version new_package repositoryrZ breakages force_colorbreakages r+rrs+D*64 %2LCHH%*7L+j.>B@ !CW]PRSS}S%++A.>#g,EEGOOPSUXY '--a0 L  (%--1 !   "$((+Mx"XXJX 5 2W!XYY#))!,<G CCEMMcSVWI%++A.L$IL L  (%--1 !  $.w  9!9G' 5J  (%--1 !   ",)!1!1#5 $!% K"&,)!1!1#5 $!% K*; DEI }=$)GG+T!!#'FF OO MMI> },3 ((9I9R9R '> hU+#**=> W 45\  OE7+#** = s) J-KJ?>J? K3 K..K3c.t}|j|}|j}|jd|jd}|jdt} t t |}t jd|tjtd tj t"t$d }||di|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')r=ri)rrr%)r parse_args__dict__poprgetattrlogging basicConfigAttributeErrorjoinrrBr/rsetrecursionlimitmaxgetrecursionlimitrr) r1ropts opts_dictrrrrcommandss r+mainrAs\F%006D I MM,|,J k+<=I P+ #AO#dC$9$9$;<=9>t.LH 8J  ,) ,, ++n- 0 ;KG9TV W  s!CADD)rDr@rEstr | IO | Noner3r4)r^ Sequence[str]rIzExtensions | NonerJSequence[str | Path] | NonerKDocstringStyle | Parser | NonerLDocstringOptions | NonerMboolrNrrO bool | NonerPrrQrrRrrSrr3r)rnr@r3zSequence[str | dict[str, Any]])r3r) r^rrrrrrKrrLrrICSequence[str | dict[str, Any] | Extension | type[Extension]] | NonerMrrNrrOrrJrrSrrrrPrrQrrrr3int)NN)r`z str | Pathr str | Nonerzstr | Path | Nonerr!rIrrJrrrrSrrPrrQrrrrrrzstr | ExplanationStyle | Noner3r )N)r1zlist[str] | Noner3r )> __future__rrrjr rrr/rrpathlibrtypingrrr r rgriffe._internalr griffe._internal.diffr griffe._internal.encodersr griffe._internal.enumerationsrrgriffe._internal.exceptionsrr griffe._internal.extensions.basergriffe._internal.gitrrgriffe._internal.loaderrrrrgriffe._internal.loggerrcollections.abcr#griffe._internal.docstrings.parsersrrrrrrrActionr"rGrcrrorrrrr%r,r+r1s#  '33"71B@<@KK*(TFBII0&9??A &%)047;15 "$(!"$00"0. 0 5 0 / 000"000000fC FX#7;15VZ!"$(04$!!"![;[; [;  [; 5 [; / [;T[;[;[;"[;.[;[;[;[;[; ![;" #[;@&*T  VZ04!$!"+/T T T $T  T T T .T T T T T T  T  )T  T n%-r,