#field #compile-time #macro-derive #getter #type

get-field-by-type

Get a value of field, based on the type of a field

3 releases

0.0.4 Mar 1, 2024
0.0.3 Sep 15, 2023
0.0.2 Jun 27, 2023

#2174 in Rust patterns

Download history 4/week @ 2024-10-23 12/week @ 2024-10-30 21/week @ 2024-11-06 19/week @ 2024-11-13 13/week @ 2024-11-20 64/week @ 2024-11-27 11/week @ 2024-12-04 24/week @ 2024-12-11 10/week @ 2024-12-18 2/week @ 2024-12-25 14/week @ 2025-01-01 5/week @ 2025-01-08 12/week @ 2025-01-15 1/week @ 2025-01-22 18/week @ 2025-01-29 129/week @ 2025-02-05

160 downloads per month
Used in 4 crates (via ezno-parser)

MIT license

6KB

Get-field-by-type

crates.io badge docs.rs badge

Create a getter for a field based on its type. For example

use get_field_by_type::GetFieldByType;

#[derive(GetFieldByType)]
#[get_field_by_type_target(i32)]
enum Enum1 {
	A(i32, char),
	B(i32, bool),
	C(i32, String)
}

let x = Enum1::A(12, '!');
assert_eq!(*GetFieldByType::<i32>::get(&x), 12);

Why not impl &Self for Into<&T>

Using Into on references for getting a field is a bit of hack. This is designed for getting the value for a field with a common type. Using a custom trait also means flexibility in the future

Additional options and features

When a struct of variant doesn't have a type, there are two behaviors

Either a compile time error (default)

Or a specified statement to evaluate. This could be a panic

use get_field_by_type::GetFieldByType;

#[derive(GetFieldByType)]
#[get_field_by_type_target(i32)]
#[get_field_no_type_behavior(panic!("could not find item");)]
enum Enum2 {
	A(i32),
	B(i32),
	C
}

assert_eq!(*GetFieldByType::<i32>::get(&Enum2::A(12)), 12);

let result = std::panic::catch_unwind(|| {
	let _value = *GetFieldByType::<i32>::get(&Enum2::C);
});
assert!(result.is_err());

or returning a constant value

use get_field_by_type::GetFieldByType;

#[derive(GetFieldByType)]
#[get_field_by_type_target(i32)]
#[get_field_no_type_behavior(return &0;)]
enum Enum2 {
	A(i32),
	B(i32),
	C
}

assert_eq!(*GetFieldByType::<i32>::get(&Enum2::A(12)), 12);
assert_eq!(*GetFieldByType::<i32>::get(&Enum2::C), 0);

Recursive on unit variants

In the AOrB enum case, the derive macro can't find a i32 on variant AOrB::A. However, as it is a unit variant, the implementation delegates it to the unit type.

use get_field_by_type::GetFieldByType;

#[derive(GetFieldByType)]
#[get_field_by_type_target(i32)]
struct A(pub i32);

#[derive(GetFieldByType)]
#[get_field_by_type_target(i32)]
struct B(pub i32);

#[derive(GetFieldByType)]
#[get_field_by_type_target(i32)]
enum AOrB {
	A(A),
	B(B)
}

let b = B(10);
assert_eq!(*GetFieldByType::<i32>::get(&b), 10);

let a_or_b = AOrB::B(b);
assert_eq!(*GetFieldByType::<i32>::get(&a_or_b), 10);

Alternatives

For more manual field access, check out getset. If looking for getting multiple fields, check out getters-by-type

Dependencies

~270–710KB
~17K SLoC