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

Class SourceBuilder

java.lang.Object

io.github.intisy.gradle.github.impl.source.SourceBuilder

public class SourceBuilder
extends java.lang.Object

Clones an arbitrary git URL and builds it, caching the resulting jar by commit, so a repeated request for the same commit never re-runs the build. Host-agnostic: the caller supplies the clone URL explicitly, so this class never assumes github.com or any other specific host.

Implementation Note:

GitHub carries a single ResourceSettings, hence a single repository identity, so a fresh GitHub is built per buildFromSource call (which buildFromGit(java.lang.String, java.lang.String) also goes through), scoped to the exact cloneUrl requested, rather than accepting one pre-built GitHub that could only ever be correctly configured for one repository.

Constructor Summary

Constructors

Constructor and Description
SourceBuilder(GitHubConfig config, GitHubLogger logger, java.io.File cacheDir, BuildInvoker invoker)

Method Summary

Modifier and Type	Method and Description
java.io.File	buildFromGit(java.lang.String cloneUrl, java.lang.String ref)
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)
java.io.File	buildFromSource(java.lang.String cloneUrl, java.lang.String owner, java.lang.String repo, java.lang.String branch, java.lang.String commitSha)

Methods inherited from class java.lang.Object

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

Constructor Detail

SourceBuilder

public SourceBuilder(GitHubConfig config,
                     GitHubLogger logger,
                     java.io.File cacheDir,
                     BuildInvoker invoker)

Parameters:

config - the access token and auth/cli/resilience settings used to clone/pull each checkout.

logger - receives diagnostic output.

cacheDir - the directory built jars are cached under, keyed by owner, repo, and resolved commit.

invoker - runs the actual build against a checkout; injected so it can be stubbed in tests.

Method Detail

buildFromGit

public java.io.File buildFromGit(java.lang.String cloneUrl,
                                 java.lang.String ref)
                          throws java.io.IOException

Parameters:

cloneUrl - the exact URL to clone from; any git host, not just github.com.

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

Returns:

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

Throws:

java.io.IOException - if the clone, 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

Parameters:

cloneUrl - the exact URL to clone from; any git host, not just github.com.

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.

modules - the module names whose jars to take, or empty for the root project's own jar.

Returns:

the cached jars for the resolved commit, in modules order.

Throws:

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

buildFromSource

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

Parameters:

cloneUrl - the exact URL to clone from; any git host, not just github.com.

owner - an identity for the repository, used only for the checkout/cache directory and jar naming, never for URL construction.

repo - an identity for the repository, used only for the checkout/cache directory and jar naming, never for URL construction.

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

commitSha - the commit to check out, 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.