# Uller

## About

This crate provides you with:

* `MakeLink`
  - An interface for generating a `Url` from a structure.
* `JsonDownload<T>`
  - An interface for fetching data from a generated `Url` using `MakeLink` and converting it to a `<T>` structure.
* `BytesDownload`
  - An interface for downloading data as `bytes` from a `MakeLink` conversion.

**Note:** Add url crate for your project.

### Information below contains examples from the [uller-macro crate](https://crates.io/crates/uller_macro).

# Example (future - macro)

## Qller (default)

### Macros for implementing `MakeLink` in query style using a struct as input

#### Example

```rust
use uller::prelude;
#[derive(Qller)]
#[url = "http://127.0.0.1:1234/"]
struct Test {
    #[name = "f"] // rename to "f"
    f111: String,
    #[name = "v"] // rename to "v"
    #[pos = 0]    // move it to the first position
    v222: String,
}
```

This will convert to: `http://127.0.0.1:1234/?v={value}&f={value}`

**Note:** Positions start at 0, like an array.

# Example (future - juller)

## Juller (feature - juller)

### Macros for downloading `<T>` using a struct that implements `MakeLink` (`Qller`) and `JsonDownload`

#### Example

```rust
use uller::prelude;
#[derive(Qller, Juller)]
#[output = "TestOut"]
#[url = "http://127.0.0.1:41112/"]
struct Test {
    f: String,
    v: String,
}

#[derive(Deserialize, Debug)]
struct TestOut {
    field: String,
}

async fn convert(st: &Test) -> TestOut {
    st.download().await.unwrap()
    // or
    st.download_verbose().await.unwrap()
}
```

# Example (future - buller)

## Buller (feature - buller)

### Macros for downloading `Bytes` using a struct that implements `MakeLink` (`Qller`) and `BytesDownload`

#### Example

```rust
use uller::prelude;

#[derive(Qller, Buller)]
#[url = "http://127.0.0.1:41112/"]
struct Test {
    f: String,
    v: String,
}

async fn convert(st: &Test) -> bytes::Bytes {
    st.download().await.unwrap()
    // or
    st.download_verbose().await.unwrap()
}
```