O'Doyle Rules Cookbook - Githubissues

thomascothran commented 2 years ago

I think it would be helpful to document common tips and tricks for using O'Doyle Rules, similar to cookbooks like this

If it is helpful, I can put together a PR with some patterns that have emerged for me while using O'Doyle Rules. Some examples:

"Fetcher" rules, which will pull an entity from a database when the entity's id is added
Locating aggregates at [:global :domain/entities entities]
"Unpacking" aggregates. For example, if an aggregate is at [:global :domain/entity entites], a rule can use o/insert! to insert the triples.
Defining different rulesets separately and merging them together
A set of directives at [:global :directives directives] which can be used to signal things to rules. For example, if :db is not in the directives, the rules which fetch entities from a database will not fire.
Different tricks around initializing values.

oakes commented 2 years ago

That would be excellent. Maybe make it a separate file since the readme is already gigantic :D I'm interested to read what patterns you've come up with. I've been using to build a fairly complex system for my company (i think around 70 rules) and i bet we've come up with similar things. I could add to it as well.

oakes commented 1 year ago

I ended up cutting a release, see the notes here:

https://github.com/oakes/odoyle-rules/releases/tag/1.0.0

The new debugging section shows how to use wrap-rule. I improved the function quite a bit and it now lets you track when individual facts reach each rule.

thomascothran commented 1 year ago

The wrap-rule functionality is great. I've done a little with it, and it's super helpful so far! Thanks @oakes

oakes / odoyle-rules

O'Doyle Rules Cookbook #17