state-machines/state-machines-rs

🚀 state-machines-rs: State Machine Thời Gian Compile Cho Rust

Library Rust cho state machine an toàn ngay từ thời gian compile, kết hợp tính năng mạnh mẽ với giáo trình học tập chi tiết.

state-machines-rs là một port của Ruby state_machines gem, được thiết kế chủ yếu như một nền tảng học tập cho các Rubyist chuyển sang Rust. Dù định hướng giáo dục, dự án vẫn đầy đủ tính năng sản xuất, với code được chú giải kỹ thuật để giải thích các pattern Rust một cách dễ hiểu. Nhờ typestate pattern, các chuyển trạng thái bị kiểm tra tại compile time, loại bỏ lỗi runtime.

✨ Điểm nổi bật

• Typestate Pattern: An toàn thời gian compile với zero runtime overhead, mỗi chuyển đổi trả về typed machine mới.
• Guards & Unless: Điều kiện chuyển tiếp ở cả cấp sự kiện và chuyển tiếp, kiểm tra logic linh hoạt.
• Callbacks: Hook before/after ở cấp sự kiện, hỗ trợ around callbacks cho semantics như transaction.
• Async Support: Hỗ trợ async/await đầu-class cho guards và callbacks.
• No-std Compatible: Hoạt động trên các target nhúng như ESP32, bare metal.
• Type-safe: Chuyển tiếp không hợp lệ thành lỗi compile, không phát sinh runtime.
• Hierarchical States: Superstates với polymorphic transitions qua trait SubstateOf.
• Dynamic Dispatch: Phát sự kiện runtime tùy chọn, phù hợp hệ thống event-driven.

💡 Vì sao值得关注

Điểm biệt của state-machines-rs nằm ở định hướng học tập: codebase được chú giải kỹ thuật, giúp Rubyist làm quen với ownership, trait bounds, và macro một cách tự nhiên. Dù vậy, nó không kém phần mạnh mẽ – zero-cost abstractions, PhantomData, và move semantics đảm bảo hiệu năng cao. Phù hợp cho cả dự án nhúng và hệ thống cần độ tin cậy tối đa, đây là lựa chọn thú vị cho ai muốn kết hợp học tập và thực tế.

#Rust #StateMachines #Embedded #NoStd #TiniX