ó ø¢TQc@sGdZddlmZddlmZddlmZddlmZddl m Z m Z ddl m Z ddlmZd d d d d dddgZdefd„ƒYZedefd„ƒYƒZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZd„Zd S(!uH Base file upload handler classes, and the built-in concrete subclasses iÿÿÿÿ(tunicode_literals(tBytesIO(tsettings(tImproperlyConfigured(tTemporaryUploadedFiletInMemoryUploadedFile(t importlib(tpython_2_unicode_compatibleuUploadFileExceptionu StopUploaduSkipFileuFileUploadHandleruTemporaryFileUploadHandleruMemoryFileUploadHandleru load_handleruStopFutureHandlerstUploadFileExceptioncBseZdZRS(u6 Any error having to do with uploading files. (t__name__t __module__t__doc__(((s8../Django//lib/python/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 ((s8../Django//lib/python/django/core/files/uploadhandler.pyt__init__scCs|jr dSdSdS(Nu StopUpload: Halt current upload.u,StopUpload: Consume request data, then halt.(R (R((s8../Django//lib/python/django/core/files/uploadhandler.pyt__str__&s (R R R tFalseRR(((s8../Django//lib/python/django/core/files/uploadhandler.pyR s tSkipFilecBseZdZRS(uX This exception is raised by an upload handler that wants to skip a given file. (R R R (((s8../Django//lib/python/django/core/files/uploadhandler.pyR,stStopFutureHandlerscBseZdZRS(u“ Upload handers that have handled a file and do not want future handlers to run should raise this exception instead of returning None. (R R R (((s8../Django//lib/python/django/core/files/uploadhandler.pyR2stFileUploadHandlercBsWeZdZdd Zd d„Zd d„Zd d„Zd„Zd„Z d „Z RS( u3 Base class for streaming upload handlers. i@ii cCs1d|_d|_d|_d|_||_dS(N(tNonet file_namet content_typetcontent_lengthtcharsettrequest(RR((s8../Django//lib/python/django/core/files/uploadhandler.pyR?s     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((Rt input_datatMETARtboundarytencoding((s8../Django//lib/python/django/core/files/uploadhandler.pythandle_raw_inputFscCs1||_||_||_||_||_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_nameRRRR(RR RRRR((s8../Django//lib/python/django/core/files/uploadhandler.pytnew_fileXs     cCs tƒ‚dS(u{ Receive data from the streamed upload parser. ``start`` is the position in the file of the chunk. N(tNotImplementedError(Rtraw_datatstart((s8../Django//lib/python/django/core/files/uploadhandler.pytreceive_data_chunkescCs tƒ‚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. N(R"(Rt file_size((s8../Django//lib/python/django/core/files/uploadhandler.pyt file_completelscCsdS(uƒ Signal that the upload is complete. Subclasses should perform cleanup that is necessary for this handler. N((R((s8../Django//lib/python/django/core/files/uploadhandler.pytupload_completeusiN( R R R t chunk_sizeRRRR!R%R'R((((s8../Django//lib/python/django/core/files/uploadhandler.pyR9s     tTemporaryFileUploadHandlercBs2eZdZd„Zd„Zd„Zd„ZRS(uA Upload handler that streams data into a temporary file. cOstt|ƒj||ŽdS(N(tsuperR*R(Rtargstkwargs((s8../Django//lib/python/django/core/files/uploadhandler.pyR€scOsAtt|ƒj|||Žt|j|jd|jƒ|_dS(uK Create the file object to append to as data is coming in. iN(R+R*R!RRRRtfile(RRR,R-((s8../Django//lib/python/django/core/files/uploadhandler.pyR!ƒscCs|jj|ƒdS(N(R.twrite(RR#R$((s8../Django//lib/python/django/core/files/uploadhandler.pyR%ŠscCs#|jjdƒ||j_|jS(Ni(R.tseektsize(RR&((s8../Django//lib/python/django/core/files/uploadhandler.pyR's (R R R RR!R%R'(((s8../Django//lib/python/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(RRRRRR((s8../Django//lib/python/django/core/files/uploadhandler.pyR—s cOs>tt|ƒj||Ž|jr:tƒ|_tƒ‚ndS(N(R+R2R!R4RR.R(RR,R-((s8../Django//lib/python/django/core/files/uploadhandler.pyR!¢s  cCs$|jr|jj|ƒn|SdS(u3 Add the data to the BytesIO file. N(R4R.R/(RR#R$((s8../Django//lib/python/django/core/files/uploadhandler.pyR%¨s c CsW|js dS|jjdƒtd|jd|jd|jd|jd|d|jƒS( u: Return a file object if we're activated. NiR.R tnameRR1R(R4R.R0RR RRR(RR&((s8../Django//lib/python/django/core/files/uploadhandler.pyR'±s     N(R R R RRR!R%R'(((s8../Django//lib/python/django/core/files/uploadhandler.pyR2’s   c OsÍ|jdƒ}|| ||d}}ytj|ƒ}WnEtk rf}td||fƒ‚ntk r‚tdƒ‚nXyt||ƒ}Wn'tk r¿td||fƒ‚nX|||ŽS(uê Given a path to a handler, return an instance of that handler. E.g.:: >>> load_handler('django.core.files.uploadhandler.TemporaryFileUploadHandler', request) u.iu.Error importing upload handler module %s: "%s"u`Error importing upload handler module.Is FILE_UPLOAD_HANDLERS a correctly defined list or tuple?u9Module "%s" does not define a "%s" upload handler backend(trfindRt import_modulet ImportErrorRt ValueErrortgetattrtAttributeError( tpathR,R-titmoduletattrtmodtetcls((s8../Django//lib/python/django/core/files/uploadhandler.pyt load_handlerÃs   N(R t __future__RtioRt django.confRtdjango.core.exceptionsRtdjango.core.files.uploadedfileRRt django.utilsRtdjango.utils.encodingRt__all__t ExceptionRR RRtobjectRR*R2RD(((s8../Django//lib/python/django/core/files/uploadhandler.pyts&  C1