query_params 0.1.0

Rust macro to automatically implement the serialization to http query parameters for arbitrary structs.
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

[![Build Status](https://travis-ci.org/NotBad4U/query_params.svg?branch=master)](https://travis-ci.org/NotBad4U/query_params)
[![Rust version]( https://img.shields.io/badge/rust-stable-blue.svg)]()


# QueryParams Derive

[Rust][rust] custom derive to automatically implement serialization to http query params for arbitrary structs. A simple `#[derive(QueryParams)]` will generate a function `to_query_params` for your struct.

## How it Works

```rust
#[macro_use]
extern crate query_params;

#[derive(QueryParams)]
struct PullRequestsParametersApi {
    page: i32,
    sort: bool,
    direction: String,
    state: Vec<String>,
    // .. other interesting fields ..
} 

fn main() {
    let pr = PullRequestsParametersApi {
        page: 2,
        sort: true,
        direction: "asc",
        state: vec!["open".to_string(), "closed".to_string()],
    }

    println!("{}", pr.to_query_params()); // => ?page=2&sort=true&direction=asc&state=open,closed
}
```

## Get Started

It's as simple as two steps:

1. Add `query_params` to your `Cargo.toml` 
  * manually 

  * or with [cargo-edit](https://github.com/killercup/cargo-edit):
  
    `cargo add derive_builder`

2. Annotate your struct with `#[derive(QueryParams)]`

## Disclaimer :exclamation:

* Tuple structs and unit structs are not supported as they have no field names.

## [Documentation][doc]

Detailed explaination of all features and tips for troubleshooting.

### Contribution

Feel free to make a pull request :smiley:

[doc]: https://docs.rs/query_params
[rust]: https://www.rust-lang.org/