<?php
require_once 'MTrack/SCM.php';

abstract class MTrackSCMFile {
  /** reference to the associated MTrackSCM object */
  public $repo;

  /** full path to file, with a leading slash (which represents
   * the root of its respective repo */
  public $name;

  /** if true, this file represents a directory */
  public $is_dir = false;

  /** revision */
  public $rev;

  function __construct(MTrackSCM $repo, $name, $rev, $is_dir = false)
  {
    $this->repo = $repo;
    $this->name = $name;
    $this->rev = $rev;
    $this->is_dir = $is_dir;
  }

  /** Returns an MTrackSCMEvent corresponding to this revision of
   * the file */
  abstract public function getChangeEvent();

  /** Returns a stream representing the contents of the file at
   * this revision */
  abstract public function cat();

  /** Returns an array of MTrackSCMAnnotation objects that correspond to
   * each line of file content, annotating when the line was last
   * changed.  The array is keyed by line number, 1-based. */
  abstract public function annotate($include_line_content = false);

  
  
  
}