net.alloyggp.tournament.api.TTournament Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ggp-tournament Show documentation

A library for GGP tournament specification and scheduling.

There is a newer version: 0.1.0

package net.alloyggp.tournament.api;

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

import org.joda.time.DateTime;

import com.google.common.base.Optional;

/**
 * The main interface for a tournament specification.
 *
 * A Tournament object can be obtained from a YAML specification on
 * the file system via the {@link TTournamentSpecParser}.
 */
public interface TTournament {

    /**
     * Returns a tournament name consisting of alphanumerics and underscores
     * that is suitable for internal use as a key identifying the tournament.
     * This name is specified by the tournament designer, so it may be necessary
     * to screen out duplicate names.
     */
    String getInternalName();

    /**
     * Returns a tournament name that is suitable for human-readable displays.
     */
    String getDisplayName();

    /**
     * Returns the set of matches that should be run in the given tournament state.
     */
    TNextMatchesResult getMatchesToRun(TSeeding initialSeeding, Set resultsSoFar);

    /**
     * Returns the most recent standings in the given tournament state.
     */
    TRanking getCurrentStandings(TSeeding initialSeeding, Set resultsSoFar);

    /**
     * Returns a history of the standings throughout the tournament, starting with the initial
     * seeding and progressing through each round.
     */
    List getStandingsHistory(TSeeding initialSeeding, Set resultsSoFar);

    /**
     * Gets the start time for the first round of the tournament if it has
     * been defined.
     */
    Optional getInitialStartTime();

    /**
     * If a restriction on the start time for the tournament is defined and
     * has not yet passed, returns the number of seconds left until
     * that start time. Otherwise, returns zero.
     */
    long getSecondsToWaitUntilInitialStartTime();

}