com.atlassian.bamboo.specs.builders.task.VcsCheckoutTask Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of bamboo-specs Show documentation
There is a newer version: 10.1.0
package com.atlassian.bamboo.specs.builders.task;

import com.atlassian.bamboo.specs.api.builders.repository.VcsRepositoryIdentifier;
import com.atlassian.bamboo.specs.api.builders.task.Task;
import com.atlassian.bamboo.specs.model.task.CheckoutItemProperties;
import com.atlassian.bamboo.specs.model.task.VcsCheckoutTaskProperties;
import org.jetbrains.annotations.NotNull;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

import static com.atlassian.bamboo.specs.api.validators.common.ImporterUtils.checkNotNull;

/**
 * Represents task that checks out selected repositories to the build working directory.
 */
public class VcsCheckoutTask extends Task {

    private List checkoutItems = new ArrayList<>();
    private boolean cleanCheckout;

    /**
     * Adds checkout request for the plan's default repository into the build directory. Default repository is the
     * repository which is the first on the list of plan's repositories.
     * 
     * The repository will be checked out to the build's working directory. For more control over checkout path, use
     * {@link VcsCheckoutTask#checkoutItems(CheckoutItem...)}.
     */
    public VcsCheckoutTask addCheckoutOfDefaultRepository() {
        return checkoutItems(new CheckoutItem().defaultRepository());
    }

    /**
     * Adds checkout request for one of plan's repositories into the build directory.
     * 

     * The repository will be checked out to the build's working directory. For more control over checkout path, use
     * {@link VcsCheckoutTask#checkoutItems(CheckoutItem...)}.
     */
    public VcsCheckoutTask addCheckoutOfRepository(@NotNull String repositoryName) {
        checkNotNull("repositoryName", repositoryName);
        return checkoutItems(new CheckoutItem().repository(repositoryName));
    }

    /**
     * Adds checkout request for one of plan's repositories into the build directory.
     * 
     * The repository will be checked out to the build's working directory. For more control over checkout path, use
     * {@link VcsCheckoutTask#checkoutItems(CheckoutItem...)}.
     */
    public VcsCheckoutTask addCheckoutOfRepository(@NotNull VcsRepositoryIdentifier repositoryIdentifier) {
        checkNotNull("repositoryIdentifier", repositoryIdentifier);
        return checkoutItems(new CheckoutItem().repository(repositoryIdentifier));
    }

    /**
     * Adds checkout requests.
     */
    public VcsCheckoutTask checkoutItems(@NotNull CheckoutItem... checkoutItems) {
        checkNotNull("checkoutItems", checkoutItems);
        Arrays.stream(checkoutItems)
                .map(CheckoutItem::build)
                .forEach(this.checkoutItems::add);
        return this;
    }

    /**
     * Enables/disabled clean checkout. If set, the task cleans the content of the checkout target directory before
     * checking out the source. Off by default.
     */
    public VcsCheckoutTask cleanCheckout(boolean cleanCheckout) {
        this.cleanCheckout = cleanCheckout;
        return this;
    }

    @Override
    @NotNull
    protected VcsCheckoutTaskProperties build() {
        return new VcsCheckoutTaskProperties(description,
                taskEnabled,
                checkoutItems,
                cleanCheckout);
    }
}