# Rust Client for Sanity.io   [![Latest Version]][crates.io] [![Rustc Version 1.60.0]][rustc]

[Latest Version]: https://img.shields.io/crates/v/sanity_rs_client.svg
[crates.io]: https://crates.io/crates/sanity_rs_client
[Rustc Version 1.60.0]: https://img.shields.io/badge/rustc-1.60.0+-lightgray.svg
[rustc]: https://blog.rust-lang.org/2022/04/07/Rust-1.60.0.html


**Rust Client for Sanity.io  is a simple client for sanity.io to query, mutate and upload images to sanity datasets.**

```toml 
[dependencies]
sanity_rs_client = "0.1.0"
```

Full documentation is available [here](https://docs.serde.rs/sanity_rs_client)


## Usage

### Create a client

```rust
    use sanity_rs_client::config::SanityConfig;
    let config = SanityConfig::new("<project-id>", "<dataset-name>")
        .api_version("<api-version>")
        .access_token("<access-token>")
        .build();
    
    let client = sanity_rs_client::sanity_client::SanityClient::new(config);
```

### Simple Query 
> The client uses `tokio` runtime for querying data
```rust    
    use sanity_rs_client::sanity_client::SanityClient;
    use sanity_rs_client::sanity_client::Query;
    let query_str = String::from("*[_type == "image"]{_id, _type, ...}");
    let response = client.fetch(Query::new(query_str, HashMap::new())).unwrap().await;

    let json_text  = response.text().await;
```

### Query with Variables
```rust 
    use sanity_rs_client::sanity_client::SanityClient;
    use sanity_rs_client::sanity_client::Query;
    use serde_json::Value;
    
    let query_str = String::from("*[_type == $type]{_id, _type, ...}");
    let variables: HashMap<String, Value> = HashMap::new();
    variables.insert(String::from("type"), Value::String(String::from("file")));

    let query = Query::new(query_str, variables);

    let response = client.fetch(query).unwrap().await;
```

### Simple Mutation
```rust 
    use sanity_rs_client::sanity_client::Mutation;
    let mutation = Mutation::Create(json!{
        "_id": "drafts.cfeba160-1123-4af9-ad4e-c657d5e537af",
        "_type": "author",
        "name": "Random"
    });

    let response = client.mutate(vec![mutation], &Vec::new()).await.unwrap();

    let json_text  = response.text().await;
```

### Mutation with params 
```rust
    use sanity_rs_client::sanity_client::Mutation;
    let mutation = Mutation::Create(json!{
        "_id": "drafts.cfeba160-1123-4af9-ad4e-c657d5e537af",
        "_type": "author",
        "name": "Random"
    });

    // Query vector is required as per `reqwest` crate's requirements for providing 
    // query params in an http request
    let query: Vec<(String, Value)> = vec![
            (String::from("returnIds"), Value::Bool(true)),
            (String::from("returnDocuments"), Value::Bool(true)),
            (String::from("dryRun"), Value::Bool(true))
    ];

    let response = client.mutate(vec![mutation], &query).await.unwrap();

    //To get json text
    let json_text  = response.text().await;
```

### Uploading an image
> Image upload currently doesn't work in an async context as I couldn't figure out a way
> to execute `reqwest` upload with tokio like post and get request
> any help/PR would be appreciated in this regard 
```rust
    let response = client.upload_image(String::from("image.jpg"));
```

## Examples 
to run the examples, run 
```
cargo run --example <example-name>
```