Skip to content

jpace/diffj

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DiffJ

DiffJ compares Java files based on their code, without regard to formatting, organization, comments, or whitespace. Differences are reported as to the precise type of change.

DiffJ was designed for comparing code when refactoring and reformatting, with the differences narrowed to the extent possible, thus isolating changes.

SUMMARY

diffj [ options ] from-file to-file

FEATURES

Understanding Java content: DiffJ handles Java syntax (through version 1.6, at this writing), and compares code based on the actual Java code, not line-by-line.

For example, the following are considered equivalent:

    Integer[] ary  =  new Integer[ index( str, ch ) + str.length( ) ];
    
    Integer[] ary = new Integer[index(str, ch) + str.length()];

Ignoring whitespace. DiffJ ignores whitespace when comparing code, so it works well when, for example, tabs have been replaced with spaces, when indentation levels have changed, or when the end-of-line style has changed.

Ignoring order of declarations. DiffJ does not consider the organization of the code, such as the order of methods within a class. Thus if methods are reordered (perhaps by accessibility), DiffJ will not report that as being a difference, since the code itself has not changed. The order of declarations applies to all Java type declarations (inner classes, fields, methods, and constructors).

Ignoring order of import statements. As with declarations, DiffJ does not consider reordered import statements to be a change in the code.

Ignoring comments: DiffJ skips comments when comparing code. Thus comments that have been updated (perhaps as a result of running DoctorJ) will not be seen as a change.

Showing added and deleted declarations: DiffJ reports declarations that have been added and deleted, described by their Java type. For example:

d0/Removed.java <=> d1/Removed.java
2,3d1,4 method removed: contender(Double[], StringBuilder)
  class Removed {
!     public void contender(Double[] dary, StringBuilder sb) {
!     }
  
      public void contender() {
      }

Showing parameters: DiffJ reports constructor and methods parameters that have been added, deleted, and changed:

2c2 parameter name changed from idx to index
  class Changed {
!     void changed(int idx) {
      }
  }

  class Changed {
!     void changed(int index) {
      }
  }

Showing code differences narrowly: DiffJ reports the actual location (lines and columns) of code changes, and the output (in context and highlight mode) displays the exact change. Thus if a variable changes within a line of code, that variable itself is highlighted for the from- and to-files.

An example: the example below is contrived, in that differences are marked <like so;>. In the real world (where GitHub doesn't strip font colors) the output is in glorious color(s).

code>./example/d0/Changed.java <=> ./example/d1/Changed.java
9,28a21,22 method added: newMethod()
          this.size = size;
      }
  
!     public <void newMethod() {>
! <    }>
  }

10c8 implemented type changed from Map to List
  import java.io.File;
  
  abstract public class Changed 
!     implements <Map>
   {
  
    public void obsoleteMethod() {

  import java.util.List;
  import java.util.Map;
  
! public abstract class Changed implements <List> {
      /**
       * The maximum size of this object.
       */

13,14d8,23 method removed: obsoleteMethod()
      implements Map
   {
  
!   public <void obsoleteMethod() {>
! <  }>
  
    public Changed( int  s ) 
     {

16c17 parameter name changed from s to size
    public void obsoleteMethod() {
    }
  
!   public Changed( int  <s> ) 
     {
       size = s;
     }

      private final int size;
      private int index;
  
!     public Changed(int <size>) {
          this.size = size;
      }
  

18c18 code changed in Changed(int)
  
    public Changed( int  s ) 
     {
!      <size = s>;
     }
  
    private int size;

      private int index;
  
      public Changed(int size) {
!         <this.size = size>;
      }
  
      public void newMethod() {

21c14 modifier added: final
       size = s;
     }
  
!   <private> int size;
  
    // @todo - comment this field
    static final public int MAX_SIZE = 317;

       */
      public final static int MAX_SIZE = 317;
  
!     private <final> int size;
      private int index;
  
      public Changed(int size) {

26c15 variable changed from idx to index
    // @todo - comment this field
    static final public int MAX_SIZE = 317;
  
!   private int <idx>;
      
  }

      public final static int MAX_SIZE = 317;
  
      private final int size;
!     private int <index>;
  
      public Changed(int size) {
          this.size = size;

Configuration files: DiffJ looks for a configuration file as ~/.diffrc, and uses the name/value pairs there for its options. All options are supported, with the syntax "name: value". For boolean options (such as --highlight/--no-highlight), the value should be either true or false.

As an example, the following file sets DiffJ to use the source version as 1.6, and to show context with non-default colors:

context: true
highlight: true
from-color: bold blue on green
to-color: underscore magenta on cyan

OPTIONS

--brief   
    Display output in brief form.

--context
    Show context (non-brief form only).

--[no-]highlight
    Use colors (context output only).

--recurse
    Process directories recursively.

--from-source VERSION
    The Java source version of from-file (default: 1.5).

--to-source VERSION
    The Java source version of to-file (default: 1.5).

--from-color COLOR
    The text color of the from-file text (default: red).

--to-color COLOR
    The text color of the to-file text (default: yellow).

--source VERSION
    The Java source version of from-file and to-file (default: 1.5).

-u
    Output unified context. Unused; exists for compatibility with GNU diff.

-L NAME  --name NAME
    Set the first/second name to be displayed. This is useful for diffing
    with an external program, such as svn, where the file names are the temp
    files, and which passes in the real names as arguments.

--verbose
    Run in verbose mode (for debugging).

-h  --help
    Show help summary.

-v  --version
    Display the version.

EXAMPLES

% diffj old/Foo.java new/Foo.java
    Compares the two files, in the brief output format.

% diffj --context branches/3.1.4 trunk
    Compares the files in the two directories, reporting their differences
    with context.

% diffj --highlight -r branches/3.1.4 branches/3.1.5
    Compares the two directories recursively, reporting their differences
    with context, and changes highlighted.

% diffj --highlight --from-color "bold red on white" --to-color "cyan on black" ../v1.2.3 .
    Displays differences in the given colors.

% diffj --from-source 1.4 --to-source 1.6 -r ~myproj/old ~myproj/current
    Compares the code, using Java 1.4 as the source of the from-files, and
    1.6 as the source for the to-files.

DOWNLOAD

Source:

*Github*: https://github.com/jpace/diffj

Binaries

*Tarball*: 

*Zip*: 

*Debian*: 

About

A command line application to compare Java files without regard to formatting.

Resources

Stars

Watchers

Forks

Packages

No packages published