Method newString

Lib/pagebot/contexts/basecontext/basecontext.py:989–1010

Creates a new BabelString instance from `bs` (converted to plain unicode string), using style as typographic parameters or `e` as cascading style source. Ignore and just answer `bs` if it is already a BabelString instance and no style is forced. PageBot function. >>

(self, bs=None, style=None, w=None, h=None)

    # String.

    def newString(self, bs=None, style=None, w=None, h=None):
        """Creates a new BabelString instance from `bs` (converted to plain
        unicode string), using style as typographic parameters or `e` as
        cascading style source.  Ignore and just answer `bs` if it is already a
        BabelString instance and no style is forced. PageBot function.

        >>> from pagebot.toolbox.units import pt
        >>> from pagebot.contexts import getContext
        >>> context = getContext()
        >>> bs = context.newString('ABCD', dict(fontSize=pt(12)))
        >>> bs, bs.__class__.__name__
        ($ABCD$, 'BabelString')
        """
        style = makeStyle(style=style)
        if not bs:
            bs = ''
        if not isinstance(bs, BabelString):
            # Otherwise convert bs into a BabelString, from whatever it is now.
            # Set the babelString.context as self.
            bs = BabelString(bs, style=style, w=w, h=h, context=self)
        assert isinstance(bs, BabelString)
        return bs

    def newBulletString(self, bullet, style=None):
        return self.newString(bullet, style=style)