N)Sequence)PathPurePath)Pattern)FinalOptional)AbstractSanitizerAbstractValidatorBaseFile BaseValidator)findall_to_str is_nt_abspathto_strvalidate_pathtype)_NTFS_RESERVED_FILE_NAMESDEFAULT_MIN_LENINVALID_CHAR_ERR_MSG_TMPLPlatform)FileNameSanitizerFileNameValidator)PathType PlatformType) ErrorAttrKey ErrorReasonInvalidCharErrorReservedNameErrorValidationError)ReservedNameHandlerValidationErrorHandler[s]_RE_INVALID_PATH_RE_INVALID_WIN_PATHceZdZ ddedeedeedeed eed eeed e d e d ee ddffd Z dde dede fdZ deefdZdefdZxZS)FilePathSanitizerNTFmax_len fs_encodingplatformnull_value_handlerreserved_name_handleradditional_reserved_names normalizevalidate_after_sanitize validatorreturnc | r| } ntt||d||} t||| |||||||_t |j|||||j||_ ||_ | drtj |_dStj |_dS)NTmin_lenr)r*check_reservedr.r+)r)r*r1r,r-r.r+r0)r)r*r,r-r.r+r0include_universal)FilePathValidatorrsuper__init___get_sanitize_regexp_sanitize_regexprr)r+#_FilePathSanitizer__fname_sanitizer_FilePathSanitizer__normalize _is_windowsntpath splitdrive_FilePathSanitizer__split_drive posixpath) selfr)r*r+r,r-r.r/r0r1fpath_validator __class__s /Users/kimhansen/Desktop/03 Workspace/ceo-agents/chl-effectiveness/mcp-servers/whoop/.venv/lib/python3.11/site-packages/pathvalidate/_filepath.pyr;zFilePathSanitizer.__init__s  'OO/''#*C! O #%1"7&?$;  !% 9 9 ; ;!2L#1"7&?]$;" " " %   d  3 3 6!'!2D   !*!5D   valuereplacement_textc t||d nX#t$rK}|jtjkr0t |tr||cYd}~Sd}~wwxYwt|}| |\}}|j ||}|j r!|rtj|}|}g}|r|||dddD]|}|t(vr||d$t+|j||} | s|s|dg|| }||} |j|nA#t$r4}|jtjkr||}Yd}~nd}~wwxYw|jr|j|t |trt;|S|S) NTr7allow_whitespaces\/_)rLrJ)rr@rreasonr NULL_NAME isinstancer_null_value_handlerrrCr=subr?ospathnormpathappendreplacesplitrstrr>sanitize&_FilePathSanitizer__get_path_separatorjoin _validatorvalidate_validate_after_sanitizer) rErKrLeunicode_filepathdrivesanitized_pathsanitized_entriesentrysanitized_entrys rHr_zFilePathSanitizer.sanitizeRs  e4;K;K^b;K;c;c7c d d d d d   x;000eX..//22222222   "%=="&"4"45E"F"F0445EGWXX   B 0 B!w//0@AA )')  ,  $ $U + + +#++D#66<?A92A>8A99A>G// H-9*H((H-cJ|drtStS)NTr7)r@r%r$rEs rHr<z&FilePathSanitizer._get_sanitize_regexps'   d  3 3 (' 'rIc2|rdSdS)NrPrQ)r@rms rH__get_path_separatorz&FilePathSanitizer.__get_path_separators      4srI) r(NNNNNTFN)rJ)__name__ __module__ __qualname__intrr^rr rboolr r;rr_rr<r` __classcell__rGs@rHr'r'sO%)+/?CBF=A(-15161616c]16<( 16 %%;< 16 ((>? 16$,HSM#:1616"&16-.16 161616161616f11h1#1x1111f gcl    crIr'cjeZdZUejddeDejZe e d<dZ e e d<e de edfffd Zed d d d d fd ed edeedeededeeedd ffd Zdedd fdZdedd fdZdedd fdZdedd fdZxZS)r9|c#FK|]}dtj|dVdS)z^/$N)reescape).0patterns rH zFilePathValidator.s8UU+bi((+++UUUUUUrI_RE_NTFS_RESERVED)rQ:_MACOS_RESERVED_FILE_PATHSr2.ctj}t|||gr ||jzS|r|dzS|S)N)rQ)r:reserved_keywordsany _is_universal _is_posix _is_macosr _is_linux)rEcommon_keywordsrGs rHrz#FilePathValidator.reserved_keywordssx''3 ""$$dnn&6&68H8HI J J E"T%DD D >>   ,"V+ +rIr(NTr5r)r*r+r6r.ct||||||t||j|||||_|drt j|_dStj|_dS)Nr4Tr7) r:r;rr)#_FilePathValidator__fname_validatorr@rArB_FilePathValidator__split_driverD)rEr5r)r*r+r6r.rGs rHr;zFilePathValidator.__init__s #)&?    "3L#)&? " " "    d  3 3 6!'!2D   !*!5D   rIrKc t||d ||||\}}|sdSt |}t ||j}tj tj tj |j tj|jtj|tj|i}||jkrt%d|jdd|ddgfi|||jkr't%d|j|gfi||||d d }|d D]#}|r|d vr |j|$|dr||dS||dS) NTr7rNz!file path is too long: expected<=dz bytes, actual=z bytesz?file path is too short: expected>={:d} bytes, actual={:d} bytesrPrQ).z..)rr@validate_abspathrrlenencode _fs_encodingrREASONrINVALID_LENGTHPLATFORMr+ FS_ENCODING BYTE_COUNTVALUEr)rr5format_validate_reserved_keywordsr\r]rrc)_FilePathValidator__validate_win_filepath*_FilePathValidator__validate_unix_filepath)rErK_drivetailrfbyte_ct err_kwargsrjs rHrczFilePathValidator.validates0%t7G7GZ^7G7_7_3_```` e$$$))%00   F!$<<&--d.?@@AA  !;  !4=  $d&7  #W   0   T\ ! !!h hhhW^hhhh   T\ ! !!U\\ g    (()9:::+33D#>>%++C00 3 3E E[00  " + +E 2 2 2 2   d  3 3 <  ( ()9 : : : : :  ) )*: ; ; ; ; ;rIcvtj|}tt|}t |o||o|grdS|r2t ||gr!td|j tj td|d|j j ddzdz|j tj }|d r|r||stj|\}}|r|r|dSdSdS) Nz8platform-independent absolute file path is not supported)r+rSzan invalid absolute file path (z) for the platform (z).zE to avoid the error, specify an appropriate platform corresponding toz the path format or 'auto'.) descriptionr+rSTr7)rDisabsrrrr@rrrr+rMALFORMED_ABS_PATHrKrArB)rErK is_posix_abs is_nt_abs err_objectrg_tails rHrz"FilePathValidator.validate_abspaths} u-- !&--00   ""0y$..2B2B2S|T U U  F      CL(A$B$B  J"5     %f%fft}ObfffYZ/0]1      d  3 3    !! !!,U33LE5 ! !   ! ! ! ! ! !rIrfct|}|r1ttjt ||dS)Ninvalid)rK)r$findallrrrr)rErfmatchs rH__validate_unix_filepathz*FilePathValidator.__validate_unix_filepaths[ (()9::  ")09N9NOOO&   rIct|}|r>  ")09N9NOOO!)&  **+;<<   !3::5AAN  . 4 4 6 6 '; ;;;"'"/!]     rI)rprqrrr{compilerar IGNORECASErr__annotations__rpropertytupler^rrrsrrrtrr;rrcrrrrurvs@rHr9r9s)rz UU;TUUUUU   u)3222  5c?     X '%)+/#=A6666c] 6 <( 6  6$,HSM#:6 666666@.`__ Nr(r+r5r)r*r6r.)r9rcrr+r5r)r*r6r.s rHvalidate_filepathr3sIro7%"; hyrIcZt|||dn|||||S)a3Check whether the ``file_path`` is a valid name or not. Args: file_path: A filepath to be checked. platform: Target platform name of the file path. Example: :ref:`example-is-valid-filepath` See Also: :py:func:`.validate_filepath()` Nr(r)r9is_validrs rHis_valid_filepathrvsD0 o7%";    hyrIrJFrLr,r-r/r0c |*tjdt|dur tj}t ||dn||| |||| ||S)a Make a valid file path from a string. To make a valid file path, the function does the following: - Replace invalid characters for a file path within the ``file_path`` with the ``replacement_text``. Invalid characters are as follows: - unprintable characters - |invalid_file_path_chars| - for Windows (or universal) only: |invalid_win_file_path_chars| - Replace a value if a sanitized value is a reserved name by operating systems with a specified handler by ``reserved_name_handler``. Args: file_path: File path to sanitize. replacement_text: Replacement text for invalid characters. Defaults to ``""``. platform: Target platform name of the file path. .. include:: platform.txt max_len: Maximum byte length of the file path. Truncate the path if the value length exceeds the `max_len`. If the value is |None| or minus, ``max_len`` will automatically determined by the ``platform``: - ``Linux``: 4096 - ``macOS``: 1024 - ``Windows``: 260 - ``universal``: 260 fs_encoding: Filesystem encoding that is used to calculate the byte length of the file path. 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 one of the reserved names. 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. normalize: If |True|, normalize the the file path. validate_after_sanitize: Execute validation after sanitization to the file path. Returns: Same type as the argument (str or PathLike object): Sanitized filepath. Raises: ValueError: If the ``file_path`` is an invalid file path. Example: :ref:`example-sanitize-file-path` NzD'check_reserved' is deprecated. Use 'reserved_name_handler' instead.Fr()r+r)r*r/r,r-r.r0)warningswarnDeprecationWarningras_isr'r_) rrLr+r)r*r6r,r-r.r/r0s rHsanitize_filepathrst! R    U " "$7$= ! o7-3"; 7   hy*++ ,rI) rJNNNNNNNTF)>__doc__rAos.pathrXrDr{rcollections.abcrpathlibrrrtypingrr_baser r r r _commonrrrr_constrrrr _filenamerr_typesrrerrorrrrrrhandlerrr rr|_INVALID_PATH_CHARSUNICODEr$r_INVALID_WIN_PATH_CHARSr%r'r9rsr^rtrrrrIrHrs  $$$$$$""""""""""""""""PPPPPPPPPPPPMMMMMMMMMMMMcccccccccccc;;;;;;;;********bbbbbbbbbbbbbb@@@@@@@@%"*%U83O)P)P%U%U%U%UWYWabb%bbb(bj8  (2338888"*e qqqqq)qqqh^^^^^ ^^^F(,"!!%9=@@@|$@@c] @ # @  @ ( 6@ @@@@J(,"!!%9=|$c]  #    ( 6 H'+!!%%);?>B9=$)l,l,l,l,|$l,c] l, # l, TN l,!!78l,$$:;l, ( 6l,l,"l,l,l,l,l,l,l,rI