dir_spec 0.5.1

A cross-platform Rust library for resolving XDG and platform-specific directories with proper fallbacks.
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

# Commit Conventions

This project uses [Conventional Commits][conventional-commits] with **scoped** messages.

## Format

```text
<type>(<scope>): <description>

[optional body]

[optional footer(s)]
```

## Scopes

If any scope can reasonably be applied to a commit, it **must** be included. Multiple scopes are comma-separated:

```text
feat(store, cli): add task creation workflow
fix(cli): correct flag parsing for --verbose
```

If no scope reasonably applies, it may be omitted:

```text
chore: update dependencies
docs: fix typo in README
```

## Types

| Type       | Purpose                                                   |
|------------|-----------------------------------------------------------|
| `feat`     | A new feature                                             |
| `fix`      | A bug fix                                                 |
| `docs`     | Documentation only changes                                |
| `style`    | Changes that do not affect the meaning of the code        |
| `refactor` | A code change that neither fixes a bug nor adds a feature |
| `perf`     | A code change that improves performance                   |
| `test`     | Adding or correcting tests                                |
| `build`    | Changes to the build system or external dependencies      |
| `ci`       | Changes to CI configuration files and scripts             |
| `chore`    | Other changes that don't modify src or test files         |
| `revert`   | Reverts a previous commit                                 |

## Breaking Changes

Append `!` after the type/scope to indicate a breaking change:

```text
feat(cli)!: remove deprecated subcommands
```

A `BREAKING CHANGE:` footer can provide additional detail:

```text
feat(cli)!: remove deprecated subcommands

BREAKING CHANGE: `dir_spec foo` and `dir_spec bar` have been removed.
```

## Guidelines

- Use the **imperative mood** in the description ("add feature" not "added feature")
- Keep the first line under **72 characters**
- Reference relevant issues in the footer (e.g., `Closes #42`)

[conventional-commits]: https://www.conventionalcommits.org/