B 0H[@sdZddlmZddlmZddlmZmZddlm Z dddd d d d d gZ Gddde Z Gddde Z Gddde ZGdd d e ZGdd d ZGdd d eZGdd d eZdd ZdS)zH Base file upload handler classes, and the built-in concrete subclasses )BytesIO)settings)InMemoryUploadedFileTemporaryUploadedFile) import_stringUploadFileException StopUploadSkipFileFileUploadHandlerTemporaryFileUploadHandlerMemoryFileUploadHandler load_handlerStopFutureHandlersc@seZdZdZdS)rz6 Any error having to do with uploading files. N)__name__ __module__ __qualname____doc__rrcC:\Users\HIRONO~1\AppData\Local\Temp\pip-install-6bm3nxem\django\django\core\files\uploadhandler.pyrsc@s"eZdZdZdddZddZdS) rz= This exception is raised when an upload must abort. FcCs ||_dS)z If ``connection_reset`` is ``True``, Django knows will halt the upload without consuming the rest of the upload. This will cause the browser to show a "connection reset" error. N)connection_reset)selfrrrr__init__szStopUpload.__init__cCs|jr dSdSdS)Nz StopUpload: Halt current upload.z,StopUpload: Consume request data, then halt.)r)rrrr__str__'szStopUpload.__str__N)F)rrrrrrrrrrrs c@seZdZdZdS)r zX This exception is raised by an upload handler that wants to skip a given file. N)rrrrrrrrr .sc@seZdZdZdS)rz Upload handers that have handled a file and do not want future handlers to run should raise this exception instead of returning None. N)rrrrrrrrr5sc@sJeZdZdZdZdddZdddZddd Zd d Zd d Z ddZ dS)r z3 Base class for streaming upload handlers. iNcCs(d|_d|_d|_d|_d|_||_dS)N) file_name content_typecontent_lengthcharsetcontent_type_extrarequest)rrrrrrCs zFileUploadHandler.__init__cCsdS)a Handle the raw input from the client. Parameters: :input_data: An object that supports reading via .read(). :META: ``request.META``. :content_length: The (integer) value of the Content-Length header from the client. :boundary: The boundary from the Content-Type header. Be sure to prepend two '--'. Nr)r input_dataMETArboundaryencodingrrrhandle_raw_inputKsz"FileUploadHandler.handle_raw_inputcCs(||_||_||_||_||_||_dS)z Signal that a new file has been started. Warning: As with any data from the client, you should not trust content_length (and sometimes won't even get it). N) field_namerrrrr)rr$rrrrrrrrnew_file]s zFileUploadHandler.new_filecCs tddS)z{ Receive data from the streamed upload parser. ``start`` is the position in the file of the chunk. zJsubclasses of FileUploadHandler must provide a receive_data_chunk() methodN)NotImplementedError)rraw_datastartrrrreceive_data_chunkksz$FileUploadHandler.receive_data_chunkcCs tddS)z Signal that a file has completed. File size corresponds to the actual size accumulated by all the chunks. Subclasses should return a valid ``UploadedFile`` object. zEsubclasses of FileUploadHandler must provide a file_complete() methodN)r&)r file_sizerrr file_completerszFileUploadHandler.file_completecCsdS)z Signal that the upload is complete. Subclasses should perform cleanup that is necessary for this handler. Nr)rrrrupload_complete{sz!FileUploadHandler.upload_complete)N)N)NN) rrrr chunk_sizerr#r%r)r+r,rrrrr =s    cs0eZdZdZfddZddZddZZS)r zA Upload handler that streams data into a temporary file. cs,tj||t|j|jd|j|j|_dS)zK Create the file object to append to as data is coming in. rN)superr%rrrrrfile)rargskwargs) __class__rrr%sz#TemporaryFileUploadHandler.new_filecCs|j|dS)N)r/write)rr'r(rrrr)sz-TemporaryFileUploadHandler.receive_data_chunkcCs|jd||j_|jS)Nr)r/seeksize)rr*rrrr+s z(TemporaryFileUploadHandler.file_complete)rrrrr%r)r+ __classcell__rr)r2rr s cs:eZdZdZd ddZfddZddZd d ZZS) r zS File upload handler to stream uploads into memory (used for small files). NcCs|tjkrd|_nd|_dS)zf Use the content_length to signal whether or not this handler should be used. FTN)rZFILE_UPLOAD_MAX_MEMORY_SIZE activated)rrr rr!r"rrrr#s z(MemoryFileUploadHandler.handle_raw_inputcs&tj|||jr"t|_tdS)N)r.r%r7rr/r)rr0r1)r2rrr%sz MemoryFileUploadHandler.new_filecCs|jr|j|n|SdS)z!Add the data to the BytesIO file.N)r7r/r3)rr'r(rrrr)sz*MemoryFileUploadHandler.receive_data_chunkc Cs8|js dS|jdt|j|j|j|j||j|jdS)z2Return a file object if this handler is activated.Nr)r/r$namerr5rr) r7r/r4rr$rrrr)rr*rrrr+s z%MemoryFileUploadHandler.file_complete)N) rrrrr#r%r)r+r6rr)r2rr s  cOst|||S)a= Given a path to a handler, return an instance of that handler. E.g.:: >>> from django.http import HttpRequest >>> request = HttpRequest() >>> load_handler('django.core.files.uploadhandler.TemporaryFileUploadHandler', request) )r)pathr0r1rrrr s N)riorZ django.confrZdjango.core.files.uploadedfilerrZdjango.utils.module_loadingr__all__ Exceptionrrr rr r r r rrrrs   F/