-
Notifications
You must be signed in to change notification settings - Fork 22
Open
Labels
enhancementNew feature or requestNew feature or request
Description
Help required
capnp-conv was written very hastily, and some help is required with improving the code:
- Code review + refactoring suggestions
- A more extensive test suite, possibly using Quickcheck or proptest. I'm not sure which one to pick.
- Better error messages
- Marking the correct span when an error occurs.
- Providing extra information in
unimplemented!()calls.
- Extra documentation
What is capnp_conv
capnp_conv is a procedural macro mechanism allowing to automatically derive capnproto serialization and deserialization glue code between Rust structs and capnp structs.
Example for usage (From offst-proto):
#[capnp_conv(crate::funder_capnp::request_send_funds_op)]
#[derive(Eq, PartialEq, Debug, Clone, Serialize, Deserialize)]
pub struct RequestSendFundsOp {
pub request_id: Uid,
pub src_hashed_lock: HashedLock,
pub route: FriendsRoute,
#[capnp_conv(with = Wrapper<u128>)]
pub dest_payment: u128,
#[capnp_conv(with = Wrapper<u128>)]
pub total_dest_payment: u128,
pub invoice_id: InvoiceId,
#[capnp_conv(with = Wrapper<u128>)]
pub left_fees: u128,
}The user can then invoke: request_send_funds.to_capnp_bytes() or RequestSendFunds::from_capnp_bytes(...)
The design of capnp_conv is inspired by proto_conv.
capnp_conv is currently being used through the whole Offst codebase, mostly in offst-proto.
Metadata
Metadata
Assignees
Labels
enhancementNew feature or requestNew feature or request