8 个版本 (4 个破坏性更新)
使用旧的 Rust 2015
0.4.0 | 2020 年 5 月 11 日 |
---|---|
0.3.0 | 2019 年 10 月 3 日 |
0.2.0 | 2019 年 8 月 29 日 |
0.1.1 | 2018 年 11 月 5 日 |
0.0.1 | 2017 年 9 月 18 日 |
#1681 in 编码
每月下载量:31
73KB
1K SLoC
Neon-serde
此软件包是一个工具,用于轻松地在以下值之间转换:
A Handle<JsValue>
从 neon 软件包和任何实现 serde::{Serialize, Deserialize}
版本支持
neon-serde 在 node 8
10
12
上进行了测试
用法
neon_serde::from_value
将 Handle<js::JsValue>
转换为实现 serde::Deserialize
的类型
neon_serde::to_value
将实现 serde::Serialize
的值转换为 Handle<JsValue>
导出宏示例
export! 宏允许您快速定义自动转换其参数的函数
#[macro_use]
extern crate neon;
#[macro_use]
extern crate neon_serde;
#[macro_use]
extern crate serde_derive;
extern crate serde_bytes;
#[derive(Deserialize)]
struct User {
name: String,
age: u16,
}
export! {
/// Say hello based on a persons name
fn say_hello(name: String) -> String {
format!("Hello, {}!", name)
}
/// Say how old someone is
fn greet(user: User) -> String {
format!("{} is {} years old", user.name, user.age)
}
/// Say how old someone is, if they exist
fn maybe_say_hello(user: Option<User>) -> Option<String> {
user.map(greet)
}
/// Sorts the bytes in a string
/// use `serde_bytes::ByteBuf` to return a `Buffer` in node
/// a `Vec<u8>` will be an array
fn sort_utf8_bytes(str: String) -> serde_bytes::ByteBuf {
let mut bytes = str.into_bytes();
bytes.sort();
serde_bytes::ByteBuf::from(bytes)
}
/// using `serde_bytes::ByteBuf` will make passing an array
/// of numbers an error
///
/// note: `-> ()` is NOT optional
fn expect_buffer_only(_buff: serde_bytes::ByteBuf) -> () {
// code
}
/// using `Vec<u8>` not accept a buffer
fn expect_array(_buff: Vec<u8>) -> () {
// code
}
/// calculate fibonacci recursively
fn fibonacci(n: i32) -> i32 {
match n {
1 | 2 => 1,
n => fibonacci(n - 1) + fibonacci(n - 2)
}
}
}
直接使用示例
extern crate neon_serde;
extern crate neon;
#[macro_use]
extern crate serde_derive;
use neon::prelude::*;
#[derive(Serialize, Debug, Deserialize)]
struct AnObject {
a: u32,
b: Vec<f64>,
c: String,
}
fn deserialize_something(mut cx: FunctionContext) -> JsResult<JsValue> {
let arg0 = cx.argument::<JsValue>(0)?;
let arg0_value :AnObject = neon_serde::from_value(&mut cx, arg0)?;
println!("{:?}", arg0_value);
Ok(JsUndefined::new().upcast())
}
fn serialize_something(mut cx: FunctionContext) -> JsResult<JsValue> {
let value = AnObject {
a: 1,
b: vec![2f64, 3f64, 4f64],
c: "a string".into()
};
let js_value = neon_serde::to_value(&mut cx, &value)?;
Ok(js_value)
}
限制
数据所有权
所有 Deserialize 值必须拥有其所有数据(它们必须具有 serde::DeserializeOwned
特性)
依赖关系
~3.5–5MB
~104K SLoC