+ O(iI~aRt;0tRt^RIt^RIt^RIt^RIt^RIt^RIH t ^RI H t H t ^RIH t ^RIHtHt^RIHtHtHtHt^RIHtHtHtHt^RIHtHtHtHt^R I H!t!H"t"^R I#H$t$H%t%^R I&H't'H(t(H)t)H*t*H+t+^R I,H-t-H.t.]P^!R ]P`!]Pb4R R2]Pd4t3]^k]P^!R ]P`!]Ph4R R2]Pd4t5]^k!RR]4t6!RR]4t7R]RRRR3RRllt8R]RRRR3RRllt9RRRllt:R#)zA .. codeauthor:: Tsuyoshi Hombashi 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]c|aa]tRt^toR V3RlV3RllltR V3RlRlltV3RlRltV3RlRltR tVt V;t #) FilePathSanitizerc<V^8dQhRS[RS[S[,RS[S[,RS[S[,RS[S[,RS[S[S[,,RS[RS[R S[S[,R R / #) max_len fs_encodingplatformnull_value_handlerreserved_name_handleradditional_reserved_names normalizevalidate_after_sanitize validatorreturnN)intrstrrrrboolr )format __classdict__s"\/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/pathvalidate/_filepath.py __annotate__FilePathSanitizer.__annotate__s161616c]16<( 16 %%;< 16 ((>? 16$,HSM#:1616"&16-.16 16c <V 'dT p M\\VVRVVR7p \S V` VVV VVVVVR7VP 4Vn\ VPVVVVVPVR7Vn Wpn VPRR7'd\PVnR#\PVnR#)Tmin_lenr&r'check_reservedr+r()r&r'r.r)r*r+r(r-)r&r'r)r*r+r(r-include_universalN)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,r-r.fpath_validator __class__s &&&&&&&&&& r5rAFilePathSanitizer.__init__s 'O/''#*C! O #%1"7&?$;  !% 9 9 ;!2LL#1"7&?]]$;" %   d  3 3!'!2!2D !*!5!5D r8c,<V^8dQhRS[RS[RS[/#)r%valuereplacement_textr/)rr1)r3r4s"r5r6r7Rs"11h1#1x1r8c\WPRR7'*R7\T4pTPT4wrTTPPY$4pTP'd(T'd \PP!T4pTp.pT'dTP#T4TP%RR4P'R4F}pT\(9dTP#T R24K$\+TP,P/YR74p T 'gT'gTP#R4KlTP#T 4K TP14P3T4pTP4P7T4TP8'dTP4P7T4\ T\4'd \;T4#T# \dSpTP\P 8Xd.\ T\4'dhTPT4uRp?#hRp?ii;i \d;pTP\P 8XdTPT4pRp?LRp?ii;i) Tr=allow_whitespacesN\/_)rQ)rrFrreasonr NULL_NAME isinstancer_null_value_handlerrrIrCsubrEospathnormpathappendreplacesplitrr1rDsanitize&_FilePathSanitizer__get_path_separatorjoin _validatorvalidate_validate_after_sanitizer) rKrPrQeunicode_filepathdrivesanitized_pathsanitized_entriesentrysanitized_entrys &&& r5rdFilePathSanitizer.sanitizeRs  e;K;K^b;K;c7c d"%="&"4"45E"F00445EX     0!ww//0@A )')   $ $U +#++D#6<FilePathValidator.s%U;T2bii()+;Ts')c4<V^8dQhRS[S[R3,/#)r%r/.)tupler1)r3r4s"r5r6FilePathValidator.__annotate__s  5c? r8c<\SV`p\VP4VP 4VP 4.4'dWP ,#VP4'd VR,#V#)rV)rV)r@reserved_keywordsany _is_universal _is_posix _is_macos_MACOS_RESERVED_FILE_PATHS _is_linux)rKcommon_keywordsrMs& r5r#FilePathValidator.reserved_keywordssc'3 ""$dnn&68HI J J"%D%DD D >>  "V+ +r8NTc<V^8dQhRS[RS[RS[S[,RS[S[,RS[RS[S[S[,,RR/#) r%r;r&r'r(r<r+r/N)r0rr1rr2r)r3r4s"r5r6rsc6666c] 6 <( 6  6$,HSM#:6 6r8c <\SV`VVVVVVR7\VVPVVVVR7VnVP RR7'd\ PVnR#\PVnR#)r:Tr=N) r@rArr&#_FilePathValidator__fname_validatorrFrGrH_FilePathValidator__split_driverJ)rKr;r&r'r(r<r+rMs&&&&&&&r5rAFilePathValidator.__init__s #)&?  "3LL#)&? "    d  3 3!'!2!2D !*!5!5D r8c$<V^8dQhRS[RR/#r%rPr/Nr)r3r4s"r5r6rs.<.={:d} bytes, actual={:d} bytesrUrV).z..)rrFvalidate_abspathrrlenencode _fs_encodingrREASONrINVALID_LENGTHPLATFORMr( FS_ENCODING BYTE_COUNTVALUEr&rr;r3_validate_reserved_keywordsrbrcrrh)_FilePathValidator__validate_win_filepath*_FilePathValidator__validate_unix_filepath)rKrP_drivetailrkbyte_ct err_kwargsros&& r5rhFilePathValidator.validates%7G7GZ^7G7_3_` e$))%0  !$<&--d.?.?@A   !;!;  ! !4==  $ $d&7&7  # #W    0   \\ !!7 Q7GW^_`Vaagh   \\ !!U\\ g    (()9:+33D#>%++C0EE[0  " " + +E 2 1   d  3 3  ( ()9 :  ) )*: ;r8c$<V^8dQhRS[RR/#rr)r3r4s"r5r6rs!!h!4!r8c\P!V4p\\V44p\ VP 4;'dTVP 4;'dT.4'dR#VP4'd9\ W2.4'd'\RVP\PR7\RV: RVPP R2R,R,VP\PR7pVP R R 7'd V'dVhVP 4'g/\P!V4wrVV'd V'dVhR#R#R#) Nz8platform-independent absolute file path is not supported)r(rYzan 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(rYTr=)rJisabsr rrrFrrrr(rMALFORMED_ABS_PATHrPrGrH)rKrP is_posix_abs is_nt_abs err_objectrl_tails&& r5r"FilePathValidator.validate_abspaths, u- !&-0   "00y$..2B2S2S|T U U      C(A$B$B J"55  %1%:Nt}}ObObNccefYZ/0]]11    d  3 3  !!!,,U3LE  #u"r8c$<V^8dQhRS[RR/#r%rkr/Nrz)r3r4s"r5r6rsr8c\PV4pV'd,\\P!\ V4R7VR7hR#)invalid)rPN)rvfindallrrr3r )rKrkmatchs&& r5__validate_unix_filepath*FilePathValidator.__validate_unix_filepaths> (()9: ")009NO&  r8c$<V^8dQhRS[RR/#rrz)r3r4s"r5r6rsr8c\PV4pV'd;\\P!\ V4R7\ PVR7hVPV4wr4V'dSVPPV4pV'd.VP4p\RV R2RVVPR7hR#R#)r)r(rP'z' is a reserved nameF) reusable_name reserved_namer(N)rurrrr3r rWINDOWSr_RE_NTFS_RESERVEDsearchgrouprr()rKrkrrrPmatch_reservedrs&& r5__validate_win_filepath)FilePathValidator.__validate_win_filepaths$,,-=> ")009NO!))&  **+;<  !33::5AN . 4 4 6 ' &:;"'"/!]]  r8c2<V^8dQh/S[;R&S[;R&#)r%rr)r)r3r4s"r5r6rs !&2 r8)__fname_validatorr)rV:r)rrrrrcompilerfr IGNORECASErrpropertyrrrArhrrr__annotate_func__rrrrs@@r5r?r?s!zz U;TUU  )3    '%)+/#=A66@.<.<`!!@Wr8r?TcV^8dQhR\R\\,R\R\\,R\\,R\ R\\ \,,RR /#) r% file_pathr(r;r&r'r<r+r/Nrrrr0r1r2r)r3s"r5r6r63sx@@@|$@@c] @ # @  @ ( 6@ @r8c R\TTVfRMTVVVR7PV4R#)aVerifying whether the ``file_path`` is a valid file path or not. Args: file_path (PathType): File path to be validated. platform (Optional[PlatformType], optional): Target platform name of the file path. .. include:: platform.txt min_len (int, optional): Minimum byte length of the ``file_path``. The value must be greater or equal to one. Defaults to ``1``. max_len (Optional[int], optional): Maximum byte length of the ``file_path``. If the value is |None| or minus, automatically determined by the ``platform``: - ``Linux``: 4096 - ``macOS``: 1024 - ``Windows``: 260 - ``universal``: 260 fs_encoding (Optional[str], optional): 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 (bool, optional): If |True|, check the reserved names of the ``platform``. Defaults to |True|. additional_reserved_names (Optional[Sequence[str]], optional): Additional reserved names to check. Raises: ValidationError (ErrorReason.INVALID_CHARACTER): If the ``file_path`` includes invalid char(s): |invalid_file_path_chars|. The following characters are also invalid for Windows platforms: |invalid_win_file_path_chars| ValidationError (ErrorReason.INVALID_LENGTH): If the ``file_path`` is longer than ``max_len`` characters. ValidationError: If ``file_path`` includes invalid values. Example: :ref:`example-validate-file-path` See Also: `Naming Files, Paths, and Namespaces - Win32 apps | Microsoft Docs `__ Nr(r;r&r'r<r+r)r?rhrr(r;r&r'r<r+s&&&&&&&r5validate_filepathr3s1ro7%"; hyr8cV^8dQhR\R\\,R\R\\,R\\,R\ R\\ \,,R\ /#) r%rr(r;r&r'r<r+r/r)r3s"r5r6r6vsn|$c]  #    ( 6 r8c N\TTVfRMTVVVR7PV4#)a Check 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()` rr)r?is_validrs&&&&&&&r5is_valid_filepathrvs50 o7%";  hyr8cXV^8dQhR\R\R\\,R\\,R\\,R\\ ,R\\ ,R\\ ,R \\\,,R \ R \ R \/ #) r%rrQr(r&r'r<r)r*r+r,r-r/)rr1rrr0r2rr)r3s"r5r6r6sl,l,l,l,|$l,c] l, # l, TN l,!!78l,$$:;l, ( 6l,l,"l,l,r8c Ve2\P!R\4VRJd\Pp\ TVfRMTVV VVVV R7P W4#)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` zD'check_reserved' is deprecated. Use 'reserved_name_handler' instead.F)r(r&r'r,r)r*r+r-r)warningswarnDeprecationWarningras_isr#rd) rrQr(r&r'r<r)r*r+r,r-s &&&&&&&&&&&r5sanitize_filepathrsjt! R  U "$7$=$= ! o7-3"; 7 hy+ ,r8chV^8dQh/^\9d \;R&^\9d \;R&#)r%rvru)__conditional_annotations__r)r3s"r5r6r6s5.cb%b/0e1r8) rXNNNNNNNTF)rs $""PPMMcc;*bb@**q83O3O)PQR(SST%UWYWaWabb jj (223A6a8"** q)qh^ ^F(,"!!%9=@J(,"!!%9=Dl,l,r8