Ease Maven Plugin

Tool to deploy projects from their installed jar files, using some metadata magic.

License	Apache License Version 2.0
Categories	Maven Build Tools Neo4J Data Databases
GroupId	org.neo4j.build.plugins
ArtifactId	ease-maven-plugin
Last Version	1
Release Date	May 9, 2012
Type	maven-plugin
Description	Ease Maven Plugin Tool to deploy projects from their installed jar files, using some metadata magic.
Project URL	http://components.neo4j.org/ease-maven-plugin/1
Project Organization	The Neo4j Graph Database Project
Source Code Management	https://github.com/neo4j/ease-maven-plugin

Download ease-maven-plugin

Filename	Size
ease-maven-plugin-1.pom
ease-maven-plugin-1.jar	17 KB
ease-maven-plugin-1-tests.jar	3 KB
ease-maven-plugin-1-sources.jar	9 KB
ease-maven-plugin-1-javadoc.jar	36 KB

How to add to project

Apache Maven

<plugin>
    <groupId>org.neo4j.build.plugins</groupId>
    <artifactId>ease-maven-plugin</artifactId>
    <version>1</version>
</plugin>

Dependencies

compile (6)

Group / Artifact	Type	Version
org.apache.maven : maven-artifact	jar	3.0.3
org.apache.maven : maven-core	jar	3.0.3
org.apache.maven.plugins : maven-dependency-plugin	jar	2.4
org.apache.maven : maven-model	jar	3.0.3
org.apache.maven : maven-plugin-api	jar	3.0.3
org.apache.maven.shared : maven-common-artifact-filters	jar	1.2

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.10

Project Modules

There are no modules declared in this project.

Ease Maven Plugin

This plugin lets you release Maven artifacts in a very controlled way. It doesn’t replace install or deploy but modifies the project before these targets are executed.

Introduction

The plugin works by adding simple metadata to artifacts during the release build, and then reading that data when deploying. Which means release build and deploy are fully separated. No building or dependency resolution happens during release, it’s just deploying existing artifacts from a known filesytem location.

• The freeze and aggregate goals are used while building a release.

• The attach goal is used when deploying a release.

• The attachsignatures goal is used when deploying with gpg signatures included.

The freeze goal should be added to all projects included in the release.

The aggregate goal is used in a separate project. This project should have everything that should go into the release as dependencies. As the aggregate goal attaches the resulting list to the project just like the freeze goal, it can be composed in multiple levels.

The attach and attachsignatures goals are used in a separate project. This project should only be concerned with where to find the artifact list and the artifacts, and how to deploy the artifacts.

Add the plugin executions to the 'pom.xml' files. Then just use normal install or deploy goals to bring it to action.

Goals

• freeze: Lists the artifacts (like the default jar, the sources jar etc.) atttached to a project and attaches the list to the project, as a -artifacts.txt artifact.

• aggregate: Traverses the dependencies of a project and aggragates artifacts.txt files into one single list, which is then attached to the project. Note that any missing artifacts.txt file will fail the build — use includes/excludes filtering to target the dependencies you want.

• attach: Attaches all artifacts in a given artifacts.txt file to the project. A file location for this file is used to prevent any dependency resolution whatsoever to take place. A separate local repo can be defined for loading the artifacts from, which is very much recommended.

• attachsignatures: Attaches the signatures of all artifacts to the project. Missing signatures will fail the build.

Use the included test/example projects

• mvn clean install -Dprepare will install the plugin and freeze some artifacts and then aggregate them.

• mvn clean install -Dperform will attach the previously created artifacts to a project and install them (again). To deploy with gpg signatures, remove the <phase>none</phase> setting from the attach example project.

Neo4j

Versions

Version
1 May 9, 2012