+ Z iY<^RIHt^RIt^RIt^RIt^RIt^RIHtHtH t H t H t H t H t ^RIHt^RIHt^RIHt^RIHt^RIHt^R IHt^R IHt^R IHtHt^R IHt]'d^R I H!t!.ROt"]PF!R4t$!RR4t%RRlt&RRlt'R#)) annotationsN) TYPE_CHECKINGAnyBinaryIOCallableClassVarMappingSequence)util)build_preprocessors)build_block_parser)build_treeprocessors)build_inlinepatterns)build_postprocessors) Extension)to_html_stringto_xhtml_string)BLOCK_LEVEL_ELEMENTS)ElementMarkdownMARKDOWNc]tRt^.t$RtRtR]R]/tR] R&Rt RR lt R R lt R R lt RRltRRltRRltRRltRRltRRRlltRtR#)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]. divhtmlxhtmlz-ClassVar[dict[str, Callable[[Element], str]]]output_formatsc VPR^4Vn.R OVn\P!4Vn.VnRVnRVnVP4/Vn \P!4Vn VPVPR.4VPR/4R7VPVPRR44VP!4R #) 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_lengthT extensionsextension_configs)r configs output_formatrN)\`*_{}[]()>#+-.!)getr ESCAPED_CHARSrcopyblock_level_elementsregisteredExtensionsdocTypestripTopLevelTags build_parser referencesr HtmlStash htmlStashregisterExtensionsset_output_formatreset)selfkwargss&,//usr/lib/python3/dist-packages/markdown/core.py__init__Markdown.__init__Xs* &zz,:)  M/C/H/H/J!57! '+ 68)-)9 6::lB+G(. 3F(K  M vzz/7CD cV^8dQhRR/#returnr)formats"rD __annotate__Markdown.__annotate__shrGc \V4Vn\V4Vn\ V4Vn\ V4Vn\V4Vn V#)a 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 preprocessorsr parserrinlinePatternsrtreeprocessorsrpostprocessors)rBs&rDr;Markdown.build_parsersI*16(. 248248248 rGc$V^8dQhRRRRRR/#)rJr zSequence[Extension | str]r"zMapping[str, dict[str, Any]]rKrrL)rMs"rDrNrOs(""-"."  "rGc  0VEFp\V\4'd"VPW2PV/44p\V\4'dZVP V4\ PRVPP: RVPP: R24KVfK\RPVPPVPP\P\P44h V#)aB 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 "r2z".z*Extension "{}.{}" must be of type: "{}.{}") isinstancestrbuild_extensionr4rextendMarkdownloggerdebug __class__ __module____name__ TypeErrorrM)rBr r"exts&&& rDr?Markdown.registerExtensionss$C#s##**3 C0DE#y))""4( }}//1G1GI@GG 00#--2H2H!,,i.@.@  rGc$V^8dQhRRRRRR/#)rJext_namerZr"zMapping[str, Any]rKrrL)rMs"rDrNrOs"3336G3I3rGc \V4p\P!4Uu.uFq3PV8XgKVNK ppV'd V^,P 4pV!R /VB#RV9dVP R^4MVR3wr\ P!V4p\PRV,4T'd\Yv4!R /TB#TP!R /TB#uupi \d0pRT,p T 3TPR,,Tn hRp?ii;i \dDpTP^,p RT: RT : 2p T 3TPR,,Tn hRp?ii;i) ac 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. :rz,Successfully imported extension module "%s".zFailed loading extension "%s".NNNzFailed to initiate extension 'z': rL)dictr get_installed_extensionsnameloadsplit importlib import_moduler]r^ ImportErrorargsgetattr makeExtensionAttributeError) rBrfr"ep entry_pointsrc class_namemoduleemessages &&& rDr[Markdown.build_extensionsS&w-%)%B%B%D\%DrS[H[%D \ q/&&(C>> !:=x~~c15xY[n ,,X6F LL>I  6.99 9 ++6g661] 6AGZ!&&*,AF  " &&)(0';!affRj0  s:C'C' 2C,D), D&7*D!!D&) E74>E22E7c V^8dQhRRRR/#)rJ extensionrrKrrL)rMs"rDrNrOs  9  rGc <VPPV4V#)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." )r8appendrBrs&&rDregisterExtensionMarkdown.registerExtensions !!((3 rGcV^8dQhRR/#rIrL)rMs"rDrNrOsxrGc VPP4VPP4VPF'p\ VR4'gKVP4K) V#)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]. rA)r>rAr<clearr8hasattrrs& rDrAMarkdown.resetsR  22Iy'**!3 rGc V^8dQhRRRR/#)rJrMrZrKrrL)rMs"rDrNrOsrGc VP4PR4VnVPVP,VnV# \ dp\ TPP44pTP4RTP: RRRPT4,R,: R2pT3TPR,,Tn hRp?ii;i) 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", "r2riN) lowerrstripr#r serializerKeyErrorlistkeyssortjoinrs)rBrMr{ valid_formatsr|s&& rDr@Markdown.set_output_formats$\\^2259 "11$2D2DEDO   !4!4!9!9!;zz<%s />z4Markdown failed to strip top-level tags. Document=%r)striprZUnicodeDecodeErrorreasonrolinesrQrunrR parseDocumentgetrootrTrr:indexdoc_taglenrindex ValueErrorendswithrU) rBrr{preproot treeprocessornewRootoutputstartendpps && rDconvertMarkdown.convert;s@||~~ [F\\$' &&D$**-DJ'{{((4<<>"00M#''-G"1 &  ! ! ! R T\\)+-0->?ABCmmGdll$:;c*002%%BVVF^F&||~Q"  HHI IH  6 R<<>**8dll+BCCF%&9;A<<>&JKPQR  Rs6 F1A7G  G'GG H78H2!H22H7Nc(V^8dQhRRRRRRRR/#)rJinputzstr | BinaryIO | Nonerencodingz str | NonerKrrL)rMs"rDrNrOs8GG$G&G G  GrGc T;'gRpV'dc\V\4'd\VRVR7pM\P!V4!V4pVP 4pVP 4M\PP 4pVPR4pVPV4pV'd\V\4'd>\P!VRVRR7pVPV4VP 4V#\P!V4pV!VRR7pVPV4V#VPVR4p\PPPV4V#) a Read Markdown text from a file or stream and write HTML output to a file or stream. Decodes the input file using the provided encoding (defaults to `utf-8`), passes the file content to markdown, and outputs the HTML to either the provided stream or the file with provided name, using the same encoding as the source file. The [`xmlcharrefreplace`](https://docs.python.org/3/library/codecs.html#error-handlers) error handler is used when encoding the output. **Note:** This is the only place that decoding and encoding of Unicode takes place in Python-Markdown. (All other code is Unicode-in / Unicode-out.) Arguments: input: File object or path. Reads from `stdin` if `None`. output: File object or path. Writes to `stdout` if `None`. encoding: Encoding of input and output files. Defaults to `utf-8`. !!! warning The Python-Markdown library does ***not*** sanitize its HTML output. As `Markdown.convertFile` writes directly to the file system, there is no easy way to sanitize the output from Python code. Therefore, it is recommended that the `Markdown.convertFile` method not be used on input from an untrusted source. For more information see [Sanitizing HTML Output](../../sanitization.md). zutf-8r)moderuwxmlcharrefreplace)rerrors)r)rYrZopencodecs getreaderreadclosesysstdinlstriprwrite getwriterencodestdoutbuffer) rBrrr input_filetextr output_filewriters &&&& rD convertFileMarkdown.convertFiles?F&&w %%%!%cHE #--h7> ??$D    99>>#D{{8$||D! &#&&$kk1DF !!$'!!#  ))(3$V4GH !!$' ;;x)<=D JJ   # #D ) rG)r5r7r9r>rSrr#rRrUrQr<r8rr:rrT)NNN)rar` __qualname____firstlineno____doc__rrrr__annotations__rEr;r?r[rrAr@rrr__static_attributes__rLrGrDrr.sm<G ./ENA )V8"H3j  . M^GGrGc$V^8dQhRRRRRR/#)rJrrZrCrrKrL)rMs"rDrNrNs!3##rGc :\R/VBpVPV4#)a7 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. !!! warning The Python-Markdown library does ***not*** sanitize its HTML output. If you are processing Markdown input from an untrusted source, it is your responsibility to ensure that it is properly sanitized. For more information see [Sanitizing HTML Output](../../sanitization.md). rL)rr)rrCmds&, rDmarkdownrs 0  F B ::d rGcV^8dQhRR/#)rJrCrrL)rMs"rDrNrNs11s1rGc \R/VBpVPVPRR4VPRR4VPRR44R#)a Read Markdown text from a file or stream and write HTML output to a file or 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. !!! warning The Python-Markdown library does ***not*** sanitize its HTML output. As `markdown.markdownFromFile` writes directly to the file system, there is no easy way to sanitize the output from Python code. Therefore, it is recommended that the `markdown.markdownFromFile` function not be used on input from an untrusted source. For more information see [Sanitizing HTML Output](../../sanitization.md). rNrrrL)rrr4)rCrs, rDmarkdownFromFilersF.  F BNN6::gt,::h-::j$/1rG)rrr)( __future__rrrloggingrptypingrrrrrr r rr rQr blockprocessorsr rTrinlinepatternsrrUrr r serializersrrrxml.etree.ElementTreer__all__ getLoggerr]rrrrLrGrDrss(# VVV./000!8&- 6   : &ccL 81rG