Filip/bld
1
0
Fork 0
mirror of https://github.com/rife2/bld synced 2026-07-25 08:57:48 +02:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

Bump @since tags to 2.4.0 for the next release

Browse source
This commit is contained in:
Geert Bevin 2026-07-12 23:05:15 -04:00
parent b2987b6b23
commit 27c45033fb
13 changed files with 58 additions and 58 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
src/main/java/rife/bld/BaseProject.java
View file

@ -29,7 +29,7 @@ public class BaseProject extends BuildExecutor {
/**
* The CLI option to trigger automatic dependency download and purge.
*
* @since 2.3.1
* @since 2.4.0
*/
public static final String AUTO_DOWNLOAD_PURGE_OPTION = "--auto-download-purge";

2
src/main/java/rife/bld/BuildExecutor.java
View file

@ -144,7 +144,7 @@ public class BuildExecutor {
*
* @return {@code true} if the execution is verbose;
* or {@code false} otherwise
* @since 2.3.1
* @since 2.4.0
*/
public boolean verbose() {
return verbose_;

6
src/main/java/rife/bld/dependencies/DependencyTransferBatch.java
View file

@ -25,7 +25,7 @@ import java.util.function.Supplier;
* transfers into the same directory are only performed once.
*
* @author Geert Bevin (gbevin[remove] at uwyn dot com)
* @since 2.3.1
* @since 2.4.0
*/
public class DependencyTransferBatch {
private record TransferRequest(Dependency dependency, File directory, String[] classifiers) {
@ -45,7 +45,7 @@ public class DependencyTransferBatch {
* @param classifiers the additional classifiers to transfer
* @return this batch instance
* @throws DependencyTransferException when the transfer couldn't be prepared
* @since 2.3.1
* @since 2.4.0
*/
public DependencyTransferBatch add(DependencySet dependencies, File directory, File modulesDirectory, String... classifiers) {
for (var dependency : dependencies) {
@ -88,7 +88,7 @@ public class DependencyTransferBatch {
* @param repositories the repositories to use for the transfer
* @return the list of artifacts that were transferred successfully
* @throws DependencyTransferException when an error occurred during the transfer
* @since 2.3.1
* @since 2.4.0
*/
public List<RepositoryArtifact> transfer(VersionResolution resolution, ArtifactRetriever retriever, List<Repository> repositories) {
final var repos = (repositories == null ? List.<Repository>of() : repositories);

12
src/main/java/rife/bld/dependencies/ParallelDependencyResolver.java
View file

@ -19,7 +19,7 @@ import java.util.function.Supplier;
* {@link DependencyResolver}, in the same order.
*
* @author Geert Bevin (gbevin[remove] at uwyn dot com)
* @since 2.3.1
* @since 2.4.0
*/
public class ParallelDependencyResolver {
private final VersionResolution resolution_;
@ -34,7 +34,7 @@ public class ParallelDependencyResolver {
* @param resolution the version resolution state that can be cached
* @param retriever the retriever to use to get artifacts
* @param repositories the repositories to use for the resolution
* @since 2.3.1
* @since 2.4.0
*/
public ParallelDependencyResolver(VersionResolution resolution, ArtifactRetriever retriever, List<Repository> repositories) {
resolution_ = resolution;
@ -55,7 +55,7 @@ public class ParallelDependencyResolver {
* @param roots the root dependencies to resolve
* @param scopes the scopes to return the transitive dependencies for
* @return the merged transitive dependencies of all the roots
* @since 2.3.1
* @since 2.4.0
*/
public DependencySet resolveAllDependencies(Collection<Dependency> roots, Scope... scopes) {
var result = new DependencySet();
@ -86,7 +86,7 @@ public class ParallelDependencyResolver {
*
* @param dependencies the dependencies to resolve the latest versions of
* @return the latest versions in the order of the provided dependencies
* @since 2.3.1
* @since 2.4.0
*/
public List<Version> resolveLatestVersions(List<Dependency> dependencies) {
var resolutions = new ArrayList<Supplier<Version>>(dependencies.size());
@ -100,7 +100,7 @@ public class ParallelDependencyResolver {
* Returns the version resolution state that can be cached.
*
* @return the version resolution state
* @since 2.3.1
* @since 2.4.0
*/
public VersionResolution resolution() {
return resolution_;
@ -110,7 +110,7 @@ public class ParallelDependencyResolver {
* Retrieve the repositories that are used by this resolver.
*
* @return the resolver's repositories
* @since 2.3.1
* @since 2.4.0
*/
public List<Repository> repositories() {
return repositories_;

2
src/main/java/rife/bld/dependencies/ParallelExecution.java
View file

@ -17,7 +17,7 @@ import java.util.function.Supplier;
* order will have its exception rethrown.
*
* @author Geert Bevin (gbevin[remove] at uwyn dot com)
* @since 2.3.1
* @since 2.4.0
*/
final class ParallelExecution {
private ParallelExecution() {

4
src/main/java/rife/bld/dependencies/PomPrefetcher.java
View file

@ -20,7 +20,7 @@ import java.util.concurrent.Executors;
* POM of each unique dependency will only be prefetched once.
*
* @author Geert Bevin (gbevin[remove] at uwyn dot com)
* @since 2.3.1
* @since 2.4.0
*/
class PomPrefetcher {
private final VersionResolution resolution_;
@ -34,7 +34,7 @@ class PomPrefetcher {
*
* @return the prefetcher; or {@code null} when the retriever doesn't
* cache the retrieved POMs or when the resolution parallelism disables it
* @since 2.3.1
* @since 2.4.0
*/
static PomPrefetcher create(VersionResolution resolution, ArtifactRetriever retriever, List<Repository> repositories) {
// prefetching only has benefits when the retrieved POMs are

10
src/main/java/rife/bld/dependencies/TransferOutput.java
View file

@ -18,7 +18,7 @@ import java.util.List;
* interleaving the lines of parallel transfers.
*
* @author Geert Bevin (gbevin[remove] at uwyn dot com)
* @since 2.3.1
* @since 2.4.0
*/
abstract class TransferOutput {
private static final TransferOutput INSTANCE = create();
@ -39,14 +39,14 @@ abstract class TransferOutput {
*
* @param location the location of the artifact that is being transferred
* @return the transfer to report progress and completion on
* @since 2.3.1
* @since 2.4.0
*/
abstract Transfer start(String location);
/**
* A single artifact transfer whose progress is being tracked.
*
* @since 2.3.1
* @since 2.4.0
*/
abstract static class Transfer {
protected final String location_;
@ -60,7 +60,7 @@ abstract class TransferOutput {
*
* @param transferred the number of bytes transferred so far
* @param total the total number of bytes; or {@code -1} when unknown
* @since 2.3.1
* @since 2.4.0
*/
abstract void progress(long transferred, long total);
@ -69,7 +69,7 @@ abstract class TransferOutput {
*
* @param status the final status of the transfer, like
* {@code done}, {@code exists} or {@code not found}
* @since 2.3.1
* @since 2.4.0
*/
abstract void finish(String status);
}

8
src/main/java/rife/bld/dependencies/VersionResolution.java
View file

@ -44,7 +44,7 @@ public class VersionResolution {
/**
* The property key that determines how many artifact transfers are
* performed in parallel, {@code 1} makes them sequential.
* @since 2.3.1
* @since 2.4.0
*/
public static final String PROPERTY_TRANSFER_PARALLELISM = "bld.transferParallelism";
private static final int DEFAULT_TRANSFER_PARALLELISM = 6;
@ -53,7 +53,7 @@ public class VersionResolution {
* The property key that determines how many POMs are speculatively
* retrieved in parallel during transitive dependency resolution,
* {@code 1} disables the parallel retrieval.
* @since 2.3.1
* @since 2.4.0
*/
public static final String PROPERTY_RESOLUTION_PARALLELISM = "bld.resolutionParallelism";
private static final int DEFAULT_RESOLUTION_PARALLELISM = 6;
@ -168,7 +168,7 @@ public class VersionResolution {
* {@code 1} means transfers are sequential.
*
* @return the number of parallel artifact transfers
* @since 2.3.1
* @since 2.4.0
*/
public int transferParallelism() {
return transferParallelism_;
@ -180,7 +180,7 @@ public class VersionResolution {
* retrieval is disabled.
*
* @return the number of parallel POM retrievals
* @since 2.3.1
* @since 2.4.0
*/
public int resolutionParallelism() {
return resolutionParallelism_;

4
src/main/java/rife/bld/operations/AbstractCreateOperation.java
View file

@ -179,7 +179,7 @@ public abstract class AbstractCreateOperation<T extends AbstractCreateOperation<
* parents, outputting the location when the operation is {@link #verbose()}.
*
* @param directory the directory to create
* @since 2.3.1
* @since 2.4.0
*/
protected void executeCreateDirectory(File directory) {
if (verbose()) {
@ -194,7 +194,7 @@ public abstract class AbstractCreateOperation<T extends AbstractCreateOperation<
*
* @param content the content to write
* @param file the file to write the content into
* @since 2.3.1
* @since 2.4.0
*/
protected void executeWriteProjectFile(String content, File file)
throws FileUtilsErrorException {

4
src/main/java/rife/bld/operations/AbstractOperation.java
View file

@ -55,7 +55,7 @@ public abstract class AbstractOperation<T extends AbstractOperation<T>> {
* @param verbose {@code true} if the operation should be verbose;
* {@code false} otherwise
* @return this operation instance
* @since 2.3.1
* @since 2.4.0
*/
public T verbose(boolean verbose) {
verbose_ = verbose;
@ -68,7 +68,7 @@ public abstract class AbstractOperation<T extends AbstractOperation<T>> {
*
* @return {@code true} if the operation should be verbose;
* {@code false} otherwise
* @since 2.3.1
* @since 2.4.0
*/
public boolean verbose() {
return verbose_;

8
src/main/java/rife/bld/operations/AbstractProcessOperation.java
View file

@ -241,7 +241,7 @@ public abstract class AbstractProcessOperation<T extends AbstractProcessOperatio
*
* @param classpath classpath entries for the operation
* @return this operation instance
* @since 2.3.1
* @since 2.4.0
*
*/
public T classpath(File... classpath) {
@ -269,7 +269,7 @@ public abstract class AbstractProcessOperation<T extends AbstractProcessOperatio
*
* @param classpath a list of classpath entries for the operation
* @return this operation instance
* @since 2.3.1
* @since 2.4.0
*/
public T classpath(Collection<File> classpath) {
classpath_.addAll(classpath.stream().map(File::getAbsolutePath).toList());
@ -293,7 +293,7 @@ public abstract class AbstractProcessOperation<T extends AbstractProcessOperatio
*
* @param modulePath module path entries for the operation
* @return this operation instance
* @since 2.3.1
* @since 2.4.0
*/
public T modulePath(File... modulePath) {
return modulePath(List.of(modulePath));
@ -320,7 +320,7 @@ public abstract class AbstractProcessOperation<T extends AbstractProcessOperatio
*
* @param modulePath a list of module path entries for the operation
* @return this operation instance
* @since 2.3.1
* @since 2.4.0
*/
public T modulePath(Collection<File> modulePath) {
modulePath_.addAll(modulePath.stream().map(File::getAbsolutePath).toList());

4
src/main/java/rife/bld/operations/DownloadOperation.java
View file

@ -145,7 +145,7 @@ public class DownloadOperation extends AbstractOperation<DownloadOperation> {
* artifact transfers of the {@linkplain #transfers() transfer batch}
* together in parallel.
*
* @since 2.3.1
* @since 2.4.0
*/
protected void executeTransferDependencies() {
transfers().transfer(new VersionResolution(properties()), artifactRetriever(), repositories());
@ -156,7 +156,7 @@ public class DownloadOperation extends AbstractOperation<DownloadOperation> {
* operation.
*
* @return the artifact transfer batch of this operation
* @since 2.3.1
* @since 2.4.0
*/
protected DependencyTransferBatch transfers() {
return transfers_;

50
src/main/java/rife/bld/operations/JavacOptions.java
View file

@ -136,7 +136,7 @@ public class JavacOptions extends ArrayList<String> {
* of other-module is ALL-UNNAMED
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions addExports(String... modules) {
if (isNotEmpty(modules)) {
@ -151,7 +151,7 @@ public class JavacOptions extends ArrayList<String> {
* of other-module is ALL-UNNAMED
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions addExports(Collection<String> modules) {
return addCommaSeparatedOption("--add-exports", modules);
@ -161,7 +161,7 @@ public class JavacOptions extends ArrayList<String> {
* Specifies additional modules to be considered as required by a given module
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions addReads(String... modules) {
if (isNotEmpty(modules)) {
@ -174,7 +174,7 @@ public class JavacOptions extends ArrayList<String> {
* Specifies additional modules to be considered as required by a given module
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions addReads(Collection<String> modules) {
return addCommaSeparatedOption("--add-reads", modules);
@ -222,7 +222,7 @@ public class JavacOptions extends ArrayList<String> {
* if none specified or inferred
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions defaultModuleForCreatedFiles(String module) {
add("--default-module-for-created-files");
@ -417,7 +417,7 @@ public class JavacOptions extends ArrayList<String> {
* Overrides or augments a module with classes and resources in JAR files or directories
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions patchModule(String module) {
add("--patch-module");
@ -441,7 +441,7 @@ public class JavacOptions extends ArrayList<String> {
* Provide source compatibility with the specified Java SE release
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions source(int version) {
add("--source");
@ -453,7 +453,7 @@ public class JavacOptions extends ArrayList<String> {
* Generate class files suitable for the specified Java SE release
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions target(int version) {
add("--target");
@ -645,7 +645,7 @@ public class JavacOptions extends ArrayList<String> {
* Specify where to find input source files for multiple modules
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions moduleSourcePathStrings(Collection<String> paths) {
return addPathOption("--module-source-path", paths);
@ -655,7 +655,7 @@ public class JavacOptions extends ArrayList<String> {
* Specify where to find input source files for multiple modules
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions moduleSourcePathPaths(Collection<Path> paths) {
if (isNotEmpty(paths)) {
@ -668,7 +668,7 @@ public class JavacOptions extends ArrayList<String> {
* Specify where to find input source files for multiple modules
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions moduleSourcePath(Collection<File> paths) {
if (isNotEmpty(paths)) {
@ -827,7 +827,7 @@ public class JavacOptions extends ArrayList<String> {
* Specify a module path where to find annotation processors
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions processorModulePathPaths(Collection<Path> paths) {
if (isNotEmpty(paths)) {
@ -840,7 +840,7 @@ public class JavacOptions extends ArrayList<String> {
* Specify a module path where to find annotation processors
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions processorModulePathStrings(Collection<String> paths) {
return addPathOption("--processor-module-path", paths);
@ -850,7 +850,7 @@ public class JavacOptions extends ArrayList<String> {
* Specify a module path where to find annotation processors
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions processorModulePath(Collection<File> paths) {
if (isNotEmpty(paths)) {
@ -902,7 +902,7 @@ public class JavacOptions extends ArrayList<String> {
* Specify where to find annotation processors
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions processorPathStrings(Collection<String> paths) {
return addPathOption("--processor-path", paths);
@ -912,7 +912,7 @@ public class JavacOptions extends ArrayList<String> {
* Specify where to find annotation processors
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions processorPath(Collection<File> paths) {
if (isNotEmpty(paths)) {
@ -925,7 +925,7 @@ public class JavacOptions extends ArrayList<String> {
* Specify where to find annotation processors
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions processorPathPaths(Collection<Path> paths) {
if (isNotEmpty(paths)) {
@ -1036,7 +1036,7 @@ public class JavacOptions extends ArrayList<String> {
* Override location of upgradeable modules
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions upgradeModulePathStrings(Collection<String> paths) {
return addPathOption("--upgrade-module-path", paths);
@ -1046,7 +1046,7 @@ public class JavacOptions extends ArrayList<String> {
* Override location of upgradeable modules
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions upgradeModulePath(Collection<File> paths) {
if (isNotEmpty(paths)) {
@ -1059,7 +1059,7 @@ public class JavacOptions extends ArrayList<String> {
* Override location of upgradeable modules
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions upgradeModulePathPaths(Collection<Path> paths) {
if (isNotEmpty(paths)) {
@ -1083,7 +1083,7 @@ public class JavacOptions extends ArrayList<String> {
* Enable recommended warning categories
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions xLint() {
add("-Xlint");
@ -1094,7 +1094,7 @@ public class JavacOptions extends ArrayList<String> {
* Warning categories to enable
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions xLint(XLintKey... keys) {
if (isNotEmpty(keys)) {
@ -1107,7 +1107,7 @@ public class JavacOptions extends ArrayList<String> {
* Warning categories to enable
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions xLint(Collection<XLintKey> keys) {
if (isNotEmpty(keys)) {
@ -1120,7 +1120,7 @@ public class JavacOptions extends ArrayList<String> {
* Warning categories to disable
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions xLintDisable(XLintKey... keys) {
if (isNotEmpty(keys)) {
@ -1133,7 +1133,7 @@ public class JavacOptions extends ArrayList<String> {
* Warning categories to disable
*
* @return this list of options
* @since 2.3.1
* @since 2.4.0
*/
public JavacOptions xLintDisable(Collection<XLintKey> keys) {
if (isNotEmpty(keys)) {