Add testing infrastructure, docs, and CI

.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 11
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '11'
+
+      - name: Build
+        run: ant compile
+
+      - name: Test
+        run: ant test

.github/workflows/docs.yml

@@ -0,0 +1,48 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'docsite/**'
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Install MkDocs
+        run: pip install mkdocs
+
+      - name: Build site
+        run: mkdocs build
+        working-directory: docsite
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docsite/site
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

build.xml

@@ -50,20 +50,57 @@
     <jar destfile="build/lib.jar" basedir="build/lib" />
   </target>
 
+  <property name="test.jar" value="lib/test-jars/junit-platform-console-standalone-1.10.2.jar"/>
+
   <target name="compile" depends="lib" >
     <mkdir dir="build/qit" />
-    <javac 
-      srcdir="src" 
-      destdir="build/qit" 
-      classpath="build/lib.jar"  
+    <javac
+      srcdir="src"
+      destdir="build/qit"
+      classpath="build/lib.jar"
       excludes="test**"
-      target="11" 
-      source="11" 
-      debug="on" 
+      target="11"
+      source="11"
+      debug="on"
       debuglevel="lines,vars,source"
       includeantruntime="false"/>
   </target>
 
+  <target name="compile-test" depends="compile">
+    <mkdir dir="build/test" />
+    <javac
+      srcdir="test"
+      destdir="build/test"
+      target="11"
+      source="11"
+      debug="on"
+      debuglevel="lines,vars,source"
+      includeantruntime="false">
+      <classpath>
+        <pathelement location="build/qit"/>
+        <pathelement location="build/lib.jar"/>
+        <pathelement location="${test.jar}"/>
+      </classpath>
+    </javac>
+  </target>
+
+  <target name="test" depends="compile-test">
+    <java classname="org.junit.platform.console.ConsoleLauncher"
+          fork="true"
+          failonerror="true">
+      <classpath>
+        <pathelement location="build/test"/>
+        <pathelement location="build/qit"/>
+        <pathelement location="build/lib.jar"/>
+        <pathelement location="${test.jar}"/>
+      </classpath>
+      <arg value="--scan-classpath"/>
+      <arg value="build/test"/>
+      <arg value="--details"/>
+      <arg value="verbose"/>
+    </java>
+  </target>
+
   <target name="jar" depends="compile">
     <jar jarfile="build/qit.jar" >
       <fileset dir="build/qit" />