11 releases

0.5.4 Aug 12, 2022
0.5.3 Jan 20, 2022
0.5.2 Dec 4, 2021
0.5.1 Nov 25, 2021
0.1.0 Jun 27, 2021

#293 in Rust patterns

Download history 15/week @ 2022-08-13 13/week @ 2022-08-20 66/week @ 2022-08-27 30/week @ 2022-09-03 28/week @ 2022-09-10 17/week @ 2022-09-17 31/week @ 2022-09-24 92/week @ 2022-10-01 84/week @ 2022-10-08 20/week @ 2022-10-15 61/week @ 2022-10-22 33/week @ 2022-10-29 41/week @ 2022-11-05 63/week @ 2022-11-12 25/week @ 2022-11-19 43/week @ 2022-11-26

179 downloads per month

Apache-2.0 OR MIT

7KB

nova

Documentation

Create newtypes with great convenience.

All types generated by the following macros implement Debug, Clone, Eq, PartialEq, Ord, PartialOrd and Hash. For Copy types, the newtype also implements Copy.

Usage

[dependencies]
nova = "0.4"

Example

use nova::newtype;

#[newtype(serde, borrow = "str")]
pub type Meow = String;

#[newtype(new, copy)]
pub(crate) type SpecialUuid = uuid::Uuid;

fn example() {
    let meow = Meow("this is a string".to_string());
    let special_uuid = SpecialUuid::from(uuid::Uuid::new_v4());

    // Get inner:
    let inner = special_uuid.into_inner();
}

Supported attributes

Crate compatibility attributes

  • serde: enables support for the serde attribute to derive Serialize and Deserialize for newtypes.
  • sqlx: enables support for the sqlx attribute to derive sqlx::Type for newtypes.
  • async_graphql: enables support for the async_graphql attribute to implement Scalar for newtypes.

Generation attributes

  • copy: derives Copy on the newtype.
  • opaque: disables generating a Deref and into_inner functions to create an opaque type.
  • borrow = "<type>": sets the type to be used for the Deref implementation, if needed.
  • new: create default construction new function and From implementation.
  • derive(...): replace the default derives for the newtype with the provided list. Same syntax as the normal #[derive(...)] attribute.

License

This project is licensed under either of

at your option.

Dependencies

~0.5–1MB
~21K SLoC