Metadata-Version: 2.1
Name: exiv2
Version: 0.3.1
Summary: Exiv2 wrapper for Python >= 3.4 on Windows
Home-page: https://bitbucket.org/zmic/exiv2-python
Author: Michael Vanslembrouck
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Requires-Python: >=3.4

=================
What is it?
=================

Low-level wrapper for exiv2 for python >= 3.3 that pip-installs on Windows.

* only works on Windows. 
* only supports Iptc for now. Exif and Xmp are on their  way.
* straight-up exposure of the C++ methods. Feel free to write more pythonic classes on top.

How do I set it up?
-------------------------------

* pip install exiv2

Example
-------------------------------
::

    import exiv2
    from PIL import Image

    def example(path):
        ''' Open an image on disk and get one piece of IPC data.
        '''
        with open(path, "rb") as f:
            imdata = f.read()
        im = exiv2.ImageFactory.open(imdata)
        im.readMetadata()    
        ipc_data = im.iptcData()
        # exiv2 method "toString()" actually returns bytes, so we have to decode it
        info = ipc_data[b'Iptc.Application2.Caption'].toString().decode('utf-8')
        return info

    def example2():
        ''' Open image, change IPTC data and save the image.
        '''
        image = exiv2.ImageFactory.open(r"c:\test\test.jpg")
        image.readMetadata()
        ipc_data = image.iptcData()
        for datum in ipc_data:
            print(datum.key(), datum.value().toString())
        ipc_data[b'Iptc.Application2.Subject'] = b'subject'
        image.writeMetadata()

    def example3():
        ''' Open image in memory
        '''    
        with open(r"c:\test\test.jpg", "rb") as f:
            imdata = f.read()
        im = exiv2.ImageFactory.open(imdata)
        im.readMetadata()               

        new_iptc_data = exiv2.IptcData()    
        new_iptc_data[b"Iptc.Application2.Caption"] = b'Hi Mom!'
        im.setIptcData(new_iptc_data)
        im.clearExifData()
        im.clearXmpData()
        im.writeMetadata()

        io = im.io()
        size = io.size()
        buffer = io.read(size)
        with open(r"c:\test\out.jpg", "wb") as f:
            f.write(buffer)

    if __name__ == '__main__':
        example1()
        example2()



