lckvdZddlZddlZddlZejeZgdZdZ dZ dZ d dZ d dZ d Zd ZdS) z(Helper functions for documentation, etc.N)s3s3ns3us3agsz0///smart_open.utils.QUESTION_MARK_PLACEHOLDER///cf tj|}d|jDS#t$rm tj|\}}}}n#t $ricYcYSwxYw|sicYS|t| d}tt||cYSwxYw)NcXi|]'\}}|jtjjk||j(S)defaultinspect Parameterempty).0nameparams 0lib/python3.11/site-packages/smart_open/utils.py z"inspect_kwargs..,sC   e} 1 77 %-   ) r signature parametersitemsAttributeError getargspec TypeErrorlendictzip)kallablerargsvarargskeywordsdefaultssupported_keywordss rinspect_kwargsr$s %h//   (399;;      7 7 7 070B80L0L -D'8XX   IIIII    III!3x==.//2C*H5566666 7s99 B0AB0 A/*B0.A//B085B0/B0ctt|fdt|D}fd|D}|rtd||S)aCheck which keyword arguments the callable supports. Parameters ---------- kallable: callable A function or method to test kwargs: dict The keyword arguments to check. If the callable doesn't support any of these, a warning message will get printed. Returns ------- dict A dictionary of argument names and values supported by the callable. cg|]}|v| Sr r )rkr#s r z check_kwargs..Ds$UUU!BT9TUAUUUrc$i|] \}}|v || Sr r )rr'vr#s rrz check_kwargs..Es*UUU!QQBT=TU1UUUrz*ignoring unsupported keyword arguments: %r)sortedr$rloggerwarning)rkwargsunsupported_keywordssupported_kwargsr#s @r check_kwargsr13s  x 8 899UUUUvf~~UUUUUUU6<<>>UUU[CEYZZZ rcJ|t||}t||}|S)aIClamp a numeric value to a specific range. Parameters ---------- value: numeric The value to clamp. minval: numeric The lower bound. maxval: numeric The upper bound. Returns ------- numeric The clamped value. It will be in the range ``[minval, maxval]``. )minmax)valueminvalmaxvals rclampr8Ms/(#E6"" v  E Lrc||td|dnt|}|dnt|}d|d|S)akCreate a byte range specifier in accordance with RFC-2616. Parameters ---------- start: int, optional The start of the byte range. If unspecified, stop indicated offset from EOF. stop: int, optional The end of the byte range. If unspecified, indicates EOF. Returns ------- str A byte range specifier. Nz7make_range_string requires either a stop or start valuezbytes=-) ValueErrorstr)startstop start_strstop_strs rmake_range_stringrBgs_( TTRSSS3UI0rrs4yyHH%IIxx 00rc|dd\}}|dd\}}|dd\}}|t|t|t|fS)aExtract units, start, stop, and length from a content range header like "bytes 0-846981/846982". Assumes a properly formatted content-range header from S3. See werkzeug.http.parse_content_range_header for a more robust version. Parameters ---------- content_range: str The content-range header to parse. Returns ------- tuple (units: str, start: int, stop: int, length: int) The units and three integers from the content-range header.  /r;)splitint) content_rangeunitsnumbersrangelengthr>r?s rparse_content_rangerNsl"#((a00NE7MM#q))ME6++c1%%KE4 #e**c$iiV 44rctj|d}d}|jtvrKd|vrGt |vr>t }|d|}tj|d}||S|j|d}tj|j|j |ddS)aThis is a hack to prevent the regular urlsplit from splitting around question marks. A question mark (?) in a URL typically indicates the start of a querystring, and the standard library's urlparse function handles the querystring separately. Unfortunately, question marks can also appear _inside_ the actual URL for some schemas like S3, GS. Replaces question marks with a special placeholder substring prior to splitting. This work-around behavior is disabled in the unlikely event the placeholder is already part of the URL. If this affects you, consider changing the value of QUESTION_MARK_PLACEHOLDER to something more suitable. See Also -------- https://bugs.python.org/issue43882 https://github.com/python/cpython/blob/3.7/Lib/urllib/parse.py https://github.com/RaRe-Technologies/smart_open/issues/285 https://github.com/RaRe-Technologies/smart_open/issues/458 smart_open/utils.py:QUESTION_MARK_PLACEHOLDER F)allow_fragmentsN?r:) urllibparseurlsplitschemeWORKAROUND_SCHEMESQUESTION_MARK_PLACEHOLDERreplacepath SplitResultnetloc)urlsr placeholderrYs r safe_urlsplitr_s*   sE  : :BK y&&?3#:?:S[^:^? 0 kk#{++ \ " "3 " > > 7??; , ,D < # #BIry$B G GGr)rN)NN)__doc__r logging urllib.parserR getLogger__name__r,rVrWr$r1r8rBrNr_r rrres/.  8 $ $666N   <4411116555.&H&H&H&H&Hr