+ O(iLE aRt60tRt^RIt^RIt^RIt^RIt^RIHt^RIH t H t ^RIH t ^RI H t Ht^RIHtHtHtHt^RIHtHtHtHtHt^RIHtHtHt^R IHtH t ^R I!H"t"H#t#H$t$H%t%^R I&H't'H(t(^t)]^k]PT!R ]PV!]PX4R R2]PZ4t.]^k]PT!R ]PV!]P^4R R2]PZ4t0]^k!RR]4t1!RR]4t2R]])RRR3RRllt3R]RRRR3RRllt4RR])RRRRRR3 RRllt5R#)zA .. codeauthor:: Tsuyoshi Hombashi 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[s]czaa]tRt^to]RRRRRRR3V3RlV3RllltR V3RlRlltV3RlRltR tVt V;t #) FileNameSanitizerNFc<V^8dQhRS[RS[S[,RS[S[,RS[S[,RS[S[,RS[S[S[,,RS[RS[S[,R R / #) max_len fs_encodingplatformnull_value_handlerreserved_name_handleradditional_reserved_namesvalidate_after_sanitize validatorreturnN)intrstrrrrboolr )format __classdict__s"\/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/pathvalidate/_filename.py __annotate__FileNameSanitizer.__annotate__ s"<"<"<c]"<<( "< %%;< "< ((>? "<$,HSM#:"<"&"<-."< "<c <V'dTp M\\VVRVVR7p \S V` VVVVVVVV R7VP 4VnR#)Tmin_lenr#r$check_reservedr(r%)r#r$r&r'r(r%r)r*N)FileNameValidatorrsuper__init___get_sanitize_regexp_sanitize_regexp) selfr#r$r%r&r'r(r)r*fname_validator __class__s &&&&&&&&& r1r;FileNameSanitizer.__init__ sh 'O/''#*C! O #1"7&?$;%  !% 9 9 ;r4c,<V^8dQhRS[RS[RS[/#)r"valuereplacement_textr+)rr-)r/r0s"r1r2r3Ds"1"1"h1"#1"x1"r4ch\WPRR7'*R7TPPT\T44p\Y@PTP4pTPP!T4TP2'dTPP!T4\ T\4'd \9T4#T# \dSpTP\P 8Xd.\ T\4'dhTPT4uRp?#hRp?ii;i \Ed/pTP\P"8Xd^TP%T4pTP&T8wd6\(P!\(P*!TP&4YT4pRp?EL9TP\P,8XdYTPRR7'dATP/R4pTP1R4pTR9dTP1R4pRp?ELTP\P 8XdTPT4pRp?ELRp?ii;i \d5p\\T4\P4TP6R7hRp?ii;i)Tinclude_universalallow_whitespacesN z .) descriptionreasonr%.z..)r _is_windowsrrLr NULL_NAME isinstancer_null_value_handlerr=subr-r _fs_encodingr# _validatorvalidate RESERVED_NAME_reserved_name_handler reserved_namereescapeINVALID_CHARACTERlstriprstrip_validate_after_sanitizeINVALID_AFTER_SANITIZEr%r)r>rCrDesanitized_filenamereplacement_words&&& r1sanitizeFileNameSanitizer.sanitizeDs6  e;K;K^b;K;c7c d"22667GUT)*<>O>OQUQ]Q]^ A OO $ $%7 8*  ( ( ( (();< eX & &*+ +!!] xx;000eX..//22    Axx;444#'#>#>q#A ??&66)+ !//24D*&[:::t?O?O"&@P@@&8%>%>s%C"&8%>%>s%C"%[8);)B)B4)H&[222%)%=%=a%@"% A.# % #A&==!]] sg!C)D5I2 D2 AD-&D2,D--D25 I/A6I*=6I*4:I*40I**I/2 J1=/J,,J1c0<V^8dQhRS[S[,/#)r"r+)rr-)r/r0s"r1r2r3ws$$gcl$r4cJVPRR7'd\#\#)TrF)rO_RE_INVALID_WIN_FILENAME_RE_INVALID_FILENAME)r>s&r1r<&FileNameSanitizer._get_sanitize_regexpws"   d  3 3+ +##r4)r=)) __name__ __module__ __qualname____firstlineno___DEFAULT_MAX_FILENAME_LENr;rdr<__static_attributes____classdictcell__ __classcell__r@r0s@@r1r r sD1%)+/?CBF=A(-15"<"FileNameValidator.s!d4cyt4(3q'"4cc#6"TFwrVR VR 2xK R#5i)rNrx)ryrzssds& r1r|r}s*  Ahs1g r~c4<V^8dQhRS[S[R3,/#)r"r+.)tupler-)r/r0s"r1r2FileNameValidator.__annotate__s''5c?'r4c<\SV`pVP4'd/\VVP,VP ,4pMVP 4'd\WP,4pMSVP4'gVP4'd\WP ,4pM \V4p\\V44#)N) r:reserved_keywords _is_universalset_WINDOWS_RESERVED_FILE_NAMES_MACOS_RESERVED_FILE_NAMESrO _is_posix _is_macosrsorted)r>common_keywordsword_setr@s& r1r#FileNameValidator.reserved_keywordss'3     334112H     ?-N-NNOH ^^  !1!1?-L-LLMH?+HVH%&&r4NTc<V^8dQhRS[RS[RS[S[,RS[S[,RS[RS[S[S[,,RR/#) r"r7r#r$r%r8r(r+N)r,rr-rr.r)r/r0s"r1r2rsc    c]  <(    $,HSM#:   r4c 2<\SV`VVVVVVR7R#)r6N)r:r;)r>r7r#r$r%r8r(r@s&&&&&&&r1r;FileNameValidator.__init__s) #)&?  r4c$<V^8dQhRS[RR/#r"rCr+N)r)r/r0s"r1r2rs";";h";4";r4c  \WPRR7'*R7\V4p\VP VP 44pVP V4\P\P\PVP\PVP \PV\PV/pW0P 8d!\#RVP R RVR R2.3/VBhW0P$8d!\#RVP$R RVR R2.3/VBhVP'V4VP)V4VPRR7'dVP+V4R#R#) TrFrHz filename is too long: expected<=rwz bytes, actual=z bytesz!filename is too short: expected>=N)rrOrlenencoderTvalidate_abspathrREASONrINVALID_LENGTHPLATFORMr% FS_ENCODING BYTE_COUNTVALUEr#rr7_validate_reserved_keywords/_FileNameValidator__validate_universal_filename)_FileNameValidator__validate_win_filename)r>rCunicode_filenamebyte_ct err_kwargss&& r1rVFileNameValidator.validatesx%7G7GZ^7G7_3_`!%=&--d.?.?@A ./   !;!;  ! !4==  $ $d&7&7  # #W    0   \\ !!6t||A6FoV]^_U``fg   \\ !!7 Q7GW^_`Vaagh   (()9: **+;<   d  3 3  ( ()9 : 4r4c$<V^8dQhRS[RR/#rr-)r/r0s"r1r2rs  c d r4c\RV: R2VP\PR7pVP RR7'd\ V4'dVh\ P!V4'dVhR#)zfound an absolute path (z), expected a filename)rKr%rLTrFN)rr%rFOUND_ABS_PATHrOr posixpathisabs)r>rCerrs&& r1r"FileNameValidator.validate_abspathsh25);QR]]--    d  3 3U## ??5 ! !I "r4c$<V^8dQhRS[RR/#r"rr+Nr)r/r0s"r1r2rs  c d r4c\PV4pV'd;\\P!\ V4R7\ PVR7hR#)invalidr%rCN)rifindallrrr/r r UNIVERSAL)r>rmatchs&& r1__validate_universal_filename/FileNameValidator.__validate_universal_filenamesL$,,-=> ")00*51"++&   r4c$<V^8dQhRS[RR/#rr)r/r0s"r1r2rs$$$$r4c\PV4pV'd;\\P!\ V4R7\ PVR7hVR9dR#Rp\P\ P\PV/pVR ,R 9dN\\P!\P!VR ,4R73RVP R4/VBhV^,R9dN\\P!\P!V^,4R73RVP R4/VBhR#) rrNz{}. Refer: https://learn.microsoft.com/en-us/troubleshoot/windows-client/shell-experience/file-folder-name-whitespace-charactersrJrKzrrKB2829981_err_tmplrs&& r1__validate_win_filename)FileNameValidator.__validate_win_filenames:(001AB ")00*51"))&   { * `  ! !8#3#3    0 B : -")00CSTVCW9XY.55R    A 3 '")00CSTUCV9WX.55H    (r4c2<V^8dQh/S[;R&S[;R&#)r"rr)r)r/r0s"r1r2r~s"' !&.r4rx)CONPRNAUXzCLOCK$NUL)COMLPT)¹²³):)rlrmrnror itertoolsproductrangerrpropertyrrrpr;rVrrr__annotate_func__rqrrrsrts@@r1r9r9~s. %dI4E4EnV[\]_aVb4cd%%dI4E4EnV[\]_aVb4cd d e % &..W %% &..W   !)/ '''('0%)+/#=A  $";";H    $$ar4r9TcV^8dQhR\R\\,R\R\R\\,R\ R\\ \,,RR /#) r"filenamer%r7r#r$r8r(r+Nrrrr,r-r.r)r/s"r1r2r2stCCC|$CC C # C  C ( 6C Cr4c F\VVVVVVR7PV4R#)aVerifying whether the ``filename`` is a valid file name or not. Args: filename: Filename to validate. platform: Target platform name of the filename. .. include:: platform.txt min_len: Minimum byte length of the ``filename``. The value must be greater or equal to one. Defaults to ``1``. max_len: Maximum byte length of the ``filename``. The value must be lower than: - ``Linux``: 4096 - ``macOS``: 1024 - ``Windows``: 260 - ``universal``: 260 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: If |True|, check the reserved names of the ``platform``. additional_reserved_names: Additional reserved names to check. Case insensitive. Raises: ValidationError (ErrorReason.INVALID_LENGTH): If the ``filename`` is longer than ``max_len`` characters. ValidationError (ErrorReason.INVALID_CHARACTER): If the ``filename`` includes invalid character(s) for a filename: |invalid_filename_chars|. The following characters are also invalid for Windows platforms: |invalid_win_filename_chars|. ValidationError (ErrorReason.RESERVED_NAME): If the ``filename`` equals the reserved name by OS. Windows reserved name is as follows: ``"CON"``, ``"PRN"``, ``"AUX"``, ``"NUL"``, ``"COM[1-9]"``, ``"LPT[1-9]"``. Example: :ref:`example-validate-filename` See Also: `Naming Files, Paths, and Namespaces - Win32 apps | Microsoft Docs `__ r%r7r#r$r8r(N)r9rVrr%r7r#r$r8r(s&&&&&&&r1validate_filenamers+x%"; hxr4cV^8dQhR\R\\,R\R\\,R\\,R\ R\\ \,,R\ /#) r"rr%r7r#r$r8r(r+r)r/s"r1r2r2[sn|$c]  #    ( 6 r4c N\TTVfRMTVVVR7PV4#)aCheck 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()` rr)r9is_validrs&&&&&&&r1is_valid_filenamer[s50 o7%";  hxr4rkFcLV^8dQhR\R\R\\,R\\,R\\,R\\ ,R\\ ,R\\ ,R \\\,,R \ R \/ #) r"rrDr%r#r$r8r&r'r(r)r+)rr-rrr,r.rr)r/s"r1r2r2}sa+a+a+a+|$a+c] a+ # a+ TN a+!!78a+$$:;a+ ( 6a+"a+a+r4c Ve2\P!R\4VRJd\Pp\ TVfRMTVVVVV R7P W4#)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` zD'check_reserved' is deprecated. Use 'reserved_name_handler' instead.F)r%r#r$r&r'r(r)r)warningswarnDeprecationWarningras_isr rd) rrDr%r#r$r8r&r'r(r)s &&&&&&&&&&r1sanitize_filenamer}sg`! R  U "$7$=$= ! o7-3"; 7 hx*+r4cV^8dQh/^\9d \;R&^\9d \;R&^\9d \;R&#)r"rprirh)__conditional_annotations__r)r/s"r1r2r2sJ*'&5&+,e-2%3r4)7r__doc__rrrZrcollections.abcrpathlibrrrtypingrr_baserr r r _commonr r rrr_constrrr_typesrrerrorrrrrhandlerrrrpcompiler[_INVALID_FILENAME_CHARSUNICODEri_INVALID_WIN_FILENAME_CHARSrhr r9rrrr2)rs@r1rs= $""PP[[HH*OO@$'& jj (223A6a8"**#%** (667:!B9=$)a+a+r4