N)Sequence)PathPurePath)Pattern)FinalOptional)AbstractSanitizerAbstractValidatorBaseFile BaseValidator)findall_to_str is_nt_abspathto_str truncate_strvalidate_pathtype)DEFAULT_MIN_LENINVALID_CHAR_ERR_MSG_TMPLPlatform)PathType PlatformType) ErrorAttrKey ErrorReasonInvalidCharErrorValidationError)ReservedNameHandlerValidationErrorHandler_DEFAULT_MAX_FILENAME_LEN[s]_RE_INVALID_FILENAME_RE_INVALID_WIN_FILENAMEceZdZedddddddfdedeedeedeedeedee ed e d ee d dffd Z dde ded e fdZd eefdZxZS)FileNameSanitizerNFmax_len fs_encodingplatformnull_value_handlerreserved_name_handleradditional_reserved_namesvalidate_after_sanitize validatorreturnc |r|} ntt||d||} t|||||||| ||_dS)NTmin_lenr'r(check_reservedr,r))r'r(r*r+r,r)r-r.)FileNameValidatorrsuper__init___get_sanitize_regexp_sanitize_regexp) selfr'r(r)r*r+r,r-r.fname_validator __class__s /Users/kimhansen/Desktop/03 Workspace/ceo-agents/chl-effectiveness/mcp-servers/whoop/.venv/lib/python3.11/site-packages/pathvalidate/_filename.pyr6zFileNameSanitizer.__init__ s  'OO/''#*C! O #1"7&?$;%  !% 9 9 ; ;valuereplacement_textc t||d nX#t$rK}|jtjkr0t |tr||cYd}~Sd}~wwxYw|j |t|}t||j |j} |j|n#t$r}|jtjkrN||}|j|kr-t)j t)j|j||}n|jtjkrZ|drD|d}|d}|dvr|d}n*|jtjkr||}Yd}~nd}~wwxYw|jr\ |j|n@#t$r3}tt|tj|jd}~wwxYwt |trt9|S|S)NTinclude_universalallow_whitespaces .z..z .) descriptionreasonr))r _is_windowsrrJr NULL_NAME isinstancer_null_value_handlerr8substrr _fs_encodingr' _validatorvalidate RESERVED_NAME_reserved_name_handler reserved_namereescapeINVALID_CHARACTERlstriprstrip_validate_after_sanitizeINVALID_AFTER_SANITIZEr)r)r9r?r@esanitized_filenamereplacement_words r<sanitizezFileNameSanitizer.sanitizeDs  e4;K;K^b;K;c;c7c d d d d d   x;000eX..//22222222   "2667GUTT)*OQUQ]^^ A O $ $%7 8 8 8 8 A A Ax;444#'#>#>q#A#A ?&666)+ !/224DFX**&[:::t?O?O"&@P@@:&8%>%>s%C%C"&8%>%>s%C%C"%[88);)B)B4)H)H&[222%)%=%=a%@%@"% A(  (  (();<<<<"   % #A&=!]  eX & & ,*++ +!!sQ&) A>?A92A>8A99A>C!! G2,C)__name__ __module__ __qualname__rintrrPrrrboolr r6rrarr7 __classcell__r;s@r<r&r&s'1%)+/?CBF=A(-15"<"<"<c]"<<( "< %%;< "< ((>? "<$,HSM#:"<"&"<-."< "<"<"<"<"<"zFileNameValidator.s7ddytS4""3"""ddddddr=)COMLPTr c#,K|]\}}|d|dVdS)r!Nrq)rrrsssds r<ruzFileNameValidator.sK  c  s         r=)¹²³_WINDOWS_RESERVED_FILE_NAMES):_MACOS_RESERVED_FILE_NAMESr/.ctj}|r t||jz|jz}n{|rt||jz}nO|s|rt||jz}nt|}tt|S)N) r5reserved_keywords _is_universalsetr~rrK _is_posix _is_macostuplesorted)r9common_keywordsword_setr;s r<rz#FileNameValidator.reserved_keywordss''3      ,3412HH      ,?T-NNOOHH ^^   ,!1!1 ,?T-LLMMHH?++HVH%%&&&r=NTr2r'r(r)r3r,cVt||||||dS)Nr1)r5r6)r9r2r'r(r)r3r,r;s r<r6zFileNameValidator.__init__sB #)&?      r=r?c t||d t|}t||j}||tjtj tj |j tj |jtj|tj|i}||jkrt#d|jdd|ddgfi|||jkrt#d|jdd|ddgfi||||||dr||dSdS) NTrBrDz filename is too long: expected<=rpz bytes, actual=z bytesz!filename is too short: expected>=)rrKrlenencoderQvalidate_abspathrREASONrINVALID_LENGTHPLATFORMr) FS_ENCODING BYTE_COUNTVALUEr'rr2_validate_reserved_keywords/_FileNameValidator__validate_universal_filename)_FileNameValidator__validate_win_filename)r9r?unicode_filenamebyte_ct err_kwargss r<rSzFileNameValidator.validates%t7G7GZ^7G7_7_3_````!%==&--d.?@@AA .///  !;  !4=  $d&7  #W   0   T\ ! !!gt|gggV]gggg   T\ ! !!h hhhW^hhhh   (()9::: **+;<<<   d  3 3 ;  ( ()9 : : : : : ; ;r=ctd|d|jtj}|drt |r|t j|r|dS)Nzfound an absolute path (z), expected a filename)rIr)rJTrB)rr)rFOUND_ABS_PATHrKr posixpathisabs)r9r?errs r<rz"FileNameValidator.validate_abspathsR5RRR]-      d  3 3 U##  ?5 ! ! I  r=rct|}|r>  ")0*511"+&    r=cjt|}|r`__ r)r2r'r(r3r,N)r4rSrr)r2r'r(r3r,s r<validate_filenamersAx%"; hxr=cZt|||dn|||||S)a0Check whether the ``filename`` is a valid name or not. Args: filename: A filename to be checked. platform: Target platform name of the filename. Example: :ref:`example-is-valid-filename` See Also: :py:func:`.validate_filename()` Nrr)r4is_validrs r<is_valid_filenamer[sD0 o7%";    hxr=r>Fr@r*r+r-c |*tjdt|dur tj}t ||dn|||||| ||S)a Make a valid filename from a string. To make a valid filename, the function does the following: - Replace invalid characters as file names included in the ``filename`` with the ``replacement_text``. Invalid characters are: - unprintable characters - |invalid_filename_chars| - for Windows (or universal) only: |invalid_win_filename_chars| - Replace a value if a sanitized value is a reserved name by operating systems with a specified handler by ``reserved_name_handler``. Args: filename: Filename to sanitize. replacement_text: Replacement text for invalid characters. Defaults to ``""``. platform: Target platform name of the filename. .. include:: platform.txt max_len: Maximum byte length of the ``filename``. Truncate the name length if the ``filename`` length exceeds this value. Defaults to ``255``. fs_encoding: Filesystem encoding that is used to calculate the byte length of the filename. If |None|, get the encoding from the execution environment. check_reserved: [Deprecated] Use 'reserved_name_handler' instead. null_value_handler: Function called when a value after sanitization is an empty string. You can specify predefined handlers: - :py:func:`~.handler.NullValueHandler.return_null_string` - :py:func:`~.handler.NullValueHandler.return_timestamp` - :py:func:`~.handler.raise_error` Defaults to :py:func:`.handler.NullValueHandler.return_null_string` that just return ``""``. reserved_name_handler: Function called when a value after sanitization is a reserved name. You can specify predefined handlers: - :py:meth:`~.handler.ReservedNameHandler.add_leading_underscore` - :py:meth:`~.handler.ReservedNameHandler.add_trailing_underscore` - :py:meth:`~.handler.ReservedNameHandler.as_is` - :py:func:`~.handler.raise_error` Defaults to :py:func:`.handler.add_trailing_underscore`. additional_reserved_names: Additional reserved names to sanitize. Case insensitive. validate_after_sanitize: Execute validation after sanitization to the file name. Returns: Same type as the ``filename`` (str or PathLike object): Sanitized filename. Raises: ValueError: If the ``filename`` is an invalid filename. Example: :ref:`example-sanitize-filename` NzD'check_reserved' is deprecated. Use 'reserved_name_handler' instead.Fr)r)r'r(r*r+r,r-)warningswarnDeprecationWarningras_isr&ra) rr@r)r'r(r3r*r+r,r-s r<sanitize_filenamer}s`! R    U " "$7$= ! o7-3"; 7   hx)**+r=)9__doc__rrrWrcollections.abcrpathlibrrrtypingrr_baser r r r _commonrrrrr_constrrr_typesrrerrorrrrrhandlerrrrrcompilerX_INVALID_FILENAME_CHARSUNICODEr#_INVALID_WIN_FILENAME_CHARSr$r&r4rfrPrgrrrrqr=r<rsm $$$$$$""""""""""""""""PPPPPPPPPPPP[[[[[[[[[[[[[[HHHHHHHHHH********OOOOOOOOOOOO@@@@@@@@$'5&&&(bj8  (2338888"*e#-"*<  (677<<<B9=$)a+a+a+a+|$a+c] a+ # a+ TN a+!!78a+$$:;a+ ( 6a+"a+a+a+a+a+a+a+r=