added getPathBetween method
added test for getPathBetween
docblocks + cs fix
fixed the default direction to null