library/Git/Commit.php

   1 <?php
   2
   3 /**
   4  * Represents a commit in the Git repository.
   5  */
   6 class Git_Commit {
   7
   8     public $repo, $id, $tree, $author, $authoredDate, $committer,
   9         $committedDate, $message, $parents = array();
  10
  11     /**
  12      * @param $repo Git_Repo of this commit.
  13      * @param $kwargs Hash of info about this commit, specifically:
  14      *      'id' => Id of commit
  15      *      'parents' => List of commit IDs (converted to Git_Commit objects)
  16      *      'tree' => Tree ID (converted to Git_Tree object)
  17      *      'author' => Author string
  18      *      'authoredDate' => Authored DateTime
  19      *      'committer' => Committer string
  20      *      'committedDate' => Committed DateTime
  21      *      'message' => First line of commit message
  22      */
  23     public function __construct($repo, $kwargs) {
  24         $this->repo = $repo;
  25         foreach ($kwargs as $k => $v) {
  26             if ($k == 'parents') {
  27                 foreach ($v as $id) {
  28                     $this->parents[] = new Git_Commit($repo, array('id' => $id));
  29                 }
  30                 continue;
  31             } elseif ($k == 'tree') {
  32                 //$this->tree = new Git_Tree($repo, array('id' => $v));
  33                 // :TODO: Implement Git_Tree
  34                 $this->tree = $v;
  35                 continue;
  36             }
  37             $this->$k = $v;
  38         }
  39     }
  40
  41     // __bake__
  42
  43     /**
  44      * Return a shortened representation of Git's commit ID.
  45      */
  46     public function idAbbrev() {
  47         return substr($this->id, 0, 7);
  48     }
  49
  50     // public static(?) function count() {
  51     // public static function findAll($repo, $ref, $kwargs) {
  52
  53     /**
  54      * Parses out commit information from git log --pretty raw into an
  55      * array of Commit objects.
  56      * @param $repo Git_Repo
  57      * @param $text Text from command
  58      * @return Array of Git_Commit objects
  59      */
  60     public static function listFromString($repo, $text) {
  61         $lines = explode("\n", $text);
  62         for ($i = 0, $c = count($lines); $i < $c; $i++) {
  63
  64             $id   = self::_l($lines, $i, true);
  65             $tree = self::_l($lines, $i, true);
  66
  67             $parents = array();
  68             while ($lines && strncmp($lines[$i], 'parent', 6) === 0) {
  69                 $parents[] = self::_l($lines, $i, true);
  70             }
  71             list($author, $authoredDate) = self::actor(self::_l($lines, $i));
  72             list($committer, $committedDate) = self::actor(self::_l($lines, $i));
  73
  74             $messages = array();
  75             while ($lines && strncmp($lines[$i], '    ', 4) === 0) {
  76                 $messages[] = trim(self::_l($lines, $i));
  77             }
  78
  79             $message = $messages ? $messages[0] : '';
  80
  81             $commits[] = new Git_Commit($repo, compact(
  82                 'id', 'parents', 'tree', 'author', 'authoredDate',
  83                 'committer', 'committedDate', 'message'
  84             ));
  85         }
  86         return $commits;
  87     }
  88
  89     /**
  90      * Grabs the current line, advances the index forward, and parses
  91      * out the last bit.
  92      * @param $lines Array of lines
  93      * @param &$i Index in $lines array
  94      * @param $grab_last Whether or not to retrieve the span of text after
  95      *        the last whitespace.
  96      */
  97     private static function _l($lines, &$i, $grab_last = false) {
  98         $line = $lines[$i++];
  99         if ($grab_last) {
 100             $line = trim($line);
 101             $line = substr($line, strrpos($line, ' ') + 1);
 102         }
 103         return $line;
 104     }
 105
 106     /**
 107      * Parse out actor (author/committer) information.
 108      * @returns array('Actor name <email>', timestamp)
 109      */
 110     public static function actor($line) {
 111         preg_match('/^.+? (.*) (\d+) .*$/', $line, $matches);
 112         list($x, $actor, $epoch) = $matches;
 113         return array(Git_Actor::fromString($actor), new DateTime($epoch));
 114     }
 115
 116 }