def test_set_value_empty(self):
tag = XmpTag('Xmp.dc.creator')
self.assertEqual(tag.type, 'seq ProperName')
self.assertRaises(ValueError, setattr, tag, 'value', [])
tag = XmpTag('Xmp.dc.title')
self.assertEqual(tag.type, 'Lang Alt')
self.assertRaises(ValueError, setattr, tag, 'value', {})
def test_setitem(self):
self.metadata.read()
# Set new tags
key = 'Exif.Photo.ExposureBiasValue'
tag = ExifTag(key, make_fraction(0, 3))
self.metadata[key] = tag
self.failUnless(key in self.metadata._tags['exif'])
self.failUnlessEqual(self.metadata._tags['exif'][key], tag)
key = 'Iptc.Application2.City'
tag = IptcTag(key, ['Barcelona'])
self.metadata[key] = tag
self.failUnless(key in self.metadata._tags['iptc'])
self.failUnlessEqual(self.metadata._tags['iptc'][key], tag)
key = 'Xmp.dc.description'
tag = XmpTag(key, {'x-default': 'Sunset picture.'})
self.metadata[key] = tag
self.failUnless(key in self.metadata._tags['xmp'])
self.failUnlessEqual(self.metadata._tags['xmp'][key], tag)
# Replace existing tags
key = 'Exif.Photo.ExifVersion'
tag = ExifTag(key, '0220')
self.metadata[key] = tag
self.failUnless(key in self.metadata._tags['exif'])
self.failUnlessEqual(self.metadata._tags['exif'][key], tag)
key = 'Iptc.Application2.Caption'
tag = IptcTag(key, ['Sunset on Barcelona.'])
self.metadata[key] = tag
self.failUnless(key in self.metadata._tags['iptc'])
self.failUnlessEqual(self.metadata._tags['iptc'][key], tag)
key = 'Xmp.dc.subject'
tag = XmpTag(key, ['sunset', 'Barcelona', 'beautiful', 'beach'])
self.metadata[key] = tag
self.failUnless(key in self.metadata._tags['xmp'])
self.failUnlessEqual(self.metadata._tags['xmp'][key], tag)
def test_setitem(metadata_ro):
m = metadata_ro.metadata
m.read()
# Set new tags
key = 'Exif.Photo.ExposureBiasValue'
tag = ExifTag(key, make_fraction(0, 3))
m[key] = tag
assert key in m._tags['exif']
assert m._tags['exif'][key] == tag
key = 'Iptc.Application2.City'
tag = IptcTag(key, ['Barcelona'])
m[key] = tag
assert key in m._tags['iptc']
assert m._tags['iptc'][key] == tag
key = 'Xmp.dc.description'
tag = XmpTag(key, {'x-default': 'Sunset picture.'})
m[key] = tag
assert key in m._tags['xmp']
assert m._tags['xmp'][key] == tag
# Replace existing tags
key = 'Exif.Photo.ExifVersion'
tag = ExifTag(key, '0220')
m[key] = tag
assert key in m._tags['exif']
assert m._tags['exif'][key] == tag
key = 'Iptc.Application2.Caption'
tag = IptcTag(key, ['Sunset on Barcelona.'])
m[key] = tag
assert key in m._tags['iptc']
assert m._tags['iptc'][key] == tag
key = 'Xmp.dc.subject'
tag = XmpTag(key, ['sunset', 'Barcelona', 'beautiful', 'beach'])
m[key] = tag
assert key in m._tags['xmp']
assert m._tags['xmp'][key] == tag
def test_set_value_empty():
tag = XmpTag('Xmp.dc.creator')
assert tag.type == 'seq ProperName'
with pytest.raises(ValueError):
tag.value = []
tag = XmpTag('Xmp.dc.title')
assert tag.type == 'Lang Alt'
with pytest.raises(ValueError):
tag.value = {}
def test_set_value_incorrect_type(self):
# Expecting a list of values
tag = XmpTag('Xmp.dc.publisher')
self.assertEqual(tag.type, 'bag ProperName')
self.assertRaises(TypeError, setattr, tag, 'value', None)
self.assertRaises(TypeError, setattr, tag, 'value', 'bleh')
# Expecting a dictionary mapping language codes to values
tag = XmpTag('Xmp.dc.description')
self.assertEqual(tag.type, 'Lang Alt')
self.assertRaises(TypeError, setattr, tag, 'value', None)
self.assertRaises(TypeError, setattr, tag, 'value', ['bleh'])
def test_set_value_incorrect_type():
# Expecting a list of values
tag = XmpTag('Xmp.dc.publisher')
assert tag.type == 'bag ProperName'
with pytest.raises(TypeError):
tag.value = None
with pytest.raises(TypeError):
tag.value = 'bleh'
# Expecting a dictionary mapping language codes to values
tag = XmpTag('Xmp.dc.description')
assert tag.type == 'Lang Alt'
with pytest.raises(TypeError):
tag.value = None
with pytest.raises(TypeError):
tag.value = ['bleh']
def test_convert_to_python_bag(self):
# Valid values
tag = XmpTag('Xmp.dc.subject')
self.assertEqual(tag.type, 'bag Text')
self.assertEqual(tag._convert_to_python('', 'Text'), u'')
self.assertEqual(tag._convert_to_python('One value only', 'Text'),
u'One value only')
def test_convert_to_string_bag(self):
# Valid values
tag = XmpTag('Xmp.dc.Subject')
self.assertEqual(tag._convert_to_string('', 'Text'), b'')
self.assertEqual(tag._convert_to_string('One value only', 'Text'),
b'One value only')
# Invalid values
self.assertRaises(XmpValueError, tag._convert_to_string, [1, 2, 3],
'Text')
def test_set_xmp_tag_overwrite(metadata_ro):
m = metadata_ro.metadata
m.read()
assert m._tags['xmp'] == {}
# Overwrite an existing tag
tag = XmpTag('Xmp.dc.format', ('image', 'png'))
m._set_xmp_tag(tag.key, tag)
assert m._tags['xmp'] == {tag.key: tag}
assert tag.key in m._image._xmpKeys()
assert m._image._getXmpTag(tag.key)._getTextValue() == tag.raw_value
def test_convert_to_python_date(self):
# Valid values
tag = XmpTag('Xmp.xmp.CreateDate')
self.assertEqual(tag.type, 'Date')
self.assertEqual(tag._convert_to_python('1999', 'Date'),
datetime.date(1999, 1, 1))
self.assertEqual(tag._convert_to_python('1999-10', 'Date'),
datetime.date(1999, 10, 1))
self.assertEqual(tag._convert_to_python('1999-10-13', 'Date'),
datetime.date(1999, 10, 13))
self.assertEqual(tag._convert_to_python('1999-10-13T05:03Z', 'Date') - \
datetime.datetime(1999, 10, 13, 5, 3, tzinfo=FixedOffset()),
datetime.timedelta(0))
self.assertEqual(tag._convert_to_python('1999-10-13T05:03+06:00', 'Date') - \
datetime.datetime(1999, 10, 13, 5, 3, tzinfo=FixedOffset('+', 6, 0)),
datetime.timedelta(0))
self.assertEqual(tag._convert_to_python('1999-10-13T05:03-06:00', 'Date') - \
datetime.datetime(1999, 10, 13, 5, 3, tzinfo=FixedOffset('-', 6, 0)),
datetime.timedelta(0))
self.assertEqual(tag._convert_to_python('1999-10-13T05:03:54Z', 'Date') - \
datetime.datetime(1999, 10, 13, 5, 3, 54, tzinfo=FixedOffset()),
datetime.timedelta(0))
self.assertEqual(tag._convert_to_python('1999-10-13T05:03:54+06:00', 'Date') - \
datetime.datetime(1999, 10, 13, 5, 3, 54, tzinfo=FixedOffset('+', 6, 0)),
datetime.timedelta(0))
self.assertEqual(tag._convert_to_python('1999-10-13T05:03:54-06:00', 'Date') - \
datetime.datetime(1999, 10, 13, 5, 3, 54, tzinfo=FixedOffset('-', 6, 0)),
datetime.timedelta(0))
self.assertEqual(tag._convert_to_python('1999-10-13T05:03:54.721Z', 'Date') - \
datetime.datetime(1999, 10, 13, 5, 3, 54, 721000, tzinfo=FixedOffset()),
datetime.timedelta(0))
self.assertEqual(tag._convert_to_python('1999-10-13T05:03:54.721+06:00', 'Date') - \
datetime.datetime(1999, 10, 13, 5, 3, 54, 721000, tzinfo=FixedOffset('+', 6, 0)),
datetime.timedelta(0))
self.assertEqual(tag._convert_to_python('1999-10-13T05:03:54.721-06:00', 'Date') - \
datetime.datetime(1999, 10, 13, 5, 3, 54, 721000, tzinfo=FixedOffset('-', 6, 0)),
datetime.timedelta(0))
# Invalid values
self.assertRaises(XmpValueError, tag._convert_to_python, 'invalid',
'Date')
self.assertRaises(XmpValueError, tag._convert_to_python, '11/10/1983',
'Date')
self.assertRaises(XmpValueError, tag._convert_to_python, '-1000',
'Date')
self.assertRaises(XmpValueError, tag._convert_to_python, '2009-13',
'Date')
self.assertRaises(XmpValueError, tag._convert_to_python, '2009-10-32',
'Date')
self.assertRaises(XmpValueError, tag._convert_to_python,
'2009-10-30T25:12Z', 'Date')
self.assertRaises(XmpValueError, tag._convert_to_python,
'2009-10-30T23:67Z', 'Date')
self.assertRaises(XmpValueError, tag._convert_to_python,
'2009-01-22T21', 'Date')
def test_convert_to_string_boolean(self):
# Valid values
tag = XmpTag('Xmp.xmpRights.Marked')
self.assertEqual(tag.type, 'Boolean')
self.assertEqual(tag._convert_to_string(True, 'Boolean'), 'True')
self.assertEqual(tag._convert_to_string(False, 'Boolean'), 'False')
# Invalid values
self.assertRaises(XmpValueError, tag._convert_to_string, 'invalid',
'Boolean')
self.assertRaises(XmpValueError, tag._convert_to_string, None,
'Boolean')
def test_convert_to_python_boolean(self):
# Valid values
tag = XmpTag('Xmp.xmpRights.Marked')
self.assertEqual(tag.type, 'Boolean')
self.assertEqual(tag._convert_to_python('True', 'Boolean'), True)
self.assertEqual(tag._convert_to_python('False', 'Boolean'), False)
# Invalid values: not converted
self.assertRaises(XmpValueError, tag._convert_to_python, 'invalid',
'Boolean')
self.assertRaises(XmpValueError, tag._convert_to_python, None,
'Boolean')
def test_convert_to_string_integer(self):
# Valid values
tag = XmpTag('Xmp.xmpMM.SaveID')
self.assertEqual(tag.type, 'Integer')
self.assertEqual(tag._convert_to_string(123, 'Integer'), '123')
self.assertEqual(tag._convert_to_string(-57, 'Integer'), '-57')
# Invalid values
self.assertRaises(XmpValueError, tag._convert_to_string, 'invalid',
'Integer')
self.assertRaises(XmpValueError, tag._convert_to_string, 3.14,
'Integer')
def _set_xmp_tag(self, key, tag_or_value):
# Set an XMP tag. If the tag already exists, its value is overwritten.
if isinstance(tag_or_value, XmpTag):
tag = tag_or_value
else:
# As a handy shortcut, accept direct value assignment.
tag = XmpTag(key, tag_or_value)
tag._set_owner(self)
self._tags['xmp'][tag.key] = tag
if tag.key not in self.xmp_keys:
self._keys['xmp'].append(tag.key)
def test_convert_to_string_url(self):
# Valid values
tag = XmpTag('Xmp.xmp.BaseURL')
self.assertEqual(tag.type, 'URL')
self.assertEqual(tag._convert_to_string('http://example.com', 'URL'),
b'http://example.com')
self.assertEqual(
tag._convert_to_string('http://localhost:8000/resource', 'URL'),
b'http://localhost:8000/resource')
# Invalid values
self.assertRaises(XmpValueError, tag._convert_to_string, None, 'URL')
def test_convert_to_python_url(self):
# Valid values
tag = XmpTag('Xmp.xmp.BaseURL')
self.assertEqual(tag.type, 'URL')
self.assertEqual(tag._convert_to_python('http://example.com', 'URL'),
'http://example.com')
self.assertEqual(tag._convert_to_python('https://example.com', 'URL'),
'https://example.com')
self.assertEqual(
tag._convert_to_python('http://localhost:8000/resource', 'URL'),
'http://localhost:8000/resource')
def test_convert_to_string_text(self):
# Valid values
tag = XmpTag('Xmp.dc.Source')
self.assertEqual(tag._convert_to_string('Some text', 'Text'),
b'Some text')
self.assertEqual(
tag._convert_to_string('Some text with exotic chàräctérʐ.',
'Text'),
b'Some text with exotic ch\xc3\xa0r\xc3\xa4ct\xc3\xa9r\xca\x90.')
# Invalid values
self.assertRaises(XmpValueError, tag._convert_to_string, None, 'Text')
def test_set_xmp_tag_overwrite(self):
self.metadata.read()
self.assertEqual(self.metadata._tags['xmp'], {})
# Overwrite an existing tag
tag = XmpTag('Xmp.dc.format', ('image', 'png'))
self.metadata._set_xmp_tag(tag.key, tag)
self.assertEqual(self.metadata._tags['xmp'], {tag.key: tag})
self.assert_(tag.key in self.metadata._image._xmpKeys())
self.assertEqual(
self.metadata._image._getXmpTag(tag.key)._getTextValue(),
tag.raw_value)
def test_set_value():
tag = XmpTag('Xmp.xmp.ModifyDate', DT(2005,
9,
7,
15,
9,
51,
tz=('-', 7, 0)))
old_value = tag.value
tag.value = DT(2009, 4, 22, 8, 30, 27)
assert tag.value != old_value
def test_convert_to_string_rational(self):
# Valid values
tag = XmpTag('Xmp.xmpDM.videoPixelAspectRatio')
self.assertEqual(tag.type, 'Rational')
self.assertEqual(
tag._convert_to_string(make_fraction(5, 3), 'Rational'), '5/3')
self.assertEqual(
tag._convert_to_string(make_fraction(-5, 3), 'Rational'), '-5/3')
# Invalid values
self.assertRaises(XmpValueError, tag._convert_to_string, 'invalid',
'Rational')
def test_convert_to_python_propername(self):
# Valid values
tag = XmpTag('Xmp.photoshop.CaptionWriter')
self.assertEqual(tag.type, 'ProperName')
self.assertEqual(tag._convert_to_python('Gérard', 'ProperName'),
u'Gérard')
self.assertEqual(
tag._convert_to_python('Python Software Foundation', 'ProperName'),
u'Python Software Foundation')
# Invalid values
self.failUnlessRaises(XmpValueError, tag._convert_to_python, None,
'ProperName')
def test_convert_to_python_text(self):
# Valid values
tag = XmpTag('Xmp.dc.source')
self.assertEqual(tag.type, 'Text')
self.assertEqual(tag._convert_to_python('Some text.', 'Text'),
'Some text.')
self.assertEqual(
tag._convert_to_python(
b'Some text with exotic ch\xc3\xa0r\xc3\xa4ct\xc3\xa9r\xca\x90.',
'Text'), 'Some text with exotic chàräctérʐ.')
# Invalid values
self.assertRaises(XmpValueError, tag._convert_to_python(None, 'Text'))
def test_convert_to_string_propername(self):
# Valid values
tag = XmpTag('Xmp.photoshop.CaptionWriter')
self.assertEqual(tag.type, 'ProperName')
self.assertEqual(tag._convert_to_string('Gérard', 'ProperName'),
b'G\xc3\xa9rard')
self.assertEqual(
tag._convert_to_string('Python Software Foundation', 'ProperName'),
b'Python Software Foundation')
# Invalid values
self.assertRaises(XmpValueError, tag._convert_to_string, None,
'ProperName')
def test_convert_to_string_bag(self):
# Valid values
tag = XmpTag('Xmp.dc.subject')
self.assertEqual(tag.type, 'bag Text')
self.assertEqual(tag._convert_to_string(u'', 'Text'), '')
self.assertEqual(tag._convert_to_string('One value only', 'Text'),
'One value only')
self.assertEqual(tag._convert_to_string(u'One value only', 'Text'),
'One value only')
# Invalid values
self.failUnlessRaises(XmpValueError, tag._convert_to_string, [1, 2, 3],
'Text')
def test_convert_to_python_mimetype(self):
# Valid values
tag = XmpTag('Xmp.dc.format')
self.assertEqual(tag.type, 'MIMEType')
self.assertEqual(tag._convert_to_python('image/jpeg', 'MIMEType'),
('image', 'jpeg'))
self.assertEqual(tag._convert_to_python('video/ogg', 'MIMEType'),
('video', 'ogg'))
# Invalid values
self.failUnlessRaises(XmpValueError, tag._convert_to_python, 'invalid',
'MIMEType')
self.failUnlessRaises(XmpValueError, tag._convert_to_python,
'image-jpeg', 'MIMEType')
def test_set_xmp_tag_overwrite_already_cached(metadata_ro):
m = metadata_ro.metadata
m.read()
assert m._tags['xmp'] == {}
# Overwrite an existing tag already cached
key = 'Xmp.dc.subject'
tag = m._get_xmp_tag(key)
assert m._tags['xmp'][key] == tag
new_tag = XmpTag(key, ['hello', 'world'])
m._set_xmp_tag(key, new_tag)
assert m._tags['xmp'] == {key: new_tag}
assert key in m._image._xmpKeys()
assert m._image._getXmpTag(key)._getArrayValue() == ['hello', 'world']
def test_convert_to_string_mimetype(self):
# Valid values
tag = XmpTag('Xmp.dc.format')
self.assertEqual(tag.type, 'MIMEType')
self.assertEqual(tag._convert_to_string(('image', 'jpeg'), 'MIMEType'),
'image/jpeg')
self.assertEqual(tag._convert_to_string(('video', 'ogg'), 'MIMEType'),
'video/ogg')
# Invalid values
self.assertRaises(XmpValueError, tag._convert_to_string, 'invalid',
'MIMEType')
self.assertRaises(XmpValueError, tag._convert_to_string, ('image', ),
'MIMEType')
def test_convert_to_python_text(self):
# Valid values
tag = XmpTag('Xmp.dc.source')
self.assertEqual(tag.type, 'Text')
self.assertEqual(tag._convert_to_python('Some text.', 'Text'),
u'Some text.')
self.assertEqual(
tag._convert_to_python('Some text with exotic chàräctérʐ.',
'Text'),
u'Some text with exotic chàräctérʐ.')
# Invalid values
self.failUnlessRaises(XmpValueError, tag._convert_to_python, None,
'Text')
def test_pickle_xmp_tag(self):
tags = []
tags.append(XmpTag('Xmp.dc.subject', ['foo', 'bar', 'baz']))
tags.append(XmpTag('Xmp.xmpRights.Marked', True))
tags.append(XmpTag('Xmp.xmp.CreateDate', datetime.date.today()))
tags.append(XmpTag('Xmp.xmpMM.SaveID', 34))
tags.append(XmpTag('Xmp.dc.format', ('image', 'jpeg')))
tags.append(XmpTag('Xmp.photoshop.CaptionWriter', 'John Doe'))
tags.append(XmpTag('Xmp.dc.source', 'bleh'))
tags.append(XmpTag('Xmp.xmpMM.DocumentID', 'http://example.com'))
tags.append(XmpTag('Xmp.xmp.BaseURL', 'http://example.com'))
tags.append(XmpTag('Xmp.xmpDM.videoPixelAspectRatio', make_fraction(5, 3)))
for tag in tags:
s = pickle.dumps(tag)
t = pickle.loads(s)
self.assert_(isinstance(t, XmpTag))
self.assertEqual(t.key, tag.key)
self.assertEqual(t.type, tag.type)
self.assertEqual(t.name, tag.name)
self.assertEqual(t.title, tag.title)
self.assertEqual(t.description, tag.description)
self.assertEqual(t.raw_value, tag.raw_value)
self.assertEqual(t.value, tag.value)
def test_set_xmp_tag_overwrite_already_cached(self):
self.metadata.read()
self.assertEqual(self.metadata._tags['xmp'], {})
# Overwrite an existing tag already cached
key = 'Xmp.dc.subject'
tag = self.metadata._get_xmp_tag(key)
self.assertEqual(self.metadata._tags['xmp'][key], tag)
new_tag = XmpTag(key, ['hello', 'world'])
self.metadata._set_xmp_tag(key, new_tag)
self.assertEqual(self.metadata._tags['xmp'], {key: new_tag})
self.assert_(key in self.metadata._image._xmpKeys())
self.assertEqual(
self.metadata._image._getXmpTag(key)._getArrayValue(),
['hello', 'world'])
