forked from StarOpenSource/Engine
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