:py:mod:`exiftool`
==================

.. py:module:: exiftool

.. autoapi-nested-parse::

   PyExifTool is a Python library to communicate with an instance of Phil
   Harvey's excellent ExifTool_ command-line application.  The library
   provides the class :py:class:`ExifTool` that runs the command-line
   tool in batch mode and features methods to send commands to that
   program, including methods to extract meta-information from one or
   more image files.  Since ``exiftool`` is run in batch mode, only a
   single instance needs to be launched and can be reused for many
   queries.  This is much more efficient than launching a separate
   process for every single query.

   .. _ExifTool: https://exiftool.org

   The source code can be checked out from the github repository with

   ::

           git clone git://github.com/sylikc/pyexiftool.git

   Alternatively, you can download a tarball_.  There haven't been any
   releases yet.

   .. _tarball: https://github.com/sylikc/pyexiftool/tarball/master

   PyExifTool is licenced under GNU GPL version 3 or later, or BSD license.

   Example usage::

           import exiftool

           files = ["a.jpg", "b.png", "c.tif"]
           with exiftool.ExifToolHelper() as et:
                   metadata = et.get_metadata(files)
           for d in metadata:
                   print("{:20.20} {:20.20}".format(d["SourceFile"],
                                            d["EXIF:DateTimeOriginal"]))



Submodules
----------
.. toctree::
   :titlesonly:
   :maxdepth: 1

   constants/index.rst
   exceptions/index.rst
   exiftool/index.rst
   experimental/index.rst
   helper/index.rst


Package Contents
----------------

.. py:data:: __version__
   :value: '0.5.6'