Crate pythonize

This crate converts Rust types which implement the Serde serialization traits into Python objects using the PyO3 library.

Pythonize has two public APIs: pythonize and depythonize.

Examples

use serde::{Serialize, Deserialize};
use pyo3::Python;
use pythonize::{depythonize, pythonize};

#[derive(Debug, Serialize, Deserialize, PartialEq)]
struct Sample {
    foo: String,
    bar: Option<usize>
}

Python::with_gil(|py| {
    let sample = Sample {
        foo: "Foo".to_string(),
        bar: None
    };

    // Rust -> Python
    let obj = pythonize(py, &sample).unwrap();

    assert_eq!("{'foo': 'Foo', 'bar': None}", &format!("{}", obj.as_ref(py).repr().unwrap()));

    // Python -> Rust
    let new_sample: Sample = depythonize(obj.as_ref(py)).unwrap();

    assert_eq!(new_sample, sample);
});

Structs

• Depythonizer
  A structure that deserializes Python objects into Rust values
• PythonizeDefault
• PythonizeError
  Errors that can occur when serializing/deserializing Python objects
• Pythonizer
  A structure that serializes Rust values into Python objects

Traits

• PythonizeDictType
  Trait for types which can represent a Python mapping
• PythonizeListType
  Trait for types which can represent a Python sequence
• PythonizeTypes
  Custom types for serialization

Functions

• depythonizeDeprecated
  Attempt to convert a Python object to an instance of T
• depythonize_bound
  Attempt to convert a Python object to an instance of T
• pythonize
  Attempt to convert the given data into a Python object
• pythonize_custom
  Attempt to convert the given data into a Python object. Also uses custom mapping python class for serialization.

Type Aliases

• Result
  Alias for std::result::Result with error type PythonizeError