Skip to content

Commit

Permalink
Introduce version 7.5
Browse files Browse the repository at this point in the history
  • Loading branch information
giancosta86 committed Apr 19, 2015
1 parent 86d76e4 commit 93cd1b5
Show file tree
Hide file tree
Showing 118 changed files with 9,124 additions and 4 deletions.
2 changes: 2 additions & 0 deletions .gitignore
@@ -0,0 +1,2 @@
target/**
**/*.html_*
7 changes: 3 additions & 4 deletions LICENSE
Expand Up @@ -631,8 +631,8 @@ to attach them to the start of each source file to most effectively
state the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.

{one line to give the program's name and a brief idea of what it does.}
Copyright (C) {year} {name of author}
<one line to give the program's name and a brief idea of what it does.>
Copyright (C) <year> <name of author>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
Expand All @@ -652,7 +652,7 @@ Also add information on how to contact you by electronic and paper mail.
If the program does terminal interaction, make it output a short
notice like this when it starts in an interactive mode:

{project} Copyright (C) {year} {fullname}
<program> Copyright (C) <year> <name of author>
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
Expand All @@ -672,4 +672,3 @@ may consider it more useful to permit linking proprietary applications with
the library. If this is what you want to do, use the GNU Lesser General
Public License instead of this License. But first, please read
<http://www.gnu.org/philosophy/why-not-lgpl.html>.

84 changes: 84 additions & 0 deletions README.md
@@ -0,0 +1,84 @@
# EasyPmd

*Seamlessly integrates PMD into your NetBeans IDE*


## Introduction

*Elegance always matters, especially when
creating software.*

However, a universal definition of such an ambitious goal seems to be fairly difficult, if not impossible, as different programmers adopt different styles.

PMD is a Java library/tool allowing you to scan your code and detecting *violations* of the *rules* that you requested to enforce: this introduces a great deal of flexibility, in particular if you consider that you can both use a wide range of predefined rules *and* write your own rules: for example, the predefined ruleset *rulesets/unusedcode.xml* will make PMD scan your source files for unused private fields, unused private methods, unused local variables and so on. Of course, you can instruct PMD to use *multiple rulesets simultaneously*.

PMD can be run both as a library and as a standalone program, and several excellent IDE plugins are now available, some of which target NetBeans: EasyPmd is designed as an open source plugin for NetBeans which seamlessly integrates the PMD scanning engine into NetBeans, by making PMD violation reports automatically appear both in the *Action items* window and in the editor: you just have to specify the scanning scope (current file, main project, all projects) in the *Action items* window.

The current major version provides a simplified, more elegant architecture, based on Helios, and *profiles*, to let you easily switch between multiple configurations.

The overall build process is based on Maven 3, for elegance and robustness.


## Features

* Includes PMD 5, compatible with Java 8.

* Fully-refactored, much better and faster architecture, relying on Helios and Maven 3.

* Automatically runs PMD on the files of your current task scope (selected in the *Action items* window).

* Reports every PMD violation both in the *Action Items* window and in the editor's side bar.

* Option field for setting PMD's *auxiliary classpath*

* **Supports profiles:** you can easily change the plugin's options simply by changing the active profile.

* **Glyphs of different colors for different priorities:** ranging from full green to full red - according to the priority of the rule that is is bound to each violation.

* **Priority filtering:** in the configuration dialog, one can choose the minimum priority level that PMD will consider when applying rules.

* **Optional priority label in task descriptions:** each violation in the *Action items* window shows its priority by default - one can therefore sort violations just by clicking the *Description* header.

* Includes a copy of PMD, for a safer and much faster execution.

* **Robustness:** most execution errors, should they occur, are caught and reported in the tasks list, without crashing the plugin.

* **Integrated cache:** to ensure maximum speed and avoid repeated scans, EasyPmd features a cache which is also persisted to disk, so it is available even after you restart NetBeans.

* You can extensively customize EasyPmd and the underlying PMD engine via a user-friendly options dialog.

* **Custom path filtering** (including and excluding paths), based on *regular expressions*.

* Predefined, customizable regular expressions, to simplify path filtering.

* Online help, integrated into the NetBeans help system.



## Requirements

EasyPmd 7 requires NetBeans 8+ and Java 8+.



## Installation

EasyPmd can be easily installed from within NetBeans, as explained in the tutorials below.

Alternatively, you can download the **.nbm** files from GitHub or from the NetBeans Plugin Portal.




## Tutorials on YouTube

* [Getting started - English version](https://www.youtube.com/watch?v=BsMx6PNn0aI)

* [Getting started - Version française](https://www.youtube.com/watch?v=3k4Fk43u0QE)



## Further references

* [PMD](http://pmd.sourceforge.net/)
* [Facebook page](https://www.facebook.com/easypmd)
118 changes: 118 additions & 0 deletions mainIcon.svg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added pluginPortal/FullSizeImage.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added pluginPortal/ThumbnailImage.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 93cd1b5

Please sign in to comment.