Type Message

object --+        
         |        
basestring --+    
             |    
       unicode --+
                 |
                Message

Message (Python implementation)

This is a string used as a message. It has a domain attribute that is its source domain, and a default attribute that is its default text to display when there is no translation. domain may be None meaning there is no translation domain. default may also be None, in which case the message id itself implicitly serves as the default text.

These are the doc tests from message.txt. Note that we have to create the message manually since MessageFactory would return the C implementation.

>>> from zope.i18nmessageid.message import pyMessage as Message
>>> robot = Message(u"robot-message", 'futurama', u"${name} is a robot.")

>>> robot
u'robot-message'
>>> isinstance(robot, unicode)
True

>>> robot.default
u'${name} is a robot.'
>>> robot.mapping
>>> 

Only the python implementation has a _readonly attribute >>> robot._readonly True

>>> robot.domain = "planetexpress"
Traceback (most recent call last):
...
TypeError: readonly attribute

>>> robot.default = u"${name} is not a robot."
Traceback (most recent call last):
...
TypeError: readonly attribute

>>> robot.mapping = {u'name': u'Bender'}
Traceback (most recent call last):
...
TypeError: readonly attribute

>>> new_robot = Message(robot, mapping={u'name': u'Bender'})
>>> new_robot
u'robot-message'
>>> new_robot.domain
'futurama'
>>> new_robot.default
u'${name} is a robot.'
>>> new_robot.mapping
{u'name': u'Bender'}

>>> callable, args = new_robot.__reduce__()
>>> callable is Message
True
>>> args
(u'robot-message', 'futurama', u'${name} is a robot.', {u'name': u'Bender'})

>>> fembot = Message(u'fembot')
>>> callable, args = fembot.__reduce__()
>>> callable is Message
True
>>> args
(u'fembot', None, None, None)

Change classes for pickle tests >>> import zope.i18nmessageid.message >>> oldMessage = zope.i18nmessageid.message.Message >>> zope.i18nmessageid.message.Message = Message

At first check if pickling and unpicklung from pyMessage to pyMessage works >>> from pickle import dumps, loads >>> pystate = dumps(new_robot) >>> pickle_bot = loads(pystate) >>> pickle_bot, pickle_bot.domain, pickle_bot.default, pickle_bot.mapping (u'robot-message', 'futurama', u'${name} is a robot.', {u'name': u'Bender'}) >>> pickle_bot._readonly True >>> from zope.i18nmessageid.message import pyMessage >>> pickle_bot.__reduce__()[0] is pyMessage True >>> del pickle_bot

At second check if cMessage is able to load the state of a pyMessage >>> from _zope_i18nmessageid_message import Message >>> zope.i18nmessageid.message.Message = Message >>> c_bot = loads(pystate) >>> c_bot, c_bot.domain, c_bot.default, c_bot.mapping (u'robot-message', 'futurama', u'${name} is a robot.', {u'name': u'Bender'}) >>> c_bot._readonly Traceback (most recent call last): AttributeError: 'zope.i18nmessageid.message.Message' object has no attribute '_readonly' >>> from _zope_i18nmessageid_message import Message as cMessage >>> c_bot.__reduce__()[0] is cMessage True

At last check if pyMessage can load a state of cMessage >>> cstate = dumps(c_bot) >>> del c_bot >>> from zope.i18nmessageid.message import pyMessage as Message >>> zope.i18nmessageid.message.Message = Message >>> py_bot = loads(cstate) >>> py_bot, py_bot.domain, py_bot.default, py_bot.mapping (u'robot-message', 'futurama', u'${name} is a robot.', {u'name': u'Bender'}) >>> py_bot._readonly True >>> py_bot.__reduce__()[0] is pyMessage True

Both pickle states should be equal >>> pystate == cstate True

Finally restore classes for other unit tests >>> zope.i18nmessageid.message.Message = oldMessage