io.github.intisy.gradle.github.impl.github

Class GitHubSourceBuilds

java.lang.Object

io.github.intisy.gradle.github.impl.github.GitHubSourceBuilds

All Implemented Interfaces:

SourceBuilds

public final class GitHubSourceBuilds
extends java.lang.Object
implements SourceBuilds

Adapts the host-agnostic SourceBuilder to the GitHub-specific SourceBuilds capability by resolving owner/repo to a github.com clone URL before delegating, so the source-build strategy behaves exactly as it did before SourceBuilder took an explicit clone URL.

Constructor Summary

Constructors

Constructor and Description
GitHubSourceBuilds(GitHub gitHub, SourceBuilder sourceBuilder)

Method Summary

Modifier and Type	Method and Description
java.util.List<java.io.File>	buildFromGit(java.lang.String cloneUrl, java.lang.String ref, java.lang.String gradleDir, java.util.List<java.lang.String> modules) Builds a multi-module git repository from source, taking one jar per named module.
java.io.File	buildFromSource(java.lang.String owner, java.lang.String repo, java.lang.String branch, java.lang.String commitSha) Builds a GitHub repository from source, identified by owner and repo.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.github.intisy.gradle.github.api.capability.SourceBuilds

buildFromGit

Constructor Detail

GitHubSourceBuilds

public GitHubSourceBuilds(GitHub gitHub,
                          SourceBuilder sourceBuilder)

Parameters:

gitHub - resolves the github.com clone URL (SSH or HTTPS) for a given owner/repo.

sourceBuilder - builds and caches the jar once the clone URL is known.

Method Detail

buildFromSource

public java.io.File buildFromSource(java.lang.String owner,
                                    java.lang.String repo,
                                    java.lang.String branch,
                                    java.lang.String commitSha)
                             throws java.io.IOException

Description copied from interface: SourceBuilds

Builds a GitHub repository from source, identified by owner and repo.

Specified by:

buildFromSource in interface SourceBuilds

Parameters:

owner - the repository owner.

repo - the repository name.

branch - the branch to clone or pull, or null for the current/default branch.

commitSha - the commit to build, or null to use the branch's latest commit.

Returns:

the cached jar for the resolved commit, built only when not already cached.

Throws:

java.io.IOException - if the clone/pull, checkout, or build itself fails.

buildFromGit

public java.util.List<java.io.File> buildFromGit(java.lang.String cloneUrl,
                                                 java.lang.String ref,
                                                 java.lang.String gradleDir,
                                                 java.util.List<java.lang.String> modules)
                                          throws java.io.IOException

Description copied from interface: SourceBuilds

Builds a multi-module git repository from source, taking one jar per named module.

Specified by:

buildFromGit in interface SourceBuilds

Parameters:

cloneUrl - the exact URL to clone from.

ref - the branch, tag, or commit to build, or null for the remote's default branch.

gradleDir - the gradle project directory relative to the checkout root, or null when the build lives at the root. A repository whose gradle root is a subdirectory is otherwise unbuildable, because the wrapper is not where the checkout is.

modules - the gradle module names whose jars to take, or empty for the single jar the root project produces.

Returns:

the cached jars for the resolved ref, in modules order, built only when not already cached.

Throws:

java.io.IOException - if the clone, checkout, or build itself fails.