<commit_before>/*
 * Copyright 2012 Red Hat, Inc. and/or its affiliates.
 *
 * Licensed under the Eclipse Public License version 1.0, available at
 * http://www.eclipse.org/legal/epl-v10.html
 */

package org.jboss.forge.addon.dependencies;

import java.util.List;
import java.util.Set;

/**
 * @author <a href="mailto:<EMAIL>"><NAME>, III</a>
 */
public interface DependencyResolver
{
   /**
    * Resolve a single {@link Dependency} matching the given {@link DependencyQuery}.
    */
   Dependency resolveArtifact(DependencyQuery query);

   /**
    * Resolve all dependencies for the {@link Dependency} resolved by the given {@link DependencyQuery} object.
    * 
    * The {@link Dependency} object included inside the {@link DependencyQuery} object is not included in the
    * {@link Set} returned
    */
   Set<Dependency> resolveDependencies(DependencyQuery query);

   /**
    * Resolve the entire dependency hierarchy for the given {@link DependencyQuery}. Return results as a graph of
    * {@link DependencyNode} instances.
    */
   DependencyNode resolveDependencyHierarchy(DependencyQuery query);

   /**
    * Resolve the versions from a {@link Dependency} object contained in the {@link DependencyQuery} object.
    */
   List<Coordinate> resolveVersions(DependencyQuery query);

   /**
    * Resolve {@link DependencyMetadata} for a given {@link DependencyQuery}, searching the default repository. This
    * returns information about the configured repositories, dependencies, and managed dependencies of the given query.
    * <p>
    * Note: This method does not accept version ranges. A single version must be specified.
    * <p>
    * <b>Valid query version:</b> 1.0 <b><br>
    * Invalid query version:</b> [1.0,2.0]
    */
   DependencyMetadata resolveDependencyMetadata(DependencyQuery query);
}
<commit_msg>Minor javadoc improvement<commit_after>/*
 * Copyright 2012 Red Hat, Inc. and/or its affiliates.
 *
 * Licensed under the Eclipse Public License version 1.0, available at
 * http://www.eclipse.org/legal/epl-v10.html
 */

package org.jboss.forge.addon.dependencies;

import java.util.List;
import java.util.Set;

/**
 * @author <a href="mailto:<EMAIL>"><NAME>, III</a>
 */
public interface DependencyResolver
{
   /**
    * Resolve a single {@link Dependency} matching the given {@link DependencyQuery}.
    */
   Dependency resolveArtifact(DependencyQuery query);

   /**
    * Resolve all dependencies for the {@link Dependency} resolved by the given {@link DependencyQuery} object.
    * 
    * The {@link Dependency} object included inside the {@link DependencyQuery} object is not included in the
    * {@link Set} returned
    */
   Set<Dependency> resolveDependencies(DependencyQuery query);

   /**
    * Resolve the entire dependency hierarchy for the given {@link DependencyQuery}. Return results as a graph of
    * {@link DependencyNode} instances.
    */
   DependencyNode resolveDependencyHierarchy(DependencyQuery query);

   /**
    * Resolve the versions from a {@link Dependency} object contained in the {@link DependencyQuery} object in ascending
    * order.
    */
   List<Coordinate> resolveVersions(DependencyQuery query);

   /**
    * Resolve {@link DependencyMetadata} for a given {@link DependencyQuery}, searching the default repository. This
    * returns information about the configured repositories, dependencies, and managed dependencies of the given query.
    * <p>
    * Note: This method does not accept version ranges. A single version must be specified.
    * <p>
    * <b>Valid query version:</b> 1.0 <b><br>
    * Invalid query version:</b> [1.0,2.0]
    */
   DependencyMetadata resolveDependencyMetadata(DependencyQuery query);
}

{'fraction_non_alphanumeric': 0.1054761262476396, 'fraction_numerical': 0.007553277582951173, 'mean_word_length': 3.7599486521181, 'pattern_counts': {'":': 0, '<': 29, '<?xml version=': 0, '>': 29, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '263783', 'n_tokens_mistral': 1064, 'n_tokens_neox': 984, 'n_words': 355}