Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[core] New report format html-report-v2.xslt to provide html with datatable and chart features #4125

Merged
merged 16 commits into from
Jan 26, 2023

Conversation

mohan-chinnappan-n
Copy link
Contributor

Describe the PR

Added pmd-report-v2.xslt to provide html with

  • datatable (search, column sorting and pagination)

  • chart features

  • Screenshot

Screen Shot 2022-09-12 at 7 17 02 PM

Also updated CLI help with a line for this xslt

Related issues

  • Fixes #

Ready?

  • Added unit tests for fixed bug/feature
  • Passing all unit tests
  • Complete build ./mvnw clean verify passes (checked automatically by github actions)
  • Added (in-code) documentation (if needed)

@pmd-test
Copy link

pmd-test commented Sep 12, 2022

1 Message
📖 Compared to master:
This changeset changes 0 violations,
introduces 0 new violations, 0 new errors and 0 new configuration errors,
removes 0 violations, 0 errors and 0 configuration errors.
Full report
Compared to master:
This changeset changes 0 violations,
introduces 0 new violations, 0 new errors and 0 new configuration errors,
removes 0 violations, 0 errors and 0 configuration errors.
Full report
Compared to master:
This changeset changes 0 violations,
introduces 0 new violations, 0 new errors and 0 new configuration errors,
removes 0 violations, 0 errors and 0 configuration errors.
Full report
Compared to master:
This changeset changes 0 violations,
introduces 0 new violations, 0 new errors and 0 new configuration errors,
removes 0 violations, 0 errors and 0 configuration errors.
Full report
Compared to master:
This changeset changes 0 violations,
introduces 0 new violations, 0 new errors and 0 new configuration errors,
removes 0 violations, 0 errors and 0 configuration errors.
Full report
Compared to master:
This changeset changes 0 violations,
introduces 0 new violations, 0 new errors and 0 new configuration errors,
removes 0 violations, 0 errors and 0 configuration errors.
Full report
Compared to master:
This changeset changes 0 violations,
introduces 0 new violations, 0 new errors and 0 new configuration errors,
removes 0 violations, 0 errors and 0 configuration errors.
Full report

Generated by 🚫 Danger

@adangel adangel changed the title Created pmd-report-v2.xslt to provide html with datatable and chart features [core] Improved html report: Created pmd-report-v2.xslt to provide html with datatable and chart features Sep 15, 2022
@adangel adangel self-requested a review September 15, 2022 18:57
@adangel adangel changed the title [core] Improved html report: Created pmd-report-v2.xslt to provide html with datatable and chart features [core] New report format pmd-report-v2.xslt to provide html with datatable and chart features Sep 23, 2022
Copy link
Member

@adangel adangel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the PR!

The screenshot looks impressive, especially the charts are a good idea.

For the available report formats, we have them all mentioned in the documentation (see https://pmd.github.io/latest/pmd_userdocs_report_formats.html). Please add your new format there as well (in this PR).

The name could be simply "html-report-v2.xslt" - since it should be clear that this report is for PMD anyway...

In the documentation we can also describe, that using this report format, various javascript/css sources are loaded from the internets... depending on the environment this might not be allowed and/or possible. So, this report format won't work offline.

There we can also describe the additional features (like pdf export, excel export). Although I'm undecided, whether to include all these features, as it smells like doing too much and a very indirect solution (in order to create a excel file, you first need to create a html report...).

Maybe you can spend some time and look at #4132 (which I've just created) and share your thoughts. It would be interesting to know the different use cases (e.g. why we need a PDF export).

pmd-core/etc/xslt/pmd-report-v2.xslt Outdated Show resolved Hide resolved
<html>
<head>
<title>PMD Report </title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.2.0/dist/css/bootstrap.min.css" integrity="sha384-gH2yIJqKdNHPEq0n4Mqa/HGKIhSkIHeL5AyhkYV8i59U5AR6csBvApHHNl/vI1Bx" crossorigin="anonymous"/>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How should we deal with updates of these libraries? E.g. bootstrap 5.2.1 is now available.
I think, whatever version we use here, it will be outdated very soon. Is this a problem we need to address?

pmd-core/etc/xslt/pmd-report-v2.xslt Outdated Show resolved Hide resolved
pmd-core/etc/xslt/pmd-report-v2.xslt Outdated Show resolved Hide resolved
pmd-core/etc/xslt/pmd-report-v2.xslt Outdated Show resolved Hide resolved
pmd-core/etc/xslt/pmd-report-v2.xslt Outdated Show resolved Hide resolved
pmd-core/etc/xslt/pmd-report-v2.xslt Outdated Show resolved Hide resolved
@mohan-chinnappan-n
Copy link
Contributor Author

mohan-chinnappan-n commented Sep 26, 2022 via email

@adangel adangel marked this pull request as draft September 30, 2022 10:21
@oowekyala
Copy link
Member

Hi @mohan-chinnappan-n, how is it going with this? Do you think we could try schedule it for the next release (in a month)? Please let us know if you need any help
Cheers

@mohan-chinnappan-n
Copy link
Contributor Author

mohan-chinnappan-n commented Oct 25, 2022 via email

@adangel adangel added this to the 6.52.0 milestone Oct 27, 2022
@mohan-chinnappan-n
Copy link
Contributor Author

mohan-chinnappan-n commented Oct 31, 2022 via email

@adangel
Copy link
Member

adangel commented Nov 18, 2022

Hi @mohan-chinnappan-n , any news on this? Can we help?

@adangel adangel modified the milestones: 6.52.0, 6.53.0 Nov 22, 2022
@adangel adangel modified the milestones: 6.53.0, 6.54.0 Dec 31, 2022
@mohan-chinnappan-n mohan-chinnappan-n marked this pull request as ready for review January 17, 2023 09:09
@mohan-chinnappan-n
Copy link
Contributor Author

Created new html-report-v2.xslt based on the comments and feedback

@mohan-chinnappan-n
Copy link
Contributor Author

mohan-chinnappan-n commented Jan 17, 2023 via email

Copy link
Member

@adangel adangel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the update!

  • Please remove the file "pmd-report-v2.xslt", as you have renamed it. We only need "html-report-v2.xslt".
  • Also please add the documentation directly in this PR. This increases the probability that we have the documentation ready when we merge this PR.

pmd-core/etc/xslt/html-report-v2.xslt Outdated Show resolved Hide resolved
pmd-core/etc/xslt/html-report-v2.xslt Outdated Show resolved Hide resolved
@adangel adangel self-assigned this Jan 23, 2023
@adangel adangel added the an:enhancement An improvement on existing features / rules label Jan 23, 2023
@adangel adangel changed the title [core] New report format pmd-report-v2.xslt to provide html with datatable and chart features [core] New report format html-report-v2.xslt to provide html with datatable and chart features Jan 23, 2023
Copy link
Member

@adangel adangel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is ready now

@mohan-chinnappan-n
Copy link
Contributor Author

mohan-chinnappan-n commented Jan 24, 2023 via email

@adangel adangel merged commit e2d6325 into pmd:master Jan 26, 2023
adangel added a commit to adangel/pmd that referenced this pull request Jan 26, 2023
adangel added a commit to adangel/pmd that referenced this pull request Jan 26, 2023
[core] New report format html-report-v2.xslt to provide html with datatable and chart features pmd#4125
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
an:enhancement An improvement on existing features / rules
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants