/usr/lib/python3/dist-packages/libxmp/utils.py is in python3-libxmp 2.0.1~git20140309.5437b0a-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 | # -*- coding: utf-8 -*-
#
# Copyright (c) 2008-2009, European Space Agency & European Southern
# Observatory (ESA/ESO)
# Copyright (c) 2008-2009, CRS4 - Centre for Advanced Studies, Research and
# Development in Sardinia
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# * Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.
#
# * Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
#
# * Neither the name of the European Space Agency, European Southern
# Observatory, CRS4 nor the names of its contributors may be used to
# endorse or promote products derived from this software without specific
# prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY ESA/ESO AND CRS4 ``AS IS'' AND ANY EXPRESS OR
# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
# EVENT SHALL ESA/ESO BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
# WHETHER # IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE
"""
Helper utilities.
"""
from . import XMPError
from .files import XMPFiles
import os
from .exempi import EXEMPI as _cexempi
__all__ = ['terminate', 'object_to_dict', 'file_to_dict']
def object_to_dict(xmp):
"""
Extracts all XMP data from a given XMPMeta instance organizing it into a
standard Python dictionary.
"""
dxmp = dict()
if not xmp:
return {}
for item in xmp:
if item[-1]['IS_SCHEMA']:
dxmp[item[0]] = []
else:
dxmp[item[0]].append(item[1:])
return dxmp
def file_to_dict(file_path):
"""
Extracts all XMP data from a given file organizing it into a standard Python
dictionary.
:param file_path: Path to file to open.
:return: An empty dictionary if there's no valid XMP in the file passed as
an argument.
"""
if not os.path.exists(file_path):
raise IOError("No such file or directory: '{0}'".format(file_path))
xmpfile = XMPFiles()
try:
xmpfile.open_file( file_path, open_read=True )
xmp = xmpfile.get_xmp()
except XMPError:
return {}
return object_to_dict(xmp)
def terminate():
"""
Terminate usage of library.
Normally function should not be called. Cases however might exists
where memory clean-up is needed, then this method may be called.
.. warning::
After this function have been called, any call to methods in
libxmp will result in a crash of Python.
"""
_cexempi.xmp_terminate()
|