dirs-lite 1.0.2

Get platform-specific config, data, and cache directories. Supports XDG-style on macOS. No dependencies.
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

# dirs-lite

[![crates.io](https://img.shields.io/crates/v/dirs-lite.svg)](https://crates.io/crates/dirs-lite)
[![docs.rs](https://docs.rs/dirs-lite/badge.svg)](https://docs.rs/dirs-lite)
[![License](https://img.shields.io/crates/l/dirs-lite.svg)](https://github.com/sassman/dirs-lite-rs#license)

A minimal, dependency-free crate for getting the user's config, data, and cache directories.

## Usage

```rust
use dirs_lite::{config_dir, data_dir, cache_dir};

fn main() {
    let config = config_dir().expect("config dir");
    println!("{}", config.display());
    // Linux:   /home/alice/.config
    // macOS:   /Users/Alice/Library/Application Support
    //          /Users/Alice/.config (with `favor-xdg-style` feature)
    // Windows: C:\Users\Alice\AppData\Roaming

    let data = data_dir().expect("data dir");
    println!("{}", data.display());
    // Linux:   /home/alice/.local/share
    // macOS:   /Users/Alice/Library/Application Support
    //          /Users/Alice/.local/share (with `favor-xdg-style` feature)
    // Windows: C:\Users\Alice\AppData\Local

    let cache = cache_dir().expect("cache dir");
    println!("{}", cache.display());
    // Linux:   /home/alice/.cache
    // macOS:   /Users/Alice/Library/Caches
    //          /Users/Alice/.cache (with `favor-xdg-style` feature)
    // Windows: C:\Users\Alice\AppData\Local
}
```

## Platform Behavior

### `config_dir()`

| Platform | Path |
|----------|------|
| Linux | `$XDG_CONFIG_HOME` or `$HOME/.config` |
| macOS | `$HOME/Library/Application Support` |
| Windows | `%APPDATA%` |

### `data_dir()`

| Platform | Path |
|----------|------|
| Linux | `$XDG_DATA_HOME` or `$HOME/.local/share` |
| macOS | `$HOME/Library/Application Support` |
| Windows | `%LOCALAPPDATA%` |

### `cache_dir()`

| Platform | Path |
|----------|------|
| Linux | `$XDG_CACHE_HOME` or `$HOME/.cache` |
| macOS | `$HOME/Library/Caches` |
| Windows | `%LOCALAPPDATA%` |

## Features

- **`favor-xdg-style`** - On macOS, returns XDG-style paths (`$HOME/.config`, `$HOME/.local/share`, `$HOME/.cache`) instead of Apple paths.

## Platform Conventions

- [XDG Base Directory Specification](https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html) (Linux)
- [Apple File System Programming Guide](https://developer.apple.com/library/content/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/FileSystemOverview/FileSystemOverview.html) (macOS)
- [Known Folder IDs](https://docs.microsoft.com/en-us/windows/win32/shell/knownfolderid) (Windows)

## Alternatives

Need more? Consider these crates:

- [`dirs`](https://crates.io/crates/dirs) - More directory types (cache, data, etc.)
- [`directories`](https://crates.io/crates/directories) - Project-specific paths with organization support
- [`etcetera`](https://crates.io/crates/etcetera) - Strategy-based (XDG, Apple, Windows)

## License

Licensed under either of [Apache License, Version 2.0](LICENSE-APACHE) or [MIT license](LICENSE-MIT) at your option.