Add support for docking in lanes that have entry events

[luca-della-vedova]

New feature implementation

Implemented feature

This PR addresses a TODO where having a dock_name property in a waypoint that had an entry or exit event would make the fleet adapter throw an exception.

Implementation description

It turns out there is no issue with exit events, but an implementation has been added for entry events by inserting a waypoint manually, basically the following:

A (entry event) -----> B

becomes

A (entry event) --> D (docking event) --> B

A and D overlap with each other. This has the effect of triggering the entry event first, then the docking event on the way to B.

This behavior is useful in cases where a system integrator wants to use docking in cases where there are entry events. A typical case is having a docking waypoint inside a lift to execute a special behavior to enter it.

[mxgrey]

@luca-della-vedova the change looks good to me, but I'm curious whether this has been tested on a graph that has a docking+event combo?

[luca-della-vedova]

@luca-della-vedova the change looks good to me, but I'm curious whether this has been tested on a graph that has a docking+event combo?

Yap! This is being tested with the TRL project to trigger docking when entering or exiting lifts, i.e. here to enter and here to exit. Without this PR it throws the exception, with the PR it triggers a docking when approaching the waypoints

[mxgrey]

Thanks for getting this to work! The exception was a dirty shortcut that I took a long time ago because I didn't have enough time to think about how best to do it, so I'm glad to see this situation becoming functional.