U ZSh]@sdZdZddlZddlmZddlZddlmZmZm Z m Z ddl m Z ddl mZddl mZdd lmZdd lmZd d ZGd ddeZGdddeZGdddeZGdddeZdS)z Directives for table elements. reStructuredTextN)Path)ionodes statemachineutils)SystemMessagePropagation) Directive) directives)urlopen)URLErrorcCs t|dS)N)leftcenterright)r choice)argumentrY/root/rtd-docs/venv/lib/python3.8/site-packages/docutils/parsers/rst/directives/tables.pyalignsrc@sxeZdZdZdZdZejeje ej e dej dZ dZddZdd Zd d Zd d ZeddZddZddZdS)Tablez# Generic table base class. T)autogrid)classnamerwidthwidthscCs^|jrN|jd}|j||j\}}tj|df|}|j|j\|_|_ nd}g}||fS)Nr) argumentsstateZ inline_textlinenortitle state_machineZget_source_and_linesourceline)self title_textZ text_nodesmessagesr!rrr make_title,s  zTable.make_titlec Csz|j|jd}g}d}d|jkrrttd|}W5QRX||jd d||\}}| |||fS)Nrrheaderignore ) r" get_sourcer optionswarningscatch_warnings simplefilter HeaderDialectparse_csv_data_into_rowssplitextend)r%r# table_headmax_header_colsZheader_dialectrowsrrrprocess_header_option9s    zTable.process_header_optioncCsJt||krD|jjd|t||jft|j|j|jd}t|t||kr\dkrnn<|jjdt|d|jdt|j|j|jd}t||D]}t||kr|jj|dt|d|jd t|j|j|jd}t|t||kr dkrnq|jjd t||jft|j|j|jd}t|qdS) NzP%s header row(s) specified but only %s row(s) of data supplied ("%s" directive).r$rzInsufficient data supplied (z9 row(s)); no data remaining for table body, required by "z " directive.z# stub column(s) specified but only z columns(s) of data supplied ("z " directive).ziInsufficient data supplied (%s columns(s)); no data remaining for table body, required by "%s" directive.) lenreportererrorrr literal_block block_textr r)r%r7 header_rows stub_columnsr<rowrrrcheck_table_dimensionsLs@   zTable.check_table_dimensionscCsd|jkr|jd|d<dS)Nrr-get)r% table_noderrrset_table_widthns zTable.set_table_widthcCs|jddS)NrrrCr%rrrrrsz Table.widthscCst|jtrTt|j|krL|jjd|j|ft|j |j |j d}t ||j}n<|rhd|g|}n(|jjdt|j |j |j d}t ||S)Nz="%s" widths do not match the number of columns in table (%s).r9dz#No table data detected in CSV file.) isinstancerlistr:r;r<rrr=r>r r)r%Zn_colsr< col_widthsrrrget_column_widthsvs$ zTable.get_column_widthscCsD|D]:}|D]0}t||kr |dddgfg|t|q qdS)Nr)r:r4)r%columnspartspartrArrr"extend_short_rows_with_empty_cellss z(Table.extend_short_rows_with_empty_cellsN)__name__ __module__ __qualname____doc__Zoptional_argumentsZfinal_argument_whitespacer class_option unchangedr length_or_percentage_or_unitlessvalue_orpositive_int_list option_specZ has_contentr(r8rBrFpropertyrrLrPrrrrrs( " rc@seZdZdZddZdS)RSTTablez Class for the `"table" directive`__ for formal tables using rST syntax. __ https://docutils.sourceforge.io/docs/ref/rst/directives.html c Cs|js2|jjd|jt|j|j|jd}|gS|\}}t }|j |j|j |t |dksvt|dtjs|jjd|jt|j|j|jd}|gS|d}|d|jdg7<||d|jkr|jd|d<t|jtrt|d}z||d }Wn4tk rD} z| jdgWYSd} ~ XYnXd d |jD} t| |D]\} } | | d <q`|jd kr|ddg7<n|jr|ddg7<|||r|d||g|S)Nz:Content block expected for the "%s" directive; none found.r9rrzOError parsing content block for the "%s" directive: exactly one table expected.classesrrcolscSsg|]}|jdkr|qS)colspec)tagname).0childrrr s z RSTTable.run..colwidthrcolwidths-autocolwidths-given)contentr;warningrrr=r>r r(Elementr nested_parsecontent_offsetr:rItabler<r-rDrFrrJrLrargschildrenzipadd_nameinsert) r%rhr!r'noder<rEtgrouprKdetailZcolspecsr_ col_widthrrrrunsR   "    z RSTTable.runN)rQrRrSrTrvrrrrr\sr\c@seZdZejejejejedejej ej ej ej eje ejejejejdZGdddejZGdddejZeddZd d Zd d Zed dZeddZddZdS)CSVTabler) header-rows stub-columnsr)rrfileurlencodingrrrdelim keepspacequoteescapecs>eZdZdZdZdZdZdZdZdZ e j Z fddZ ZS)zCSVTable.DocutilsDialectz&CSV dialect for `csv_table` directive.,"Tr+csXd|kr|d|_d|kr d|_d|kr2|d|_d|krJd|_|d|_tdS)Nr~rFrr) delimiterskipinitialspace quotechar doublequote escapecharsuper__init__)r%r- __class__rrrs   z!CSVTable.DocutilsDialect.__init__)rQrRrSrTrrrrstrictlineterminatorcsv QUOTE_MINIMALquotingr __classcell__rrrrDocutilsDialectsrcsBeZdZdZdZdZdZdZdZdZ dZ e j Z fdd ZZS) zCSVTable.HeaderDialectzw CSV dialect used for the "header" option data. Deprecated. Will be removed in Docutils 0.22. rr\FTr+cstjdtddtdS)Nz8CSVTable.HeaderDialect will be removed in Docutils 0.22. stacklevel)r.warnPendingDeprecationWarningrrrGrrrr s zCSVTable.HeaderDialect.__init__)rQrRrSrTrrrrrrrrrrrrrrrrr1sr1cCstjdtdddS)NzaCSVTable.check_requirements() is not required with Python 3 and will be removed in Docutils 0.22.rrr.rDeprecationWarningrrrrcheck_requirementsszCSVTable.check_requirementsc Csz|jjjjsPd|jks"d|jkrP|jjd|jt |j |j |j d}|gWS| \}}| \}}|\}}||||j|\}} t| |} |jdd} |jdd} ||| | ||d| || d} || } || || fWntk r0}z|jdgWYSd}~XYnbtjk r}z@t|}|jjd|j|ft |j |j |j d}|gWYSd}~XYnX| || f}|jj||j| |jd }|d |jd g7<d |jkr|jd |d <| ||!||r|"d||g|S) Nr{r|z9File and URL access deactivated; ignoring "%s" directive.r9ryrrzz)Error with CSV data in "%s" directive: %s)rr]rr)#rdocumentsettingsZfile_insertion_enabledr-r;rhrrr=r>r r( get_csv_datar8r2rmaxrDrBr4rLrPrrmrErrorstrr<Z build_tablerkrrFrprq)r%rhr!r'csv_datar#r5r6r7max_colsr?r@Z table_bodyrKrtmessager<rlrErrrrvsn               z CSVTable.runc Cst|jd|jjjj}|jjjj}|jrd|jks|jd}z t|} | } W5QRXWndttt fk r}z>|jjd |j |jd|ft |j |j |jd}t|W5d}~XYnXtj!| |||jjjjd }|}n.|jj"d |j t |j |j |jd}t|||fS)zr Get CSV data from the directive content, from an external file, or from a URL reference. r}r{r|zF"%s" directive may not both specify an external file and have content.r9rzXThe "file" and "url" options may not be simultaneously specified for the "%s" directive.N) source_pathr} error_handlerz&Problems with "%s" directive path: %s.z*Problems with "%s" directive URL "%s": %s.)r#rr}rz3The "%s" directive requires content; none supplied.)#r-rDrrrZinput_encodingZinput_encoding_error_handlerrgr;r<rrr=r>r rr#rZcurrent_sourceparentr relative_pathrZ FileInputread splitlinesOSErrorsevereZrecord_dependenciesaddr r ValueErrorZ StringInputrh) r%r}rr<r#rZ_baseZcsv_filerresponseZcsv_textrrrrFs           zCSVTable.get_csv_datacCstjdtdd|S)NzgCSVTable.decode_from_csv() is not required with Python 3 and will be removed in Docutils 0.21 or later.rrrsrrrdecode_from_csvs zCSVTable.decode_from_csvcCstjdtdd|S)NzgCSVTable.encode_from_csv() is not required with Python 3 and will be removed in Docutils 0.21 or later.rrrrrrrencode_for_csvs zCSVTable.encode_for_csvc Cs|tjdd|D|d}g}d}|D]N}g}|D](} dddtj| |df} || q0||t|t|}q$||fS)Ncss|]}|dVqdS)r+Nr)rar$rrr sz4CSVTable.parse_csv_data_into_rows..)dialectr)r#)rreaderrZ StringListrappendrr:) r%rrr#Z csv_readerr7rrAZrow_datacellZ cell_datarrrr2s    z!CSVTable.parse_csv_data_into_rowsN)rQrRrSr nonnegative_intrVrWrXrYpathurir}rUrZ$single_char_or_whitespace_or_unicodeflagZsingle_char_or_unicoderZrDialectrr1 staticmethodrrvrrrr2rrrrrws:# -G  rwc@sPeZdZdZejejejedejej ej e dZ ddZ ddZdd Zd S) ListTablez Implement tables whose data is encoded as a uniform two-level bullet list. For further ideas, see https://docutils.sourceforge.io/docs/dev/rst/alternatives.html#list-driven-tables rx)ryrzrrrrrc CsR|js2|jjd|jt|j|j|jd}|gS|\}}t }|j |j|j |zN| |\}}dd|dD}|jdd}|jdd} |||| Wn2tk r} z| jdgWYSd} ~ XYnX||||| } d|jkr|jd| d<| d |jd g7<|| || |rH| d|| g|S) Nz.The "%s" directive is empty; content required.r9cSsg|]}dd|dDqS)cSsg|] }|jqSr)rn)raitemrrrrcsz,ListTable.run...rr)raZrow_listrrrrcsz!ListTable.run..rryrzrr]r)rgr;r<rrr=r>r r(rirrjrkcheck_list_contentr-rDrBrrmbuild_table_from_listrFrprq) r%r<r!r'rrnum_colsrK table_datar?r@rtrErrrrvsB "    z ListTable.runcCs>t|dkst|dtjsJ|jjd|jt|j|j|j d}t ||d}d}t t|D]}||}t|dkst|dtjs|jjd|j|dft|j|j|j d}t |qb|rt|d|kr*|jjd|j|dt|d|ft|j|j|j d}t |qbt|d}qb| |}||fS)NrrzUError parsing content block for the "%s" directive: exactly one bullet list expected.r9zError parsing content block for the "%s" directive: two-level bullet list expected, but row %s does not contain a second-level bullet list.zError parsing content block for the "%s" directive: uniform two-level bullet list expected, but row %s does not contain the same number of items as row 1 (%s vs %s).) r:rIrZ bullet_listr;r<rr=r>r rrangerL)r%rrr<Z list_noderZ item_indexrrKrrrrsF    zListTable.check_list_contentcCs(t}|jdkr&|ddg7<n|jr>|ddg7<tjt|d}||7}|D]<}t}|dk rx||jd<|rd|jd<|d8}||7}qZg} |D]8} t} | D]} t} | | 7} | | 7} q| | q|rt }| | d|||7}t }| | |d||7}|S) Nrr]rerf)r^rdrZstub) rrlrrsr:r_ attributesrAentryrtheadr4tbody)r%rrKr?r@rlrsrur_r7rAZrow_noderrrrrrrrs>      zListTable.build_table_from_listN)rQrRrSrTr rrWrXrYrUrVrrZrvrrrrrrrs &r)rT __docformat__rpathlibrr.ZdocutilsrrrrZdocutils.utilsrZdocutils.parsers.rstr r urllib.requestr urllib.errorr rrr\rwrrrrrs       t0n