photo_sort 0.3.3

A tool to rename and sort photos/videos by its EXIF date/metadata. It tries to extract the date from the EXIF data or file name and renames the image file according to a given format string. Foreach source directory all images are processed and renamed to the target directory
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
52

use log::trace;
use regex::Regex;
use std::sync::LazyLock;

/// Matches image names with optional prefixes and suffixes.
///
/// This regex matches image names that optionally start with `IMG`, `img`, `NO_DATE`, or `no_date`, `VID`, `vid`, `MOV`, `mov`,
/// followed by any characters, and ending with a file extension.
static RE_IMAGE_NAME: LazyLock<Regex> = LazyLock::new(|| {
    Regex::new(r"^((MOV|VID|mov|vid|IMG|img|NO_?DATE|no_?date)?[-_]*)*(.*?)[-_]*?\.([A-Za-z0-9]+)$")
        .expect("Failed to compile regex")
});

/// Matches and removes file extensions.
///
/// This regex matches any sequence of characters followed by a period and one or more alphabetic characters,
/// effectively matching file extensions for removal.
static RE_REMOVE_EXT: LazyLock<Regex> =
    LazyLock::new(|| Regex::new(r"\.[A-Za-z]+$").expect("Failed to compile regex"));

/// Matches and removes `NO_DATE` or `no_date` from image names.
///
/// This regex matches `NO_DATE` or `no_date`, with or without an underscore, for removal from image names.
static RE_REMOVE_NODATE: LazyLock<Regex> =
    LazyLock::new(|| Regex::new(r"(NO_?DATE|no_?date)").expect("Failed to compile regex"));

/// Cleans an image name by removing certain prefixes, suffixes, and file extensions.
///
/// # Arguments
///
/// * `name` - A string slice that holds the name of the image.
///
/// # Returns
///
/// * `String` - The cleaned image name.
pub fn clean_image_name(name: &str) -> String {
    let caps = RE_IMAGE_NAME.captures(name);
    let result = match caps {
        None => RE_REMOVE_EXT.replace(name, "").to_string(),
        Some(caps) => {
            if let (Some(cap_name), Some(_cap_ext)) = (caps.get(3), caps.get(4)) {
                RE_REMOVE_NODATE.replace(cap_name.as_str(), "").to_string()
            } else {
                RE_REMOVE_NODATE
                    .replace(RE_REMOVE_EXT.replace(name, "").as_ref(), "")
                    .to_string()
            }
        }
    };
    trace!("Cleaned name: {name:?} -> {result:?}");
    result
}