rust-embed 0.3.2

Rust Marco which loads files into the rust binary at compile time during release and loads the file from the fs during dev
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

## Rust Embed
Rust Marco which loads files into the rust binary at compile time during release and loads the file from the fs during dev.

You can use this to embed your css, js and images into a single executable.

This is similar to [go-embed](https://github.com/pyros2097/go-embed).

This is similar to [pony-embed](https://github.com/pyros2097/pony-embed).

Note:
 
This is not the same as std macros,
`include_bytes!`
`include_str!`
these are macros which generate code at compile time for only files.
`embed!("examples/public")` accepts folders and returns a function to get the contents using the file path

## Installation

```
[dependencies]
rust-embed="0.3.0"
```

## Documentation
It exposes a function to serve all files stored in your assets folder which is useful for webservers. So now you can statically compile all your assets i.e. your /static/ or /public/ folders into the rust executable and serve them during release and in development it will load the file from the file
system so that it doesn't take to much time to compile;]

```rust
asset(path: String) -> Option<Vec<u8>>

let asset = embed!("examples/public".to_owned());
match asset("/index.html".to_owned()) {
    None => assert!(false, "index.html should exist"),
    _ => assert!(true),
}
```

## Examples
To run the examples,
`cargo run --example hyper`

## Testing
debug: `cargo test --lib -- --nocapture`

release: `cargo test --lib --release -- --nocapture`

Go Rusketeers!
The power is yours!