Added rudimentary methods for writing data

doc/repository.md

@@ -145,3 +145,21 @@ It is possible to send environment variables to the `git` commands.
 ```php
 $repository = new Gitonomy\Git\Repository('/tmp/foo', ['environment_variables' => ['GIT_']])
 ```
+
+Pull
+----
+
+You can pull changes from remote by calling `pull()`:
+
+```php
+$repository->pull();
+```
+
+Push
+----
+
+You can push changes to remote by calling `push()`:
+
+```php
+$repository->push();
+```

doc/workingcopy.md

@@ -45,3 +45,41 @@ You can get pending modifications on tracked files by calling method
 ```php
 $diff = $wc->getDiffPending();
 ```
+
+Staging file(s)
+---------------
+
+You can stage changed files by calling `stage(...files)`:
+
+```php
+$wc->stage('file1.txt', 'file2.txt');
+```
+
+Unstaging file(s)
+-----------------
+
+You can unstage files by calling `unstage(...files)`:
+
+```php
+$wc->unstage('file1.txt', 'file2.txt');
+```
+
+Discard file(s) changes
+-----------------------
+
+You can discard file(s) changed by calling `discard(...files)`:
+
+```php
+$wc->discard('file1.txt', 'file2.txt');
+```
+
+Committing
+---------
+
+You can commit changed files by calling `commit(message, author, ...files)`:
+
+NOTE :: this will commit all staged files, the ...files argument simply stages those files before commiting, if you already have files staged by having called `stage(...files)` these files are included in the commit
+
+```php
+$wc->commit('summary', 'author', 'file1.txt', 'file2.txt');
+```

src/Gitonomy/Git/Repository.php

@@ -516,6 +516,30 @@ public function setDescription($description)
         return $this;
     }
 
+    /**
+     * Executes pull command.
+     *
+     * @return Repository the current repository
+     */
+    public function pull()
+    {
+        $result = $this->run('pull');
+
+        return preg_match('/\d (?:file|files) changed, \d insertion\(\+\), \d deletion\(\-\)/', $result) === 1;
+    }
+
+    /**
+     * Executes push command.
+     *
+     * @return Repository the current repository
+     */
+    public function push()
+    {
+        $result = $this->run('push');
+
+        return strpos($result, 'Writing objects: 100%') !== false;
+    }
+
     /**
      * This command is a facility command. You can run any command
      * directly on git repository.

src/Gitonomy/Git/WorkingCopy.php

@@ -94,6 +94,62 @@ public function checkout($revision, $branch = null)
         return $this;
     }
 
+    /**
+     * Stages the files provided by arguments.
+     *
+     * @return Repository the current repository
+     */
+    public function stage(string ...$files)
+    {
+        foreach ($files as $file) {
+            $this->run('add', [$file]);
+        }
+
+        return $this;
+    }
+
+    /**
+     * Unstages the files provided by arguments.
+     *
+     * @return Repository the current repository
+     */
+    public function unstage(string ...$files)
+    {
+        foreach ($files as $file) {
+            $this->run('restore', ['--staged', $file]);
+        }
+
+        return $this;
+    }
+
+    /**
+     * Discards file changed from files provided by arguments.
+     *
+     * @return Repository the current repository
+     */
+    public function discard(string ...$files)
+    {
+        foreach ($files as $file) {
+            $this->run('checkout', ['--', $file]);
+        }
+
+        return $this;
+    }
+
+    /**
+     * Creates a commit with the message provided.
+     * Optionally stages files provided.
+     *
+     * @return Repository the current repository
+     */
+    public function commit(string $message, string ...$files)
+    {
+        $this->stage(...$files);
+        $this->run('commit', ['-m', $message]);
+
+        return $this;
+    }
+
     protected function run($command, array $args = [])
     {
         return $this->repository->run($command, $args);

tests/Gitonomy/Git/Tests/RepositoryTest.php

@@ -55,6 +55,22 @@ public function testGetDescription($repository)
         $this->assertSame("Unnamed repository; edit this file 'description' to name the repository.\n", $repository->getDescription());
     }
 
+    /*
+     * @dataProvider provideFoobar
+     */
+    public function testPull($repository)
+    {
+        $this->assertIsBool($repository->pull());
+    }
+
+    /*
+     * @dataProvider provideFoobar
+     */
+    public function testPush($repository)
+    {
+        $this->assertIsBool($repository->push());
+    }
+
     /**
      * @dataProvider provideFoobar
      */

tests/Gitonomy/Git/Tests/WorkingCopyTest.php

@@ -110,4 +110,66 @@ public function testGetUntracked()
 
         $this->assertContains('untracked.txt', $wc->getUntrackedFiles());
     }
+
+    public function testStage()
+    {
+        $repository = self::createFoobarRepository(false);
+        $wc = $repository->getWorkingCopy();
+
+        $file = $repository->getWorkingDir().'/test.sh';
+        file_put_contents($file, 'test');
+
+        $this->assertContains('test.sh', $wc->getDiffPending());
+
+        $wc->stage('test.sh');
+
+        $this->assertContains('test.sh', $wc->getDiffStaged());
+    }
+
+    public function testUnstage()
+    {
+        $repository = self::createFoobarRepository(false);
+        $wc = $repository->getWorkingCopy();
+
+        $file = $repository->getWorkingDir().'/test.sh';
+        file_put_contents($file, 'test');
+
+        $wc->stage('test.sh');
+        $this->assertContains('test.sh', $wc->getDiffStaged());
+
+        $wc->unstage('test.sh');
+        $this->assertContains('test.sh', $wc->getDiffPending());
+    }
+
+    public function testDiscard()
+    {
+        $repository = self::createFoobarRepository(false);
+        $wc = $repository->getWorkingCopy();
+
+        $file = $repository->getWorkingDir().'/test.sh';
+        file_put_contents($file, 'test');
+
+        $this->assertContains('test.sh', $wc->getDiffPending());
+
+        $wc->discard('test.sh');
+
+        $diffPending = $wc->getDiffPending();
+        $this->assertCount(0, $diffPending->getFiles());
+    }
+
+    public function testCommit()
+    {
+        $repository = self::createFoobarRepository(false);
+        $wc = $repository->getWorkingCopy();
+
+        $file = $repository->getWorkingDir().'/test.sh';
+        file_put_contents($file, 'test');
+
+        $this->assertContains('test.sh', $wc->getDiffPending());
+
+        $wc->commit('this is the commit message', 'John Doe', 'test.sh');
+
+        $diffPending = $wc->getDiffPending();
+        $this->assertCount(0, $diffPending->getFiles());
+    }
 }