xdg 1.0.0 

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

rust-xdg
========

rust-xdg is a library that makes it easy to follow the X Desktop Group
standards for data, configuration, cache and runtime directories.

Installation
------------

Add the following to `Cargo.toml`:

```toml
[dependencies]
xdg = "*"
```

Examples
--------

To store configuration:

```rust
extern crate xdg;
let xdg_dirs = xdg::XdgDirs::new();

let mut file = try!(File::create(xdg_dirs.place_config_file("myapp/config.ini")));
try!(write!(&mut file, "configured = 1"));
```

The `myapp.ini` file will appear in the proper location for desktop
configuration files, most likely `~/.config/myapp/config.ini`.
The leading directories will be automatically created.

To retrieve supplementary data:

```rust
let config_path = xdg_dirs.find_config_file("myapp/logo.png")
                          .expect("application data not present");
let mut file = try!(File::open(config_path));
let mut data = String::new();
try!(file.read_to_string(&mut data));
```

The `logo.png` will be searched in the proper locations for
supplementary data files, most likely `~/.local/share/myapp/logo.png`,
then `/usr/local/share/myapp/logo.png` and `/usr/share/myapp/logo.png`.

License
-------

rust-xdg is distributed under the terms of both the MIT license
and the Apache License (Version 2.0).

See LICENSE-APACHE and LICENSE-MIT for details.