exif-rs/src/lib.rs

//
// Copyright (c) 2016 KAMADA Ken'ichi.
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions
// are met:
// 1. Redistributions of source code must retain the above copyright
//    notice, this list of conditions and the following disclaimer.
// 2. 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.
//
// THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``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 THE AUTHOR OR CONTRIBUTORS 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.
//

//! Exif parsing library written in pure Rust.
//!
//! # Examples
//!
//! An example to parse a JPEG/TIFF file:
//!
//! ```
//! let file = std::fs::File::open("tests/exif.jpg").unwrap();
//! let mut reader = std::io::BufReader::new(&file);
//! let mut buf = Vec::new();
//! let (fields, _) = exif::parse_image(&mut reader, &mut buf).unwrap();
//! for f in fields {
//!     println!("{} {} {:?}", f.tag, f.thumbnail, f.value);
//! }
//! ```

pub use error::Error;
pub use image::parse_image;
pub use jpeg::get_exif_attr as get_exif_attr_from_jpeg;
pub use tag::{Context, Tag};
pub use tiff::Field;
pub use tiff::parse_exif;
pub use value::Value;
pub use value::{Rational, SRational};

#[cfg(test)]
#[macro_use]
mod tmacro;

mod endian;
mod error;
mod image;
mod jpeg;
pub mod tag;
mod tiff;
mod util;
mod value;

#[cfg(test)]
mod tests {
    use std::mem;

    // This library assumes that usize is not smaller than u32.
    #[test]
    fn size_of_usize() {
        assert!(mem::size_of::<usize>() >= mem::size_of::<u32>());
    }
}