12 breaking releases
0.23.0 | Nov 22, 2024 |
---|---|
0.21.1 | Apr 2, 2024 |
0.20.0 | Oct 15, 2023 |
0.19.0 | Jun 11, 2023 |
0.12.0 | Nov 22, 2020 |
#14 in FFI
86,651 downloads per month
Used in 28 crates
(24 directly)
61KB
1.5K
SLoC
Pythonize
This is an experimental serializer for Rust's serde ecosystem, which can convert Rust objects to Python values and back.
At the moment the Python structures it produces should be very similar to those which are produced by serde_json
; i.e. calling Python's json.loads()
on a value encoded by serde_json
should produce an identical structure to
that which is produced directly by pythonize
.
Usage
This crate converts Rust types which implement the Serde serialization traits into Python objects using the PyO3 library.
Pythonize has two main public APIs: pythonize
and depythonize
.
Examples
use serde::{Serialize, Deserialize};
use pyo3::prelude::*;
use pythonize::{depythonize, pythonize};
#[derive(Debug, Serialize, Deserialize, PartialEq)]
struct Sample {
foo: String,
bar: Option<usize>
}
let sample = Sample {
foo: "Foo".to_string(),
bar: None
};
Python::with_gil(|py| {
// Rust -> Python
let obj = pythonize(py, &sample).unwrap();
assert_eq!("{'foo': 'Foo', 'bar': None}", &format!("{}", obj.repr().unwrap()));
// Python -> Rust
let new_sample: Sample = depythonize(&obj).unwrap();
assert_eq!(new_sample, sample);
})
Dependencies
~2.5MB
~55K SLoC