README

A Sage instance allows you to

Transparently access data stored in Repositories of different types (PDO, Array, Cache, NdJson files, etc) as in-memory arrays
Traverse relations (one-to-many, many-to-one) between them
Access virtual fields (akin to GraphQL field resolvers) for modifications, calculations and other advanced use-cases

Sage can be thought of as a supersedence of linkorb/context.

Usage

Instantiate a new Sage\Sage instance
Instantiate a Repository for each table/collection you'd like to access
Attach the Repositories to the Sage instance
Add "Virtual Fields" to specify relations between tables or add data modifiers
Query tables using common findAll() with conditions
Access the resulting rows as an array, allowing you to traverse the array as if it is all in-memory (Sage lazy-loads accessed rows behind the scenes).

Sage: A collection of repositories and virtual fields
Repository: Analogue to a database table/collection. May be backed by different storage methods (see src/Repository/ for current implementations)
Record: An in-memory Record can be accessed as an array ($user['name']) and supports many-to-one and one-to-many relations to other tables though virtual fields

Rapid application development: You don't need to model objects (with getters/setters/etc) in order to work with them. Just load raw data (from json, yaml, arrays, pdo, etc for example) and you're ready to traverse the repositories and records within it.
Complex medical record mapping/conversion: Use a "context" (subset of records pertaining to a single medical record or patient) then easily traverse it through it's relations.
Structured Documentation: Model information according to it's domain, then load it into a Context and use (twig/mustache/handlebars) templates to traverse the information.
GraphQL datastore: A Sage instance is in essence a Graph. A context can therefor be used to generate a GraphQL server which can be used by other applications to easily query the context in a format of their choosing.
Natural user interface/email/view generation: Simply define a context into a view, and loop over it with any template language such as twig, handlebars, mustache, etc. No further controller logic required.

Check out our other projects at linkorb.com/engineering.

Btw, we're hiring!