Metadata-Version: 2.1
Name: IPTCInfo3
Version: 2.0.3
Summary: IPTC info for images in Python 3
Home-page: https://github.com/jamesacampbell/iptcinfo3
Author: Tamas Gulacsi
Author-email: gthomas@fw.hu
Maintainer: James Campbell
Maintainer-email: james@jamescampbell.us
License: http://www.opensource.org/licenses/gpl-license.php
Keywords: iptc image-metadata metadata
Platform: any
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: Artistic License
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Utilities
Requires-Python: >=3
Description-Content-Type: text/markdown

# IPTCINFO 3

[![Build Status](https://travis-ci.org/crccheck/iptcinfo3.svg?branch=master)](https://travis-ci.org/crccheck/iptcinfo3)

### Like IPTCInfo but finally compatible for Python 3

IPTCInfo: extract and modify IPTC (metadata) information on images - port of IPTCInfo.pm by Josh Carter <josh@multipart-mixed.com>'

Ported from Josh Carter's Perl IPTCInfo-1.9.pm by Tamas Gulacsi

Ever wish you add information to your photos like a caption, the place
you took it, the date, and perhaps even keywords and categories? You
already can. The International Press Telecommunications Council (IPTC)
defines a format for exchanging meta-information in news content, and
that includes photographs. You can embed all kinds of information in
your images. The trick is putting it to use.

That's where this IPTCInfo Python module comes into play. You can embed
information using many programs, including Adobe Photoshop, and
IPTCInfo will let your web server -- and other automated server
programs -- pull it back out. You can use the information directly in
Python programs, export it to XML, or even export SQL statements ready
to be fed into a database.

Usage
-----

    from iptcinfo3 import IPTCInfo


    # Create new info object
    info = IPTCInfo('doge.jpg')

    # Print list of keywords, supplemental categories, contacts
    print(info['keywords'])
    print(info['supplementalCategories'])
    print(info['contacts'])

    # Get specific attributes...
    caption = info['caption/abstract']

    # Create object for file that may not have IPTC data
    info = IPTCInfo('such_iptc.jpg', force=True)

    # Add/change an attribute
    info['caption/abstract'] = 'Witty caption here'
    info['supplemental category'] = ['portrait']

    # Save new info to file
    ##### See disclaimer in 'SAVING FILES' section #####
    info.save()
    info.save_as('very_meta.jpg')


