org.ajoberstar.gradle.jacoco.plugins.JacocoPluginExtension.groovy Maven / Gradle / Ivy

Go to download
/* Copyright 2013 the original author or authors.
 *
 * 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.
 */
package org.ajoberstar.gradle.jacoco.plugins

import groovy.util.logging.Slf4j
import org.gradle.api.Project
import org.gradle.process.JavaForkOptions
import org.gradle.api.tasks.TaskCollection
import org.ajoberstar.gradle.jacoco.JacocoAgentJar
import org.ajoberstar.gradle.jacoco.tasks.JacocoTaskExtension

/**
 * Extension including common properties and methods for Jacoco.
 */
@Slf4j
class JacocoPluginExtension {
	static final String TASK_EXTENSION_NAME = 'jacoco'
	
	/**
	 * Version of Jacoco JARs to use.
	 */
	String toolVersion = '0.6.2.201302030002'

	protected final Project project
	private final JacocoAgentJar agent

	/**
	 * Creates a Jacoco plugin extension.
	 * @param project the project the extension is attached to
	 * @param agent the agent JAR to be used by Jacoco
	 */
	JacocoPluginExtension(Project project, JacocoAgentJar agent) {
		this.project = project
		this.agent = agent
	}

	/**
	 * Applies Jacoco to the given task. Configuration options will be
	 * provided on a task extension named {@link #TASK_EXTENSION_NAME}.
	 * Jacoco will be run as an agent during the execution of the task.
	 * @param task the task to apply Jacoco to.
	 */
	void applyTo(JavaForkOptions task) {
		log.debug "Applying Jacoco to $task.name"
		JacocoTaskExtension extension = task.extensions.create(TASK_EXTENSION_NAME, JacocoTaskExtension, project, agent)
		task.jacoco.destPath = { "${project.buildDir}/jacoco/${task.name}.exec" }
		task.doFirst {
			//add agent
			if (extension.enabled) {
				task.jvmArgs extension.asJvmArg
			}
		}
	}

	/**
	 * Applies Jacoco to all of the given tasks.
	 * @param tasks the tasks to apply Jacoco to
	 * @see #applyTo(JavaForkOptions)
	 */
	void applyTo(TaskCollection tasks) {
		tasks.withType(JavaForkOptions) {
			applyTo(it)
		}
	}
}