(pulsar-site) 07/12: Support newer ASF Maven POM for javadoc generation

[lhotari]

This is an automated email from the ASF dual-hosted git repository.

lhotari pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/pulsar-site.git

commit b7aa650d76e16f380a040a672214f7b71ae5cf53
Author: Lari Hotari <lhot...@users.noreply.github.com>
AuthorDate: Sat Sep 27 08:41:34 2025 +0300

    Support newer ASF Maven POM for javadoc generation
---
 tools/pytools/lib/execute/javadoc_generator.py | 23 ++++++++++++++++++++---
 1 file changed, 20 insertions(+), 3 deletions(-)

diff --git a/tools/pytools/lib/execute/javadoc_generator.py 
b/tools/pytools/lib/execute/javadoc_generator.py
index e555ed99b39..dbe3e82dce0 100644
--- a/tools/pytools/lib/execute/javadoc_generator.py
+++ b/tools/pytools/lib/execute/javadoc_generator.py
@@ -27,6 +27,20 @@ from command import find_command, run
 from constant import site_path
 
 
+def find_apidocs_path(base_path):
+    """Find the apidocs directory, checking common locations."""
+    candidates = [
+        base_path / 'target' / 'site' / 'apidocs',
+        base_path / 'target' / 'reports' / 'apidocs'
+    ]
+    
+    for path in candidates:
+        if path.exists():
+            return path
+    
+    raise FileNotFoundError(f"Could not find apidocs in any of: {candidates}")
+
+
 def execute(dir_or_version: str):
     mvn = find_command('mvn', msg="mvn is required")
     
@@ -60,14 +74,17 @@ def execute(dir_or_version: str):
     # client
     dst = site_path() / 'static' / 'api' / 'client' / v
     run(mvn, '-Dlocale=en_US', '-pl', 'pulsar-client-api', 'javadoc:javadoc', 
cwd=src)
-    shutil.copytree(src / 'pulsar-client-api' / 'target' / 'site' / 'apidocs', 
dst)
+    client_apidocs = find_apidocs_path(src / 'pulsar-client-api')
+    shutil.copytree(client_apidocs, dst)
 
     # admin
     dst = site_path() / 'static' / 'api' / 'admin' / v
     run(mvn, '-Dlocale=en_US', '-pl', 'pulsar-client-admin-api', 
'javadoc:javadoc', cwd=src)
-    shutil.copytree(src / 'pulsar-client-admin-api' / 'target' / 'site' / 
'apidocs', dst)
+    admin_apidocs = find_apidocs_path(src / 'pulsar-client-admin-api')
+    shutil.copytree(admin_apidocs, dst)
 
     # function
     dst = site_path() / 'static' / 'api' / 'pulsar-functions' / v
     run(mvn, '-Dlocale=en_US', '-pl', 'api-java', 'javadoc:javadoc', cwd=(src 
/ 'pulsar-functions'))
-    shutil.copytree(src / 'pulsar-functions' / 'api-java' / 'target' / 'site' 
/ 'apidocs', dst)
\ No newline at end of file
+    function_apidocs = find_apidocs_path(src / 'pulsar-functions' / 'api-java')
+    shutil.copytree(function_apidocs, dst)
\ No newline at end of file