/VhPS&ddlmZddlZddlZddlZddlZddlmZmZm Z m Z m Z m Z m Z ddlmZddlmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZmZdd lmZerddl m!Z!gdZ"ejFdZ$GddZ% ddZ&ddZ'y)) annotationsN) TYPE_CHECKINGAnyBinaryIOCallableClassVarMappingSequence)util)build_preprocessors)build_block_parser)build_treeprocessors)build_inlinepatterns)build_postprocessors) Extension)to_html_stringto_xhtml_string)BLOCK_LEVEL_ELEMENTS)Element)MarkdownmarkdownmarkdownFromFileMARKDOWNceZdZUdZdZeedZded< dZ ddZ ddZ dd Z dd Z dd Zdd Zdd ZddZ d ddZy)ra A parser which converts Markdown to HTML. Attributes: Markdown.tab_length (int): The number of spaces which correspond to a single tab. Default: `4`. Markdown.ESCAPED_CHARS (list[str]): List of characters which get the backslash escape treatment. Markdown.block_level_elements (list[str]): List of HTML tags which get treated as block-level elements. See [`markdown.util.BLOCK_LEVEL_ELEMENTS`][] for the full list of elements. Markdown.registeredExtensions (list[Extension]): List of extensions which have called [`registerExtension`][markdown.Markdown.registerExtension] during setup. Markdown.doc_tag (str): Element used to wrap document. Default: `div`. Markdown.stripTopLevelTags (bool): Indicates whether the `doc_tag` should be removed. Default: 'True'. Markdown.references (dict[str, tuple[str, str]]): A mapping of link references found in a parsed document where the key is the reference name and the value is a tuple of the URL and title. Markdown.htmlStash (util.HtmlStash): The instance of the `HtmlStash` used by an instance of this class. Markdown.output_formats (dict[str, Callable[xml.etree.ElementTree.Element]]): A mapping of known output formats by name and their respective serializers. Each serializer must be a callable which accepts an [`Element`][xml.etree.ElementTree.Element] and returns a `str`. Markdown.output_format (str): The output format set by [`set_output_format`][markdown.Markdown.set_output_format]. Markdown.serializer (Callable[xml.etree.ElementTree.Element]): The serializer set by [`set_output_format`][markdown.Markdown.set_output_format]. Markdown.preprocessors (util.Registry): A collection of [`preprocessors`][markdown.preprocessors]. Markdown.parser (blockparser.BlockParser): A collection of [`blockprocessors`][markdown.blockprocessors]. Markdown.inlinePatterns (util.Registry): A collection of [`inlinepatterns`][markdown.inlinepatterns]. Markdown.treeprocessors (util.Registry): A collection of [`treeprocessors`][markdown.treeprocessors]. Markdown.postprocessors (util.Registry): A collection of [`postprocessors`][markdown.postprocessors]. div)htmlxhtmlz-ClassVar[dict[str, Callable[[Element], str]]]output_formatsc |jdd|_gd|_ tj|_g|_d|_d|_|ji|_ tj|_ |j|jdg|jdi|j|jd d |j!y ) a Creates a new Markdown instance. Keyword Arguments: extensions (list[Extension | str]): A list of extensions. If an item is an instance of a subclass of [`markdown.extensions.Extension`][], the instance will be used as-is. If an item is of type `str`, it is passed to [`build_extension`][markdown.Markdown.build_extension] with its corresponding `extension_configs` and the returned instance of [`markdown.extensions.Extension`][] is used. extension_configs (dict[str, dict[str, Any]]): Configuration settings for extensions. output_format (str): Format of output. Supported formats are: * `xhtml`: Outputs XHTML style tags. Default. * `html`: Outputs HTML style tags. tab_length (int): Length of tabs in the source. Default: `4` tab_length)\`*_{}[]()>#+-.!T extensionsextension_configs)r4configs output_formatrN)getr! ESCAPED_CHARSrcopyblock_level_elementsregisteredExtensionsdocTypestripTopLevelTags build_parser referencesr HtmlStash htmlStashregisterExtensionsset_output_formatreset)selfkwargss =/home/dcms/DCMS/lib/python3.12/site-packages/markdown/core.py__init__zMarkdown.__init__Xs* &zz,:)  M/C/H/H/J!57! '+ 68)-)9 6::lB+G(. 3F(K  M vzz/7CD ct||_t||_t ||_t ||_t||_ |S)a0 Build the parser from the various parts. Assigns a value to each of the following attributes on the class instance: * **`Markdown.preprocessors`** ([`Registry`][markdown.util.Registry]) -- A collection of [`preprocessors`][markdown.preprocessors]. * **`Markdown.parser`** ([`BlockParser`][markdown.blockparser.BlockParser]) -- A collection of [`blockprocessors`][markdown.blockprocessors]. * **`Markdown.inlinePatterns`** ([`Registry`][markdown.util.Registry]) -- A collection of [`inlinepatterns`][markdown.inlinepatterns]. * **`Markdown.treeprocessors`** ([`Registry`][markdown.util.Registry]) -- A collection of [`treeprocessors`][markdown.treeprocessors]. * **`Markdown.postprocessors`** ([`Registry`][markdown.util.Registry]) -- A collection of [`postprocessors`][markdown.postprocessors]. This method could be redefined in a subclass to build a custom parser which is made up of a different combination of processors and patterns. ) r preprocessorsrparserrinlinePatternsrtreeprocessorsrpostprocessors)rFs rHr?zMarkdown.build_parsersI*16(. 248248248 rJc  |D]}t|tr"|j||j|i}t|trV|j |t jd|jjd|jjd|tdj|jj|jjtjtj|S)a Load a list of extensions into an instance of the `Markdown` class. Arguments: extensions (list[Extension | str]): A list of extensions. If an item is an instance of a subclass of [`markdown.extensions.Extension`][], the instance will be used as-is. If an item is of type `str`, it is passed to [`build_extension`][markdown.Markdown.build_extension] with its corresponding `configs` and the returned instance of [`markdown.extensions.Extension`][] is used. configs (dict[str, dict[str, Any]]): Configuration settings for extensions. zSuccessfully loaded extension "r1z".z*Extension "{}.{}" must be of type: "{}.{}") isinstancestrbuild_extensionr8rextendMarkdownloggerdebug __class__ __module____name__ TypeErrorformat)rFr4r6exts rHrCzMarkdown.registerExtensionss$ C#s#**3 C0DE#y)""4( }}//1G1GI@GG 00#--2H2H!,,i.@.@   rJct|}tjDcgc]}|j|k(s|}}|r|dj }|d i|Sd|vr|j ddn|df\}} t j|}tjd|z|rt||d i|S |jd i|Scc}w#t$r#}d|z} | f|jddz|_ d}~wwxYw#t$r5}|jd} d|d | } | f|jddz|_ d}~wwxYw) a Build extension from a string name, then return an instance using the given `configs`. Arguments: ext_name: Name of extension as a string. configs: Configuration settings for extension. Returns: An instance of the extension with the given configuration settings. First attempt to load an entry point. The string name must be registered as an entry point in the `markdown.extensions` group which points to a subclass of the [`markdown.extensions.Extension`][] class. If multiple distributions have registered the same name, the first one found is returned. If no entry point is found, assume dot notation (`path.to.module:ClassName`). Load the specified class and return an instance. If no class is specified, import the module and call a `makeExtension` function and return the [`markdown.extensions.Extension`][] instance returned by that function. r:r r3z,Successfully imported extension module "%s".zFailed loading extension "%s".NzFailed to initiate extension 'z': )dictr get_installed_extensionsnameloadsplit importlib import_modulerVrW ImportErrorargsgetattr makeExtensionAttributeError) rFext_namer6ep entry_pointsr] class_namemoduleemessages rHrTzMarkdown.build_extensions\&w-%)%B%B%D\rS[H[\ \ q/&&(C>> !:=x~~c15xY[n* ,,X6F LL>I  .76:.99 9 +v++6g661] 6AGZ!&&*,AF  " &&)(0';!affQRj0  s:C C 8-C:D C=C88C= D> 0D99D>c<|jj||S)a Register an extension as having a resettable state. Arguments: extension: An instance of the extension to register. This should get called once by an extension during setup. A "registered" extension's `reset` method is called by [`Markdown.reset()`][markdown.Markdown.reset]. Not all extensions have or need a resettable state, and so it should not be assumed that all extensions are "registered." )r<appendrF extensions rHregisterExtensionzMarkdown.registerExtensions !!((3 rJc|jj|jj|jD]}t |ds|j!|S)z Resets all state variables to prepare the parser instance for new input. Called once upon creation of a class instance. Should be called manually between calls to [`Markdown.convert`][markdown.Markdown.convert]. rE)rBrEr@clearr<hasattrrvs rHrEzMarkdown.resetsT  22 "Iy'*! " rJc|jjd|_ |j|j|_|S#t $ry}t |jj}|jd|jdddj|zdzd}|f|jddz|_ d}~wwxYw) z Set the output format for the class instance. Arguments: format: Must be a known value in `Markdown.output_formats`. 145zInvalid Output Format: "z". Use one of "z", "r1r N) lowerrstripr7r serializerKeyErrorlistkeyssortjoinri)rFr\rr valid_formatsrss rHrDzMarkdown.set_output_formats$\\^2259 "11$2D2DEDO   !4!4!9!9!;zz<%s />z4Markdown failed to strip top-level tags. Document=%r)striprSUnicodeDecodeErrorreasonrelinesrLrunrM parseDocumentgetrootrOrr>indexdoc_taglenrindex ValueErrorendswithrP) rFsourcerrpreproot treeprocessornewRootoutputstartendpps rHconvertzMarkdown.convert;s4||~ [F\\$' && .D$**-DJ .{{((4<<>"00 M#''-G"  &  ! ! R T\\)+-0->?ABCmmGdll$:;c*002%% $BVVF^F $||~Q"  HHI IH  6 R<<>**8dll+BCF%&9;A<<>&JKPQR Rs1 E7A(F7 FFF G='A G88G=Nc|xsd}|r[t|trt|d|}ntj||}|j }|j ntjj }|jd}|j|}|r~t|tr ??$D    99>>#D{{8$||D! &#&$kk1DF !!$'!!#  ))(3$V4GH !!$' ;;x)<=D JJ   # #D ) rJ)returnr)r4zSequence[Extension | str]r6zMapping[str, dict[str, Any]]rr)rmrSr6zMapping[str, Any]rr)rwrrr)r\rSrr)rrrbool)rrSrrS)NNN)rstr | BinaryIO | Nonerrrz str | Nonerr)rZrY __qualname____doc__rrrr__annotations__rIr?rCrTrxrErDrrrr`rJrHrr.s<G!!ENA )V8"-"."  "H3j  . GV(,(,# ?$?&? ?  ?rJrc :tdi|}|j|S)a5 Convert a markdown string to HTML and return HTML as a Unicode string. This is a shortcut function for [`Markdown`][markdown.Markdown] class to cover the most basic use case. It initializes an instance of [`Markdown`][markdown.Markdown], loads the necessary extensions and runs the parser on the given text. Arguments: text: Markdown formatted text as Unicode or ASCII string. Keyword arguments: **kwargs: Any arguments accepted by the Markdown class. Returns: A string in the specified output format. r`)rr)rrGmds rHrrs $  F B ::d rJc tdi|}|j|jdd|jdd|jddy)aE Read Markdown text from a file and write output to a file or a stream. This is a shortcut function which initializes an instance of [`Markdown`][markdown.Markdown], and calls the [`convertFile`][markdown.Markdown.convertFile] method rather than [`convert`][markdown.Markdown.convert]. Keyword arguments: input (str | BinaryIO): A file name or readable object. output (str | BinaryIO): A file name or writable object. encoding (str): Encoding of input and output. **kwargs: Any arguments accepted by the `Markdown` class. rNrrr`)rrr8)rGrs rHrrsF  F BNN6::gt,::h-::j$/1rJ)rrSrGrrrS)rGr)( __future__rrrloggingrftypingrrrrrr r r3r rLr blockprocessorsrrOrinlinepatternsrrPrr4r serializersrrrxml.etree.ElementTreer__all__ getLoggerrVrrrr`rJrHrsu(# VVV./000!8&- 6   : &UUp ,1rJ