[fix][cli] Dedicated docs tools

[tisonkun]

This closes #18932.

This is a follow-up to #20687. We parse ApiPropertyModel annotations when generate docs in the site repo.

• https://github.com/apache/pulsar-site/blob/e0557ec306143b50d150b7b143ca7fcb9ef0f89e/tools/pytools/lib/execute/config_doc_generator.py
• https://github.com/apache/pulsar-site/actions/runs/5428385621

Factor out a module to handle dependency issues. Also payback some debt that inlines CmdDocGen in core modules.

Verified locally.

I'm preparing a counterpart in the site repo now. See apache/pulsar-site#628

Does this pull request potentially affect one of the following parts:

If the box was checked, please highlight the changes

• Dependencies (add or upgrade a dependency)
• The public API
• The schema
• The default values of configurations
• The threading model
• The binary protocol
• The REST endpoints
• The admin CLI options
• The metrics
• Anything that affects deployment

Documentation

• doc
• doc-required
• doc-not-needed
• doc-complete

Matching PR in forked repository

PR in forked repository:

[tisonkun]

I'm trying to solve #18932 also and avoid compatibility hack in the site repo. I have an idea and am implementing it.

[codecov-commenter]

Codecov Report

Merging #20700 (1577436) into master (e360379) will increase coverage by 0.41%.
The diff coverage is 58.04%.

@@             Coverage Diff              @@
##             master   #20700      +/-   ##
============================================
+ Coverage     72.69%   73.11%   +0.41%     
- Complexity    31878    32092     +214     
============================================
  Files          1871     1868       -3     
  Lines        138982   138937      -45     
  Branches      15283    15275       -8     
============================================
+ Hits         101037   101585     +548     
+ Misses        29873    29306     -567     
+ Partials       8072     8046      -26     

Flag	Coverage Δ
inttests	24.19% <23.52%> (+0.07%)	⬆️
systests	24.98% <21.00%> (-0.06%)	⬇️
unittests	72.40% <58.04%> (+0.46%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
...in/java/org/apache/pulsar/PulsarBrokerStarter.java	34.13% <ø> (ø)
.../org/apache/pulsar/PulsarClusterMetadataSetup.java	72.51% <ø> (ø)
...g/apache/pulsar/PulsarClusterMetadataTeardown.java	75.75% <ø> (ø)
...org/apache/pulsar/PulsarInitialNamespaceSetup.java	75.00% <ø> (ø)
...ava/org/apache/pulsar/PulsarStandaloneStarter.java	35.38% <ø> (ø)
...sar/PulsarTransactionCoordinatorMetadataSetup.java	63.15% <ø> (ø)
...n/java/org/apache/pulsar/PulsarVersionStarter.java	42.30% <ø> (ø)
...pache/pulsar/broker/tools/GenerateDocsCommand.java	77.27% <ø> (ø)
...a/org/apache/pulsar/broker/web/RequestWrapper.java	54.54% <ø> (ø)
...pache/pulsar/broker/web/ResponseHandlerFilter.java	57.14% <ø> (ø)
... and 20 more

... and 118 files with indirect coverage changes

[nicoloboschi]

LGTM

[tisonkun]

Pending to merge...