======================
 Test Message Catalog
======================

The test message catalog "translates" test by simply outputing (in
unicode) the domain and message id in square-bracket markers:

    >>> import zope.i18n.testmessagecatalog
    >>> cat = zope.i18n.testmessagecatalog.TestMessageCatalog('foo.bar')

    >>> cat.language, cat.domain
    ('test', 'foo.bar')

    >>> print(cat.queryMessage('eek'))
    [[foo.bar][eek]]

    >>> print(cat.getMessage('eek'))
    [[foo.bar][eek]]

    >>> isinstance(cat.getMessage('eek'), str if bytes is not str else unicode)
    True

    >>> cat.getIdentifier()
    'test'

    >>> cat.reload()

If a message id has a default, it will be included in the output:

    >>> id = zope.i18nmessageid.MessageFactory('foo.bar')('eek', default='Eek')

    >>> print(cat.queryMessage(id))
    [[foo.bar][eek (Eek)]]

    >>> print(cat.getMessage(id))
    [[foo.bar][eek (Eek)]]

If a message doesn't have a default, but a default is passed in to
queryMessage, the default will be used used:

    >>> print(cat.queryMessage('eek', default='Eek'))
    [[foo.bar][eek (Eek)]]

    >>> print(cat.getMessage(id, default='Waaa'))
    [[foo.bar][eek (Eek)]]

Fallback domains
================

The testmessagecatalog module also provide a fallback domain factory
that has the test catalog as it's only catalog:

    >>> factory = zope.i18n.testmessagecatalog.TestMessageFallbackDomain
    >>> import zope.i18n.interfaces
    >>> zope.i18n.interfaces.IFallbackTranslationDomainFactory.providedBy(
    ...     factory)
    True

    >>> domain = factory('foo.bar')
    >>> print(domain.translate('eek'))
    eek

    >>> print(domain.translate('eek', target_language='test'))
    [[foo.bar][eek]]

Note that if a default is padded in, it will be included in test
output:

    >>> print(domain.translate('eek', target_language='test', default='Eek'))
    [[foo.bar][eek (Eek)]]