aksr 0.0.4

A Rust derive macro designed to automatically generate getter and setter methods for both named and tuple structs.
Documentation

aksr

A Rust derive macro that automatically generates Builder Lite pattern methods for structs, supporting both named and tuple structs with extensive customization options.

Builder Lite Pattern

aksr implements the Builder Lite pattern, where the struct itself acts as the builder. Unlike traditional builders that require a separate builder object, Builder Lite is an incremental, zero-cost evolution from the new() or Default::default() method.

Requirements:

  • Struct must implement Default trait, OR
  • Struct must have a new() method

This allows you to use the builder pattern without creating a separate builder type, making it especially useful for rapidly evolving application code.

Features

  • 🚀 Builder Lite pattern - Zero-cost, incremental builder evolution
  • 🎯 Field aliases for more intuitive API
  • 📦 Vector extension methods for incremental updates
  • 🔧 Flexible customization via attributes
  • 💡 String optimization with &str → String and &[String] support
  • 🎁 Smart Option handling for Vec<T> with empty check
  • ⚡ Zero-cost abstractions following Rust best practices

Installation

Add aksr to your Cargo.toml:

[dependencies]
aksr = "0.0.4"

Examples

Run the examples to see all features in action:

cargo run --example rect        # Named struct
cargo run --example color       # Tuple struct

To see the generated code:

cargo install cargo-expand      # Install expand tool
cargo expand --example rect     # View generated code

Supported Attributes

Attribute Description Values Example
alias Field alias for setter/getter String #[args(alias = "width")]
extend Enable extend methods for Vec true, false #[args(extend = true)]
setter Control setter generation true, false #[args(setter = false)]
getter Control getter generation true, false #[args(getter = false)]
setter_prefix Custom setter prefix String #[args(setter_prefix = "set")]
getter_prefix Custom getter prefix String #[args(getter_prefix = "get")]
getter_visibility Control getter visibility "pub", "private", "pub(crate)", "pub(self)", "pub(super)", "pub(in path)" #[args(getter_visibility = "private")]
setter_visibility Control setter visibility "pub", "private", "pub(crate)", "pub(self)", "pub(super)", "pub(in path)" #[args(setter_visibility = "pub(crate)")]
skip Skip both getter and setter true, false #[args(skip)]
allow Whitelist specific features setter, getter, extend, skip #[args(allow(setter, extend))]
except Blacklist specific features setter, getter, extend, skip #[args(except(getter))]

License

This project is licensed under LICENSE.