o iI@svUdZddlZddlZddlZddlZddlZddlmZddl m Z m Z ddlm Z ddl mZmZddlmZmZmZmZdd lmZmZmZmZdd lmZmZmZmZdd lm Z m!Z!dd l"m#Z#m$Z$dd l%m&Z&m'Z'm(Z(m)Z)m*Z*ddl+m,Z,m-Z-e.de/ej0ddej1Z2ee3d<e.de/ej4ddej1Z5ee3d<GdddeZ6GdddeZ7deddddfde#dee$de8dee8dee9de:deee9d dfd!d"Z;deddddfde#dee$de8dee8dee9de:deee9d e:fd#d$Z< %         &d.de#d'e9dee$dee8dee9dee:d(ee-d)ee-deee9d*e:d+e:d e#fd,d-Z=dS)/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]_RE_INVALID_PATH_RE_INVALID_WIN_PATHcseZdZ         ddedeedeedeed eed eeed e d e d ee ddffdd Z dde dede fddZ deefddZdefddZZS)FilePathSanitizerNTFmax_len fs_encodingplatformnull_value_handlerreserved_name_handleradditional_reserved_names normalizevalidate_after_sanitize validatorreturnc s| r| } n tt||d||d} tj||| |||||d||_t|j|||||j|d|_ ||_ |j ddr?t j |_dStj |_dS)NTmin_lenr'r(check_reservedr,r))r'r(r/r*r+r,r)r.)r'r(r*r+r,r)r.include_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-r.r/fpath_validator __class__\/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/pathvalidate/_filepath.pyr8sD     zFilePathSanitizer.__init__valuereplacement_textc Csz t||jdd dWn$ty1}z|jtjkr,t|tr!||WYd}~Sd}~wwt |}| |\}}|j ||}|j rO|rOtj|}|}g}|rZ|||dddD](}|tvrr||dqct|jj||d} | s|s|dqc|| qc||}z|j|Wnty}z|jtjkr||}WYd}~nd}~ww|jr|j|t|trt|S|S) NTr4allow_whitespaces\/_)rJrH)rr=rreasonr NULL_NAME isinstancer_null_value_handlerrr@r:subr<ospathnormpathappendreplacesplitrstrr;sanitize&_FilePathSanitizer__get_path_separatorjoin _validatorvalidate_validate_after_sanitizer) rBrIrJeunicode_filepathdrivesanitized_pathsanitized_entriesentrysanitized_entryrFrFrGr\RsX           zFilePathSanitizer.sanitizecCs|jddrtStS)NTr4)r=r$r#rBrFrFrGr9s z&FilePathSanitizer._get_sanitize_regexpcCs|rdSdS)NrMrN)r=rirFrFrG__get_path_separatorsz&FilePathSanitizer.__get_path_separator) r&NNNNNTFN)rH)__name__ __module__ __qualname__intrr[rrrboolr r8rr\rr9r] __classcell__rFrFrDrGr%sD    33r%cseZdZUedddeDejZe e d<dZ e e d<e de edfffd d Zed d d d d fdededeedeededeeedd ffdd Zdedd fddZdedd fddZdedd fddZdedd fddZZS) r6|ccs"|] }dt|dVqdS)z^/$N)reescape).0patternrFrFrG s zFilePathValidator._RE_NTFS_RESERVED)rN:_MACOS_RESERVED_FILE_PATHSr0.cs@tj}t|||gr||jS|r|dS|S)N)rN)r7reserved_keywordsany _is_universal _is_posix _is_macosrz _is_linux)rBcommon_keywordsrDrFrGr{s  z#FilePathValidator.reserved_keywordsr&NTr2r'r(r)r3r,csTtj||||||dt||j||||d|_|jddr$tj|_dSt j|_dS)Nr1Tr4) r7r8rr'#_FilePathValidator__fname_validatorr=r>r?_FilePathValidator__split_driverA)rBr2r'r(r)r3r,rDrFrGr8s&    zFilePathValidator.__init__rIc Cs4t||jdd d||||\}}|sdSt|}t||j}tj t j tj |j tj|jtj|tj|i}||jkrStd|jdd|ddgfi|||jkrftd|j|gfi||||d d }|d D]}|r~|d vrqv|j|qv|jddr||dS||dS) NTr4rKz!file path is too long: expected<=dz bytes, actual=z bytesz?file path is too short: expected>={:d} bytes, actual={:d} bytesrMrN).z..)rr=validate_abspathrrlenencode _fs_encodingrREASONrINVALID_LENGTHPLATFORMr) FS_ENCODING BYTE_COUNTVALUEr'rr2format_validate_reserved_keywordsrYrZrr`)_FilePathValidator__validate_win_filepath*_FilePathValidator__validate_unix_filepath)rBrI_drivetailrcbyte_ct err_kwargsrgrFrFrGr`sL      zFilePathValidator.validatecCst|}tt|}t|o||o|grdS|r.t||gr.td|j t j dtd|d|j j ddd|j t j d}|jd d rN|rN||s_t |\}}|ra|rc|dSdSdS) Nz8platform-independent absolute file path is not supported)r)rPzan 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)rPTr4)rAisabsrrr|r=r~r}rr)rMALFORMED_ABS_PATHrIr>r?)rBrI is_posix_abs is_nt_abs err_objectrd_tailrFrFrGrs6   z"FilePathValidator.validate_abspathrccCs*t|}|rttjt|d|ddS)Ninvalid)rI)r#findallrrrr )rBrcmatchrFrFrG__validate_unix_filepaths z*FilePathValidator.__validate_unix_filepathcCsvt|}|rttjt|dtj|d||\}}|r7|j |}|r9| }t d|dd||j ddSdS)Nr)r)rI'z' is a reserved nameF) reusable_name reserved_namer))r$rrrrr rWINDOWSrrxsearchgrouprr))rBrcrrrImatch_reservedrrFrFrG__validate_win_filepaths(   z)FilePathValidator.__validate_win_filepath)rkrlrmrscompiler^r IGNORECASErxr__annotations__rzpropertytupler[r{rrnrrrorr8rr`rrrrprFrFrDrGr6sB     0 r6T file_pathr)r2r'r(r3r,r0cCs*t|||dur dn||||d|dS)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)r2r'r(r3r,)r6r`rr)r2r'r(r3r,rFrFrGvalidate_filepath3s9 rcCs&t|||dur dn||||d|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)r6is_validrrFrFrGis_valid_filepathvsrrHFrJr*r+r-r.c CsN|durtdt|durtj}t||durdn||| |||| d||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,r.)warningswarnDeprecationWarningras_isr%r\) rrJr)r'r(r3r*r+r,r-r.rFrFrGsanitize_filepaths&Z r) rHNNNNNNNTF)>__doc__r>os.pathrUrArsrcollections.abcrpathlibrrrtypingrr_baser r r r _commonr rrr_constrrrr _filenamerr_typesrrerrorrrrrrhandlerrrrrt_INVALID_PATH_CHARSUNICODEr#r_INVALID_WIN_PATH_CHARSr$r%r6rnr[rorrrrFrFrFrGs  ( t$  E  $