N&iBdZddlmZdZddlZddlZddlZddlZddlZddl m Z ddl m Z m Z mZejdkreZGdd eZGd d eZd ZGd de ZGdde ZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGdd eZdS)!z I/O classes provide a uniform API for low-level input and output. Subclasses exist for a variety of input/output mechanisms. )print_functionreStructuredTextN) TransformSpec)locale_encoding ErrorString ErrorOutputrceZdZdS) InputErrorN__name__ __module__ __qualname__X/home/geonatureadmin/si_en_reseau/tutos/venv/lib/python3.11/site-packages/docutils/io.pyr r rr ceZdZdS) OutputErrorNr rrrrrrrrc tj|jtj|kS#ttt f$rYdSwxYw)aNTest, whether the encoding of `stream` matches `encoding`. Returns :None: if `encoding` or `stream.encoding` are not a valid encoding argument (e.g. ``None``) or `stream.encoding is missing. :True: if the encoding argument resolves to the same value as `encoding`, :False: if the encodings differ. N)codecslookupencoding LookupErrorAttributeError TypeError)streamrs rcheck_encodingrsQ}V_--x1H1HHH  3tts.1A  A ceZdZdZdZdZ ddZdZdZdZ e j d Z e jd fe jd fe jd ffZ d ZdS)Inputz1 Abstract base class for input wrappers. inputNstrictcp||_ ||_ ||_ ||_ |s |j|_d|_dSN)r error_handlersource source_pathdefault_source_pathsuccessful_encoding)selfr'r(rr&s r__init__zInput.__init__6sM  1** '&- 8#7D #' EErc4|jd|jd|jS)Nz : source=z, source_path=) __class__r'r(r+s r__repr__zInput.__repr__Js(26...$+++262B2BD Drctr%NotImplementedErrorr/s rreadz Input.readNs!!rc|jr<|jdkrt|ts Jdt|tr|S|jr |jg}nA||}|r|g}n&ddg}t r|dt |D]W} t|||j}||_| ddcS#ttf$r }|}Yd}~Pd}~wwxYwtd d d |Dd t|d )a Decode a string, `data`, heuristically. Raise UnicodeError if unsuccessful. The client application should call ``locale.setlocale`` at the beginning of processing:: locale.setlocale(locale.LC_ALL, '') unicodez=input encoding is "unicode" but input is not a unicode objectutf-8zlatin-1uNz=Unable to decode input data. Tried the following encodings: z, c,g|]}t|Sr)repr).0encs r z Input.decode..~s%E%E%ECd3ii%E%E%Er. ())rlower isinstancer6determine_encoding_from_datarinsertr&r*replace UnicodeErrorrjoinr)r+data encodings data_encodingr=decodederrerrors rdecodez Input.decodeQs = 5T]0022i??dG,, 5 54 5 5 5 dG $ $ K = 9II ==dCCM 9+O %i0 "9$$Q888  C !$T-?@@+.(y#66666 +.    l99%E%E9%E%E%EFFFF$U++++ -.. .s12C&&D7C>>Dscoding[:=]\s*([-\w.]+)r7z utf-16-bez utf-16-lec|jD]\}}||r|cS|ddD]H}|j|}|r*|ddcSIdS)z Try to determine the encoding of `data` by looking *in* `data`. Check for a byte order mark (BOM) or an encoding declaration. Nr8ascii)byte_order_marks startswith splitlines coding_slugsearchgrouprN)r+rH start_bytesrlinematchs rrCz"Input.determine_encoding_from_datas &*%:  !K{++  OO%%bqb) 6 6D$++D11E 6{{1~~,,W55555 6trNNNr#)rrr__doc__component_typer)r,r0r4rNrecompilerUrBOM_UTF8 BOM_UTF16_BE BOM_UTF16_LErRrCrrrr!r!,sN?C'FFFF(DDD"""......`"*788K''2,k:,k:=-rr!c8eZdZdZdZdZ d dZdZdZdZ dS) Outputz2 Abstract base class for output wrappers. outputNr#cj||_ |pd|_ ||_ ||_ |s|j|_dSdS)Nr#)rr& destinationdestination_pathdefault_destination_path)r+rgrhrr&s rr,zOutput.__init__sX  7*6h*&. 02 B$($AD ! ! ! B Brc4|jd|jd|jS)Nz: destination=z, destination_path=)r.rgrhr/s rr0zOutput.__repr__s*>>>4#3#3#3T5J5JL Mrct)z;`data` is a Unicode string, to be encoded by `self.encode`.r2r+rHs rwritez Output.writes!!rc|jr>|jdkr!t|ts Jd|St|ts|S||j|jS)Nr6zFthe encoding given is "unicode" but the output is not a Unicode string)rrArBr6encoder&rls rroz Output.encodes = T]0022i??dG,, $ $# $ $ $K$(( BK;;t}d.@AA Arr[) rrrr\r]rir,r0rmrorrrrdrds~N#:>.6BBBB"MMM""" B B B B BrrdcReZdZdZdddddejdkrdndfdZd Zd Zd Z dS) FileInputz5 Input for single, simple file-like objects. Nr#Tr rrUcZt|||||||_t|_|x|rdt jdkr|j|jd}ni} t||fi||_ n#t$r }t|j |j|d}~wwxYwt j|_ nQt jdkrAt!|j |jdur%t#d|jd|j jd|s% |j j|_dS#t($rYdSwxYwdS)a :Parameters: - `source`: either a file-like object (which is read directly), or `None` (which implies `sys.stdin` if no `source_path` given). - `source_path`: a path to a file, which is opened and then read. - `encoding`: the expected text encoding of the input file. - `error_handler`: the encoding error handler to use. - `autoclose`: close automatically after read (except when `sys.stdin` is the source). - `mode`: how the file is to be opened (see standard function `open`). The default 'rU' provides universal newline support for text files with Python 2.x. Nr rerrorsFz#Encoding clash: encoding given is "z&" but source is opened with encoding "z".)r!r, autocloser_stderrsys version_inforr&openr'IOErrorr errnostrerrorstdinrrFnamer(r) r+r'r(rr&rwmodekwargsrMs rr,zFileInput.__init__sz" tV[(MJJJ""}} > (#v--*.-(,(:<BBD D('D(c |jtjurYtjdkrI|jj}d|dz}n|j}n#ttf$r}|j so|j rht|j d}|}| d|dz}nYd}~nd}~wwxYw|jr| n!#|jr| wwxYw||S)zU Read and decode a single file and return the data (Unicode string). r  rbN)r'ryrrzbufferr4rGrTrFrrr(r{closerwrN)r+rHrLb_sources rr4zFileInput.readsX {ci''C,<,F,F{)..00zz$//"3"344u<{''))k*   = T%5  0$77}}   zz$//"3"344u< ~  ~   {{4   s1BBD9DA7DD9DD99EcP|dS)zK Return lines of a single file as list of Unicode strings. T)r4rTr/s r readlineszFileInput.readliness yy{{%%d+++rcb|jtjur|jdSdSr%)r'ryrrr/s rrzFileInput.close!s3 ;ci ' ' K        ( 'r) rrrr\ryrzr,r4rrrrrrqrqs#h -77ccT----^!!!6,,,      rrqc8eZdZdZdZ d dZdZdZd ZdS) FileOutputz6 Output for single, simple file-like objects. wNr#Tct|||||d|_||_|t jdt d|||_t|_ ||rd|_n`tj |_ nN|rLt|j dr7||j jkr'td|j jd |d |j |s% |j j|_dS#t"$rYdSwxYwdS) aA :Parameters: - `destination`: either a file-like object (which is written directly) or `None` (which implies `sys.stdout` if no `destination_path` given). - `destination_path`: a path to a file, which is opened and then written. - `encoding`: the text encoding of the output file. - `error_handler`: the encoding error handler to use. - `autoclose`: close automatically after write (except when `sys.stdout` or `sys.stderr` is the destination). - `handle_io_errors`: ignored, deprecated, will be removed. - `mode`: how the file is to be opened (see standard function `open`). The default is 'w', providing universal newline support for text files. TNziio.FileOutput: initialization argument "handle_io_errors" is ignored and will be removed in Docutils 1.2.rP) stacklevelFrzWarning: Destination mode "z" differs from specified mode "")file)rdr,openedrwwarningswarnDeprecationWarningrrrxrystdoutrghasattrprintrrhr)r+rgrhrr&rwhandle_io_errorsrs rr,zFileOutput.__init__2sU& k+; - 1 1 1 "  ' M !3 C C C C  DI"}}   .# #&:   )t/88 )$*///%)%5%:%:%:DDDB<))))   (,(8(=%%%!      sC)) C76C7c tjdkrd|jvr|j|jd}ni} t |j|jfi||_n2#t$r%}t|j |j |jd}~wwxYwd|_ dS)Nr bruT) ryrzrrr&r{rhrgr|rr}r~r)r+rrMs rr{zFileOutput.openas  v % %#TY*>*>"&- $ 244FFF 5#D$949OOOOD   5 5 5ek5>"355 5 5 sA A: A55A:c |js|d|jvrtjdkst |j|jdurc||}tjdkr>tj dkr.| dttj d} |j |n#t$r}tjdkrt|tr| |jj |n[#t"$rNt |j|jdur/t%d|jpdd |jjd |jd |wxYwYd }~nDd }~wt(t*f$r-}t)d |jdt-|d d }~wwxYw|jr|n!#|jr|wwxYw|S)zEncode `data`, write it to a single file, and return it. With Python 3 or binary output mode, `data` is returned unchanged, except when specified encoding and output encoding differ. rr F rrQz Encoding of rgz (z&) differs from specified encoding (r@Nz2Unable to encode output data. output-encoding is: r?)rr{rryrzrrgrrooslineseprEbytesrmrrBrr ValueErrorrhrFrrrwr)r+rHrLs rrmzFileOutput.writeos@ {  IIKKK ty S%5%>%>d. >>%GG;;t$$D6))bjD.@.@||E5W+E+EFF    " "4 ( ( ( ( " " "6))ju.E.E) "$+11$7777%"""%d&6&*m558=>>(j!2CmCC ,555t}}}*FGGG " "k* A A A,#}}}k#.>.>.>.>@AA A A ~  ~    sU5CG  G%FD F AE88F;G G(F<<GG G>c|jtjtjfvr"|jd|_dSdS)NF)rgryrstderrrrr/s rrzFileOutput.closesA  CJ #; ; ;   " " $ $ $DKKK < ;r)NNNr#TNN) rrrr\rr,r{rmrrrrrr&sv D) ;?BF-1----^   %%%N     rrceZdZdZdZdS)BinaryFileOutputzL A version of docutils.io.FileOutput which writes to a binary file. wbN)rrrr\rrrrrrs DDDrrceZdZdZdZdZdS) StringInputz Direct string input. c6||jS)z$Decode and return the source string.)rNr'r/s rr4zStringInput.reads{{4;'''rNrrrr\r)r4rrrrrs5%(((((rrceZdZdZdZdZdS) StringOutputz Direct string output. rcD|||_|jS)z=Encode `data`, store it in `self.destination`, and return it.)rorgrls rrmzStringOutput.writes;;t,,rNrrrr\rirmrrrrrs5 *     rrceZdZdZdZdZdS) NullInputz) Degenerate input: read nothing. z null inputcdS)zReturn a null string.r9rr/s rr4zNullInput.readssrNrrrrrrs5'rrceZdZdZdZdZdS) NullOutputz+ Degenerate output: write nothing. z null outputcdS)z6Do nothing ([don't even] send data to the bit bucket).Nrrls rrmzNullOutput.writes rNrrrrrrs5 -     rrceZdZdZdZdZdS) DocTreeInputzm Adapter for document tree input. The document tree must be passed in the ``source`` parameter. z doctree inputc|jS)zReturn the document tree.)r'r/s rr4zDocTreeInput.reads {rNrrrrrrs5 *rr) r\ __future__r __docformat__rrr^ryrdocutilsrdocutils.utils.error_reportingrrrrzstrr6r|r rrr!rdrqrrrrrrrrrrrs &%%%%%" """"""TTTTTTTTTTvG '     mmmmmMmmm`-B-B-B-B-B]-B-B-B`W W W W W W W W ts s s s s s s s lz ( ( ( ( (% ( ( (      6                           5     r