fileslug 0.1.2

Filename-aware slug generator — slugifies file names (preserving extensions, dotfiles, version numbers) and arbitrary text
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

# fileslug

Filename-aware slug generator for Rust. Converts messy filenames into clean, shell-safe slugs while preserving extensions, dotfiles, and version numbers.

Unlike URL slug libraries (which destroy `.tar.gz` → `tar-gz`), fileslug understands filenames.

## Usage

```rust
use fileslug::{slugify, SlugifyOptions, Style};

let opts = SlugifyOptions::default(); // kebab-case, transliterate unicode
assert_eq!(slugify("Café Résumé (Final).pdf", &opts), "cafe-resume-final.pdf");
assert_eq!(slugify(".env.local", &opts), ".env.local");
assert_eq!(slugify("archive.tar.gz", &opts), "archive.tar.gz");
assert_eq!(slugify("app-1.2.3.dmg", &opts), "app-1.2.3.dmg");

// Snake case
let snake = SlugifyOptions { style: Style::Snake, ..Default::default() };
assert_eq!(slugify("My Cool File.txt", &snake), "my_cool_file.txt");

// camelCase
let camel = SlugifyOptions { style: Style::Camel, ..Default::default() };
assert_eq!(slugify("my cool file.txt", &camel), "myCoolFile.txt");

// Keep unicode (skip transliteration)
let unicode = SlugifyOptions { keep_unicode: true, ..Default::default() };
assert_eq!(slugify("Café.txt", &unicode), "café.txt");
```

## Features

- **Extension preservation** — `.txt`, `.tar.gz`, `.tar.bz2` etc. never modified
- **Dotfile awareness** — `.gitignore`, `.env` returned as-is
- **Version number preservation** — `1.2.3` dots kept intact
- **Unicode transliteration** — via `any_ascii` (or keep-unicode to skip)
- **Three styles** — kebab-case (default), snake_case, camelCase
- **Zero-copy for dotfiles** — returns `Cow::Borrowed` when no changes needed