/*
* Copyright (c) 2013 Cisco Systems, Inc. and others. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v1.0 which accompanies this distribution,
* and is available at http://www.eclipse.org/legal/epl-v10.html
*/
package org.opendaylight.yangtools.yang2sources.plugin;
import com.google.common.annotations.VisibleForTesting;
import com.google.common.collect.Collections2;
import com.google.common.collect.ImmutableList;
import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;
import java.io.File;
import java.util.Arrays;
import java.util.Collection;
import java.util.List;
import java.util.Set;
import org.apache.maven.artifact.repository.ArtifactRepository;
import org.apache.maven.plugin.AbstractMojo;
import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugin.MojoFailureException;
import org.apache.maven.plugins.annotations.Component;
import org.apache.maven.plugins.annotations.LifecyclePhase;
import org.apache.maven.plugins.annotations.Mojo;
import org.apache.maven.plugins.annotations.Parameter;
import org.apache.maven.plugins.annotations.ResolutionScope;
import org.apache.maven.project.MavenProject;
import org.apache.maven.repository.RepositorySystem;
import org.opendaylight.yangtools.plugin.generator.api.FileGenerator;
import org.opendaylight.yangtools.yang.model.api.EffectiveModelContext;
import org.opendaylight.yangtools.yang.model.repo.api.StatementParserMode;
import org.opendaylight.yangtools.yang2sources.plugin.ConfigArg.CodeGeneratorArg;
import org.opendaylight.yangtools.yang2sources.spi.BasicCodeGenerator;
import org.sonatype.plexus.build.incremental.BuildContext;
/**
* Generate sources from yang files using user provided set of
* {@link BasicCodeGenerator}s. Steps of this process:
*
* - List yang files from {@link #yangFilesRootDir}
* - Process yang files using Yang Parser
* - For each {@link BasicCodeGenerator} from {@link #codeGenerators}:
*
* - Instantiate using default constructor
* - Call {@link BasicCodeGenerator#generateSources(EffectiveModelContext, File, Set,
* org.opendaylight.yangtools.yang2sources.spi.ModuleResourceResolver)}
*
*
*
*/
@Mojo(name = "generate-sources", defaultPhase = LifecyclePhase.GENERATE_SOURCES,
requiresDependencyResolution = ResolutionScope.COMPILE, requiresProject = true, threadSafe = true)
public final class YangToSourcesMojo extends AbstractMojo {
public static final String PLUGIN_NAME = "org.opendaylight.yangtools:yang-maven-plugin";
/**
* Classes implementing {@link BasicCodeGenerator} interface. An instance will be
* created out of every class using default constructor. Method {@link
* BasicCodeGenerator#generateSources(EffectiveModelContext, File, Set)} will be called on every instance.
*/
@Parameter(required = false)
private CodeGeneratorArg[] codeGenerators;
/**
* {@link FileGenerator} instances resolved via ServiceLoader can hold additional configuration, which details
* how they are executed.
*/
@Parameter(required = false)
private FileGeneratorArg[] fileGenerators;
/**
* Source directory that will be recursively searched for yang files (ending
* with .yang suffix).
*/
@Parameter(required = false)
// defaults to ${basedir}/src/main/yang
private String yangFilesRootDir;
@Parameter(required = false)
private String[] excludeFiles;
@Parameter(property = "project", required = true, readonly = true)
private MavenProject project;
@Parameter(property = "inspectDependencies")
private boolean inspectDependencies;
@Component
@VisibleForTesting
BuildContext buildContext;
private YangToSourcesProcessor yangToSourcesProcessor;
@Component
private RepositorySystem repoSystem;
@Parameter(readonly = true, defaultValue = "${localRepository}")
private ArtifactRepository localRepository;
@Parameter(readonly = true, defaultValue = "${project.remoteArtifactRepositories}")
private List remoteRepos;
// When set to "true", then the execution of the plugin is disabled
@Parameter(property = "yang.skip")
private String yangSkip;
@Parameter(defaultValue = "DEFAULT_MODE")
@Deprecated(forRemoval = true)
private StatementParserMode parserMode;
public YangToSourcesMojo() {
}
@VisibleForTesting
YangToSourcesMojo(final YangToSourcesProcessor processor) {
this.yangToSourcesProcessor = processor;
}
public void setProject(final MavenProject project) {
this.project = project;
}
@Override
@SuppressFBWarnings(value = "UWF_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR", justification = "yangFilesRootDir")
public void execute() throws MojoExecutionException, MojoFailureException {
Util.checkClasspath(project, repoSystem, localRepository, remoteRepos);
if (yangToSourcesProcessor == null) {
// defaults to ${basedir}/src/main/yang
File yangFilesRootFile = processYangFilesRootDir(yangFilesRootDir, project.getBasedir());
Collection excludedFiles = processExcludeFiles(excludeFiles, yangFilesRootFile);
yangToSourcesProcessor = new YangToSourcesProcessor(buildContext, yangFilesRootFile,
excludedFiles, arrayToList(codeGenerators), arrayToList(fileGenerators), project,
inspectDependencies);
}
yangToSourcesProcessor.conditionalExecute("true".equals(yangSkip));
}
private static List arrayToList(final T[] array) {
return array == null ? ImmutableList.of() : Arrays.asList(array);
}
private static File processYangFilesRootDir(final String yangFilesRootDir, final File baseDir) {
File yangFilesRootFile;
if (yangFilesRootDir == null) {
yangFilesRootFile = new File(baseDir, "src" + File.separator + "main" + File.separator + "yang");
} else {
File file = new File(yangFilesRootDir);
if (file.isAbsolute()) {
yangFilesRootFile = file;
} else {
yangFilesRootFile = new File(baseDir, file.getPath());
}
}
return yangFilesRootFile;
}
private static Collection processExcludeFiles(final String[] excludeFiles, final File baseDir) {
if (excludeFiles == null) {
return ImmutableList.of();
}
return Collections2.transform(Arrays.asList(excludeFiles), f -> new File(baseDir, f));
}
}