# napchart-rs

[![GitHub last commit](https://img.shields.io/github/last-commit/barrowsys/napchart-rs)](https://github.com/barrowsys/napchart-rs)
[![Crates.io](https://img.shields.io/crates/v/napchart)](https://crates.io/crates/napchart/)
[![Docs.rs](https://docs.rs/napchart/badge.svg)](https://docs.rs/napchart)

A strongly-typed rust interface to the <https://napchart.com> API.

The public napchart api is pretty barebones right now, but this will let you use it!

## Usage

Add to your Cargo.toml:
```text
[dependencies]
napchart = "0.3"
```

## Examples

### Creating a new napchart from scratch
Example: <https://napchart.com/snapshot/O6kunUfuL>
```
use napchart::prelude::*;

let mut chart = Napchart::default()
    .shape(ChartShape::Circle)
    .lanes(1);
let first_lane = chart.get_lane_mut(0).unwrap();
first_lane.add_element(0, 60).unwrap()
    .text("Hour One");
first_lane.add_element(180, 240).unwrap()
    .text("Hour Four");
let second_lane = chart.add_lane();
second_lane.add_element(0, 120).unwrap()
    .color(ChartColor::Blue);
second_lane.add_element(120, 240).unwrap()
    .color(ChartColor::Green)
    .text("Cool green time");
```

### Downloading a napchart
Example Chart: <https://napchart.com/3tbkt>
```
use napchart::api::BlockingClient;

let client = BlockingClient::default();
let rchart = client.get_chart("3tbkt").unwrap();
assert_eq!(rchart.chartid, String::from("3tbkt"));
assert_eq!(rchart.title, Some(String::from("State test chart")));
assert_eq!(rchart.chart.shape, napchart::ChartShape::Circle);
assert_eq!(rchart.chart.lanes_len(), 1);
```

### Uploading a napchart as a snapshot
Example Output: <https://napchart.com/snapshot/TpCfggr4i>
```
use napchart::prelude::*;
use napchart::api::BlockingClient;

let client = BlockingClient::default();
let mut chart = Napchart::default();
let lane = chart.add_lane();
lane.add_element(420, 1260)
    .unwrap()
    .text("Nighttime")
    .color(ChartColor::Gray);
let upload_builder = chart.upload()
    .title("readme doctest")
    .description("https://crates.io/crates/napchart");
let remote_chart = client.create_snapshot(upload_builder).unwrap();
assert!(!remote_chart.chartid.is_empty());
```