Architecture

The rsonpath library has to be finely modular for at least three separate reasons. We need to be able to (not necessarily in order of priority):

1. swap parts of the algorithm between generic portable versions and hyperoptimized architecture-specific implementations;
2. swap classifier algorithms in-flight for best engine performance (we call this the State-driven Classifier Pipeline);
3. manage the complexity of the solution, since it would otherwise drive anyone trying to grasp it insane.

If anything, the last point should be the one driving engineering decisions. Remember that Correctness is the core principle, and even the fastest algorithm is useless if it's written in such a complex way it's unmaintainable. Managing complexity is, after all, the primary objective of software engineering.

Overview