-2iLE:UdZddlZddlZddlZddlZddlmZddlmZm Z ddlm Z ddl m Z m Z ddlmZmZmZmZdd lmZmZmZmZmZdd lmZmZmZdd lmZmZdd l m!Z!m"Z"m#Z#m$Z$dd l%m&Z&m'Z'dZ(e e)d<ejTdejVejXddejZZ.e e)d<ejTdejVej^ddejZZ0e e)d<GddeZ1GddeZ2dee(dddfdede ede3de3de e4de5d e ee4d!dfd"Z6deddddfdede ede3de e3de e4de5d e ee4d!e5fd#Z7d$de(dddddd%f ded&e4de ede e3de e4de e5d'e e'd(e e'd e ee4d)e5d!efd*Z8y)+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_DEFAULT_MAX_FILENAME_LEN[s]_RE_INVALID_FILENAME_RE_INVALID_WIN_FILENAMEceZdZedddddddfdedeedeedeedeedee ed e d ee d dffd Z dd e ded e fdZd eefdZxZS)FileNameSanitizerNFmax_len fs_encodingplatformnull_value_handlerreserved_name_handleradditional_reserved_namesvalidate_after_sanitize validatorreturnc |r|} ntt||d||} t | |||||||| |j |_y)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 `/mnt/e/genesis-system/.venvs/voice-bridge/lib/python3.12/site-packages/pathvalidate/_filename.pyr6zFileNameSanitizer.__init__ sh 'O/''#*C! O #1"7&?$;%  !% 9 9 ;valuereplacement_textc t||jd |jj|t|}t||j|j} |jj!||j2r |jj!|t |tr t9|S|S#t$rJ}|jtj k(r't |tr|j|cYd}~Sd}~wwxYw#t$r}|jtj"k(rU|j%|}|j&|k7rt)jt)j*|j&||}n|jtj,k(rJ|jdr8|j/d}|j1d}|dvr@|j1d}n.|jtj k(r|j|}Yd}~d}~wwxYw#t$r4}tt|tj4|j6d}~wwxYw)NTinclude_universalallow_whitespaces .z..z .) descriptionreasonr))r _is_windowsrrIr 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;c7c d"22667GUT)*O>OQUQ]Q]^ A OO $ $%7 8*  ( ( (();< eX &*+ +!!] xx;000eX.//22    Axx;444#'#>#>q#A ??&66)+ !//24DFX*&[:::t?O?O"&@P@&8%>%>s%C"&8%>%>s%C"%[8);)B)B4)H&[222%)%=%=a%@"% A.# % #A&==!]] sTC'DH< D>DDDD H9'DH44H9< I9/I44I9c>|jdrtStS)NTrA)rJr$r#)r9s r<r7z&FileNameSanitizer._get_sanitize_regexpws   d  3+ +##r=))__name__ __module__ __qualname__rintrrOrrrboolr r6rr`rr7 __classcell__r;s@r<r&r&s1%)+/?CBF=A(-15"<"<c]"<<( "< %%;< "< ((>? "<$,HSM#:"<"&"<-."< "zFileNameValidator.s!dytS4(3q'"d)COMLPTr c#2K|]\}}|d|dyw)r!Nrq)rrrsssds r<ruzFileNameValidator.s) cAhs1g  rv)¹²³_WINDOWS_RESERVED_FILE_NAMES):_MACOS_RESERVED_FILE_NAMESr/.ct|}|jr&t||jz|j z}nm|j rt||jz}nD|js|jrt||j z}n t|}tt|S)N) r5reserved_keywords _is_universalsetrrrJ _is_posix _is_macostuplesorted)r9common_keywordsword_setr;s r<rz#FileNameValidator.reserved_keywordss'3    334112H    ?T-N-NNOH ^^ !1?T-L-LLMH?+HVH%&&r=NTr2r'r(r)r3r,c0t|||||||y)Nr1)r5r6)r9r2r'r(r)r3r,r;s r<r6zFileNameValidator.__init__s) #)&?  r=r>c t||jd t|}t|j |j }|j |tjtjtj|jtj|j tj|tj|i}||j kDr t#d|j dd|ddgfi|||j$kr t#d|j$dd|ddgfi||j'||j)||jdr|j+|yy) NTrArCz filename is too long: expected<=rpz bytes, actual=z bytesz!filename is too short: expected>=)rrJrlenencoderPvalidate_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<rRzFileNameValidator.validates{%t7G7GZ^7G7_3_`!%=&--d.?.?@A ./   !;!;  ! !4==  $ $d&7&7  # #W    0   T\\ !!6t||A6FoV]^_U``fg   T\\ !!7 Q7GW^_`Vaagh   (()9: **+;<   d  3  ( ()9 : 4r=ctd|d|jtj}|j dr t |r|t j|r|y)Nzfound an absolute path (z), expected a filename)rHr)rITrA)rr)rFOUND_ABS_PATHrJr posixpathisabs)r9r>errs r<rz"FileNameValidator.validate_abspaths_25);QR]]--    d  3U# ??5 !I "r=rctj|}|r9ttjt |t j|y)Ninvalidr)r>)r#findallrrformatrr UNIVERSAL)r9rmatchs r<__validate_universal_filenamez/FileNameValidator.__validate_universal_filenamesL$,,-=> ")00*51"++&   r=cJtj|}|r9ttjt |t j||dvryd}tjt jtj|i}|ddvrGttjtj|dfd|j di||d d vrGttjtj|d fd|j d i|y) NrrrFz{}. Refer: https://learn.microsoft.com/en-us/troubleshoot/windows-client/shell-experience/file-folder-name-whitespace-characters)rErGrHz`__ r)r2r'r(r3r,N)r4rRrr)r2r'r(r3r,s r<validate_filenamers+x%"; hxr=cJt|||dn||||j|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()` rr)r4is_validrs r<is_valid_filenamer[s50 o7%";  hxr=rbFr?r*r+r-c |.tjdt|durtj}t ||dn|||||| j ||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` zD'check_reserved' is deprecated. Use 'reserved_name_handler' instead.Fr)r)r'r(r*r+r,r-)warningswarnDeprecationWarningras_isr&r`) rr?r)r'r(r3r*r+r,r-s r<sanitize_filenamer}sj`! R  U "$7$=$= ! o7-3"; 7 hx)*+r=)9__doc__rrrVrcollections.abcrpathlibrrrtypingrr_baser r r r _commonrrrrr_constrrr_typesrrerrorrrrrhandlerrrrrcompilerW_INVALID_FILENAME_CHARSUNICODEr#_INVALID_WIN_FILENAME_CHARSr$r&r4rfrOrgrrrrqr=r<rs $""PP[[HH*OO@$'5&(bjj  (223A6a8"**e#-"**  (667:!B9=$)a+a+a+|$a+c] a+ # a+ TN a+!!78a+$$:;a+ ( 6a+"a+a+r=