#pyo3 #derive #dict

macro dict_derive

Derive macros for some PyO3 traits to convert python dicts into rust structs

7 unstable releases

0.4.0 Aug 3, 2021
0.3.1 Jan 26, 2021
0.3.0 Sep 16, 2020
0.2.0 Sep 11, 2019
0.1.1 Jun 16, 2019

#527 in Procedural macros

Download history 610/week @ 2023-05-15 907/week @ 2023-05-22 718/week @ 2023-05-29 621/week @ 2023-06-05 609/week @ 2023-06-12 594/week @ 2023-06-19 626/week @ 2023-06-26 471/week @ 2023-07-03 499/week @ 2023-07-10 806/week @ 2023-07-17 787/week @ 2023-07-24 676/week @ 2023-07-31 665/week @ 2023-08-07 668/week @ 2023-08-14 605/week @ 2023-08-21 821/week @ 2023-08-28

2,780 downloads per month
Used in 4 crates

Apache-2.0

10KB
163 lines

Dict-Derive

Derive macro for PyO3's FromPyObject and IntoPy<PyObject> traits. The derived implementation turns a Python's dict into your Rust struct and back.

Usage

Add the library to your Cargo.toml together with PyO3:

[dependencies]
pyo3 = "0.9"
dict_derive = "0.2.0"

Import the derive implementation and use it on your structs:

extern crate dict_derive;

use dict_derive::{FromPyObject, IntoPyObject};


#[derive(FromPyObject, IntoPyObject)]
struct User {
    name: String,
    email: String,
    age: u32,
}

Then you can use your structs as arguments and return values in your PyO3 functions:

extern crate pyo3;
use pyo3::prelude::*;
use pyo3::wrap_pyfunction;

// Requires FromPyObject to receive a struct as an argument
#[pyfunction]
fn get_contact_info(user: User) -> PyResult<String> {
    Ok(format!("{} - {}", user.name, user.email))
}

// Requires IntoPyObject to return a struct
#[pyfunction]
fn get_default_user() -> PyResult<User> {
    Ok(User {
        name: "Default".to_owned(),
        email: "default@user.com".to_owned(),
        age: 27,
    })
}

And then call your functions using normal python dicts:

>>> import mylib
>>> mylib.get_contact_info({"name": "Thor", "email": "thor@asgard.com", "age": 23})
'Thor - thor@asgard.com'
>>> mylib.get_default_user()
{'name': 'Default', 'email': 'default@user.com', 'age': 27}

Older PyO3 versions

  • For PyO3 version 0.7.0 or lower, use version 0.1 of this crate.
  • For PyO3 version 0.8 to 0.10, use version 0.2 of this crate.
  • For PyO3 version 0.11 to 0.13, use version 0.3 of this crate.

Dependencies

~1MB
~31K SLoC