kinded

What is kinded?

Kinded is a Rust procedural macro that generates a companion "kind" enum with the same variants as your original enum but without the associated data.

New Features

skip_derive attribute

Opt out of default trait implementations when you need custom behavior or want to avoid conflicts with other derives.

use kinded::Kinded;

#[derive(Kinded)]
#[kinded(skip_derive(Display, FromStr))]
enum Status {
    Active,
    Inactive,
}

// Now you can implement Display and FromStr manually

Available traits to skip: Display, FromStr, From, Clone, Copy, Debug, PartialEq, Eq.

attrs attribute for generated enum

Pass extra attributes to the generated kind enum, useful for integrating with serde and other derive macros.

use kinded::Kinded;
use serde::{Serialize, Deserialize};

#[derive(Kinded)]
#[kinded(attrs(derive(Serialize, Deserialize), serde(rename_all = "snake_case")))]
enum Beverage {
    Coffee(String),
    Tea { flavor: String },
    Water,
}

// BeverageKind now has Serialize/Deserialize with snake_case naming

Per-variant attrs attribute

Apply attributes to individual kind variants for fine-grained control.

use kinded::Kinded;
use serde::{Serialize, Deserialize};

#[derive(Kinded)]
#[kinded(attrs(derive(Serialize, Deserialize)))]
enum Priority {
    #[kinded(attrs(serde(rename = "p0")))]
    Critical,
    #[kinded(attrs(serde(rename = "p1")))]
    High,
    Normal,
    Low,
}

const fn kind() method

The kind() method is now const fn, enabling use in const contexts.

use kinded::Kinded;

#[derive(Kinded)]
enum Direction {
    North,
    South,
    East,
    West,
}

const NORTH_KIND: DirectionKind = Direction::North.kind();

const fn is_vertical(dir: &Direction) -> bool {
    matches!(dir.kind(), DirectionKind::North | DirectionKind::South)
}

Upgrading

Update your Cargo.toml:

[dependencies]
kinded = "0.5"

• Add skip_derive attribute to opt out of default trait implementations (fixes #19).
• Add attrs attribute to pass extra attributes to the generated kind enum (e.g., #[kinded(attrs(serde(rename_all = "snake_case")))])
• Add per-variant attrs attribute to pass attributes to individual kind variants (e.g., #[kinded(attrs(default))]) (fixes #22)
• Make kind() method const fn, allowing usage in const contexts (fixes #12)

• Add #[kinded(rename = "...")] attribute for variants to customize display/parse names. This is useful when the automatic case conversion doesn't produce the desired result.

• Update to Rust 2024 edition.
• no_std support.

Changes

• [BREAKING] - Make ::all() function return an array instead of vector.

• Make ::all() function return an array instead of vector.

Changes

• Add Kind trait.

• Add Kind trait.

Changes

• Add ::all() to the kind type to iterate over all kind variants
• Generate customizable implementation of Display trait
• Generate implementation of FromStr trait

• Add ::all() to the kind type to iterate over all kind variants
• Generate customizable implementation of Display trait
• Generate implementation of FromStr trait

Changes

• Make the generated kind() function public

• Make generated kind() function public

Changes

• Support enums with generics

• Support enums with generics

• Very initial release