iptc 0.2.0

Read IPTC tags from JPEG files in pure Rust, with partial support for Tiff files.
Documentation 
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

# IPTC

[![Crates.io](https://img.shields.io/crates/v/iptc)](https://crates.io/crates/iptc)
[![CI Build](https://github.com/alvinometric/iptc/actions/workflows/rust.yml/badge.svg)](https://github.com/alvinometric/iptc/actions/workflows/rust.yml)

A fast, lightweight crate to read **and write** IPTC metadata in JPEG files, in pure Rust. Also includes partial support for TIFF files.

## Features

- 🚀 **Fast & Lightweight** - Written in pure Rust
- 📖 **Read IPTC Tags** - Extract IPTC metadata like keywords, captions, and copyright info
- ✍️ **Write IPTC Tags** - Add or modify IPTC metadata in your images
- 🔒 **Safe** - Memory-safe operations with Rust's guarantees
- 📸 **Format Support** - Full JPEG support

## Example

```rs
use iptc::IPTC;
use iptc::IPTCTag;
use std::error::Error;
use std::path::Path;

fn main() -> Result<(), Box<dyn Error>> {
    let image_path = Path::new("tests/smiley.jpg");

    // Reading IPTC metadata
    let mut iptc = IPTC::read_from_path(&image_path)?;

    // See all the tags in the image
    println!("IPTC: {:?}", iptc.get_all());

    // Get a specific tag
    let keywords = iptc.get(IPTCTag::Keywords);
    println!("keywords: {}", keywords);

    // Writing new metadata
    // For repeatable fields like Keywords, you can add multiple values
    let keywords = vec!["rust", "metadata", "iptc"];
    for keyword in keywords {
        iptc.set_tag(IPTCTag::Keywords, keyword);
    }

    // For single-value fields, just set them directly
    iptc.set_tag(IPTCTag::City, "Oslo");

    iptc.write_to_file(&image_path)?;

    Ok(())
}
```