commit 735766bcb647d1b2d39387903d9ae6514d218d9b
Author: Paul Campbell <pcampbell@kemitix.net>
Date:   Tue Aug 2 19:51:59 2016 +0100

    Initial commit

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..7933d63
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,51 @@
+# Package Files #
+*.jar
+*.war
+*.ear
+*.zip
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+
+# maven build outputs
+target/
+
+# netbeans legacy
+nbproject/
+nbactions.xml
+
+# eclipse legacy
+.project
+
+# intellij
+.idea/libraries/
+.idea/workspace.xml
+.idea/uiDesigner.xml
+.idea/compiler.xml
+.idea/misc.xml
+.idea/checkstyle.xml
+.idea/artifacts/
+.idea/dataSources*
+.idea/tasks.xml
+.idea/dictionaries/
+.idea/shelf/
+.idea/dynamic.xml
+.idea/sqlDataSources.xml
+.idea/gradle.xml
+.idea/mongoSettings.xml
+.idea/checkstyle-idea.xml
+.idea/findbugs-idea.xml
+
+# Spring
+spring.log
+logs/
+/application.properties
+/bootstrap.properties
+
+# Composer-style
+vendor
+
+# Git and temp files
+*.orig
+*.patch
+*~
diff --git a/LICENSE.md b/LICENSE.md
new file mode 100644
index 0000000..a012f4a
--- /dev/null
+++ b/LICENSE.md
@@ -0,0 +1,22 @@
+
+The MIT License (MIT)
+
+Copyright (c) 2016 Paul Campbell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3cbcaef
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# kemitix-checkstyle-ruleset
+
+Provides an extensive Checkstyle ruleset for use with `kemitix-parent`.
+
+The ruleset includes rules from both the core Checkstyle 7.0 library and
+from the Sevntu-Checkstyle 1.21.0 library.  
+
+## Rules Enabled
+
+### Checkstyle
+
+TODO
+
+### Sevntu
+
+TODO
diff --git a/pom.xml b/pom.xml
new file mode 100644
index 0000000..09c5488
--- /dev/null
+++ b/pom.xml
@@ -0,0 +1,121 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>net.kemitix</groupId>
+    <artifactId>kemitix-checkstyle-ruleset</artifactId>
+    <version>0.1.0-SNAPSHOT</version>
+    <packaging>jar</packaging>
+
+    <name>Kemitix Checkstyle Ruleset</name>
+    <description>Checkstyle Ruleset for use by packages derived from kemitix-parent</description>
+
+    <inceptionYear>2016</inceptionYear>
+
+    <prerequisites>
+        <maven>3.0.4</maven>
+    </prerequisites>
+
+    <licenses>
+        <license>
+            <name>The MIT License (MIT)</name>
+            <url>https://opensource.org/licenses/MIT</url>
+        </license>
+    </licenses>
+
+    <developers>
+        <developer>
+            <name>Paul Campbell</name>
+            <email>pcampbell@kemitix.net</email>
+            <organization>Kemitix</organization>
+            <organizationUrl>https://github.com/kemitix/</organizationUrl>
+        </developer>
+    </developers>
+
+    <properties>
+        <maven-javadoc-plugin.version>2.10.4</maven-javadoc-plugin.version>
+        <maven-source-plugin.version>3.0.1</maven-source-plugin.version>
+        <maven-gpg-plugin.version>1.6</maven-gpg-plugin.version>
+        <maven-deploy-plugin.version>2.8.2</maven-deploy-plugin.version>
+    </properties>
+
+    <profiles>
+        <profile>
+            <id>release</id>
+            <build>
+                <plugins>
+                    <!-- plugin sequence: javadoc, sources, gpg, deploy -->
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-javadoc-plugin</artifactId>
+                        <version>${maven-javadoc-plugin.version}</version>
+                        <executions>
+                            <execution>
+                                <id>attach-javadocs</id>
+                                <phase>verify</phase>
+                                <goals>
+                                    <goal>jar</goal>
+                                </goals>
+                            </execution>
+                        </executions>
+                    </plugin><!-- maven-javadoc-plugin -->
+
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-source-plugin</artifactId>
+                        <version>${maven-source-plugin.version}</version>
+                        <executions>
+                            <execution>
+                                <id>attach-sources</id>
+                                <phase>verify</phase>
+                                <goals>
+                                    <goal>jar-no-fork</goal>
+                                </goals>
+                            </execution>
+                        </executions>
+                    </plugin><!-- maven-source-plugin -->
+
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-gpg-plugin</artifactId>
+                        <version>${maven-gpg-plugin.version}</version>
+                        <configuration>
+                            <passphrase>${gpg.passphrase}</passphrase>
+                        </configuration>
+                        <executions>
+                            <execution>
+                                <id>sign-artifacts</id>
+                                <phase>verify</phase>
+                                <goals>
+                                    <goal>sign</goal>
+                                </goals>
+                            </execution>
+                        </executions>
+                    </plugin><!-- maven-gpg-plugin -->
+
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-deploy-plugin</artifactId>
+                        <version>${maven-deploy-plugin.version}</version>
+                    </plugin><!-- maven deploy-plugin -->
+                </plugins>
+            </build>
+        </profile><!-- release -->
+    </profiles>
+
+    <distributionManagement>
+        <snapshotRepository>
+            <id>sonatype-nexus-snapshots</id>
+            <name>Sonatype Nexus Snapshots</name>
+            <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
+        </snapshotRepository>
+        <repository>
+            <id>sonatype-nexus-staging</id>
+            <name>Nexus Release Repository</name>
+            <url>https://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
+        </repository>
+    </distributionManagement>
+
+</project>
\ No newline at end of file
diff --git a/src/main/resources/net/kemitix/checkstyle.xml b/src/main/resources/net/kemitix/checkstyle.xml
new file mode 100644
index 0000000..2287f64
--- /dev/null
+++ b/src/main/resources/net/kemitix/checkstyle.xml
@@ -0,0 +1,205 @@
+<?xml version="1.0"?>
+<!DOCTYPE module PUBLIC
+        "-//Puppy Crawl//DTD Check Configuration 1.3//EN"
+        "http://www.puppycrawl.com/dtds/configuration_1_3.dtd">
+
+<!-- Template checkstyle rules primarily intented for use with projects based on the kemitix-parent POM -->
+<!--                                                                                                    -->
+<!-- See http://checkstyle.sourceforge.net/checks.html for documentation on each rule.                  -->
+
+<module name="Checker">
+
+    <module name="JavadocPackage"/> <!-- package-info.java must exist -->
+    <module name="NewlineAtEndOfFile">
+        <property name="lineSeparator" value="lf"/> <!-- must use unix line endings -->
+    </module>
+    <module name="FileLength"/> <!-- files must be less than 2000 lines -->
+    <module name="FileTabCharacter"/> <!-- tabs not allowed -->
+    <module name="RegexpSingleline">
+        <property name="format" value="\s+$"/>
+        <property name="message" value="Line has trailing spaces."/>
+    </module>
+    <module name="SuppressWarningsFilter"/> <!-- enable @SuppressWarnings for checkstyle rules -->
+
+    <module name="TreeWalker">
+
+        <module name="AbbreviationAsWordInName"/> <!-- enforce proper CamelCase -->
+        <module name="AbstractClassName"/> <!-- enforce Abstract.* in abstract class names -->
+        <module name="AnnotationLocation"/> <!-- annotations should be on line by themselves -->
+        <module name="AnnotationUseStyle"/> <!-- annotations should only use () and named attributes when needed -->
+        <module name="AnonInnerLength"/> <!-- limits anonymous inner classes to 20 lines -->
+        <module name="ArrayTypeStyle"/> <!-- enforce Java style arrays -->
+        <module name="AtclauseOrder"/> <!-- enforce standard order for javadoc elements -->
+        <module name="AvoidEscapedUnicodeCharacters"> <!-- prevent use of obscure escape codes -->
+            <property name="allowEscapesForControlCharacters" value="true"/> <!-- unless non-printable controls -->
+        </module>
+        <module name="AvoidNestedBlocks"/> <!-- avoid unnecessary blocks {} -->
+        <module name="AvoidStarImport"/> <!-- import package.* is not allowed -->
+        <module name="AvoidStaticImport"> <!-- import static ... is not allowed -->
+            <property name="excludes"
+                      value="org.assertj.core.api.Assertions.assertThat,org.mockito.BDDMockito.given,org.mockito.Mockito.*,org.mockito.Matchers.*,org.mockito.Mockito.*"/>  <!-- unless selected testing shorthands -->
+        </module>
+        <module name="BooleanExpressionComplexity"> <!-- restrict number of &&, ||, &, | and ^ expressions -->
+            <property name="max" value="2"/>
+        </module>
+        <module name="CatchParameterName"/> <!-- restrict parameter names when catching an Exception -->
+        <module name="ClassDataAbstractionCoupling"/> <!-- restrict number of classes instantiated per class to 7 -->
+        <module name="ClassFanOutComplexity"/> <!-- restrict class dependencies to 20 -->
+        <module name="ClassTypeParameterName"/> <!-- restrict class type parameters (i.e. generics) to ^[A-Z]$ -->
+        <module name="ConstantName"/> <!-- force all uppercase for static final fields -->
+        <module name="CommentsIndentation"/> <!-- enforce comment indentation to match surrounding code -->
+        <module name="CovariantEquals"/> <!-- ensure correct version of equals() is implemented -->
+        <module name="CyclomaticComplexity"> <!-- limit complexity score -->
+            <property name="max" value="5"/>
+        </module>
+        <module name="DeclarationOrder"/> <!-- enforce order: static variables, variables, constructors, methods -->
+        <module name="DefaultComesLast"/> <!-- enforce default as last option in switch statement -->
+        <module name="DesignForExtension"/> <!-- protect against bad subclassing - use interfaces for mocking in unit tests -->
+        <module name="EmptyBlock"/> <!-- checks for empty blocks -->
+        <module name="EmptyCatchBlock"> <!-- checks the catch blocks contain comment -->
+            <property name="commentFormat" value="expected|ignore"/>
+        </module>
+        <module name="EmptyForInitializerPad"/> <!-- empty for loop initializer must have no spaces -->
+        <module name="EmptyForIteratorPad"/> <!-- empty for loop iterator muse have have no spaces -->
+        <module name="EmptyLineSeparator"/> <!-- enforce blank lines after header, fields, constructors, methods, etc -->
+        <module name="EmptyStatement"/> <!-- prevent standalone ";" semicolons -->
+        <module name="EqualsHashCode"/> <!-- if equals() is overridden then so must hashCode() be -->
+        <module name="ExecutableStatementCount"/> <!-- limit executable statements to 30 per method -->
+        <module name="ExplicitInitialization"/> <!-- avoid initializing a field twice to the same value -->
+        <module name="FallThrough"/> <!-- checks that each switch case fall-through is commented as such -->
+        <module name="FinalClass"/> <!-- class which has only private constructors is declared as final -->
+        <module name="FinalParameters"/> <!-- parameters that never change must be declared final -->
+        <module name="GenericWhitespace"/> <!-- generic tokens are spaced correctly -->
+        <module name="HiddenField">
+            <property name="ignoreConstructorParameter" value="true"/>
+            <property name="ignoreSetter" value="true"/>
+        </module>
+        <module name="HideUtilityClassConstructor"/> <!-- suppress for class with public static void main(...) -->
+        <module name="IllegalCatch"/> <!-- prevent generic catches (i.e. Exception, Throwable, RuntimeException) -->
+        <module name="IllegalImport"/> <!-- prevent imports from the sun.* package -->
+        <module name="IllegalThrows"/> <!-- prevent generic throws (i.e. Exception, Throwable, RuntimeException) -->
+        <module name="IllegalType"/> <!-- prevents variables, returns or parameters of non-interface Collections classes  -->
+        <module name="InnerAssignment"/> <!-- prevent assignments in subexpressions (i.e. while((line = read()){}) -->
+        <module name="InnerTypeLast"/> <!-- inner classes appear after methods and fields -->
+        <module name="InterfaceIsType"/> <!-- interface must define method not just constants -->
+        <module name="JavaNCSS"/> <!-- Non-Commenting Source Statements complexity analysis -->
+        <module name="JavadocMethod"> <!-- methods should have javadoc block -->
+            <property name="scope" value="public"/> <!-- if they are public -->
+        </module>
+        <module name="JavadocParagraph"/> <!-- javadoc paragraphs have opening <p> elements -->
+        <module name="JavadocStyle"/> <!-- javadoc comments are well formed -->
+        <module name="JavadocType"/> <!-- jacvadoc is present for classes, interfaces and enums -->
+        <module name="LeftCurly"/> <!-- placement of left curly braces ('{') for code blocks at end of line -->
+        <module name="LineLength"/> <!-- lines can't be longer the 80 -->
+        <module name="LocalFinalVariableName"/> <!-- validates identifiers for local, final variables, including catch parameters -->
+        <module name="LocalVariableName"/> <!-- validates non-final identifiers -->
+        <module name="MagicNumber"/> <!-- checks for magic numbers -->
+        <module name="MemberName"/> <!--  instance variable names conform to ^[a-z][a-zA-Z0-9]*$ -->
+        <module name="MethodCount"> <!-- restrict the number of methods in a class -->
+            <property name="maxTotal" value="30"/>
+        </module>
+        <module name="MethodLength"> <!-- restrict the number of lines in a method -->
+            <property name="max" value="60"/>
+        </module>
+        <module name="MethodName"/> <!-- method names conform to ^[a-z][a-zA-Z0-9]*$ -->
+        <module name="MethodParamPad"/> <!-- verifies padding around method parameters -->
+        <module name="MissingDeprecated"/> <!-- @Deprecated annotation must be accompanied by javadoc @deprecated -->
+        <module name="MissingSwitchDefault"/> <!-- switch must have a default -->
+        <module name="ModifiedControlVariable"/> <!-- prevent for loop control being modified inside loop -->
+        <module name="ModifierOrder"/> <!-- enforce order: public protected private abstract static final transient volatile synchronized native strictfp -->
+        <module name="MultipleStringLiterals"/> <!-- merge string literals -->
+        <module name="MultipleVariableDeclarations"/> <!-- declare variables separately -->
+        <module name="MutableException"/> <!-- prevent changing an exception once created -->
+        <module name="NPathComplexity"> <!-- restrict method complexity -->
+            <property name="max" value="400"/>
+        </module>
+        <module name="NeedBraces"/> <!-- braces around code blocks -->
+        <module name="NestedForDepth"/> <!-- prevent nested for loops -->
+        <module name="NestedIfDepth"/> <!-- prevent nested if-else blocks -->
+        <module name="NestedTryDepth"/> <!-- prevent nested try blocks -->
+        <module name="NoClone"/> <!-- prevent overriding Object.clone() -->
+        <module name="NonEmptyAtclauseDescription"/> <!-- javadoc tags have descriptions -->
+        <module name="NoWhitespaceAfter"/> <!-- prevent white space after tokens -->
+        <module name="NoWhitespaceBefore"/> <!-- prevent white space before tokens -->
+        <module name="OneStatementPerLine"/> <!-- only one statement per line -->
+        <module name="OneTopLevelClass"/> <!-- one top-level class per file -->
+        <module name="OperatorWrap"/> <!-- when line wrapping on an operator, the operator is on the new line -->
+        <module name="OuterTypeFilename"/> <!-- class name and filename must match -->
+        <module name="OverloadMethodsDeclarationOrder"/> <!-- group overloaded methods together -->
+        <module name="PackageDeclaration"/> <!-- class must have package and it must match the directory -->
+        <module name="PackageName"/> <!-- validate package name format -->
+        <module name="ParameterName"/> <!-- validate parameter name format -->
+        <module name="ParameterNumber"/> <!-- limits the number of parameters to 7 -->
+        <module name="ParenPad"/> <!-- parentheses should have no padding spaces -->
+        <module name="RedundantImport"/> <!-- checks for redundant imports (i.e. in the same package) -->
+        <module name="RedundantModifier"/> <!-- checks for redundant modifies (e.g. public methods in an interface) -->
+        <module name="ReturnCount"/> <!-- Restricts return statements to 2 per method (1 if return type is void) -->
+        <module name="RightCurly"/> <!-- placement of right curly braces ('}') for code blocks at end of line -->
+        <module name="SingleSpaceSeparator"/> <!-- Checks that non-whitespace characters are separated by only 1 character -->
+        <module name="SeparatorWrap"> <!-- checks line wrapping on separators (,) have separator at the end of the line -->
+            <property name="tokens" value="COMMA"/>
+            <property name="option" value="eol"/>
+        </module>
+        <module name="SeparatorWrap"> <!-- checks line wrapping on separators (.) have separator on the new line -->
+            <property name="tokens" value="DOT"/>
+            <property name="option" value="nl"/>
+        </module>
+        <module name="SimplifyBooleanExpression"/> <!-- finds code like if (b == true), b || true, !false, etc. -->
+        <module name="SimplifyBooleanReturn"/> <!-- overly complicated boolean return statements. -->
+        <module name="StaticVariableName"/> <!-- Static non-finals should be formatted like normal identifiers -->
+        <module name="StringLiteralEquality"/> <!-- use .equals(...) when comparing strings for equality -->
+        <module name="SuppressWarningsHolder"/> <!-- holds all @SuppressWarnings found for SuppressWarningsFilter -->
+        <module name="ThrowsCount"/> <!-- Restricts throws statements to 4 -->
+        <module name="TodoComment"> <!-- no to do or fix me comments -->
+            <property name="format" value="(TODO)|(FIXME)"/>
+        </module>
+        <module name="TrailingComment"/> <!-- no end-line comments (the irony!) -->
+        <module name="TypeName"/> <!-- validates class, interface, enum and annotation names -->
+        <module name="TypecastParenPad"/> <!-- no spaces in type casting parentheses -->
+        <module name="UnnecessaryParentheses"/> <!-- unnecessary parentheses -->
+        <module name="UnusedImports"/> <!-- checks for import that aren't used -->
+        <module name="UpperEll"/> <!-- long constants have an 'L' suffix -->
+        <module name="VariableDeclarationUsageDistance"/> <!-- distance between declaration of variable and first usage -->
+        <module name="VisibilityModifier"/> <!-- visibility of class members -->
+        <module name="WhitespaceAfter"/> <!-- comma, semicolon, and type cast are followed by a space -->
+        <module name="WhitespaceAround"/> <!-- selected token are surrounded by a space -->
+
+        <!-- Sevntu checks -->
+        <!-- sevntu/coding -->
+        <module name="AvoidConstantAsFirstOperandInConditionCheck"/> <!-- avoid code like if(12 == value){...} -->
+        <module name="AvoidHidingCauseExceptionCheck"/> <!-- ensure exceptions are propagated as cause in subsequent exceptions -->
+        <module name="AvoidNotShortCircuitOperatorsForBooleanCheck"/> <!-- limits using of not short-circuit operators -->
+        <module name="ConfusingConditionCheck"/> <!-- prevents negation within an "if" expression if "else" is present -->
+        <module name="DiamondOperatorForVariableDefinitionCheck"/> <!-- use the diamond operator -->
+        <module name="EitherLogOrThrowCheck"/> <!-- log or throw an exception - don't do both -->
+        <module name="ForbidCCommentsInMethodsCheck"/> <!-- prevent /* C-style */ comments inside methods -->
+        <module name="ForbidReturnInFinallyBlockCheck"/> <!-- returns in finally override returns elsewhere in method -->
+        <module name="ForbidThrowAnonymousExceptionsCheck"/> <!-- only throw concrete exceptions -->
+        <module name="LogicConditionNeedOptimizationCheck"/> <!-- prevent placement of local variables and fields after call to method in logical conditionals -->
+        <module name="MapIterationInForEachLoopCheck"/> <!-- warns of unoptimised map iteration -->
+        <module name="NameConventionForJunit4TestClassesCheck"/> <!-- checks names of test classes -->
+        <module name="NoNullForCollectionReturnCheck"/> <!-- don't return null when should be an empty collection -->
+        <module name="NumericLiteralNeedsUnderscoreCheck"/> <!-- long numeric literals have underscore spacers -->
+        <module name="OverridableMethodInConstructorCheck"/> <!-- don't call overridable method from constructor -->
+        <module name="RedundantReturnCheck"/> <!-- returns at end of void methods is pointless -->
+        <module name="ReturnBooleanFromTernaryCheck"/> <!-- use value inside condition -->
+        <module name="ReturnNullInsteadOfBooleanCheck"/> <!-- Boolean is NOT a ternary state object -->
+        <module name="SimpleAccessorNameNotationCheck"/> <!-- setters and getters must match to the field of the same name and type -->
+        <module name="SingleBreakOrContinueCheck"/> <!-- avoid complicated flow control -->
+        <module name="TernaryPerExpressionCountCheck"/> <!-- prevent nested ternary expressions -->
+        <module name="UselessSingleCatchCheck"/> <!-- prevent single catch blocks that just rethrow the original exception -->
+        <module name="UselessSuperCtorCallCheck"/> <!-- detects calls to super() when not needed -->
+        <!-- sevntu/design -->
+        <module name="AvoidConditionInversionCheck"/> <!-- catch condition inversion which could be more readable -->
+        <!--<module name="ChildBlockLengthCheck"/> &lt;!&ndash; broken in sevntu 1.20 - limit child blocks to 80% of parent block &ndash;&gt;-->
+        <module name="ConstructorWithoutParamsCheck"/> <!-- Exception classes must take parameters -->
+        <module name="ForbidWildcardAsReturnTypeCheck"/> <!-- forbid <? extends|super Object> generics as return types on public, protected and package methods -->
+        <module name="NestedSwitchCheck"/> <!-- prevent nested switch statements -->
+        <module name="NoMainMethodInAbstractClassCheck"/> <!-- Forbids main methods in abstract classes -->
+        <module name="PublicReferenceToPrivateTypeCheck"/> <!-- prevent attempt to expose private type -->
+        <!-- sevntu/naming -->
+        <module name="EnumValueNameCheck"/> <!-- validate enum value format -->
+        <module name="UniformEnumConstantNameCheck"/> <!-- forces enum names to all follow the same pattern as each other -->
+    </module>
+
+</module>