U \>e@sVdZddlmZddlmZmZmZmZddlm Z erDddl m Z GdddZ d S) a Markdown accepts an [`Extension`][markdown.extensions.Extension] instance for each extension. Therefore, each extension must to define a class that extends [`Extension`][markdown.extensions.Extension] and over-rides the [`extendMarkdown`][markdown.extensions.Extension.extendMarkdown] method. Within this class one can manage configuration options for their extension and attach the various processors and patterns which make up an extension to the [`Markdown`][markdown.Markdown] instance. ) annotations) TYPE_CHECKINGAnyIterableMapping)parseBoolValue)Markdownc@seZdZUdZiZded<ddZd dddd d d Zd d ddZdd ddZ ddddddZ dddddZ dddddZ dS)! Extensionz( Base class for extensions to subclass. zMapping[str, list]configcKs||dS)z( Initiate Extension and set up configs. N) setConfigs)selfkwargsr@/tmp/pip-unpacked-wheel-wj0og6ym/markdown/extensions/__init__.py__init__8szExtension.__init__strr)keydefaultreturncCs ||jkr|j|dS|SdS)a Return a single configuration option value. Arguments: key: The configuration option name. default: Default value to return if key is not set. Returns: Value of stored configuration option. rNr )r rrrrr getConfig<s zExtension.getConfigzdict[str, Any])rcsfddjDS)zl Return all configuration options. Returns: All configuration options. csi|]}||qSr)r.0rr rr Ssz(Extension.getConfigs..r keysrrrr getConfigsLszExtension.getConfigszlist[tuple[str, str]]csfddjDS)z Return descriptions of all configuration options. Returns: All descriptions of configuration options. csg|]}|j|dfqS)rrrrr \sz+Extension.getConfigInfo..rrrrr getConfigInfoUszExtension.getConfigInfoNone)rvaluercCsLt|j|dtrt|}|j|ddkr:t|dd}||j|d<dS)a Set a configuration option. If the corresponding default value set in [`config`][markdown.extensions.Extension.config] is a `bool` value or `None`, then `value` is passed through [`parseBoolValue`][markdown.util.parseBoolValue] before being stored. Arguments: key: Name of configuration option to set. value: Value to assign to option. Raises: KeyError: If `key` is not known. rNT)Z preserve_none) isinstancer boolr)r rr$rrr setConfig^s  zExtension.setConfigz-Mapping[str, Any] | Iterable[tuple[str, Any]])itemsrcCs0t|dr|}|D]\}}|||qdS)a Loop through a collection of configuration options, passing each to [`setConfig`][markdown.extensions.Extension.setConfig]. Arguments: items: Collection of configuration options. Raises: KeyError: for any unknown key. r(N)hasattrr(r')r r(rr$rrrr ss  zExtension.setConfigsr )mdrcCstd|jj|jjfdS)z Add the various processors and patterns to the Markdown Instance. This method must be overridden by every extension. Arguments: md: The Markdown instance. z8Extension "%s.%s" must define an "extendMarkdown"method.N)NotImplementedError __class__ __module____name__)r r*rrrextendMarkdowns zExtension.extendMarkdownN)r) r.r- __qualname____doc__r __annotations__rrrr"r'r r/rrrrr %s    r N) r1 __future__rtypingrrrrutilrZmarkdownr r rrrrs