This is a fork of the google-java-format project that seeks to conform to the style guide set by UCF's Sean Szulmanski. This project may require permission from Sean Szulmanski for its naming or usage. It is almost fully functional, but is still a work-in-progress.

WARNING: This program is not responsible for loss of code/problems that it may cause. Always backup your source code, using either a local .git or some other manual or automatic backup service. This program is ALSO not responsible for ensuring the complete formatting correctness of your program (Although I hope it outputs as such).

NOTE: I modified ~100 lines of code; the vast majority of this codebase is not my work. Use the commit history to see where this project and the original diverged. HUGE thanks to the original Google authors of google-java-format.

Download the jar from the Releases tab. Install the jar anywhere into your System Path, or just put the jar in with the rest of your source code. Execute java -jar google-java-format-szumver-1.1.jar -r <.java file>.

This format does not exactly match Sean Szulmanski's, but should be a subset of it.

• A header must be included with // comments at the very top of the file, in the format: (warning)

// <FirstName> <Last Name>, <NID>
// <Course Number/String>, <Spring|Fall|Summer> <4-digit (with MSD != 0) non-negative Semester Year>
// <Description of program in 1+ lines>

• Indenting is done with 4 spaces per level (formatted)
• All methods in a file are seperated by a blank line (formatted)
• Braces are Allman style (formatted)
• Max column width is 100 (formatted)
• Binary operators have a single space one both sides (formatted)
• There are no spaces between method names and their argument lists (formatted)
• There is a single space before conditional keywords and their "argument list"s (formatted)
• Slash-star comments (/* */) are dissallowed anywhere in the file (warning)
• Slash-slash comments (//) are dissallowed when trailing statements (but OK on lines by themselves) (warning)
• Var keyword is disallowed (warning)
• Class/method names follow Java conventions (warning)
• By default, any formatting not listed here is handled by the the style guide set by Google

The rest of this README is copied from the original project.

google-java-format is a program that reformats Java source code to comply with Google Java Style.

Download the formatter and run it with:

java -jar /path/to/google-java-format-1.7-all-deps.jar <options> [files...]

The formatter can act on whole files, on limited lines (--lines), on specific offsets (--offset), passing through to standard-out (default) or altered in-place (--replace).

To reformat changed lines in a specific patch, use google-java-format-diff.py.

Note: There is no configurability as to the formatter's algorithm for formatting. This is a deliberate design decision to unify our code formatting on a single format.

A google-java-format IntelliJ plugin is available from the plugin repository. To install it, go to your IDE's settings and select the Plugins category. Click the Marketplace tab, search for the google-java-format plugin, and click the Install button.

The plugin will be disabled by default. To enable it in the current project, go to File→Settings...→google-java-format Settings (or IntelliJ IDEA→Preferences...→Other Settings→google-java-format Settings on macOS) and check the Enable google-java-format checkbox. (A notification will be presented when you first open a project offering to do this for you.)

To enable it by default in new projects, use File→Other Settings→Default Settings....

When enabled, it will replace the normal Reformat Code action, which can be triggered from the Code menu or with the Ctrl-Alt-L (by default) keyboard shortcut.

The import ordering is not handled by this plugin, unfortunately. To fix the import order, download the IntelliJ Java Google Style file and import it into File→Settings→Editor→Code Style.

A google-java-format Eclipse plugin can be downloaded from the releases page. Drop it into the Eclipse drop-ins folder to activate the plugin.

The plugin adds a google-java-format formatter implementation that can be configured in Window > Preferences > Java > Code Style > Formatter > Formatter Implementation.

• Gradle plugins
  • Spotless:
  • sherter/google-java-format-gradle-plugin
• Apache Maven plugins
  • coveo/fmt-maven-plugin
  • talios/googleformatter-maven-plugin
  • Cosium/maven-git-code-format: A maven plugin that automatically deploys google-java-format as a pre-commit git hook.
• SBT plugins
  • sbt/sbt-java-formatter
• maltzj/google-style-precommit-hook: A pre-commit (pre-commit.com) hook that will automatically run GJF whenever you commit code to your repository

The formatter can be used in software which generates java to output more legible java code. Just include the library in your maven/gradle/etc. configuration.

<dependency>
  <groupId>com.google.googlejavaformat</groupId>
  <artifactId>google-java-format</artifactId>
  <version>1.7</version>
</dependency>

dependencies {
  compile 'com.google.googlejavaformat:google-java-format:1.7'
}

You can then use the formatter through the formatSource methods. E.g.

String formattedSource = new Formatter().formatSource(sourceString);

or

CharSource source = ...
CharSink output = ...
new Formatter().formatSource(source, output);

Your starting point should be the instance methods of com.google.googlejavaformat.java.Formatter.

mvn install

Please see the contributors guide for details.

Copyright 2015 Google Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not
use this file except in compliance with the License. You may obtain a copy of
the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations under
the License.