Question 1

How do I implement a basic state machine with GenStateMachine in Elixir?

Accepted Answer

Add the dependency to mix.exs, then in your module, use `use GenStateMachine` with a callback mode like `:state_functions`. Implement callbacks such as `handle_event/4` for state transitions, leveraging the automatic defaults to reduce boilerplate.

Question 2

GenStateMachine vs raw gen_statem: which should I choose for my Elixir project?

Accepted Answer

GenStateMachine offers cleaner Elixir syntax and less boilerplate, making it ideal for teams preferring idiomatic code. However, if you need direct control over Erlang compatibility or are already proficient with gen_statem, the raw version might suffice without extra dependencies.

Question 3

Does GenStateMachine support state timeouts and other advanced gen_statem features?

Accepted Answer

Yes, it fully supports all gen_statem features like state timeouts, event postponing, and state callbacks because it maintains 100% compatibility, as emphasized in the documentation. You implement them similarly to gen_statem but with Elixir conventions.

Question 4

How can I disable the Logger error translator in GenStateMachine?

Accepted Answer

To disable it, modify your mix.exs to include `:gen_state_machine` in `:included_applications` instead of `:applications`, as noted in the README. This prevents the automatic addition of the translator while keeping the library functional.

Question 5

What's the performance difference between GenStateMachine and vanilla gen_statem?

Accepted Answer

Performance is nearly identical since GenStateMachine is a thin wrapper with minimal overhead. However, for critical high-performance applications, benchmark your specific use case, as macro expansions and extra layers could introduce negligible latency.

Question 6

Can I use GenStateMachine with Phoenix for real-time applications?

Accepted Answer

Absolutely, it integrates well with Phoenix for managing stateful processes in channels or background jobs, leveraging OTP's fault-tolerance within Elixir's ecosystem, though you'll need to handle supervision and lifecycle as with any gen_statem.

Question 7

Is GenStateMachine actively maintained and compatible with Elixir 1.15+?

Accepted Answer

Check the GitHub repository for recent commits and issues; the library is on Hex with docs, and since it wraps OTP functionality, it likely stays compatible, but verify maintenance status from community activity and release notes.

gen_state_machine

What is gen_state_machine?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions