Changelog

0.22.11 (2017-01-12)

  • (Fixed) Path error when using sismic-behave on Windows.

0.22.10 (2016-11-25)

  • (Added) A --debug-on-error parameter for sismic-behave.

0.22.9 (2016-11-25)

  • (Fixed) Behave step “Event x should be fired” now checks that the event was fired during the last execution.

0.22.8 (2016-10-19)

  • (Fixed) YAML values like “1”, “1.0”, “yes”, “True” are converted to strings, not to int, float and bool respectively.
  • (Changed) ruamel.yaml replaces pyyaml as supported YAML parser.
  • (Changed) Use schema instead of pykwalify (which unfortunately freezes its dependencies versions) to validate (the structure of) YAML files.
  • (Changed) import_from_yaml raises StatechartError instead of SchemaError if it cannot validate given YAML against the predefined schema.

0.22.7 (2016-08-19)

  • (Added) A new helper coverage_from_trace that returns coverage information (in absolute numbers) from a trace.
  • (Added) Parameter fails_fast (default is False, behavior preserved) for ExecutionWatcher.watch_with methods. This parameter allows the watcher to raise an AssertionError as soon as the added watcher reaches a final configuration.
  • (Changed) StateMixin, Transition and Event‘s __eq__ method returns a NotImplemented object if the other object involved in the comparison is not an instance of the same class, meaning that Event('a') == 1 now raises a NotImplementedError instead of being False.

0.22.6 (2016-08-03)

  • (Changed) Event, MacroStep, MicroStep, StateMixin, Transition, Statechart and Interpreter‘s __repr__ returns a valid Python expression.
  • (Changed) The context returned by a PythonEvaluator (and thus by the default Interpreter) exhibits nested variables (the ones that are not defined in the preamble of a statechart). Those variables are prefixed by the name of the state in which they are declared, to avoid name clashing.
  • (Changed) Context variables are sorted in exceptions’.__str__ methods.

0.22.4 (2016-07-08)

  • (Added) sismic-behave CLI now accepts a --steps parameter, which is a list of file paths containing the steps implementation.
  • (Added) sismic-behave CLI now accepts a --show-steps parameter, which list the steps (equivalent to Behave’s overriden --steps parameter).
  • (Added) sismic-behave now returns an appropriate exit code.
  • (Changed) Reorganisation of docs/examples.
  • (Fixed) Coverage data for sismic-behave takes the initialization step into account (regression introduced in 0.21.0).

0.22.3 (2016-07-06)

  • (Added) sent and received are also available in preconditions and postconditions.

0.22.2 (2016-07-01)

  • (Added) model.Event is now correctly pickled, meaning that Sismic can be used in a multiprocessing environment.

0.22.1 (2016-06-29)

  • (Added) A event {event_name} should not be fired steps for BDD.
  • (Added) Both MicroStep and MacroStep have a list sent_events of events that were sent during the step.
  • (Added) Property statecharts receive a event sent event when an event is sent by the statechart under test.
  • (Changed) Events fired from within the statechart are now collected and sent at the end of the current micro step, instead of being immediately sent.
  • (Changed) Invariants and sequential contracts are now evaluated ordered by their state’s depth

0.22.0 (2016-06-13)

  • (Added) Support for sequential conditions in contracts (see documentation for more information).
  • (Added) Python code evaluator: after and idle are now available in postconditions and invariants.
  • (Added) Python code evaluator: received and sent are available in invariants.
  • (Added) An Evaluator has now a on_step_starts method which is called at the beginning of each step, with the current event (if any) being processed.
  • (Added) Interpreter.raise_event to send events from within the statechart.
  • (Added) A copy_from_statechart method for a Statechart instance that allows to copy (part of) a statechart into a state.
  • (Added) Microwave controller example (see docs/examples/microwave.[yaml|py]).
  • (Changed) Events sent by a code evaluator are now returned by the execute_* methods instead of being automatically added to the interpreter’s queue.
  • (Changed) Moved run_in_background and log_trace from sismic.interpreter to the newly added sismic.interpreter.helpers.
  • (Changed) Internal API changes: rename self.__x to self._x to avoid (mostly) useless name mangling.

0.21.0 (2016-04-22)

Changes for interpreter.Interpreter class:

  • (Removed) _select_eventless_transition which is a special case of _select_transition.
  • (Added) _select_event, extracted from execute_once.
  • (Added) _filter_transitions, extracted from _select_transition.
  • (Changed) _execute_step is now _apply_step.
  • (Changed) _compute_stabilization_step is now _create_stabilization_step and accepts a list of state names
  • (Changed) _compute_transitions_step is now _create_steps.
  • (Changed) Except for the statechart parameter, all the parameters for Interpreter‘s constructor can now be only provided by name.
  • (Fixed) Contracts on a transition are checked (if not explicitly disabled) even if the transition has no action.
  • (Fixed) Evaluator.execute_action is called even if the transition has no action.
  • (Fixed) States are added/removed from the active configuration as soon as they are entered/exited. Previously, the configuration was only updated at the end of the step (and could possibly lead to inaccurate results when using active(name) in a PythonEvaluator).

The default PythonEvaluator class has been completely rewritten:

  • (Changed) Code contained in states and/or transitions is now executed with a local context instead of a global one. The local context of a state is built upon the local context of its parent, and so one until the local context of the statechart is reached. This should facilitate the use of dummy variables in nested states and transitions.
  • (Changed) The code is now compiled (once) before is evaluation/execution. This should increase performance.
  • (Changed) The frozen context of a state (ie. __old__) is now computed only if contracts are checked, and only if at least one invariant or one postcondition exists.
  • (Changed) The initial_context parameter of Evaluator‘s constructor can now only be provided by name.
  • (Changed) The additional_context parameter of Evaluator._evaluate_code and Evaluator._execute_code can now only be provided by name.

Miscellaneous:

  • (Fixed) Step I load the statechart now executes (once) the statechart in order to put it into a stable initial configuration (regression introduced in 0.20.0).

0.20.5 (2016-04-14)

  • (Added) Type hinting (see PEP484 and mypy-lang project)

0.20.4 (2016-03-25)

  • (Changed) Statechart testers are now called property statechart.
  • (Changed) Property statechart can describe desirable and undesirable properties.

0.20.3 (2016-03-22)

  • (Changed) Step Event x should be fired now checks sent events from the beginning of the test, not only for the last executed step.
  • (Fixed) Internal events that are sequentially sent are now sequentially consumed (and not anymore in reverse order).

0.20.2 (2016-02-24)

  • (Fixed) interpreter.log_trace does not anymore log empty macro step.

0.20.1 (2016-02-19)

  • (Added) A step ended event at the end of each step in a tester story.
  • (Changed) The name of the events and attributes that are exposed in a tester story has changed. Consult the documentation for more information.

0.20.0 (2016-02-17)

  • (Added) Module interpreter provides a log_trace function that takes an interpreter instance and returns a (dynamic) list of executed macro steps.
  • (Added) Module testing exposes an ExecutionWatcher class that can be used to check statechart properties with tester statecharts at runtime.
  • (Changed) Interpreter.__init__ does not anymore stabilize the statechart. Stabilization is done during the first call of execute_once.
  • (Changed) Story.tell returns a list of MacroStep (the trace) instead of an Interpreter instance.
  • (Changed) The name of some attributes of an event in a tester story changes (e.g. event becomes consumed_event, state becomes entered_state or exited_state or source_state or target_state).
  • (Removed) Interpreter.trace, as it can be easily obtained from execute_once or using log_trace.
  • (Removed) Interpreter.__init__ does not accept an initial_time parameter.
  • (Fixed) Parallel state without children does not any more result into an infinite loop.

0.19.0 (2016-02-10)

  • (Added) BDD can now output coverage data using --coverage command-line argument.
  • (Changed) The YAML definition of a statechart must use root state: instead of initial state:.
  • (Changed) When a contract is evaluated by a PythonEvaluator, __old__.x raises an AttributeError instead of a KeyError if x does not exist.
  • (Changed) Behave is now called from Python instead of using a subprocess and thus allows debugging.

0.18.1 (2016-02-03)

  • (Added) Support for behavior-driven-development using Behave.

0.17.3 (2016-01-29)

  • (Added) An io.text.export_to_tree that returns a textual representation of the states.
  • (Changed) Statechart.rename_to does not anymore raise KeyError but exceptions.StatechartError.
  • (Changed) Wheel build should work on Windows

0.17.1 (2016-01-25)

Many backward incompatible changes in this update, especially if you used to work with model. The YAML format of a statechart also changed, look carefully at the changelog and the documentation.

  • (Added) YAML: an history state can declare on entry and on exit.
  • (Added) Statechart: new methods to manipulate transitions: transitions_from, transitions_to, transitions_with, remove_transition and rotate_transition.
  • (Added) Statechart: new methods to manipulate states: remove_state, rename_state, move_state, state_for, parent_for, children_for.
  • (Added) Steps: __eq__ for MacroStep and MicroStep.
  • (Added) Stories: tell_by_step method for a Story.
  • (Added) Testing: teststory_from_trace generates a step event at the beginning of each step.
  • (Added) Module: a new exceptions hierarchy (see exceptions module). The new exceptions are used in place of the old ones (Warning, AssertionError and ValueError).
  • (Changed) YAML: uppermost states: should be replaced by initial state: and can contain at most one state.
  • (Changed) YAML: uppermost on entry: should be replaced by preamble:.
  • (Changed) YAML: initial memory of an history state should be specified using memory instead of initial.
  • (Changed) YAML: contracts for a statechart must be declared on its root state.
  • (Changed) Statechart: rename StateChart to Statechart.
  • (Changed) Statechart: rename events to events_for.
  • (Changed) Statechart: states attribute is now Statechart.state_for method.
  • (Changed) Statechart: register_state is now add_state.
  • (Changed) Statechart: register_transition is now add_transition.
  • (Changed) Statechart: now defines a root state.
  • (Changed) Statechart: checks done in validate.
  • (Changed) Transition: .event is a string instead of an Event instance.
  • (Changed) Transition: attributes from_state and to_state are renamed into source and target.
  • (Changed) Event: __eq__ takes data attribute into account.
  • (Changed) Event: event.foo raises an AttributeError instead of a KeyError if foo is not defined.
  • (Changed) State: StateMixin.name is now read-only (use Statechart.rename_state).
  • (Changed) State: split HistoryState into a mixin HistoryStateMixin and two concrete subclasses, namely ShallowHistoryState and DeepHistoryState.
  • (Changed) IO: Complete rewrite of io.import_from_yaml to load states before transitions. Parameter names have changed.
  • (Changed) Module: adapt module hierarchy (no visible API change).
  • (Changed) Module: expose module content through __all__.
  • (Removed) Transition: transitions attribute on TransitionStateMixin, use Statechart.transitions_for instead.
  • (Removed) State: CompositeStateMixin.children, use Statechart.children_for instead.

0.16.0 (2016-01-15)

  • (Added) An InternalEvent subclass for model.Event.
  • (Added) Interpreter now exposes its statechart.
  • (Added) Statechart.validate checks that a targeted compound state declares an initial state.
  • (Changed) Interpreter.queue does not accept anymore an internal parameter. Use an instance of InternalEvent instead (#20).
  • (Fixed) Story.story_from_trace now ignores internal events (#19).
  • (Fixed) Condition C3 in Statechart.validate.

0.15.0 (2016-01-12)

  • (Changed) Rename Interpreter.send to Interpreter.queue (#18).
  • (Changed) Rename evaluator module to code.

0.14.3 (2016-01-12)

  • (Added) Changelog.
  • (Fixed) Missing files in MANIFEST.in