Improve API dumping script

* Ensure it runs from the intended directory.
* Clean old API files.
* Stop collapsing overloaded method signatures (done in later step now).
* Invoke implementation-agnostic post-processing script after dumping.
* Make miscellaneous small tweaks.

Author: ctrueden

bin/api.sh

@@ -1,24 +1,32 @@
 #!/bin/sh
 
+cd "$(dirname "$0")/.."
+
+# Check for required cross-implementation script.
+postprocessScript="../appose/bin/postprocess-api.py"
+if [ ! -f "$postprocessScript" ]; then
+  echo "Error: $postprocessScript not found" >&2
+  echo "Please ensure appose repository is cloned as a sibling directory." >&2
+  exit 1
+fi
+
 if [ ! -d target/dependency ]; then
   echo "Copying dependencies..." >&2
   mvn -q dependency:copy-dependencies -DincludeScope=test
 fi
 
-testJar=$(ls target/appose-*-SNAPSHOT-tests.jar 2>/dev/null | head -1)
+# Recompile DumpApi.java to ensure latest changes are used.
+echo "Compiling DumpApi..." >&2
+mvn -q test-compile
 
-# Build the test JAR if necessary (contains DumpApi).
-if [ ! -f "$testJar" ]; then
-  echo "Compiling Java code..." >&2
-  mvn -q -DskipTests package
-  testJar=$(ls target/appose-*-SNAPSHOT-tests.jar 2>/dev/null | head -1)
-  if [ -f "$testJar" ]; then
-    ls -l "$testJar" >&2
-  fi
-fi
+# Clean old api files.
+rm -rf api
 
 # Run DumpApi on source directories.
-# Output will be written to api/appose/*.pyi files
+# Output will be written to api/appose/*.api files
 java \
-  -cp 'target/dependency/*':"$testJar" \
+  -cp 'target/dependency/*:target/test-classes' \
   org.apposed.appose.DumpApi api src/main/java src/test/java
+
+# Post-process API: normalize | None to ?, expand optional parameters.
+python3 "$postprocessScript" api