@|hw ndZddlmZddlZdddddd ddd d d d dZ ddZddZddZddZy)zjVarious utilities for parsing OpenAPI operations from docstrings and validating against the OpenAPI spec. ) annotationsN definitions responses parameterssecurityDefinitions)schemaresponse parametersecurity_schemeschemasheadersexamplessecuritySchemes)rr r headerexampler )cNddj|dk\rdndt|||iS)zReturn path to reference :param str component_type: Component type (schema, parameter, response, security_scheme) :param int openapi_major_version: OpenAPI major version (2 or 3) :param str component_name: Name of component to reference z$refz #/{}{}/{}rz components/)formatCOMPONENT_SUBSECTIONS)component_typeopenapi_major_versioncomponent_names L/var/www/html/test/engine/venv/lib/python3.12/site-packages/apispec/utils.pybuild_referencers;  ""2a7MR !"7 8 H   cB|r|jsy|jj}td|D}|dj g|ddDcgc]}||dj c}z}dj |jScc}w)zUniformly trims leading/trailing whitespace from docstrings. Based on http://www.python.org/peps/pep-0257.html#handling-docstring-indentation rc3K|]:}|jst|t|jz <yw)N)lstriplen).0lines r z!trim_docstring..7s,SDT[[]TS//Ss A*ArN )strip expandtabs splitlinesminr rstripjoin) docstringlinesindentr#trimmeds rtrim_docstringr1.s IOO-  " - - /E SES SFQx !ab $RT&']%9%9%;$RRG 99W  # # %%%SsBc l|jddDcgc]8}|jr&t|t|jdz :}}|rJddt|zz}t j t j |tjd|}|jScc}w)a Remove leading indent from a block of text. Used when generating descriptions from docstrings. Note that python's `textwrap.dedent` doesn't quite cut it, as it fails to dedent multiline docstrings that include unindented text on the initial line. r%N ^r) r)r r!r*resubcompile MULTILINEr')contentr#whitespace_countswhitespace_patterns rdedentr<=s&&(,  ;;= D C C()) C#.?*@$@A&&$6 Er7S ==?s=B1c|jD]/\}}||vr|||<t|ts!t|||1|S)zURecursively update a dict. Subdict's won't be overwritten but also updated. )items isinstancedict deepupdate)originalupdatekeyvalues rrArATsN nn&+ U f F3K t $ ufSk * + Mr)rstrrintrrFreturnzdict[str, str])r-rFrHrF)r9rFrHrF)rBr@rCr@rHr@) __doc__ __future__rr5rrr1r<rArrrLsz#  !0 !, $03EH& &. r