U bek@spdZddlZddlZddlZeeZdddddgZdZ d d Z d d Z dd dZ dddZ ddZddZdS)z(Helper functions for documentation, etc.NZs3Zs3nZs3uZs3agsz0///smart_open.utils.QUESTION_MARK_PLACEHOLDER///c Cszt|}Wnttk rzt|\}}}}Wntk rPiYYSX|s^iYS|t| d}tt||YSXdd|j DSdS)NcSs&i|]\}}|jtjjkr||jqS)defaultinspect Parameterempty).0nameparamrrR/var/www/html/services/stratfitenv/lib/python3.8/site-packages/smart_open/utils.py ,sz"inspect_kwargs..) r signatureAttributeError getargspec TypeErrorlendictzip parametersitems)kallabler argsvarargskeywordsdefaultssupported_keywordsrrr inspect_kwargssrcsLtt|fddt|D}fdd|D}|rHtd||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. csg|]}|kr|qSrr)rkrrr Dsz check_kwargs..csi|]\}}|kr||qSrr)rrvrrr r Esz check_kwargs..z*ignoring unsupported keyword arguments: %r)sortedrrloggerwarning)rkwargsZunsupported_keywordsZsupported_kwargsrrr check_kwargs3s   r%cCs |dk rt||}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]``. N)minmax)valueminvalmaxvalrrr clampMs  r+cCsL|dkr|dkrtd|dkr$dnt|}|dkr8dnt|}d||fS)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 valuez bytes=%s-%s) ValueErrorstr)startstopZ start_strZstop_strrrr make_range_stringgs r1cCsH|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.  /-)splitint)Z content_rangeZunitsnumbersrangelengthr/r0rrr parse_content_rangesr;cCstjj|dd}d}|jtkrNd|krNt|krNt}|d|}tjj|dd}|dkrZ|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 placeholderrErrr safe_urlsplits rK)rN)NN)__doc__rlogging urllib.parser> getLogger__name__r"rBrCrr%r+r1r;rKrrrr  s