U Sh* @sdZddlmZddlZddlmZddlmZddlm Z m Z ddl Z ddl m Z ddlmZdd lmZdd lmZdd lmZd d lmZmZeGdddZeGdddZddddddddddddddZeGdddZd%ddddddddd Zddd!d"d#d$ZdS)&aFenced code blocks are parsed as directives, if the block starts with ``{directive_name}``, followed by arguments on the same line. Directive options are read from a YAML block, if the first content line starts with ``---``, e.g. :: ```{directive_name} arguments --- option1: name option2: | Longer text block --- content... ``` Or the option block will be parsed if the first content line starts with ``:``, as a YAML block consisting of every line that starts with a ``:``, e.g. :: ```{directive_name} arguments :option1: name :option2: other content... ``` If the first line of a directive's content is blank, this will be stripped from the content. This is to allow for separation between the option block and content. ) annotationsN) dataclass)dedent)AnyCallable) Directive)flag) TestDirective) MarkupError) MystWarnings) TokenizeErroroptions_to_itemsc@s0eZdZUded<dZded<ejZded<dS) ParseWarningsstrmsgN int | Nonelinenor type)__name__ __module__ __qualname____annotations__rr ZDIRECTIVE_PARSINGrrrQ/root/rtd-docs/venv/lib/python3.8/site-packages/myst_parser/parsers/directives.pyr7s  rc@s6eZdZUded<ded<ded<ded<ded <d S) DirectiveParsingResult list[str] argumentsdictoptionsbodyintZ body_offsetlist[ParseWarnings]warningsNrrrrrrrrr>s rT)linevalidate_optionsadditional_optionsztype[Directive]rrboolzdict[str, str] | None)directive_class first_linecontentr%r&r'returnc Cs|jrLt|||| |d}|j}|j}|j} |j} t|t| } ng}d}i} |} d} |js|j s| r|rt | r| t d| d|d} g} n t||} | r| d s| dd} | d7} | r|js| t dt| | | | |S)aParse (and validate) the full directive text. :param first_line: The text on the same line as the directive name. May be an argument or body text, dependent on the directive :param content: All text after the first line. Can include options. :param validate_options: Whether to validate the values of options This is actually only here to be used by myst-nb cells, which converts options directly to JSON metadata, using the full YAML spec. :param additional_options: Additional options to add to the directive, above those parsed from the content (content options take priority). :raises MarkupError: if there is a fatal parsing/validation error )r%as_yamlr'FrzbSplitting content across first line and body, when an options block is present, is not recommendedr NzHas content, but none permitted) option_spec_parse_directive_optionsr# has_optionsrr+ splitlineslenrequired_argumentsoptional_argumentsstripanyappendrinsertparse_directive_argumentsZ has_contentr) r)r*r+r%r&r'resultZparse_warningshas_options_blockr body_linesZcontent_offsetrrrrparse_directive_textNsT       r=c@s.eZdZUded<ded<ded<ded<d S) _DirectiveOptionsrr+zdict[str, Any]rr"r#r(r0Nr$rrrrr>s r>)r+r)r-r%r'r,c CsLd}|dr|dkrdn|d}d|dd}td|tj}|rr|d|}||dd}n|}d}t|}nd| dr|}g}|r|d dsq| | d ddqd|}d|}|dk } |rg} zt |pdpi} Wn:t jjt jjfk rNi} | td |tjYnXt| tsti} | td |tjt|| | | Sg} i} |dk rzt|\}}t|} WnJtk r}z*t|| td |j|tjg| WYSd}~XYnX|jr| td |tjt|tr.t|| g| S|r<|| } |j}g}i}| D]\}}z ||}Wn&t!k r| |YqRYnX|sd}|t"krd}z ||}WnNt#t$fk r}z*| td |d|d||tjW5d}~XYn X|||<qR|r>| tdt%|dt%|d|tjt||| | S)zlParse (and validate) the directive option section. :returns: (content, options, validation_errors) Nz---r  z^-{3,}:rz!Invalid options format (bad YAML)z#Invalid options format (not a dict)zInvalid options format: zPDirective options has # comments, which may not be supported in future versions.zInvalid option value for z: zUnknown option keys: z (allowed: ))& startswithjoinr1research MULTILINEstartendrlstripr7popyamlZ safe_loadparserZ ParserErrorscannerZ ScannerErrorrr ZDIRECTIVE_OPTION isinstancerr>rr problemZ has_commentsZDIRECTIVE_OPTION_COMMENTS issubclassr r.itemsKeyErrorr ValueError TypeErrorsorted)r+r)r-r%r'Z options_blockmatchZ content_linesZ yaml_linesr;Z yaml_errorsZ yaml_optionsZvalidation_errorsr_optionsstateerrZ options_specZunknown_options new_optionsnamevalueZ convertorZconverted_valueerrorrrrr/s                    r/r) directive_clsarg_textr,cCs|j}|j}|}t||kr:t|dt|dnJt|||kr|jrf|d||d}ntd||dt|d|S)z4Parse (and validate) the directive argument section.z argument(s) required, z suppliedNr zmaximum z argument(s) allowed, )r3r4splitr2r Zfinal_argument_whitespace)r_r`requiredoptionalrrrrr94s r9)N)__doc__ __future__rrE dataclassesrtextwraprtypingrrrLZdocutils.parsers.rstrZdocutils.parsers.rst.directivesrZ$docutils.parsers.rst.directives.miscr Zdocutils.parsers.rst.statesr Zmyst_parser.warnings_r rr rrrr=r>r/r9rrrrs4$        Q