# aasmevent:completedo# complete/collected - dichotomy between states and eventsbefore{puts"event complete"}transitionsfrom: :collecting,to: :collectedend# pay/archived difficult to remember the relationship between statuses and events# try to explain this to the logic of business stakeholdersevent:paydotransitionsfrom: [:created,:collected],to: :archivedendorder=Order.create(state: "collecting")order.update(state: "archived")# not check transitions, invalid logicorder.update(state: "collected")# not run callbacksorder.complete# need use event for transition, but your object in UI and DB have only states# enum_machinetransitions(# simple readable transitions map"collecting"=>"collected","collected"=>"archived",)before_transition("collecting"=>"collected"){puts"event complete"}order=Order.create(state: "collecting")order.update(state: "archived")# checked transitions, raise exceptionorder.update(state: "collected")# run callbacks

gem"enum_machine"

# With ActiveRecordclassProduct < ActiveRecord::Baseenum_machine:color,%w[redgreen]end# Or with plain classclassProduct# attributes must be defined before including the EnumMachine moduleattr_accessor:colorincludeEnumMachine[color: {enum: %w[redgreen]}]# or reuse from modelProduct::COLOR.enum_decoratorendProduct::COLOR.values# => ["red", "green"]Product::COLOR::RED# => "red"Product::COLOR::RED.red?# => trueProduct::COLOR::RED.human_name# => "Красный"Product::COLOR::RED__GREEN# => ["red", "green"]Product::COLOR["red"].red?# => trueProduct::COLOR["red"].human_name# => "Красный"product=Product.newproduct.color# => nilproduct.color="red"product.color.red?# => trueproduct.color.human_name# => "Красный"

classProduct < ActiveRecord::Baseenum_machine:state,%w[createdapprovedpublished]doaliases("forming"=>%w[createdapproved],)endendProduct::STATE.forming# => %w[created approved]product=Product.new(state: "created")product.state.forming?# => true

# Value classes nested from base classmoduleColorDecoratordefhexcaseselfwhenProduct::COLOR::REDthen"#ff0000"whenProduct::COLOR::GREENthen"#00ff00"endendendclassProductattr_accessor:colorincludeEnumMachine[color: {enum: %w[redgreen],value_decorator: ColorDecorator}]endproduct=Product.newproduct.color="red"product.color.hex# => "#ff0000"

classProduct < ActiveRecord::Baseenum_machine:color,%w[redgreenblue]enum_machine:state,%w[createdapprovedcancelledactivated]do# transitions(any => any) - allow all transitionstransitions(nil=>"created","created"=>[nil,"approved"],%w[cancelledapproved]=>"activated","activated"=>%w[createdcancelled],)# Will be executed in `before_save` callbackbefore_transition"created"=>"approved"do |product| product.color="green"ifproduct.color.red?end# Will be executed in `after_save` callbackafter_transition%w[created]=>%w[approved]do |product| product.color="red"endafter_transitionany=>"cancelled"do |product| product.cancelled_at=Time.zone.nowendendendproduct=Product.create(state: "created")product.state.possible_transitions# => [nil, "approved"]product.state.can_activated?# => falseproduct.state.to_activated!# => EnumMachine::Error: transition "created" => "activated" not defined in enum_machineproduct.state.to_approved!# => true; equal to `product.update!(state: "approve")`

product=Product.new(state: "created")product.skip_state_transitions{product.save}

FactoryBot.definedofactory:productdoname{Faker::Commerce.product_name}to_create{ |product| product.skip_state_transitions{product.save!}}endend

# ActiveRecordclassProduct < ActiveRecord::Baseenum_machine:color,%w[redgreen]end# Plain classclassProduct# attributes must be defined before including the EnumMachine moduleattr_accessor:color# `i18n_scope` option must be explicitly set to use methods belowincludeEnumMachine[color: {enum: %w[redgreen],i18n_scope: "product"}]endProduct::COLOR.human_name_for("red")# => "Красный"Product::COLOR.values_for_form# => [["Красный", "red"], ["Зеленый", "green"]]product=Product.new(color: "red")product.color.human_name# => "Красный"

# For AciveRecordclassProduct < ActiveRecord::Baseenum_machine:color,%w[redgreen],i18n_scope: "users.product"end# For plain classclassProductincludeEnumMachine[color: {enum: %w[redgreen],i18n_scope: "users.product"}]end