Rust: wsd is an intuitive crate delivers What Simply Defined

• Crate: https://crates.io/crates/wsd
• Documents: https://docs.rs/wsd
• Add dependency to your Cargo.toml

[dependencies]
wsd = "0.0.3"

Native JSON for Rust

use std::collections::HashMap;
use wsd::json::*;

fn main()
{
    let var = 123;
    let map = HashMap::from([ ("a", 1), ("b", 2), ("c", 3) ]);

    let mut t = json!{
        name: "native json",
        style: {
            color: "red",
            size: 12,
            bold: true
        },
        class: null,
        array: [5,4,3,2,1],
        vector: vec![1,2,3,4,5],
        hashmap: map,
        students: [
            {name: "John", age: 18},
            {name: "Jack", age: 21},
        ],
        rect: {x: 10, y: 10, width: 100, height: 50},
        sum: var + 10
    };

    // Native access
    t.rect.x += 10;
    t.rect.y += 20;

    // Debug
    println!("{:#?}", t);

    // Stringify
    let text = stringify(&t, 4);
    println!("{}", text);

}

Most simple way to make http request

Get

fn test() {
    wsd::http::get("https://docs.rs/", |data| {
        println!("status = {}, data = {}", data.status(), data.text());
    });
}

Post

fn test() {
    wsd::http::post("https://docs.rs/", "{id: 100}", |data| {
        println!("status = {}, data = {}", data.status(), data.text());
    });
}

Request

 use wsd::http::*;
 fn test() {
    let mut c = Request::new(Method::POST, "https://docs.rs");
    c.gzip(true);
    c.timeout(5);
    c.header("TOKEN", "1234567890");
    c.send("{id: 100}", |data| {
        println!("Data: {}", data.text());
        println!("Headers: {:#?}", data.headers());
     });
}

Intutive File Class

Just a convenient wrapper to rust File, check the return value quickly as we did with C API, don't need to check the Result, and unwrap() etc.

Example

using wsd::fs::*;

fn test() -> i32 {
    let mut f = File::new();
    if f.open("test.txt", O_CREATE | O_RW) != 0 {
        // check the error
        println!("Error: {}", f.error());
        return -1;
    }

    let data = "Hello World!";
    let n = f.write(data);
    if n < 0 {
        // write error
    }

    f.rewind();
    let mut buf = [0; 4096];
    let n = f.read(&mut buf);
    if n > 0 {
        // success to read n bytes
    }

    // get file length
    let off = f.length();
    if off > 0 {

    }

    f.seek(256, SEEK_SET);
    f.write("more data");

    f.close();

    return 0;
} 

Methods

File::new()
File::open()
File::read()
File::write()
File::close()
File::error()
File::path()
File::seek()
File::position()
File::length()
File::is_none()

Open flags

O_CREATE
O_TRUNCATE
O_RW
O_READ
O_WRITE
O_APPEND
O_NONBLOCK

Seek flags

SEEK_SET
SEEK_CUR
SEEK_END