*surround text with given characters*

        **Key Arguments:**
            - ``text`` -- the text to surround.
            - ``left`` -- characters to the left of text
            - ``right`` -- characters to the right of text

        **Return:**
            - ``text`` -- the surronded text

def _surround(
            self,
            text,
            left,
            right):
        """*surround text with given characters*

        **Key Arguments:**
            - ``text`` -- the text to surround.
            - ``left`` -- characters to the left of text
            - ``right`` -- characters to the right of text

        **Return:**
            - ``text`` -- the surronded text
        """
        self.log.debug('starting the ``_surround`` method')

        prefix, text, suffix = self._snip_whitespace(text)

        text = text.replace("\n\n\n", "\n\n").replace("\n\n\n", "\n\n").replace(
            "\n\n\n", "\n\n").replace("\n\n\n", "\n\n").replace("\n\n", "%(right)s\n\n%(left)s" % locals())

        text = """%(prefix)s%(left)s%(text)s%(right)s%(suffix)s""" % locals()

        self.log.debug('completed the ``_surround`` method')
        return text