findfont 0.1.0

find font by file name
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

# findfont-rs

[![Crates.io](https://img.shields.io/crates/v/findfont-rs)](https://crates.io/crates/findfont-rs)
[![Docs.rs](https://img.shields.io/docsrs/findfont-rs)](https://docs.rs/findfont-rs)

A cross-platform Rust library to find font files in system font directories.

## Features

- **Multi-platform support** (Linux/macOS/Windows)
- Searches standard system font directories
- Supports common font formats: TTF, TTC, OTF
- Automatic font variant detection (Light, Medium)
- Simple and intuitive API

## Installation

Add to your `Cargo.toml`:

```toml
[dependencies]
findfont-rs = "0.1"
```

## Usage

Basic usage:

```rust
use findfont_rs::find;

fn main() {
    if let Some(path) = find("Arial") {
        println!("Found font at: {}", path.display());
    } else {
        println!("Font not found");
    }
}
```

With error handling:

```rust
use findfont_rs::find;

fn load_font(font_name: &str) -> std::io::Result<Vec<u8>> {
    find(font_name)
        .map(std::fs::read)
        .unwrap_or_else(|| Err(std::io::Error::new(
            std::io::ErrorKind::NotFound,
            "Font not found"
        )))
}
```

## Supported Platforms

### Linux

- `~/.fonts/`
- `~/.local/share/fonts/`
- `/usr/local/share/fonts/`
- `/usr/share/fonts/`
- XDG_DATA_HOME and XDG_DATA_DIRS locations

### macOS

- `~/Library/Fonts/`
- `/Library/Fonts/`
- `/System/Library/Fonts/`
- System supplemental fonts

### Windows

- `%windir%\Fonts`
- `%LOCALAPPDATA%\Microsoft\Windows\Fonts`

## Search Logic

1. Checks for exact filename matches with extensions in this order:
   - `.ttf`
   - `.ttc`
   - `.otf`
2. If no exact match found, checks for common variants:
   - `{font_name} Light.{ext}`
   - `{font_name} Medium.{ext}`
3. Returns first match found in system font directories

Note: Search is case-sensitive and uses platform-specific path separators

## Limitations

- Does not parse font files to verify actual font names
- Limited variant detection (only Light/Medium)
- First match in search order is returned
- Doesn't handle font collections (.ttc) differently

## Contributing

Contributions are welcome! Please open an issue or PR for:

- Additional font variants
- Improved search algorithms
- More comprehensive test coverage
- Platform-specific enhancements

## License

MIT/Apache