OwlCyberSecurity - MANAGER
Edit File: base.cpython-39.pyc
a ���e � @ s^ d dl Z d dlZd dlmZ d dlmZ d dlmZ d dlm Z d dl m Z G dd� d�Z dS ) � N)�SuspiciousFileOperation)�File)�validate_file_name��get_random_string��get_valid_filenamec @ s� e Zd ZdZd"dd�Zd#dd�Zdd � Zd d � Zd$d d �Zdd� Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zd d � Zd d � Zd d!� ZdS )%�Storagez� A base storage class, providing some default behaviors that all other storage systems can inherit or override, as necessary. �rbc C s | � ||�S )z)Retrieve the specified file from storage.)�_open)�self�name�mode� r �_/home/gouroczh/virtualenv/pat/3.9/lib/python3.9/site-packages/django/core/files/storage/base.py�open s z Storage.openNc C sL |du r|j }t|d�s"t||�}| j||d�}| �||�}t|dd� |S )z� Save new content to the file specified by name. The content should be a proper File object or any Python file-like object, ready to be read from the beginning. N�chunks)� max_lengthT)Zallow_relative_path)r �hasattrr �get_available_nameZ_saver )r r �contentr r r r �save s z Storage.savec C s t |�S )z� Return a filename, based on the provided filename, that's suitable for use in the target storage system. r �r r r r r �get_valid_name- s zStorage.get_valid_namec C s d|t d�|f S )z� Return an alternative filename, by adding an underscore and a random 7 character alphanumeric string (before the file extension, if one exists) to the filename. z%s_%s%s� r )r � file_root�file_extr r r �get_alternative_name4 s z Storage.get_alternative_namec C s� t |��dd�}tj�|�\}}dt�|�jv r<td| ��t |� tj� |�\}}| � |�sn|r�t |�|kr�tj� || �||��}|du r�qTt |�| }|dkrT|d| � }|s�td| ��tj� || �||��}qT|S )z� Return a filename that's free on the target storage system and available for new content to be written to. �\�/�..�'Detected path traversal attempt in '%s'Nr z�Storage can not find an available filename for "%s". Please make sure that the corresponding file field allows sufficient "max_length".)�str�replace�os�path�split�pathlib�PurePath�partsr r �splitext�exists�len�joinr )r r r �dir_name� file_namer r Z truncationr r r r < s6 � � �� �zStorage.get_available_namec C sX t |��dd�}tj�|�\}}dt�|�jv r<td| ��tj� tj� || � |���S )z� Validate the filename by calling get_valid_name() and return a filename to be passed to the save() method. r r r r! ) r" r# r$ r% r& r' r( r) r �normpathr- r )r �filename�dirnamer r r �generate_filenamee s �zStorage.generate_filenamec C s t d��dS )z� Return a local filesystem path where the file can be retrieved using Python's built-in open() function. Storage systems that can't be accessed using open() should *not* implement this method. z,This backend doesn't support absolute paths.N��NotImplementedErrorr r r r r% s s z Storage.pathc C s t d��dS )zD Delete the specified file from the storage system. z4subclasses of Storage must provide a delete() methodNr4 r r r r �delete~ s �zStorage.deletec C s t d��dS )z� Return True if a file referenced by the given name already exists in the storage system, or False if the name is available for a new file. z5subclasses of Storage must provide an exists() methodNr4 r r r r r+ � s �zStorage.existsc C s t d��dS )z� List the contents of the specified path. Return a 2-tuple of lists: the first item being directories, the second item being files. z5subclasses of Storage must provide a listdir() methodNr4 )r r% r r r �listdir� s �zStorage.listdirc C s t d��dS )zQ Return the total size, in bytes, of the file specified by name. z2subclasses of Storage must provide a size() methodNr4 r r r r �size� s z Storage.sizec C s t d��dS )zu Return an absolute URL where the file's contents can be accessed directly by a web browser. z1subclasses of Storage must provide a url() methodNr4 r r r r �url� s z Storage.urlc C s t d��dS )z� Return the last accessed time (as a datetime) of the file specified by name. The datetime will be timezone-aware if USE_TZ=True. z?subclasses of Storage must provide a get_accessed_time() methodNr4 r r r r �get_accessed_time� s �zStorage.get_accessed_timec C s t d��dS )z� Return the creation time (as a datetime) of the file specified by name. The datetime will be timezone-aware if USE_TZ=True. z>subclasses of Storage must provide a get_created_time() methodNr4 r r r r �get_created_time� s �zStorage.get_created_timec C s t d��dS )z� Return the last modified time (as a datetime) of the file specified by name. The datetime will be timezone-aware if USE_TZ=True. z?subclasses of Storage must provide a get_modified_time() methodNr4 r r r r �get_modified_time� s �zStorage.get_modified_time)r )N)N)�__name__� __module__� __qualname__�__doc__r r r r r r3 r% r6 r+ r7 r8 r9 r: r; r< r r r r r s ) r ) r$ r' Zdjango.core.exceptionsr Zdjango.core.filesr Zdjango.core.files.utilsr Zdjango.utils.cryptor Zdjango.utils.textr r r r r r �<module> s