<?php
/*
 * igitigit - Web frontend for Git repositories
 * Copyright (C) 2011  Klaus Reimer <hide@address.com>
 *
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU 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 General
 * Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

namespace igitigit;

/**
 * Repository object interface.
 *
 * @author Klaus Reimer <hide@address.com>
 */
interface RepoObject extends Object
{
    /**
     * Returns the revision.
     *
     * @return string
     *            The revision.
     */
    public function getRevision();
        
    /**
     * Returns the repository this blob belongs to.
     *
     * @return Repository
     *             The repository.
     */
    public function getRepo();

    /**
     * Returns the URL to view the full history of this tree.
     *
     * @return string
     *             The history URL.
     */
    public function getHistoryUrl();

    /**
     * Returns the commits for this tree.
     *
     * @return Commit[]
     *            The commits.
     */
    public function getCommits();
    
    /**
     * Returns the last commit of this repository object.
     *
     * @return Commit
     *            The last commit. NULL if there is no commit at all.
     */
    public function getLastCommit();
}