create and delete reference

Author: juliendidier

doc/api/references.rst

@@ -51,6 +51,25 @@ On each of those objects, you can access those informations:
     // Get the last modification
     $lastModification = $master->getLastModification();
 
+Create and delete reference
+---------------------------
+
+You can create new tags and branches on repository, using helper methods
+on ReferenceBag object:
+
+.. code-block:: php
+
+    // create a branch
+    $references = $repository->getReferences();
+    $branch     = $references->createBranch('foobar', 'a8b7e4...'); // commit to reference
+
+    // create a tag
+    $references = $repository->getReferences();
+    $tag        = $references->createTag('0.3', 'a8b7e4...'); // commit to reference
+
+    // delete a branch or a tag
+    $branch->delete();
+
 Resolution from a commit
 ------------------------
 

src/Gitonomy/Git/Reference.php

@@ -16,6 +16,7 @@
  * Reference in a Git repository.
  *
  * @author Alexandre Salomé <[email protected]>
+ * @author Julien DIDIER <[email protected]>
  */
 abstract class Reference
 {
@@ -97,4 +98,9 @@ public function getLastModification()
     {
         return $this->getCommit()->getAuthorDate();
     }
+
+    public function delete()
+    {
+        $this->repository->getReferences()->delete($this->getFullname());
+    }
 }

src/Gitonomy/Git/ReferenceBag.php

@@ -16,11 +16,14 @@
 
 use Gitonomy\Git\Exception\ReferenceNotFoundException;
 use Gitonomy\Git\Exception\RuntimeException;
+use Gitonomy\Git\Reference\Branch;
+use Gitonomy\Git\Reference\Tag;
 
 /**
  * Reference set associated to a repository.
  *
  * @author Alexandre Salomé <[email protected]>
+ * @author Julien DIDIER <[email protected]>
  */
 class ReferenceBag implements \Countable, \IteratorAggregate
 {
@@ -97,6 +100,38 @@ public function has($fullname)
         return isset($this->references[$fullname]);
     }
 
+    public function update(Reference $reference)
+    {
+        $fullname = $reference->getFullname();
+
+        $this->repository->run('update-ref', array($fullname, $reference->getCommitHash()));
+
+        $this->references[$fullname] = $reference;
+
+        return $reference;
+    }
+
+    public function createBranch($name, $commitHash)
+    {
+        $branch = new Branch($this->repository, 'refs/heads/'.$name, $commitHash);
+
+        return $this->update($branch);
+    }
+
+    public function createTag($name, $commitHash)
+    {
+        $tag = new Tag($this->repository, 'refs/tags/'.$name, $commitHash);
+
+        return $this->update($tag);
+    }
+
+    public function delete($fullname)
+    {
+        $this->repository->run('update-ref', array('-d', $fullname));
+
+        unset($this->references[$fullname]);
+    }
+
     public function hasBranches()
     {
         $this->initialize();

tests/Gitonomy/Git/Tests/ReferenceTest.php

@@ -109,4 +109,30 @@ public function testIterable()
         }
         $this->assertGreaterThanOrEqual(2, $i, "At least two references in repository");
     }
+
+    public function testCreateAndDeleteTag()
+    {
+        $references = $this->getLibRepository()->getReferences();
+        $tag        = $references->createTag('0.0', self::INITIAL_COMMIT);
+
+        $this->assertTrue($references->hasTag('0.0'), "Tag 0.0 created");
+        $this->assertEquals(self::INITIAL_COMMIT, $tag->getCommit()->getHash());
+        $this->assertSame($tag, $references->getTag('0.0'));
+
+        $tag->delete();
+        $this->assertFalse($references->hasTag('0.0'), "Tag 0.0 removed");
+    }
+
+    public function testCreateAndDeleteBranch()
+    {
+        $references = $this->getLibRepository()->getReferences();
+        $branch     = $references->createBranch('foobar', self::INITIAL_COMMIT);
+
+        $this->assertTrue($references->hasBranch('foobar'), "Branch foobar created");
+        $this->assertEquals(self::INITIAL_COMMIT, $branch->getCommit()->getHash());
+        $this->assertSame($branch, $references->getBranch('foobar'));
+
+        $branch->delete();
+        $this->assertFalse($references->hasBranch('foobar'), "Branch foobar removed");
+    }
 }

tests/Gitonomy/Git/Tests/TestBase.php

@@ -12,6 +12,7 @@
 
 namespace Gitonomy\Git\Tests;
 
+use Gitonomy\Git\Admin;
 use Gitonomy\Git\Repository;
 
 class TestBase extends \PHPUnit_Framework_TestCase
@@ -43,6 +44,11 @@ public function createTempDir()
         return $tmpDir;
     }
 
+    public function createEmptyRepository()
+    {
+        return Admin::init($this->createTempDir());
+    }
+
     public function deleteDir($dir)
     {
         $iterator = new \RecursiveDirectoryIterator($dir, \FilesystemIterator::SKIP_DOTS | \FilesystemIterator::FOLLOW_SYMLINKS);