/*
 * Copyright (C) 2022 - 2024, the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package io.github.ascopes.jct.assertions;

import static io.github.ascopes.jct.utils.IoExceptionUtils.uncheckedIo;
import static io.github.ascopes.jct.utils.IterableUtils.requireAtLeastOne;
import static io.github.ascopes.jct.utils.IterableUtils.requireNonNullValues;
import static io.github.ascopes.jct.utils.StringUtils.quoted;
import static io.github.ascopes.jct.utils.StringUtils.quotedIterable;
import static java.util.function.Predicate.not;
import static org.assertj.core.api.Assertions.assertThat;

import io.github.ascopes.jct.containers.PackageContainerGroup;
import io.github.ascopes.jct.repr.LocationRepresentation;
import io.github.ascopes.jct.utils.StringUtils;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.List;
import java.util.Objects;
import java.util.Optional;
import java.util.Set;
import java.util.stream.Collectors;
import java.util.stream.StreamSupport;
import org.apiguardian.api.API;
import org.apiguardian.api.API.Status;
import org.assertj.core.api.AbstractPathAssert;
import org.assertj.core.description.TextDescription;
import org.assertj.core.error.MultipleAssertionsError;
import org.jspecify.annotations.Nullable;

/**
 * Assertions for package container groups.
 *
 * @author Ashley Scopes
 * @since 0.0.1
 */
@API(since = "0.0.1", status = Status.STABLE)
public final class PackageContainerGroupAssert
    extends AbstractContainerGroupAssert<PackageContainerGroupAssert, PackageContainerGroup> {

  /**
   * Initialize the container group assertions.
   *
   * @param containerGroup the container group to assert upon.
   */
  public PackageContainerGroupAssert(@Nullable PackageContainerGroup containerGroup) {
    super(containerGroup, PackageContainerGroupAssert.class);
  }

  /**
   * Assert that all given files exist.
   *
   * @param paths paths to check for.
   * @return this object for further call chaining.
   * @throws AssertionError           if the container group is null, or if any of the files do not
   *                                  exist.
   * @throws NullPointerException     if any of the paths are null.
   * @throws IllegalArgumentException if no fragments are provided.
   */
  public PackageContainerGroupAssert allFilesExist(String... paths) {
    requireNonNullValues(paths, "paths");
    requireAtLeastOne(paths, "paths");

    allFilesExist(List.of(paths));
    return this;
  }

  /**
   * Assert that all given files exist.
   *
   * @param paths paths to check for.
   * @return this object for further call chaining.
   * @throws AssertionError       if the container group is null, or if any of the files do not
   *                              exist.
   * @throws NullPointerException if any of the paths are null.
   */
  public PackageContainerGroupAssert allFilesExist(Iterable<String> paths) {
    requireNonNullValues(paths, "paths");

    isNotNull();

    var errors = new ArrayList<AssertionError>();

    for (var path : paths) {
      try {
        fileExists(path);
      } catch (AssertionError ex) {
        errors.add(ex);
      }
    }

    if (errors.isEmpty()) {
      return this;
    }

    throw new MultipleAssertionsError(
        new TextDescription(
            "Expected all paths in %s to exist but one or more did not",
            quotedIterable(paths)
        ),
        errors
    );
  }

  /**
   * Get assertions to perform on the class loader associated with this container group.
   *
   * @return the assertions to perform.
   * @throws AssertionError if the container group is null.
   */
  public ClassLoaderAssert classLoader() {
    isNotNull();

    return new ClassLoaderAssert(actual.getClassLoader());
  }

  /**
   * Assert that the given file does not exist.
   *
   * <pre><code>
   *   // Using platform-specific separators.
   *   assertions.fileDoesNotExist("foo/bar/baz.txt")...;
   *
   *   // Letting JCT infer the correct path separators to use (recommended).
   *   assertions.fileDoesNotExist("foo", "bar", "baz.txt");
   * </code></pre>
   *
   * @param fragments any additional parts of the path.
   * @return this assertion object for further assertions.
   * @throws AssertionError           if the file exists, or if the container group is null.
   * @throws NullPointerException     if any of the fragments are null.
   * @throws IllegalArgumentException if no fragments are provided.
   */
  public PackageContainerGroupAssert fileDoesNotExist(String... fragments) {
    requireNonNullValues(fragments, "fragments");
    requireAtLeastOne(fragments, "fragments");

    isNotNull();

    var actualFile = actual.getFile(fragments);

    if (actualFile == null) {
      return this;
    }

    throw failure(
        "Expected path %s to not exist in %s but it was found at %s",
        quotedUserProvidedPath(List.of(fragments)),
        LocationRepresentation.getInstance().toStringOf(actual.getLocation()),
        quoted(actualFile)
    );
  }

  /**
   * Assert that the given file exists.
   *
   * <pre><code>
   *   // Letting JCT infer the correct path separators to use (recommended).
   *   assertions.fileExists("foo", "bar", "baz.txt");
   *
   *   // Using platform-specific separators (more likely to produce unexpected results).
   *   assertions.fileExists("foo/bar/baz.txt")...;
   * </code></pre>
   *
   * <p>If the file does not exist, then this object will attempt to find the
   * closest matches and list them in an error message along with the assertion error.
   *
   * @param fragments parts of the path.
   * @return assertions to perform on the path of the file that exists.
   * @throws AssertionError           if the file does not exist, or if the container group is
   *                                  null.
   * @throws NullPointerException     if any of the fragments are null.
   * @throws IllegalArgumentException if no fragments are provided.
   */

  public AbstractPathAssert<?> fileExists(String... fragments) {
    requireNonNullValues(fragments, "fragments");
    requireAtLeastOne(fragments, "fragments");

    isNotNull();

    var actualFile = actual.getFile(fragments);

    if (actualFile != null) {
      // File exists with this path. Hooray, lets return assertions on it.
      return assertThat(actualFile);
    }

    var expected = List.of(fragments);
    var message = StringUtils.resultNotFoundWithFuzzySuggestions(
        fuzzySafePath(expected),
        quotedUserProvidedPath(expected),
        listAllUniqueFilesForAllContainers(),
        this::fuzzySafePath,
        this::quotedUserProvidedPath,
        "file with relative path"
    );

    throw failure(message);
  }

  private Set<Path> listAllUniqueFilesForAllContainers() {
    return uncheckedIo(actual::listAllFiles)
        .keySet()
        .stream()
        // Make all the files relative to their roots.
        .flatMap(container -> uncheckedIo(container::listAllFiles)
            .stream()
            .map(container.getInnerPathRoot().getPath()::relativize))
        // Filter out the inner path root itself, preventing few confusing issues with zero-length
        // file names. In ZIP paths this can also be null, so we have to check for both "" and null
        // here.
        .filter(this::fileNameIsPresent)
        // Remove duplicates (don't think this can ever happen but this is just to be safe).
        .collect(Collectors.toSet());
  }

  private <T> String quotedUserProvidedPath(Iterable<T> parts) {
    return StreamSupport
        .stream(parts.spliterator(), false)
        .map(Objects::toString)
        .collect(Collectors.collectingAndThen(
            Collectors.joining("/"),
            StringUtils::quoted
        ));
  }

  private <T> String fuzzySafePath(Iterable<T> parts) {
    // Join on null bytes as we don't ever use those in normal path names. This way, we ignore
    // file-system and OS-specific path separators creating ambiguities (like how Windows uses
    // backslashes rather than forward slashes to delimit paths).
    return StreamSupport
        .stream(parts.spliterator(), false)
        .map(Objects::toString)
        .collect(Collectors.joining("\0"));
  }

  private boolean fileNameIsPresent(@Nullable Path path) {
    // Path can be null if no path elements exist in ZipPath implementations.
    return Optional
        .ofNullable(path)
        .map(Path::getFileName)
        .map(Path::toString)
        .filter(not(String::isBlank))
        .isPresent();
  }
}