o iLE@s\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<e*de+ej,ddej-Z.e e)d<e*de+ej/ddej-Z0e e)d<GdddeZ1GdddeZ2dee(dddfdede ede3de3de e4de5d e ee4d!dfd"d#Z6deddddfdede ede3de e3de e4de5d e ee4d!e5fd$d%Z7d&de(dddddd'f ded(e4de ede e3de e4de e5d)e e'd*e e'd e ee4d+e5d!efd,d-Z8dS).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_FILENAMEcseZdZedddddddfdedeedeedeedeedee ed e d ee d dffd d Z dde ded e fddZd eefddZZS)FileNameSanitizerNFmax_len fs_encodingplatformnull_value_handlerreserved_name_handleradditional_reserved_namesvalidate_after_sanitize validatorreturnc sH|r|} n tt||d||d} tj|||||||| d||_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__\/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/pathvalidate/_filename.pyr3 s*   zFileNameSanitizer.__init__valuereplacement_textc Csz t||jdd dWn$ty1}z|jtjkr,t|tr!||WYd}~Sd}~ww|j |t |}t ||j |j}z|j|WnYty}zM|jtjkro||}|j|krnt t|j||}n+|jtjkr|jddr|d}|d}|dvr|d}n |jtjkr||}WYd}~nd}~ww|jrz|j|Wnty}z tt |tj|jdd}~wwt|trt|S|S)NTinclude_universalallow_whitespaces .z..z .) descriptionreasonr')r _is_windowsrrGr NULL_NAME isinstancer_null_value_handlerr5substrr _fs_encodingr% _validatorvalidate RESERVED_NAME_reserved_name_handler reserved_namereescapeINVALID_CHARACTERlstriprstrip_validate_after_sanitizeINVALID_AFTER_SANITIZEr'r)r6r=r>esanitized_filenamereplacement_wordr:r:r;sanitizeDs`           zFileNameSanitizer.sanitizecCs|jddrtStS)NTr?)rHr#r")r6r:r:r;r4ws z&FileNameSanitizer._get_sanitize_regexp)r<)__name__ __module__ __qualname__rintrrMrrrboolr r3rr^rr4 __classcell__r:r:r8r;r$s<   $3r$cseZdZUdeddededdDeddeddDZee d <d Z ee d <e d ee d fffdd Z eeddddfdededee deededeee d dffdd Zded dfddZde d dfddZde d dfd d!Zde d dfd"d#ZZS)$r1)CONPRNAUXzCLOCK$NULccs$|] \}}|d|dVqdS)r dNr:).0namenumr:r:r; s"zFileNameValidator.)COMLPTr ccs$|] \}}|d|dVqdS)r Nr:)rjrkssdr:r:r;rms  )¹²³_WINDOWS_RESERVED_FILE_NAMES):_MACOS_RESERVED_FILE_NAMESr-.csrtj}|rt||j|j}n |rt||j}n|s'|r/t||j}nt|}t t |S)N) r2reserved_keywords _is_universalsetrurwrH _is_posix _is_macostuplesorted)r6common_keywordsword_setr8r:r;rxs z#FileNameValidator.reserved_keywordsNTr/r%r&r'r0r*cstj||||||ddS)Nr.)r2r3)r6r/r%r&r'r0r*r8r:r;r3s  zFileNameValidator.__init__r=c Cst||jdd dt|}t||j}||tjt j tj |j tj |jtj|tj|i}||jkrHtd|jdd|ddgfi|||jkr`td|jdd|ddgfi||||||jddrw||dSdS) NTr?rAz filename is too long: expected<=riz bytes, actual=z bytesz!filename is too short: expected>=)rrHrlenencoderNvalidate_abspathrREASONrINVALID_LENGTHPLATFORMr' FS_ENCODING BYTE_COUNTVALUEr%rr/_validate_reserved_keywords/_FileNameValidator__validate_universal_filename)_FileNameValidator__validate_win_filename)r6r=unicode_filenamebyte_ct err_kwargsr:r:r;rPs:      zFileNameValidator.validatecCsDtd|d|jtjd}|jddrt|r|t|r |dS)Nzfound an absolute path (z), expected a filename)rFr'rGTr?)rr'rFOUND_ABS_PATHrHr posixpathisabs)r6r=errr:r:r;rs   z"FileNameValidator.validate_abspathrcCs.t|}|rttjt|dtj|ddS)Ninvalidr'r=)r"findallrrformatr r UNIVERSAL)r6rmatchr:r:r;__validate_universal_filenames z/FileNameValidator.__validate_universal_filenamecCst|}|rttjt|dtj|d|dvrdSd}tj tjtj |i}|ddvrBttjt |ddfd|di||d d vr^ttjt |d dfd|d i|dS) NrrrDz{}. Refer: https://learn.microsoft.com/en-us/troubleshoot/windows-client/shell-experience/file-folder-name-whitespace-characters)rCrErFz`__ r'r/r%r&r0r*N)r1rPrr'r/r%r&r0r*r:r:r;validate_filenames< rcCs&t|||dur dn||||d|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)r1is_validrr:r:r;is_valid_filename[srr<Fr>r(r)r+c CsL|durtdt|durtj}t||durdn|||||| d||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$r^) rr>r'r%r&r0r(r)r*r+r:r:r;sanitize_filename}s$Pr)9__doc__rrrTrcollections.abcrpathlibrrrtypingrr_baser r r r _commonr rrrr_constrrr_typesrrerrorrrrrhandlerrrrrcompilerU_INVALID_FILENAME_CHARSUNICODEr"_INVALID_WIN_FILENAME_CHARSr#r$r1rbrMrcrrrr:r:r:r;s     _  H  $