File: //usr/lib/python3/dist-packages/django/core/files/__pycache__/storage.cpython-310.pyc
o
/ �hB> � @ s" d dl Z d dlZd dlmZ d dlmZ d dlmZ d dlmZ d dl m
Z
m Z d dl m
Z
d dlmZ d d lmZ d d
lmZ d d lmZ d d lmZ d d
lmZ d dlmZ d dl m Z m Z d dl m Z d dl!m"Z" dZ#G dd� d�Z$eG dd� de$��Z%ddd�Z&G dd� de �Z'e'� Z(dS ) � N)�datetime)�urljoin)�settings)�SuspiciousFileOperation)�File�locks)�file_move_safe)�validate_file_name)�setting_changed)�timezone)� safe_join��get_random_string)�deconstructible)�filepath_to_uri)�
LazyObject�cached_property)�
import_string��get_valid_filename)�Storage�FileSystemStorage�DefaultStorage�default_storage�get_storage_classc @ 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 )$r z�
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! �;/usr/lib/python3/dist-packages/django/core/files/storage.py�open$ s z Storage.openNc C sd |du r|j }t|d�st||�}t|dd� | j||d�}t|dd� | �||�}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�chunksT)�allow_relative_path)�
max_length)r �hasattrr r �get_available_name�_save)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_nameH � 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_nameO s z Storage.get_alternative_namec C s� t |��dd�}tj�|�\}}dt�|�jv r td| ��t |� tj�
|�\}}| � |�s7|rxt |�|krxtj�
|| �||��}|du rGq*t |�| }|dkrk|d| � }|s`td| ��tj�
|| �||��}| � |�s7|rxt |�|ks7|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�joinr2 )r r r& �dir_name� file_namer0 r1 �
truncationr! r! r" r( W s, ���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.
r3 r4 r5 r6 ) r7 r8 r9 r: r; r< r= r> r �normpathrB r- )r �filename�dirnamer! r! r" �generate_filenamey s
zStorage.generate_filenamec C � t d��)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.��NotImplementedErrorr, r! r! r" r: � s z Storage.pathc C rJ )zD
Delete the specified file from the storage system.
z4subclasses of Storage must provide a delete() methodrK r, r! r! r" �delete� � zStorage.deletec C rJ )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() methodrK r, r! r! r" r@ � r. zStorage.existsc C rJ )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() methodrK )r r: r! r! r" �listdir� r. zStorage.listdirc C rJ )zQ
Return the total size, in bytes, of the file specified by name.
z2subclasses of Storage must provide a size() methodrK r, r! r! r" �size� rN z Storage.sizec C rJ )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() methodrK r, r! r! r" �url� r. z Storage.urlc C rJ )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() methodrK r, r! r! r" �get_accessed_time� r. zStorage.get_accessed_timec C rJ )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() methodrK r, r! r! r" �get_created_time� r. zStorage.get_created_timec C rJ )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() methodrK r, r! r! r" �get_modified_time� r. zStorage.get_modified_time�r �N)�__name__�
__module__� __qualname__�__doc__r# r+ r- r2 r( rI r: rM r@ rO rP rQ rR rS rT r! r! r! r" r s"
" r c @ s� e Zd ZdZejejB ejB eedd�B Z d.dd�Z
dd� Z d d
� Z e
d d � �Ze
d
d� �Ze
dd� �Ze
dd� �Ze
dd� �Zd/dd�Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Z d*d+� Z d,d-� Z dS )0r z%
Standard filesystem storage
�O_BINARYr Nc C s( || _ || _|| _|| _t�| j� d S rV )� _location� _base_url�_file_permissions_mode�_directory_permissions_moder
�connect�_clear_cached_properties)r �location�base_url�file_permissions_mode�directory_permissions_moder! r! r" �__init__� s
zFileSystemStorage.__init__c K sz |dkr| j �dd� | j �dd� dS |dkr!| j �dd� dS |dkr.| j �dd� dS |d kr;| j �d
d� dS dS ) z$Reset setting based property values.�
MEDIA_ROOT�
base_locationNrb � MEDIA_URLrc �FILE_UPLOAD_PERMISSIONSrd �!FILE_UPLOAD_DIRECTORY_PERMISSIONSre )�__dict__�pop)r �setting�kwargsr! r! r" ra � s �z*FileSystemStorage._clear_cached_propertiesc C s |d u r|S |S rV r! )r �valuern r! r! r" �_value_or_setting� s z#FileSystemStorage._value_or_settingc C � | � | jtj�S rV )rq r\ r rg �r r! r! r" rh � � z FileSystemStorage.base_locationc C s t j�| j�S rV )r9 r: �abspathrh rs r! r! r" rb � s zFileSystemStorage.locationc C s4 | j d ur| j �d�s| j d7 _ | �| j tj�S )Nr4 )r] �endswithrq r ri rs r! r! r" rc � s zFileSystemStorage.base_urlc C rr rV )rq r^ r rj rs r! r! r" rd � rt z'FileSystemStorage.file_permissions_modec C rr rV )rq r_ r rk rs r! r! r" re � rt z,FileSystemStorage.directory_permissions_moder c C s t t| �|�|��S rV )r r# r: r r! r! r" r � s zFileSystemStorage._openc
C s� | � |�}tj �|�}z.| jd ur1t�d| j @ �}ztj|| jdd� W t�|� n
t�|� w tj|dd� W n
tyF td| ��w zit|d�rVt|� � |� nZt�
|| j d�}d }z;t �
|t j� |�� D ]}|d u r�t|t�rydnd} t�|| �}|�|� qlW t �|� |d ur�|�� nt�|� nt �|� |d ur�|�� w t�|� w W n ty� | �|�}| � |�}Y nw nqH| jd ur�t�|| j� tj �|| j�}t|�� d d
�S ) Ni� T)�exist_okz!%s exists and is not a directory.�temporary_file_pathi� �wb�wtr3 r4 ) r: r9 rH re �umask�makedirs�FileExistsErrorr' r rx r# �
OS_OPEN_FLAGSr �lock�LOCK_EXr$ �
isinstance�bytes�fdopen�write�unlock�closer( rd �chmod�relpathrb r7 r8 )
r r r* � full_path� directory� old_umask�fd�_file�chunkr r! r! r" r) s\
� �
�
�
�
��
zFileSystemStorage._savec C sX |sJ d��| � |�}ztj �|�rt�|� W d S t�|� W d S ty+ Y d S w )Nz-The name argument is not allowed to be empty.)r: r9 �isdir�rmdir�remove�FileNotFoundErrorr, r! r! r" rM A s
�zFileSystemStorage.deletec C � t j�| �|��S rV )r9 r: r@ r, r! r! r" r@ O � zFileSystemStorage.existsc C sN | � |�}g g }}t�|�D ]}|�� r |�|j� q|�|j� q||fS rV )r: r9 �scandir�is_dir�appendr )r r: � directories�files�entryr! r! r" rO R s
zFileSystemStorage.listdirc C s t | j|�S rV )r rb r, r! r! r" r: \ s zFileSystemStorage.pathc C r� rV )r9 r: �getsizer, r! r! r" rP _ r� zFileSystemStorage.sizec C s8 | j d u r td��t|�}|d ur|�d�}t| j |�S )Nz&This file is not accessible via a URL.r4 )rc �
ValueErrorr �lstripr )r r rQ r! r! r" rQ b s
zFileSystemStorage.urlc C s$ t jr
t�|�jtjd�S t�|�S )z�
If timezone support is enabled, make an aware datetime object in UTC;
otherwise make a naive one in the local timezone.
)�tzinfo)r �USE_TZr �utcfromtimestampr8 r �utc�
fromtimestamp)r �tsr! r! r" �_datetime_from_timestampj s
z*FileSystemStorage._datetime_from_timestampc C � | � tj�| �|���S rV )r� r9 r: �getatimer, r! r! r" rR u � z#FileSystemStorage.get_accessed_timec C r� rV )r� r9 r: �getctimer, r! r! r" rS x r� z"FileSystemStorage.get_created_timec C r� rV )r� r9 r: �getmtimer, r! r! r" rT { r� z#FileSystemStorage.get_modified_time)NNNNrU ) rW rX rY rZ r9 �O_WRONLY�O_CREAT�O_EXCL�getattrr~ rf ra rq r rh rb rc rd re r r) rM r@ rO r: rP rQ r� rR rS rT r! r! r! r" r � s<
�
A
r c C s t | ptj�S rV )r r �DEFAULT_FILE_STORAGE)� import_pathr! r! r" r � r c @ s e Zd Zdd� ZdS )r c C s t � � | _d S rV )r �_wrappedrs r! r! r" �_setup� r� zDefaultStorage._setupN)rW rX rY r� r! r! r! r" r � s r rV ))r9 r< r � urllib.parser � django.confr �django.core.exceptionsr �django.core.filesr r �django.core.files.mover �django.core.files.utilsr �django.core.signalsr
� django.utilsr �django.utils._osr �django.utils.cryptor �django.utils.deconstructr �django.utils.encodingr �django.utils.functionalr r �django.utils.module_loadingr �django.utils.textr �__all__r r r r r r! r! r! r" �<module> s6 -
8