Convert itkgroup Doxygen script to Python.

[blowekamp]

Relates to: #3654

PR Checklist

• No API changes were made (or the changes have been approved)
• No major design changes were made (or the changes have been approved)
• Added test (or behavior not changed)
• Updated API documentation (or API not changed)
• Added license to new files (if any)
• Added Python wrapping to new files (if any) as described in ITK Software Guide Section 9.5
• Added ITK examples for all new major features (if any)

Refer to the ITK Software Guide for
further development details if necessary.

[blowekamp]

The conversion was mostly done with git Copilot. The the following command was used for comparison the prior version:

 for fn in $(find ./ -name \*.h); do diff <(python ~/src/ITK/Utilities/Doxygen/itkgroup.py $fn) <( perl ~/src/ITK/Utilities/Doxygen/itkgroup.pl $fn) || echo FAILED: $fn; done

[dzenanz]

If this works the same as before, this is good! More people are fluent in Python than Perl.

[jhlegarreta]

Use argparse with a separate method to parse input arguments? This parser method could host the documentation for the file, or else, we could document the file before the first import e.g.

(....)
"""
Docstring.
"""

import argparse
(...)

def _build_arg_parser():

    p = argparse.ArgumentParser(
        description=__doc__,
        formatter_class=argparse.RawTextHelpFormatter
    )
    p.add_argument("filename", type=str, help="Input path.")

    return p

def main():

    parser = _build_arg_parser()
    args = parser.parse_args()
    (...)

if __name__ == "__main__":
    main()

Unless the ITK style is the one you adopted.

[blowekamp]

Use argparse with a separate method to parse input arguments? This parser method could host the documentation for the file, or else, we could document the file before the first import e.g.

(....)
"""
Docstring.
"""

import argparse
(...)

def _build_arg_parser():

    p = argparse.ArgumentParser(
        description=__doc__,
        formatter_class=argparse.RawTextHelpFormatter
    )
    p.add_argument("filename", type=str, help="Input path.")

    return p

def main():

    parser = _build_arg_parser()
    args = parser.parse_args()
    (...)

if __name__ == "__main__":
    main()

Unless the ITK style is the one you adopted.

I'll update to use a proper Python DocString for the file.

This is an improvement to modernize the scripts in a utility function. I do not find the additional effort to refactor the arguments worth the needed time.

[jhlegarreta]

I believe it would be informative to add a commit body message; will let other maintainers to merge.

Thanks for doing this Brad !!