Yuuka - Introduction

Yuuka is a Rust procedural macro library that lets you define complex, deeply nested struct and enum hierarchies using a concise, JSON-like DSL syntax. It is built on top of serde for seamless serialization and deserialization.

Installation

Add the following to your Cargo.toml:

[dependencies]
yuuka = "0.6"
serde = { version = "1", features = ["derive"] }
serde_json = "1"

serde and serde_json are optional but commonly used alongside yuuka for serialization support.

Core Macros

Yuuka exports three procedural macros:

See also:

• Attributes & Visibility — Extra derive macros, attribute propagation, visibility control, and cross-crate usage
• Examples — Real-world examples and generated code structure

Quick Start

#![allow(unused)]
fn main() {
use serde::{Serialize, Deserialize};
use yuuka::{derive_struct, auto};

derive_struct!(
    #[derive(PartialEq, Serialize, Deserialize)]
    GameConfig {
        title: String,
        window: Window {
            width: u32,
            height: u32,
            fullscreen: bool,
        },
        plugins: [Plugin {
            name: String,
            enabled: bool,
        }],
    }
);

let config = auto!(GameConfig {
    title: "My Game".to_string(),
    window: {
        width: 1920,
        height: 1080,
        fullscreen: true,
    },
    plugins: vec![
        Plugin {
            name: "Audio".to_string(),
            enabled: true,
        },
    ],
});
}

This single derive_struct! call automatically generates three independent structs — GameConfig, Window, and Plugin — all with #[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]. The auto! macro then allows constructing instances using { } blocks for anonymous/inline sub-structs without knowing their generated names.

Documentation Index