serde_fields

Crates.ioserde_fields
lib.rsserde_fields
version0.1.0
created_at2025-11-20 19:12:39.355364+00
updated_at2025-11-20 19:12:39.355364+00
descriptionMacro making rendered serde field-names available as `&'static str`
homepage
repositoryhttps://github.com/bruderj15/serde_fields
max_upload_size
id1942438
size28,555
Julian Bruder (bruderj15)

documentation

https://docs.rs/serde_fields

README

serde_fields

Crates.io Docs.rs License

A procedural macro to generate field name enums and constants for structs using Serde, respecting #[serde(rename = "...")] and #[serde(rename_all = "...")].


Features

  • Automatically generate a const SERDE_FIELDS: &'static [&'static str] array containing the serialized names of all non-skipped struct fields.
  • Generate an enum named {StructName}SerdeField for all non-skipped fields.
  • Enum variants match Rust field names (PascalCase) and are annotated with #[serde(rename = "...")] - matching the field names of the original struct. They're (de)serializable.
  • Provides convenient methods and trait implementations:
    • as_str() -> &'static str
    • Display implementation
    • From<Enum> and From<&Enum> for &'static str
    • TryFrom<&str> and TryFrom<String> with custom error Invalid{StructName}SerdeField
    • FromStr implementation
    • AsRef<str> for ergonomic usage
  • Supports skipped fields via #[serde(skip)] and renaming via #[serde(rename = "...")].
  • Fully respects struct-level #[serde(rename_all = "...")].

Installation

Add this to your Cargo.toml:

[dependencies]
serde = { version = "1.0", features = ["serde_derive"] }
serde_fields = "0.1"

Usage

use serde::{Serialize, Deserialize};
use serde_fields::SerdeField;

#[derive(Serialize, Deserialize, SerdeField)]
#[serde(rename_all = "camelCase")]
struct User {
    user_id: u32,
    #[serde(rename = "eMail")]
    email: String,
    foo_bar: String,
}

// Access serialized field names as a slice
assert_eq!(User::SERDE_FIELDS, &["userId", "eMail", "fooBar"]);

// Use the generated enum
let field = UserSerdeField::UserId;
assert_eq!(field.as_str(), "userId");
assert_eq!(field.to_string(), "userId");

// Parse enum from string
let parsed: UserSerdeField = "userId".parse().unwrap();
assert_eq!(parsed, UserSerdeField::UserId);

// Convert enum to string slice
let name: &str = UserSerdeField::Email.into();
assert_eq!(name, "eMail");

// Serialize
let serialized = serde_json::to_string(&UserSerdeField::FooBar).unwrap();
assert_eq!("\"fooBar\"", serialized);
Commit count: 0

cargo fmt