feat: allow_event_without_transition

[fgmacedo]

Added option to ignore unknown events

You can now instantiate a {ref}StateMachine with allow_event_without_transition=True,
so the state machine will allow triggering events that may not lead to a state {ref}transition,
including tolerance to unknown {ref}event triggers.

The default value is False, that keeps the backward compatible behavior of when an
event does not result in a {ref}transition, an exception TransitionNotAllowed will be raised.

>>> from statemachine import StateMachine, State

>>> class ApprovalMachine(StateMachine):
...     pending = State(initial=True)
...     waiting_approval = State()
...     approved = State(final=True)
...
...     start = pending.to(waiting_approval)
...     approve = waiting_approval.to(approved)
...

>>> sm = ApprovalMachine(allow_event_without_transition=True)

>>> sm.send("unknow_event_name")

>>> sm.pending.is_active
True

>>> sm.send("approve")

>>> sm.pending.is_active
True

>>> sm.send("start")

>>> sm.waiting_approval.is_active
True

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
0.0% Duplication

[codecov]

Codecov Report

Patch coverage: 100.00% and no project coverage change

Comparison is base (de5d085) 100.00% compared to head (44cec99) 100.00%.

Additional details and impacted files

@@            Coverage Diff            @@
##           develop      #364   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           19        19           
  Lines          924       931    +7     
  Branches       153       154    +1     
=========================================
+ Hits           924       931    +7     

Flag	Coverage Δ
unittests	100.00% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
statemachine/exceptions.py	100.00% <ø> (ø)
statemachine/state.py	100.00% <ø> (ø)
statemachine/event.py	100.00% <100.00%> (ø)
statemachine/event_data.py	100.00% <100.00%> (ø)
statemachine/statemachine.py	100.00% <100.00%> (ø)

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.