o M=&bV@sdZdZddlZddlZddlZddlmZmZm Z m Z ddl m Z ddl mZddl mZdd ZGd d d eZGd d d eZGdddeZGdddeZdS)z Directives for table elements. ZreStructuredTextN)ionodes statemachineutils)SystemMessagePropagation) Directive) directivescCs t|dS)N)leftcenterright)rchoice)Zargumentr Jusr/lib/python3.10/site-packages/docutils/parsers/rst/directives/tables.pyaligns rc@sxeZdZdZdZdZejeje ej e dej dZ dZddZdd Zd d Zd d ZeddZddZddZdS)Tablez# Generic table base class. T)autoZgrid)classnamerwidthwidthscCsf|jr+|jd}|j||j\}}tj|dg|R}|j|j\|_|_ ||fSd}g}||fS)Nr) argumentsstateZ inline_textlinenortitle state_machineZget_source_and_linesourceline)selfZ title_textZ text_nodesmessagesrr r r make_title*s  zTable.make_titlecCsX|j|jd}g}d}d|jvr(||jdd||\}}||||fS)Nrrheader )r get_sourceroptionsparse_csv_data_into_rowssplit HeaderDialectextend)rr table_headmax_header_colsrowsr r rprocess_header_option7s  zTable.process_header_optioncCsHt||kr"|jjd|t||jft|j|j|jd}t|t||kr.dkrNnn|jjdt|d|jdt|j|j|jd}t||D]Q}t||krx|jj|dt|d|jd t|j|j|jd}t|t||krdkrnqP|jjd t||jft|j|j|jd}t|qPdS) NzP%s header row(s) specified but only %s row(s) of data supplied ("%s" directive).rrzInsufficient 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_textrr)rr, header_rows stub_columnsr1rowr r rcheck_table_dimensionsBsP    zTable.check_table_dimensionscCs"d|jvr|jd|d<dSdS)Nrr%get)r table_noder r rset_table_widthds zTable.set_table_widthcCs|jddS)Nrrr8rr r rrhsz Table.widthscCst|jtr+t|j|kr&|jjd|j|ft|j |j |j d}t ||j}|S|r6d|g|}|S|jjdt|j |j |j d}t |)Nz="%s" widths do not match the number of columns in table (%s).r.dz#No table data detected in CSV file.) isinstancerlistr/r0r1rrr2r3rr)rZn_colsr1 col_widthsr r rget_column_widthsls& zTable.get_column_widthscCsD|D]}|D]}t||kr|dddgfg|t|qqdS)Nr)r/r))rcolumnspartspartr6r r r"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!r-r7r;propertyrrArEr r r rrs*  "  rc@seZdZddZdS)RSTTablec Cs|js|jjd|jt|j|j|jd}|gS|\}}t }|j |j|j |t |dks;t|dtjsQ|jjd|jt|j|j|jd}|gS|d}|d|jdg7<||d|jvrt|jd|d<t|jtr|d}z ||d }Wnty} z | jdgWYd} ~ Sd} ~ wwd 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.r.rrzOError parsing content block for the "%s" directive: exactly one table expected.classesrrcolscSsg|] }|jdkr|qS)colspec)Ztagname).0childr r r s z RSTTable.run..colwidthrcolwidths-autocolwidths-given)contentr0warningrrr2r3rr!Elementr nested_parsecontent_offsetr/r>tabler1r%r9r;rr?rArargschildrenzipadd_nameinsert) rr\rr noder1r:tgroupr@detailZcolspecsrT col_widthr r rrunsV         z RSTTable.runN)rFrGrHrjr r r rrQs rQc@seZdZejejejejedejej ej ej ej eje ejejejejdZGdddejZGdddejZddZd d Zd d Zed dZeddZddZdS)CSVTabler) header-rows stub-columnsr"rrfileurlencodingrrrdelim keepspacequoteescapec@s6eZdZdZdZdZdZdZdZdZ e j Z ddZ dS) zCSVTable.DocutilsDialectz&CSV dialect for `csv_table` directive.,"Tr#cCsZd|vr |d|_d|vrd|_d|vr|d|_d|vr%d|_|d|_tj|dS)NrrrsFrtru) delimiterskipinitialspace quotechar doublequote escapecharcsvDialect__init__)rr%r r rrs   z!CSVTable.DocutilsDialect.__init__N)rFrGrHrIrxrzr{rystrictlineterminatorr} QUOTE_MINIMALquotingrr r r rDocutilsDialects rc@s2eZdZdZdZdZdZdZdZdZ dZ e j Z dS) zCSVTable.HeaderDialectz0CSV dialect to use for the "header" option data.rvrw\FTr#N)rFrGrHrIrxrzr|r{ryrrr}rrr r r rr(s r(cCsdS)Nr r<r r rcheck_requirementsszCSVTable.check_requirementsc Csz|jjjjs(d|jvsd|jvr(|jjd|jt |j |j |j d}|gWS| | \}}|\}}|\}}||||j|\}} t| |} |jdd} |jdd} ||| | ||d| || d} || } || || fWnFty}z |jdgWYd}~Sd}~wtjy}z"t|}|jjd|j|ft |j |j |j d}|gWYd}~Sd}~ww| || f}|jj||j| |j d }|d |jd g7<d |jvr|jd |d <|!||"||r|#d||g|S) Nrorpz9File and URL access deactivated; ignoring "%s" directive.r.rmrrnz)Error with CSV data in "%s" directive: %s)rrRrr)$rdocumentsettingsZfile_insertion_enabledr%r0r\rrr2r3rrr! get_csv_datar-r&rmaxr9r7r)rArErrar}Errorstrr1Z build_tabler_rr;rdre)rr\rr csv_datarr*r+r,max_colsr4r5Z table_bodyr@rhmessager1r`r:r r rrjsl                z CSVTable.runc Cs|jd|jjjj}|jjjj}|jrBd|jvsd|jvr5|jj d|j t |j |j |jd}t||jd}|j}||fSd|jvrd|jvrc|jj d|j t |j |j |jd}t|tjtj|jjj}tjtj||jd}td|}ztj|||d }|}Wn%ty}z|jjd |j |ft |j |j |jd}t|d}~ww|jjjj !|||fSd|jvr+dd l"m#} dd l$m%} |jd}z| |} Wn-| tt&fy}z|jjd |j |jd|ft |j |j |jd}t|d}~wwtj'| |||jjjjd}|}||fS|jj(d|j t |j |j |jd}t|)zr Get CSV data from the directive content, from an external file, or from a URL reference. rqrorpzF"%s" directive may not both specify an external file and have content.r.rzXThe "file" and "url" options may not be simultaneously specified for the "%s" directive.N) source_pathrq error_handlerz&Problems with "%s" directive path: %s.)urlopen)URLErrorz*Problems with "%s" directive URL "%s": %s.)rrrqrz3The "%s" directive requires content; none supplied.))r%r9rrrZinput_encodingZinput_encoding_error_handlerr[r0r1rrr2r3rrrospathdirnameabspathZcurrent_sourcenormpathjoinrZ relative_pathrZ FileInputread splitlinesOSErrorsevereZrecord_dependenciesaddZurllib.requestrZ urllib.errorr ValueErrorZ StringInputr\) rrqrr1rr source_dirZcsv_filerrrZcsv_textr r rrs   ;      zCSVTable.get_csv_datacCtjdtdd|S)NzgCSVTable.decode_from_csv() is not required with Python 3 and will be removed in Docutils 0.21 or later. stacklevelwarningswarnDeprecationWarningsr r rdecode_from_csvlzCSVTable.decode_from_csvcCr)NzgCSVTable.encode_from_csv() is not required with Python 3 and will be removed in Docutils 0.21 or later.rrrrr r rencode_for_csvtrzCSVTable.encode_for_csvc Cs|tjdd|D|d}g}d}|D]'}g}|D]} dddtj| |df} || q||t|t|}q||fS)NcSsg|]}|dqS)r#r )rUrr r rrW}sz5CSVTable.parse_csv_data_into_rows..)dialectr)r)r}readerrZ StringListrappendrr/) rrrrZ csv_readerr,rr6Zrow_datacellZ cell_datar r rr&|s   z!CSVTable.parse_csv_data_into_rowsN)rFrGrHrnonnegative_intrKrLrMrNrZurirqrJrZ$single_char_or_whitespace_or_unicodeflagZsingle_char_or_unicoderOr}r~rr(rrjr staticmethodrrr&r r r rrks: .N   rkc@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 rl)rmrnrrrrrc CsL|js|jjd|jt|j|j|jd}|gS|\}}t }|j |j|j |z'| |\}}dd|dD}|jdd}|jdd} |||| Wntyl} z | jdgWYd} ~ Sd} ~ ww||||| } d|jvr|jd| d<| d |jd g7<|| || |r| d|| g|S) Nz.The "%s" directive is empty; content required.r.cSsg|] }dd|dDqS)cSsg|]}|jqSr )rb)rUitemr r rrWsz,ListTable.run...rr )rUZrow_listr r rrWsz!ListTable.run..rrmrnrrRr)r[r0r1rrr2r3rr!r]rr^r_check_list_contentr%r9r7rrabuild_table_from_listr;rdre) rr1rr rfnum_colsr@ table_datar4r5rhr:r r rrjsD      z ListTable.runcCs8t|dkst|dtjs%|jjd|jt|j|j|j d}t ||d}d}t t|D]a}||}t|dksEt|dtjs`|jjd|j|dft|j|j|j d}t ||rt|d|kr|jjd|j|dt|d|ft|j|j|j d}t |q1t|d}q1| |}||fS)NrrzUError parsing content block for the "%s" directive: exactly one bullet list expected.r.zError 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/r>rZ bullet_listr0r1rr2r3rrrangerA)rrfr1Z list_noder item_indexrr@r r rrsH  zListTable.check_list_contentcCs&t}|jdkr|ddg7<n |jr|ddg7<tjt|d}||7}|D]}t}|dur<||jd<|rGd|jd<|d8}||7}q-g} |D]} t} | D]} t} | | 7} | | 7} qX| | qP|rt }| | d|||7}t }| | |d||7}|S) NrrRrYrZ)rSrXrZstub) rr`rrgr/rTZ attributesr6entryrtheadr)tbody)rrr@r4r5r`rgrirTr,r6Zrow_noderrrrr r rrs>      zListTable.build_table_from_listN)rFrGrHrIrrrLrMrNrJrKrrOrjrrr r r rrs  &r)rIZ __docformat__r}os.pathrrdocutilsrrrrZdocutils.utilsrZdocutils.parsers.rstrrrrrQrkrr r r rs   l+\