yt-api 0.1.0

a work in progress library to interact asynchronously with the youtube api
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

# yt-api

[![Crates.io](https://img.shields.io/crates/v/yt-api.svg)](https://crates.io/crates/yt-api)
[![dependency status](https://deps.rs/repo/gitlab/nycex/yt-api/status.svg)](https://deps.rs/repo/gitlab/nycex/yt-api)
[![pipeline status](https://gitlab.com/nycex/yt-api/badges/master/build.svg)](https://gitlab.com/nycex/yt-api/pipelines)

## about
With yt-api you can interact asynchronously with the youtube-api.
Currently it implements the following endpoints:
 * search
 
## example
A basic search request with yt-api:

``` rust
fn main() {
    let key = ApiKey::new(&env::var("YT_API_KEY").expect("YT_API_Key env-var not found"));

    // create the SearchList struct for the query "rust lang"
    let search_list = SearchList::new(key).q("rust lang".to_string());

    let future = async move {
        // perform the search
        let result = search(&search_list).await.unwrap();
        // outputs the video_id of the first search result
        println!("https://youtube.com/watch?v={}", result.items[0].id.video_id.as_ref().unwrap());
    };

    // run the future
    tokio::run(future.unit_error().boxed().compat());
}
```

More examples can be found [here](examples). 

## supported rust versions

yt-api is currently only able to run on nightly, but as async/await will
probably be stabilized in 1.38, this will be the required rust version.

## license

This project is licensed under the [MIT license](LICENSE).

## contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in yt-api by you, shall be licensed as MIT, without any additional
terms or conditions.