coop/rose-ash
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

datalog: refresh datalog.sx API doc with magic-sets + later additions
Some checks failed
Test, Build, and Deploy / test-build-deploy (push) Failing after 24s
Details

Browse Source
This commit is contained in:
giles
2026-05-08 10:08:58 +00:00
parent 5100c5d5a6
commit ce8fed6b22
1 changed files with 18 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
lib/datalog/datalog.sx
View File

@@ -14,6 +14,7 @@
;; (load "lib/datalog/strata.sx") ;; (load "lib/datalog/strata.sx")
;; (load "lib/datalog/eval.sx") ;; (load "lib/datalog/eval.sx")
;; (load "lib/datalog/api.sx") ;; (load "lib/datalog/api.sx")
;; (load "lib/datalog/magic.sx")
;; (load "lib/datalog/demo.sx") ;; (load "lib/datalog/demo.sx")
;; ;;
;; (lib/datalog/conformance.sh runs this load list automatically.) ;; (lib/datalog/conformance.sh runs this load list automatically.)
@@ -35,10 +36,15 @@
;; (dl-rule head body) dict-rule constructor ;; (dl-rule head body) dict-rule constructor
;; (dl-add-clause! db clause) parser output → fact or rule ;; (dl-add-clause! db clause) parser output → fact or rule
;; (dl-load-program! db src) string source ;; (dl-load-program! db src) string source
;; (dl-set-strategy! db strategy) :semi-naive default; :magic
;; is informational, use
;; dl-magic-query for actual
;; magic-sets evaluation
;; ;;
;; Mutation: ;; Mutation:
;; (dl-assert! db lit) add + re-saturate ;; (dl-assert! db lit) add + re-saturate
;; (dl-retract! db lit) drop EDB, wipe IDB, re-saturate ;; (dl-retract! db lit) drop EDB, wipe IDB, re-saturate
;; (dl-clear-idb! db) wipe rule-headed relations
;; ;;
;; Query / inspection: ;; Query / inspection:
;; (dl-saturate! db) stratified semi-naive default ;; (dl-saturate! db) stratified semi-naive default
@@ -48,6 +54,18 @@
;; (dl-relation db rel-name) tuple list for a relation ;; (dl-relation db rel-name) tuple list for a relation
;; (dl-rules db) rule list ;; (dl-rules db) rule list
;; (dl-fact-count db) total ground tuples ;; (dl-fact-count db) total ground tuples
;; (dl-summary db) {<rel>: count} for inspection
;;
;; Single-call convenience:
;; (dl-eval source query-source) parse, run, return substs
;; (dl-eval-magic source query-source) single-goal → magic-sets
;;
;; Magic-sets (lib/datalog/magic.sx):
;; (dl-adorn-goal goal) "b/f" adornment string
;; (dl-rule-sips rule head-adn) SIPS analysis per body lit
;; (dl-magic-rewrite rules rel adn args)
;; rewritten rule list + seed
;; (dl-magic-query db query-goal) end-to-end magic-sets query
;; ;;
;; ── Body literal kinds ───────────────────────────────────────────── ;; ── Body literal kinds ─────────────────────────────────────────────
;; ;;