Fall2026

.github/workflows/java.yml

@@ -0,0 +1,48 @@
+name: Java
+
+on:
+  push:
+    branches: [Fall2026, editionFirst]
+  pull_request:
+  workflow_dispatch:
+
+defaults:
+  run:
+    working-directory: Java
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      # 21 because pom.xml sets both maven.compiler.source and target to 21.
+      # Temurin rather than the runner's default so the version is pinned rather
+      # than inherited from whatever the image happens to ship.
+      - uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: maven
+
+      - name: Compile, main and test sources
+        run: mvn -B test-compile
+
+      # A plain `mvn test` is a meaningful gate now that CancelOnNotImplemented
+      # reports an unwritten exercise as skipped rather than failed. Before that
+      # roughly a quarter of the suite was red by design, so the build could only
+      # ever be red and said nothing at all.
+      #
+      # Expect around 1208 tests: all passing, about 300 skipped. A skip names
+      # the file and line of the exercise it is waiting for; a failure is a real
+      # problem.
+      - name: Test
+        run: mvn -B test
+
+      - name: Publish the test report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: surefire-reports
+          path: Java/target/surefire-reports/
+          if-no-files-found: warn

.github/workflows/python.yml

@@ -0,0 +1,54 @@
+name: Python
+
+on:
+  push:
+    branches: [Fall2026, editionFirst]
+  pull_request:
+  workflow_dispatch:
+
+defaults:
+  run:
+    working-directory: Python
+
+jobs:
+  test:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        # 3.10 is the floor declared in pyproject.toml; 3.13 guards against
+        # anything that only works on the older interpreter.
+        python-version: ["3.10", "3.13"]
+    env:
+      # NOTE: this must be UV_PYTHON, not `uv sync --python`. The .python-version
+      # file pins 3.10, and `uv run` honours it even after `--python` built the
+      # environment against something else -- so passing the version as a flag
+      # silently tests 3.10 twice. UV_PYTHON takes precedence over the file.
+      UV_PYTHON: ${{ matrix.python-version }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --locked
+
+      - name: Confirm the interpreter under test
+        run: uv run python -V
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Every module under src can be imported
+        run: uv run pytest test/test_imports.py -q
+
+      # A plain pytest is a meaningful gate now that conftest.py reports an
+      # unwritten exercise as skipped: red means a real failure, not coursework
+      # not yet done. Before that it was permanently red and said nothing, which
+      # is what tools/check_stub_failures.py existed to work around.
+      - name: Tests
+        run: uv run pytest -rs

.gitignore

@@ -1,6 +1,6 @@
 # Compiled class file
 *.class
-/target/
+**/target/
 
 # Log filea
 logs/
@@ -22,3 +22,13 @@ bin/*
 *.kml
 
 Java/src/test/java/edu/neu/coe/info6205/admin/TicketTest.java
+
+# Python files
+*.pyc
+**/__pycache__/
+*.pyo
+**/.venv/
+**/.pytest_cache/
+**/.ruff_cache
+
+.DS_Store

Java/pom.xml

@@ -12,19 +12,37 @@
     <version>1</version>
     <build>
         <plugins>
-            <plugin>
+            <!-- <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-compiler-plugin</artifactId>
                 <configuration>
                     <source>17</source>
                     <target>18</target>
                 </configuration>
             </plugin>
+            -->
+            <!--
+              Pinned because the version inherited from the super-POM is 2.12.4,
+              which dates from 2012 and reports a skipped test as a bare
+              <skipped/> with no message. CancelOnNotImplemented reports an
+              unwritten exercise as skipped, carrying the location of the work
+              ("You need to implement the code at Bag_Array.java:187"), and that
+              message is the useful part. Surefire 3.x records it.
+            -->
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-surefire-plugin</artifactId>
+                <version>3.2.5</version>
+            </plugin>
         </plugins>
     </build>
     <properties>
-        <maven.compiler.source>1.17</maven.compiler.source>
-        <maven.compiler.target>1.18</maven.compiler.target>
+        <!-- NOTE: "21", not "1.21". javac only accepts the 1.x form up to 1.10;
+             anything later must be bare. With the compiler plugin commented out
+             above, these properties are what reach javac, so "1.21" fails the
+             build outright with "invalid target release: 1.21". -->
+        <maven.compiler.source>21</maven.compiler.source>
+        <maven.compiler.target>21</maven.compiler.target>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
     </properties>
@@ -35,15 +53,34 @@
         </repository>
     </repositories>
     <dependencies>
+        <!--
+        <dependency>
+            <groupId>com.phasmidsoftware</groupId>
+            <artifactId>gryphon_3</artifactId>
+            <version>1.3.0</version>
+            <scope>system</scope>
+            <systemPath>${user.home}/.m2/repository/com/phasmidsoftware/gryphon_3/1.3.0/gryphon_3-1.3.0.jar</systemPath>
+        </dependency>
+        <dependency>
+            <groupId>com.phasmidsoftware</groupId>
+            <artifactId>visitor_3</artifactId>
+            <version>1.5.0</version>
+        </dependency>
+        -->
+        <dependency>
+            <groupId>com.phasmidsoftware</groupId>
+            <artifactId>gryphon_3</artifactId>
+            <version>1.3.0</version>
+        </dependency>
         <dependency>
             <groupId>com.phasmidsoftware</groupId>
             <artifactId>args_2.13</artifactId>
             <version>1.0.3</version>
         </dependency>
         <dependency>
             <groupId>com.phasmidsoftware</groupId>
-            <artifactId>number_2.13</artifactId>
-            <version>1.0.12</version>
+            <artifactId>number_3</artifactId>
+            <version>1.9.3</version>
         </dependency>
       <dependency>
             <groupId>org.apache.logging.log4j</groupId>
@@ -104,4 +141,4 @@
                 </dependency>
                 -->
     </dependencies>
-</project>
+</project>

Java/src/it/java/com/phasmidsoftware/dsaipg/adt/hashtable/FrequencyCounterFuncTest.java

@@ -22,4 +22,4 @@ public void testIncrementVeryLargeCount() {
         }
         assertEquals((long) Integer.MAX_VALUE / 2, fc.get(key).intValue());
     }
-}
+}

Java/src/it/java/com/phasmidsoftware/dsaipg/sort/BenchmarksLong.java

@@ -77,4 +77,4 @@ public void runBenchmark(String description, Sort<Integer> sort, Helper<Integer>
 
     private static Config config;
 
-}
+}

Java/src/it/java/com/phasmidsoftware/dsaipg/sort/counting/MSDStringSortFuncTest.java

@@ -129,7 +129,7 @@ static String[] getWords(final String resource, final Function<String, List<Stri
         try {
             final File file = new File(getPathname(resource, MSDStringSortFuncTest.class));
             final String[] result = getWordArray(file, stringListFunction, 2);
-            System.out.println("getWords: testing with " + Utilities.formatWhole(result.length) + " unique words: from " + file);
+            System.out.println("getWords: testing with " + Utilities.formatWholeWithCommas(result.length) + " unique words: from " + file);
             return result;
         } catch (final FileNotFoundException e) {
             System.out.println("Cannot find resource: " + resource);

Java/src/main/java/com/phasmidsoftware/dsaipg/adt/array/OrderedArray.java

@@ -179,4 +179,4 @@ private static <T extends Comparable<T>> Comparator<Object> getComparator() {
     private Object[] array;
 
     private int size;
-}
+}

Java/src/main/java/com/phasmidsoftware/dsaipg/adt/balsearchtree/TwoFourTree.java

@@ -64,4 +64,4 @@ public Node(Value value, Key key1, Key key2, Key key3) {
 //        Node n = cf(key, node, node.key1, node.left);
 //        if (n)
 //    }
-}
+}

Java/src/main/java/com/phasmidsoftware/dsaipg/adt/bqs/BQSException.java

@@ -25,4 +25,4 @@ public BQSException(String msg) {
     public BQSException(Exception x) {
         super(x);
     }
-}
+}

Java/src/main/java/com/phasmidsoftware/dsaipg/adt/bqs/Bag.java

@@ -46,10 +46,29 @@ public interface Bag<Item> extends SizedIterable<Item> {
      *
      * @return this Bag as an array of Objects.
      */
-    Item[] asArray();
+    Object[] asArray();
+
+    /**
+     * Method to get this Bag as an array of the same component type as the one
+     * supplied.
+     * <p>
+     * The array carries the type information that {@link #asArray()} cannot: Item
+     * is erased, so there is nothing at runtime to say what kind of array to
+     * allocate, and the caller supplying one settles it. This is exactly
+     * {@link java.util.Collection#toArray(Object[])}, and for exactly the same
+     * reason — call it with {@code new Item[0]} to get a genuinely typed array
+     * back.
+     *
+     * @param a   an array of the desired component type. It is filled and returned
+     *            if it is big enough; otherwise a new one of the same type is
+     *            allocated.
+     * @param <T> the component type.
+     * @return this Bag as an array of T.
+     */
+    <T> T[] asArray(T[] a);
 
     /**
      * Empty out this Bag
      */
     void clear();
-}
+}