Add probably broken dependency resolver
This commit is contained in:
parent
ef8cdb87cf
commit
4793d7aefe
6 changed files with 484 additions and 0 deletions
|
@ -0,0 +1,40 @@
|
|||
/*
|
||||
* STAROPENSOURCE ENGINE SOURCE FILE
|
||||
* Copyright (c) 2024 The StarOpenSource Engine Contributors
|
||||
* Licensed under the GNU Affero General Public License v3
|
||||
*
|
||||
* This program is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as
|
||||
* published by the Free Software Foundation, either version 3 of the
|
||||
* License, or (at your option) any later version.
|
||||
*
|
||||
* This program is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
package de.staropensource.sosengine.base.exceptions;
|
||||
|
||||
import org.jetbrains.annotations.NotNull;
|
||||
|
||||
/**
|
||||
* Represents an exception caused by a dependency cycle.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
@SuppressWarnings({ "unused" })
|
||||
public class DependencyCycleException extends Exception {
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @param path cycle path
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
public DependencyCycleException(@NotNull String path) {
|
||||
super("Dependency cycle detected: " + path);
|
||||
}
|
||||
}
|
|
@ -0,0 +1,68 @@
|
|||
/*
|
||||
* STAROPENSOURCE ENGINE SOURCE FILE
|
||||
* Copyright (c) 2024 The StarOpenSource Engine Contributors
|
||||
* Licensed under the GNU Affero General Public License v3
|
||||
*
|
||||
* This program is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as
|
||||
* published by the Free Software Foundation, either version 3 of the
|
||||
* License, or (at your option) any later version.
|
||||
*
|
||||
* This program is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
package de.staropensource.sosengine.base.exceptions;
|
||||
|
||||
import lombok.Getter;
|
||||
import org.jetbrains.annotations.NotNull;
|
||||
import org.jetbrains.annotations.Nullable;
|
||||
|
||||
/**
|
||||
* Represents an exception caused by some throwable.
|
||||
* Basic wrapper for every throwable there is.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
@SuppressWarnings({ "unused", "JavadocDeclaration", "JavadocBlankLines" })
|
||||
@Getter
|
||||
public class UnexpectedThrowableException extends Exception {
|
||||
/**
|
||||
* Contains the throwable supplied to the constructor.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*
|
||||
* -- GETTER --
|
||||
* Returns the throwable supplied by the constructor.
|
||||
*
|
||||
* @return throwable
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
@Nullable
|
||||
Throwable throwable;
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @param throwable throwable
|
||||
* @param message message
|
||||
*/
|
||||
public UnexpectedThrowableException(@NotNull Throwable throwable, @NotNull String message) {
|
||||
super(message);
|
||||
this.throwable = throwable;
|
||||
}
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @param throwable throwable
|
||||
*/
|
||||
public UnexpectedThrowableException(@NotNull Throwable throwable) {
|
||||
this.throwable = throwable;
|
||||
}
|
||||
}
|
|
@ -0,0 +1,53 @@
|
|||
/*
|
||||
* STAROPENSOURCE ENGINE SOURCE FILE
|
||||
* Copyright (c) 2024 The StarOpenSource Engine Contributors
|
||||
* Licensed under the GNU Affero General Public License v3
|
||||
*
|
||||
* This program is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as
|
||||
* published by the Free Software Foundation, either version 3 of the
|
||||
* License, or (at your option) any later version.
|
||||
*
|
||||
* This program is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
package de.staropensource.sosengine.base.exceptions;
|
||||
|
||||
import de.staropensource.sosengine.base.types.DependencyVector;
|
||||
import lombok.Getter;
|
||||
import org.jetbrains.annotations.NotNull;
|
||||
|
||||
import java.util.Map;
|
||||
|
||||
/**
|
||||
* Represents an exception caused by unmet dependencies.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
@SuppressWarnings({ "unused", "JavadocDeclaration", "JavadocBlankLines" })
|
||||
@Getter
|
||||
public class UnmetDependenciesException extends Exception {
|
||||
/**
|
||||
* Contains the unmet dependencies list supplied to the constructor.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*
|
||||
* -- GETTER --
|
||||
* Returns the unmet dependencies list supplied to the constructor.
|
||||
*
|
||||
* @return unmet dependencies list
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
@NotNull
|
||||
private final Map<@NotNull DependencyVector, @NotNull String> unmetDependencies;
|
||||
|
||||
public UnmetDependenciesException(@NotNull Map<@NotNull DependencyVector, @NotNull String> unmetDependencies) {
|
||||
this.unmetDependencies = unmetDependencies;
|
||||
}
|
||||
}
|
|
@ -0,0 +1,51 @@
|
|||
/*
|
||||
* STAROPENSOURCE ENGINE SOURCE FILE
|
||||
* Copyright (c) 2024 The StarOpenSource Engine Contributors
|
||||
* Licensed under the GNU Affero General Public License v3
|
||||
*
|
||||
* This program is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as
|
||||
* published by the Free Software Foundation, either version 3 of the
|
||||
* License, or (at your option) any later version.
|
||||
*
|
||||
* This program is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
package de.staropensource.sosengine.base.types;
|
||||
|
||||
import lombok.Getter;
|
||||
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* Represents a dependency vector with resolved dependencies, used for dependency management.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
@SuppressWarnings({ "unused", "JavadocDeclaration", "JavadocBlankLines" })
|
||||
@Getter
|
||||
public class DependencyResolvedDependencyVector extends DependencyVector {
|
||||
/**
|
||||
* Contains all resolved dependencies.
|
||||
*
|
||||
* @since v1-alpha1
|
||||
*
|
||||
* -- GETTER --
|
||||
* Returns all resolved dependencies.
|
||||
*
|
||||
* @return resolved dependencies
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
private final List<DependencyVector> resolvedDependencies;
|
||||
|
||||
public DependencyResolvedDependencyVector(DependencyVector vector, List<DependencyVector> resolvedDependencies) {
|
||||
super(vector.getIdentifier(), vector.getVersioningSystem(), vector.getVersion(), vector.getDependencies());
|
||||
this.resolvedDependencies = resolvedDependencies;
|
||||
}
|
||||
}
|
|
@ -0,0 +1,120 @@
|
|||
/*
|
||||
* STAROPENSOURCE ENGINE SOURCE FILE
|
||||
* Copyright (c) 2024 The StarOpenSource Engine Contributors
|
||||
* Licensed under the GNU Affero General Public License v3
|
||||
*
|
||||
* This program is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as
|
||||
* published by the Free Software Foundation, either version 3 of the
|
||||
* License, or (at your option) any later version.
|
||||
*
|
||||
* This program is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
package de.staropensource.sosengine.base.types;
|
||||
|
||||
import lombok.Getter;
|
||||
import org.jetbrains.annotations.NotNull;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* Represents a dependency vector, used for dependency management.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
@SuppressWarnings({ "unused", "JavadocDeclaration", "JavadocBlankLines" })
|
||||
@Getter
|
||||
public class DependencyVector {
|
||||
/**
|
||||
* Contains the identifier of this vector.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*
|
||||
* -- GETTER --
|
||||
* Returns the vector identifier.
|
||||
*
|
||||
* @return vector identifier
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
@NotNull
|
||||
private final String identifier;
|
||||
|
||||
/**
|
||||
* Determines which versioning system this vector uses.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*
|
||||
* -- GETTER --
|
||||
* Returns the versioning system this vector uses.
|
||||
*
|
||||
* @return versioning system in use
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
@NotNull
|
||||
private final Class<? extends VersioningSystem> versioningSystem;
|
||||
|
||||
/**
|
||||
* Contains the version of this vector.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*
|
||||
* -- GETTER --
|
||||
* Returns the vector version.
|
||||
*
|
||||
* @return vector version
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
@NotNull
|
||||
private final String version;
|
||||
|
||||
/**
|
||||
* Contains all vectors this vector hard-depends on.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*
|
||||
* -- GETTER --
|
||||
* Returns all vectors this vector hard-depends on.
|
||||
*
|
||||
* @return hard dependencies
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
@NotNull
|
||||
private final List<@NotNull String> dependencies;
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @param identifier identifier
|
||||
* @param versioningSystem versioning system to use
|
||||
* @param version version
|
||||
* @param dependencies dependencies in the usual format ({@code dependency1}, {@code dependency2=5.1}, {@code dependency3>3.1}, {@code dependency<6.1})
|
||||
*/
|
||||
public DependencyVector(@NotNull String identifier, @NotNull Class<? extends VersioningSystem> versioningSystem, @NotNull String version, @NotNull List<@NotNull String> dependencies) {
|
||||
this.identifier = identifier;
|
||||
this.versioningSystem = versioningSystem;
|
||||
this.version = version;
|
||||
this.dependencies = dependencies;
|
||||
}
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @param identifier identifier
|
||||
* @param versioningSystem versioning system to use
|
||||
* @param version version
|
||||
*/
|
||||
public DependencyVector(@NotNull String identifier, @NotNull Class<? extends VersioningSystem> versioningSystem, @NotNull String version) {
|
||||
this.identifier = identifier;
|
||||
this.versioningSystem = versioningSystem;
|
||||
this.version = version;
|
||||
this.dependencies = new ArrayList<>();
|
||||
}
|
||||
}
|
|
@ -0,0 +1,152 @@
|
|||
/*
|
||||
* STAROPENSOURCE ENGINE SOURCE FILE
|
||||
* Copyright (c) 2024 The StarOpenSource Engine Contributors
|
||||
* Licensed under the GNU Affero General Public License v3
|
||||
*
|
||||
* This program is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as
|
||||
* published by the Free Software Foundation, either version 3 of the
|
||||
* License, or (at your option) any later version.
|
||||
*
|
||||
* This program is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
package de.staropensource.sosengine.base.utility;
|
||||
|
||||
import de.staropensource.sosengine.base.exceptions.UnexpectedThrowableException;
|
||||
import de.staropensource.sosengine.base.exceptions.UnmetDependenciesException;
|
||||
import de.staropensource.sosengine.base.types.DependencyResolvedDependencyVector;
|
||||
import de.staropensource.sosengine.base.types.DependencyVector;
|
||||
import org.jetbrains.annotations.NotNull;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.HashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
/**
|
||||
* Resolves dependency vectors.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
@SuppressWarnings({ "unused" })
|
||||
public class DependencyResolver {
|
||||
/**
|
||||
* A list of {@link DependencyVector}s.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
List<DependencyVector> vectors = new ArrayList<>();
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*/
|
||||
public DependencyResolver() {}
|
||||
|
||||
/**
|
||||
* Adds a dependency vector.
|
||||
*
|
||||
* @param vector dependency vector to add
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
public void addVector(@NotNull DependencyVector vector) {
|
||||
vectors.add(vector);
|
||||
}
|
||||
|
||||
/**
|
||||
* Resolves all dependency vectors.
|
||||
* Throws an exception when detecting an unmet dependency or a dependency cycle.
|
||||
*
|
||||
* @since 1-alpha1
|
||||
*/
|
||||
public void resolve() throws UnmetDependenciesException, UnexpectedThrowableException {
|
||||
List<DependencyResolvedDependencyVector> resolvedDependencyVectors = new ArrayList<>();
|
||||
Map<DependencyVector, String> unmetDependencies = new HashMap<>();
|
||||
|
||||
try {
|
||||
for (DependencyVector vector : vectors)
|
||||
for (String dependency : vector.getDependencies()) {
|
||||
int match = 0;
|
||||
|
||||
if (dependency.contains("=")) {
|
||||
String dependencyIdentifier = dependency.substring(0, dependency.indexOf("="));
|
||||
String dependencyVersion = dependency.substring(dependency.indexOf("="));
|
||||
|
||||
for (DependencyVector vectorCheck : vectors)
|
||||
if (vectorCheck.getIdentifier().equals(dependency)) {
|
||||
if (vectorCheck.getVersioningSystem().getDeclaredConstructor().newInstance(dependencyVersion).compare(vectorCheck.getVersioningSystem().getDeclaredConstructor().newInstance(vectorCheck.getVersion())) == 1)
|
||||
match = -1;
|
||||
else
|
||||
match = 2;
|
||||
|
||||
break;
|
||||
}
|
||||
|
||||
if (match == 0)
|
||||
unmetDependencies.put(vector, "Depends on '" + dependencyIdentifier + "', which is missing");
|
||||
else {
|
||||
unmetDependencies.put(vector, "Depends exactly on '" + dependency + "', which is not installed");
|
||||
}
|
||||
} else if (dependency.contains("<")) {
|
||||
String dependencyIdentifier = dependency.substring(0, dependency.indexOf("<"));
|
||||
String dependencyVersion = dependency.substring(dependency.indexOf("<"));
|
||||
|
||||
for (DependencyVector vectorCheck : vectors)
|
||||
if (vectorCheck.getIdentifier().equals(dependency)) {
|
||||
if (vectorCheck.getVersioningSystem().getDeclaredConstructor().newInstance(dependencyVersion).compare(vectorCheck.getVersioningSystem().getDeclaredConstructor().newInstance(vectorCheck.getVersion())) == 0)
|
||||
match = -1;
|
||||
else
|
||||
match = 2;
|
||||
|
||||
break;
|
||||
}
|
||||
|
||||
if (match == 0)
|
||||
unmetDependencies.put(vector, "Depends on '" + dependencyIdentifier + "', which is missing");
|
||||
else {
|
||||
unmetDependencies.put(vector, "Depends at maximum on '" + dependency + "', which is not installed");
|
||||
}
|
||||
} else if (dependency.contains(">")) {
|
||||
String dependencyIdentifier = dependency.substring(0, dependency.indexOf(">"));
|
||||
String dependencyVersion = dependency.substring(dependency.indexOf(">"));
|
||||
|
||||
for (DependencyVector vectorCheck : vectors)
|
||||
if (vectorCheck.getIdentifier().equals(dependency)) {
|
||||
if (vectorCheck.getVersioningSystem().getDeclaredConstructor().newInstance(dependencyVersion).compare(vectorCheck.getVersioningSystem().getDeclaredConstructor().newInstance(vectorCheck.getVersion())) == 2)
|
||||
match = -1;
|
||||
else
|
||||
match = 2;
|
||||
|
||||
break;
|
||||
}
|
||||
|
||||
if (match == 0)
|
||||
unmetDependencies.put(vector, "Depends on '" + dependencyIdentifier + "', which is missing");
|
||||
else {
|
||||
unmetDependencies.put(vector, "Depends at minimum on '" + dependency + "', which is not installed");
|
||||
}
|
||||
} else {
|
||||
for (DependencyVector vectorCheck : vectors)
|
||||
if (vectorCheck.getIdentifier().equals(dependency)) {
|
||||
match = -1;
|
||||
break;
|
||||
}
|
||||
|
||||
if (match == 0)
|
||||
unmetDependencies.put(vector, "Depends on any version of '" + dependency + "', which is missing");
|
||||
}
|
||||
}
|
||||
} catch (Exception exception) {
|
||||
throw new UnexpectedThrowableException(exception);
|
||||
}
|
||||
|
||||
if (!unmetDependencies.isEmpty())
|
||||
throw new UnmetDependenciesException(unmetDependencies);
|
||||
}
|
||||
}
|
Loading…
Reference in a new issue