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
def _surround ( self , text , left , right ) : 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
*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