This library tries to compute compliant semantic versions for your maven project by following these rules.

For the moment, only a few ones are implemented.

• Add API package
• Delete API package
• Add API type to API package
• Delete API type from API package
• Add non-public (non-API) type to API package
• Delete non-public (non-API) type from API package
• Change non-public (non-API) type in API package to make public (API)
• Change public type in API package to make non-public
• Change kind of API type (class, interface, enum, or annotation type)

• Add abstract method
• Add default method
• Add static method
• Delete API method
• Move API method up type hierarchy
• Move API method down type hierarchy
• Add API field
• Delete API field
• Expand superinterface set (direct or inherited)
• Contract superinterface set (direct or inherited)
• Add, delete, or change static initializers
• Add API type member
• Delete API type member
• Re-order field, method, and type member declarations
• Add type parameter
• Delete type parameter
• Re-order type parameters
• Rename type parameter
• Add, delete, or change type bounds of type parameter
• Add element to annotation type
• Delete element from annotation type

• Change formal parameter name
• Change method name
• Add or delete formal parameter
• Change type of a formal parameter
• Change result type (including void)
• Add checked exceptions thrown
• Add unchecked exceptions thrown
• Delete checked exceptions thrown
• Delete unchecked exceptions thrown
• Re-order list of exceptions thrown
• Change static to non-static
• Change non-static to static
• Change default to abstract
• Change abstract to default
• Add type parameter
• Delete type parameter
• Re-order type parameters
• Rename type parameter
• Add, delete, or change type bounds of type parameter
• Change last parameter from array type T[] to variable arity T...
• Change last parameter from variable arity T... to array type T[]
• Add default clause to annotation type element
• Change default clause on annotation type element
• Delete default clause from annotation type element

• Change type of API field
• Change value of API field

• Add API method
• Delete API method
• Move API method up type hierarchy
• Move API method down type hierarchy
• Add API constructor
• Delete API constructor
• Add API field
• Delete API field
• Expand superinterface set (direct or inherited)
• Contract superinterface set (direct or inherited)
• Expand superclass set (direct or inherited)
• Contract superclass set (direct or inherited)
• Add, delete, or change static or instance initializers
• Add API type member
• Delete API type member
• Re-order field, method, constructor, and type member declarations
• Add or delete non-API members; that is, private or default access fields, methods, constructors, and type members
• Change abstract to non-abstract
• Change non-abstract to abstract
• Change final to non-final
• Change non-final to final
• Add type parameter
• Delete type parameter
• Re-order type parameters
• Rename type parameter
• Add, delete, or change type bounds of type parameter
• Rename enum constant considered as add+delete
• Add, change, or delete enum constant arguments
• Add, change, or delete enum constant class body
• Add enum constant
• Delete enum constant
• Re-order enum constants

• Change body of method or constructor
• Change formal parameter name
• Change method name considered as add+delete
• Add or delete formal parameter
• Change type of a formal parameter
• Change result type (including void)
• Add checked exceptions thrown
• Add unchecked exceptions thrown
• Delete checked exceptions thrown
• Delete unchecked exceptions thrown
• Re-order list of exceptions thrown
• Decrease access; that is, from protected access to default or private access; or from public access to protected, default, or private access
• Increase access; that is, from protected access to public access
• Change abstract to non-abstract
• Change non-abstract to abstract
• Change final to non-final
• Change non-final to final
• Change static to non-static
• Change non-static to static
• Change native to non-native
• Change non-native to native
• Change synchronized to non-synchronized
• Change non-synchronized to synchronized
• Add type parameter
• Delete type parameter
• Re-order type parameters
• Rename type parameter
• Add, delete, or change type bounds of type parameter
• Change last parameter from array type T[] to variable arity T...
• Change last parameter from variable arity T... to array type T[]

• Change type of API field
• Change value of API field
• Decrease access; that is, from protected access to default or private access; or from public access to protected, default, or private access
• Increase access; that is, from protected access to public access
• Change final to non-final
• Change non-final to final
• Change static to non-static
• Change non-static to static
• Change transient to non-transient
• Change non-transient to transient

• Decrease access; that is, from protected access to default or private access; or from public access to protected, default, or private access
• Increase access; that is, from protected access to public access

• Add non-API package
• Delete non-API package
• Add class or interface to non-API package
• Delete class or interface in a non-API package
• Change existing class or interface in non-API package

When you need to release your project, you'll have to use the following maven pugin:

<plugin>
	<groupId>org.codegeny</groupId>
	<artifactId>codegeny-semver-maven-plugin</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<executions>
		<execution>
			<goals>
				<goal>version</goal>
			</goals>
		</execution>
	</executions>
</plugin>

This plugin will retrieve the previous release of your project and compare the classes.

Let's consider you are working on version 1.2.3-SNAPSHOT and want to release; the plugin will compare this version with the previous one (which is 1.2.2) and give the versions for your release and the next snapshot: