Skip to content

smart_strong

Smart_Strong Extension for Python-Markdown.

This extention adds smarter handling of double underscores within words.

See https://pythonhosted.org/Markdown/extensions/smart_strong.html for documentation.

Original code Copyright 2011 Waylan Limberg

All changes Copyright 2011-2014 The Python Markdown Project

License: BSD

Attributes

SMART_STRONG_RE = '(?<!\\w)(_{2})(?!_)(.+?)(?<!_)\\2(?!\\w)' module-attribute

STRONG_RE = '(\\*{2})(.+?)\\2' module-attribute

Classes

SmartEmphasisExtension(*args, **kwargs)

Bases: Extension

Add smart_emphasis extension to Markdown class.

Initiate Extension and set up configs.

Source code in pyrevitlib/pyrevit/coreutils/markdown/extensions/__init__.py 
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
def __init__(self, *args, **kwargs):
    """Initiate Extension and set up configs."""
    # check for configs arg for backward compat.
    # (there only ever used to be one so we use arg[0])
    if len(args):
        if args[0] is not None:
            self.setConfigs(args[0])
        warnings.warn(
            "Extension classes accepting positional args is "
            "pending Deprecation. Each setting should be "
            "passed into the Class as a keyword. Positional "
            "args are deprecated and will raise "
            "an error in version 2.7. See the Release Notes for "
            "Python-Markdown version 2.6 for more info.",
            DeprecationWarning,
        )
    # check for configs kwarg for backward compat.
    if "configs" in kwargs.keys():
        if kwargs["configs"] is not None:
            self.setConfigs(kwargs.pop("configs", {}))
        warnings.warn(
            "Extension classes accepting a dict on the single "
            'keyword "config" is pending Deprecation. Each '
            "setting should be passed into the Class as a "
            'keyword directly. The "config" keyword is '
            "deprecated and raise an error in "
            "version 2.7. See the Release Notes for "
            "Python-Markdown version 2.6 for more info.",
            DeprecationWarning,
        )
    # finally, use kwargs
    self.setConfigs(kwargs)

Attributes

config = {} class-attribute instance-attribute

Methods:

extendMarkdown(md, md_globals)

Modify inline patterns.

Source code in pyrevitlib/pyrevit/coreutils/markdown/extensions/smart_strong.py 
27
28
29
30
31
32
def extendMarkdown(self, md, md_globals):
    """Modify inline patterns."""
    md.inlinePatterns["strong"] = SimpleTagPattern(STRONG_RE, "strong")
    md.inlinePatterns.add(
        "strong2", SimpleTagPattern(SMART_STRONG_RE, "strong"), ">emphasis2"
    )
getConfig(key, default='')

Return a setting for the given key or an empty string.

Source code in pyrevitlib/pyrevit/coreutils/markdown/extensions/__init__.py 
53
54
55
56
57
58
def getConfig(self, key, default=""):
    """Return a setting for the given key or an empty string."""
    if key in self.config:
        return self.config[key][0]
    else:
        return default
getConfigs()

Return all configs settings as a dict.

Source code in pyrevitlib/pyrevit/coreutils/markdown/extensions/__init__.py 
60
61
62
def getConfigs(self):
    """Return all configs settings as a dict."""
    return dict([(key, self.getConfig(key)) for key in self.config.keys()])
getConfigInfo()

Return all config descriptions as a list of tuples.

Source code in pyrevitlib/pyrevit/coreutils/markdown/extensions/__init__.py 
64
65
66
def getConfigInfo(self):
    """Return all config descriptions as a list of tuples."""
    return [(key, self.config[key][1]) for key in self.config.keys()]
setConfig(key, value)

Set a config setting for key with the given value.

Source code in pyrevitlib/pyrevit/coreutils/markdown/extensions/__init__.py 
68
69
70
71
72
73
74
def setConfig(self, key, value):
    """Set a config setting for `key` with the given `value`."""
    if isinstance(self.config[key][0], bool):
        value = parseBoolValue(value)
    if self.config[key][0] is None:
        value = parseBoolValue(value, preserve_none=True)
    self.config[key][0] = value
setConfigs(items)

Set multiple config settings given a dict or list of tuples.

Source code in pyrevitlib/pyrevit/coreutils/markdown/extensions/__init__.py 
76
77
78
79
80
81
82
def setConfigs(self, items):
    """Set multiple config settings given a dict or list of tuples."""
    if hasattr(items, "items"):
        # it's a dict
        items = items.items()
    for key, value in items:
        self.setConfig(key, value)

Functions:

makeExtension(*args, **kwargs)

Source code in pyrevitlib/pyrevit/coreutils/markdown/extensions/smart_strong.py 
35
36
def makeExtension(*args, **kwargs):
    return SmartEmphasisExtension(*args, **kwargs)