Proxmox/perlmod
5
0
Fork 0
mirror of git://git.proxmox.com/git/perlmod.git synced 2025-01-19 18:03:36 +03:00
Code Issues Packages Projects Releases Wiki Activity

update docs and let the bless test use Value::bless_box

Browse Source 
Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>
This commit is contained in:
Wolfgang Bumiller 2021-10-19 10:30:50 +02:00
parent 81354c3960
commit d1743af5d8
2 changed files with 9 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
perlmod-test/src/bless.rs
View File

@ -13,15 +13,8 @@ mod export {
}
#[export(raw_return)]
fn new(#[raw] class: Value, content: String) -> Result<Value, Error> {
let mut ptr = Box::new(Bless { content });
let value = Value::new_pointer::<Bless>(&mut *ptr);
let value = Value::new_ref(&value);
let this = value.bless_sv(&class)?;
let _perl = Box::leak(ptr);
Ok(this)
fn new(#[raw] class: Value, content: String) -> Result<Value, perlmod::Error> {
Value::bless_box(class, Box::new(Bless { content }))
}
// The `#[raw]` attribute is an optimization, but not strictly required.

9
perlmod/src/lib.rs
View File

@ -53,15 +53,20 @@ pub use perlmod_macro::package;
/// [`package!`](macro@package) macro for a usage example.
///
/// This macro can optionally take a `raw_return` argument specifying that the return type, which
/// must be a [`Value`], will be returned as is, and not go through serialization.
/// must be a [`Value`], will be returned as is, and not go through serialization. As of perlmod
/// 0.6, serialization of a [`perlmod::Value`] will not produce a clone, so this is mostly an
/// optimization.
///
/// Additionally, function parameters can also use the following attributes:
///
/// * `#[raw]` with a parameter of type [`Value`]: The parameter will be passed as
/// is and not go through deserialization.
/// is and not go through deserialization. As of perlmod 0.6, deserialization will not produce
/// clones anymore, so this is mostly an optimization.
/// * `#[try_from_ref]`: Instead of regular deserialization, `TryFrom::try_from(&Value)` will be
/// used.
///
/// Implementing the `TryFrom` trait accordingly can make using blessed references more
/// convenient, but at the cost of hiding underlying `unsafe` code.
///
/// For an example on making blessed objects, see [`Value::bless_box`](Value::bless_box()).
pub use perlmod_macro::export;