Merge pull request #833 from clulab/kwalcock/v10debugger

Add debugger subproject to v10

Author: kwalcock

build.sbt

@@ -1,26 +1,29 @@
+// These were last checked on 2025-02-19.
 val scala211 = "2.11.12" // up to 2.11.12
-val scala212 = "2.12.19" // up to 2.12.19
-val scala213 = "2.13.14" // up to 2.13.14
+val scala212 = "2.12.19" // up to 2.12.20
+val scala213 = "2.13.14" // up to 2.13.16
 val scala30  = "3.0.2"   // up to 3.0.2
 val scala31  = "3.1.3"   // up to 3.1.3
 val scala32  = "3.2.2"   // up to 3.2.2
-val scala33  = "3.3.3"   // up to 3.3.3
-val scala34  = "3.4.2"   // up to 3.4.2
-
-val scala3   = scala31
+val scala33  = "3.3.5"   // up to 3.3.5 (LTS)
+val scala34  = "3.4.3"   // up to 3.4.3
+val scala35  = "3.5.2"   // up to 3.5.2
+val scala36  = "3.6.3"   // up to 3.6.3
 
 // See https://www.scala-lang.org/blog/2022/08/17/long-term-compatibility-plans.html.
 // Scala30: "If you are maintaining a library, you should drop Scala 3.0."  Dropped.
 // Scala31: This is a LTS (long term support) version before it was called that.
 // Scala32: This is for experimentation, as in Scala Next, and not for release.
 // Scala33: This is the first official LTS, but hold off until necessary.
+val scala3 = scala31
+
 ThisBuild / crossScalaVersions := Seq(scala212, scala211, scala213, scala3)
 ThisBuild / scalaVersion := crossScalaVersions.value.head
 
 lazy val root = (project in file("."))
   // Skip webapp because it only works for particular Scala versions.
   // It needs to be released separately (if at all).
-  .aggregate(library, apps)
+  .aggregate(library, apps, debugger)
   .settings(
     publish / skip := true
   )
@@ -42,4 +45,7 @@ lazy val webapp = project
     crossScalaVersions := Seq(scala212)
   )
 
+lazy val debugger = project
+    .dependsOn(library % "compile -> compile; test -> test")
+
 addCommandAlias("dockerizeWebapp", ";webapp/docker:publishLocal")

debugger/build.sbt

@@ -0,0 +1,11 @@
+name := "processors-debugger"
+description := "A debugger for the Odin ExtractionEngine within processors"
+
+libraryDependencies ++= {
+  Seq(
+    "com.lihaoyi" %% "scalatags"        % "0.12.0", // as of 2025-02-19 up to 0.13.1
+    "com.lihaoyi" %% "sourcecode"       % "0.3.0",  // as of 2025-01-27 up to 0.4.2
+
+    "org.clulab"   % "processors-model" % "0.3.1"
+  )
+}

debugger/publish.sbt

@@ -0,0 +1 @@
+Compile / packageBin / mainClass := None

debugger/src/main/resources/org/clulab/odin/debugger/FOOD.tsv

@@ -0,0 +1,4 @@
+cake
+pizza
+burger
+pain au chocolat

debugger/src/main/resources/org/clulab/odin/debugger/entities.yml

@@ -0,0 +1,27 @@
+- name: foods-from-lexicon
+  priority: ${rulepriority}
+  label: Food
+  type: token
+  pattern: |
+    [entity='B-FOOD'] [entity='I-FOOD']+
+
+- name: person-from-lexicon
+  priority: ${rulepriority}
+  label: Person
+  type: token
+  pattern: |
+    [entity='B-PER'] [entity='I-PER']*
+
+- name: more-foods-from-lexicon
+  priority: ${rulepriority}
+  label: Food
+  type: token
+  pattern: |
+    (?<= hello there) [entity='B-FOOD'] [entity='I-FOOD']* @theme:Person $
+
+- name: more-person-from-lexicon
+  priority: ${rulepriority}
+  label: Person
+  type: token
+  pattern: |
+    ^ @theme:Food [entity='B-PER'] [entity='I-PER']* (?= goodbye)

debugger/src/main/resources/org/clulab/odin/debugger/events.yml

@@ -0,0 +1,10 @@
+
+- name: people-eat-food
+  priority: ${rulepriority}
+  label: Eating
+  example: "John eats cake"
+  graph: "hybrid"
+  pattern: |
+    trigger = [lemma=/eat/ & tag=/^V/]
+    food:Food = dobj
+    person:Person = nsubj

debugger/src/main/resources/org/clulab/odin/debugger/main.yml

@@ -0,0 +1,19 @@
+
+taxonomy:
+  - Entity:
+    - Food
+    - Person
+  - Event:
+    - Eating
+
+rules:
+  - import: org/clulab/odin/debugger/entities.yml
+    vars:
+      # We need our entities before we can match events
+      # Here we make use of the ${rulepriority} variable
+      # used in the entities.yml rules
+      rulepriority: "1"
+
+  - import: org/clulab/odin/debugger/events.yml
+    vars:
+      rulepriority: "2"