ó ®â0_c@s7dZddlmZddlmZddlmZddlmZm Z ddl m Z ddl m Z dd d d d d ddgZdefd„ƒYZe defd„ƒYƒZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZd„ZdS( uH Base file upload handler classes, and the built-in concrete subclasses iÿÿÿÿ(tunicode_literals(tBytesIO(tsettings(tInMemoryUploadedFiletTemporaryUploadedFile(tpython_2_unicode_compatible(t import_stringuUploadFileExceptionu StopUploaduSkipFileuFileUploadHandleruTemporaryFileUploadHandleruMemoryFileUploadHandleru load_handleruStopFutureHandlerstUploadFileExceptioncBseZdZRS(u6 Any error having to do with uploading files. (t__name__t __module__t__doc__(((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyRst StopUploadcBs#eZdZed„Zd„ZRS(u= This exception is raised when an upload must abort. cCs ||_dS(uÒ 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(tconnection_reset(tselfR ((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyt__init__#scCs|jr dSdSdS(Nu StopUpload: Halt current upload.u,StopUpload: Consume request data, then halt.(R (R ((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyt__str__+s (RR R tFalseRR(((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyR s tSkipFilecBseZdZRS(uX This exception is raised by an upload handler that wants to skip a given file. (RR R (((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyR2stStopFutureHandlerscBseZdZRS(u“ Upload handers that have handled a file and do not want future handlers to run should raise this exception instead of returning None. (RR R (((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyR9stFileUploadHandlercBsZeZdZdd Zd d„Zd d„Zd d d„Zd„Zd„Z d „Z RS( u3 Base class for streaming upload handlers. i@ii cCs:d|_d|_d|_d|_d|_||_dS(N(tNonet file_namet content_typetcontent_lengthtcharsettcontent_type_extratrequest(R R((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyRGs      cCsdS(uÆ 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 '--'. N((R t input_datatMETARtboundarytencoding((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pythandle_raw_inputOscCs:||_||_||_||_||_||_dS(u½ 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(t field_nameRRRRR(R R RRRRR((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pytnew_fileas      cCstdƒ‚dS(u{ Receive data from the streamed upload parser. ``start`` is the position in the file of the chunk. uJsubclasses of FileUploadHandler must provide a receive_data_chunk() methodN(tNotImplementedError(R traw_datatstart((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pytreceive_data_chunkoscCstdƒ‚dS(uÆ 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. uEsubclasses of FileUploadHandler must provide a file_complete() methodN(R"(R t file_size((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyt file_completevscCsdS(uƒ Signal that the upload is complete. Subclasses should perform cleanup that is necessary for this handler. N((R ((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pytupload_completesiN( RR R t chunk_sizeRRRR!R%R'R((((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyRAs     tTemporaryFileUploadHandlercBs2eZdZd„Zd„Zd„Zd„ZRS(uA Upload handler that streams data into a temporary file. cOstt|ƒj||ŽdS(N(tsuperR*R(R targstkwargs((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyR‹scOsDtt|ƒj||Žt|j|jd|j|jƒ|_dS(uK Create the file object to append to as data is coming in. iN( R+R*R!RRRRRtfile(R R,R-((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyR!ŽscCs|jj|ƒdS(N(R.twrite(R R#R$((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyR%•scCs#|jjdƒ||j_|jS(Ni(R.tseektsize(R R&((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyR'˜s (RR R RR!R%R'(((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyR*‡s    tMemoryFileUploadHandlercBs5eZdZdd„Zd„Zd„Zd„ZRS(uS File upload handler to stream uploads into memory (used for small files). cCs(|tjkrt|_n t|_dS(u` Use the content_length to signal whether or not this handler should be in use. N(RtFILE_UPLOAD_MAX_MEMORY_SIZERt activatedtTrue(R RRRRR((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyR£s cOs>tt|ƒj||Ž|jr:tƒ|_tƒ‚ndS(N(R+R2R!R4RR.R(R R,R-((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyR!®s  cCs$|jr|jj|ƒn|SdS(u3 Add the data to the BytesIO file. N(R4R.R/(R R#R$((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyR%´s cCs`|js dS|jjdƒtd|jd|jd|jd|jd|d|jd |jƒS( u: Return a file object if we're activated. NiR.R tnameRR1RR( R4R.R0RR RRRR(R R&((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyR'½s      N(RR R RRR!R%R'(((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyR2žs   cOst|ƒ||ŽS(u= 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(tpathR,R-((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyt load_handlerÐs N(R t __future__RtioRt django.confRtdjango.core.files.uploadedfileRRtdjango.utils.encodingRtdjango.utils.module_loadingRt__all__t ExceptionRR RRtobjectRR*R2R8(((sA/tmp/pip-unpacked-wheel-BAJOf3/django/core/files/uploadhandler.pyts$   F2