feat(branch): add more bindings and api methods (#13)

test/assets/testrepo/.gitdir/config

@@ -3,7 +3,10 @@
 	filemode = true
 	bare = false
 	logallrefupdates = true
-  editor = vim
+	editor = vim
 [remote "origin"]
 	url = git://github.com/SkinnyMind/libgit2dart.git
 	fetch = +refs/heads/*:refs/remotes/origin/*
+[branch "master"]
+	remote = origin
+	merge = refs/heads/master

test/assets/testrepo/.gitdir/refs/remotes/origin/master

@@ -0,0 +1 @@
+821ed6e80627b8769d170a293862f9fc60825226

test/branch_test.dart

@@ -26,7 +26,7 @@ void main() {
 
   group('Branch', () {
     test('returns a list of all branches', () {
-      const branchesExpected = ['feature', 'master'];
+      const branchesExpected = ['feature', 'master', 'origin/master'];
       final branches = repo.branches;
 
       for (var i = 0; i < branches.length; i++) {
@@ -46,7 +46,13 @@ void main() {
     });
 
     test('returns a list of remote branches', () {
-      expect(repo.branchesRemote, <Branch>[]);
+      const branchesExpected = ['origin/master'];
+      final branches = repo.branchesRemote;
+
+      for (var i = 0; i < branches.length; i++) {
+        expect(branches[i].name, branchesExpected[i]);
+        branches[i].free();
+      }
     });
 
     test('throws when trying to return list and error occurs', () {
@@ -121,6 +127,113 @@ void main() {
       expect(() => nullBranch.name, throwsA(isA<LibGit2Error>()));
     });
 
+    test('returns remote name of a remote-tracking branch', () {
+      final branch = repo.branchesRemote.first;
+      expect(branch.remoteName, 'origin');
+      branch.free();
+    });
+
+    test(
+        'throws when getting remote name of a remote-tracking branch and '
+        'error occurs', () {
+      final branch = repo.lookupBranch(name: 'master');
+      expect(() => branch.remoteName, throwsA(isA<LibGit2Error>()));
+    });
+
+    test('returns upstream of a local branch', () {
+      final branch = repo.lookupBranch(name: 'master');
+      final upstream = branch.upstream;
+
+      expect(upstream.isRemote, true);
+      expect(upstream.name, 'refs/remotes/origin/master');
+
+      upstream.free();
+      branch.free();
+    });
+
+    test('throws when trying to get upstream of a remote branch', () {
+      final branch = repo.branchesRemote.first;
+      expect(() => branch.upstream, throwsA(isA<LibGit2Error>()));
+      branch.free();
+    });
+
+    test('successfully sets upstream of a branch', () {
+      final branch = repo.lookupBranch(name: 'master');
+      var upstream = branch.upstream;
+      expect(upstream.name, 'refs/remotes/origin/master');
+
+      final ref = repo.createReference(
+        name: 'refs/remotes/origin/new',
+        target: 'refs/heads/master',
+      );
+      branch.setUpstream(ref.shorthand);
+
+      upstream = branch.upstream;
+      expect(upstream.name, 'refs/remotes/origin/new');
+
+      ref.free();
+      upstream.free();
+      branch.free();
+    });
+
+    test('successfully unsets upstream of a branch', () {
+      final branch = repo.lookupBranch(name: 'master');
+      final upstream = branch.upstream;
+      expect(upstream.name, 'refs/remotes/origin/master');
+
+      branch.setUpstream(null);
+      expect(() => branch.upstream, throwsA(isA<LibGit2Error>()));
+
+      upstream.free();
+      branch.free();
+    });
+
+    test('throws when trying to set upstream of a branch and error occurs', () {
+      final branch = repo.lookupBranch(name: 'master');
+      expect(
+        () => branch.setUpstream('some/upstream'),
+        throwsA(isA<LibGit2Error>()),
+      );
+      branch.free();
+    });
+
+    test('returns upstream name of a local branch', () {
+      final branch = repo.lookupBranch(name: 'master');
+      expect(branch.upstreamName, 'refs/remotes/origin/master');
+      branch.free();
+    });
+
+    test('throws when trying to get upstream name of a branch and error occurs',
+        () {
+      final branch = repo.lookupBranch(name: 'feature');
+      expect(() => branch.upstreamName, throwsA(isA<LibGit2Error>()));
+      branch.free();
+    });
+
+    test('returns upstream remote of a local branch', () {
+      final branch = repo.lookupBranch(name: 'master');
+      expect(branch.upstreamRemote, 'origin');
+      branch.free();
+    });
+
+    test('throws when trying to get upstream remote of a remote branch', () {
+      final branch = repo.branchesRemote.first;
+      expect(() => branch.upstreamName, throwsA(isA<LibGit2Error>()));
+      branch.free();
+    });
+
+    test('returns upstream merge of a local branch', () {
+      final branch = repo.lookupBranch(name: 'master');
+      expect(branch.upstreamMerge, 'refs/heads/master');
+      branch.free();
+    });
+
+    test('throws when trying to get upstream merge of a remote branch', () {
+      final branch = repo.branchesRemote.first;
+      expect(() => branch.upstreamMerge, throwsA(isA<LibGit2Error>()));
+      branch.free();
+    });
+
     group('create()', () {
       test('successfully creates', () {
         final commit = repo.lookupCommit(lastCommit);
@@ -128,7 +241,7 @@ void main() {
         final branch = repo.createBranch(name: 'testing', target: commit);
         final branches = repo.branches;
 
-        expect(repo.branches.length, 3);
+        expect(repo.branches.length, 4);
         expect(branch.target, lastCommit);
 
         for (final branch in branches) {
@@ -194,7 +307,7 @@ void main() {
         final branch = repo.lookupBranch(name: 'renamed');
         final branches = repo.branches;
 
-        expect(branches.length, 2);
+        expect(branches.length, 3);
         expect(
           () => repo.lookupBranch(name: 'feature'),
           throwsA(isA<LibGit2Error>()),

test/libgit2_test.dart

@@ -1,5 +1,4 @@
 import 'package:libgit2dart/libgit2dart.dart';
-import 'package:libgit2dart/src/libgit2.dart';
 import 'package:libgit2dart/src/util.dart';
 import 'package:test/test.dart';
 

test/packbuilder_test.dart

@@ -123,7 +123,7 @@ void main() {
     test('successfully packs with provided packDelegate', () {
       Directory('${repo.workdir}.git/objects/pack/').createSync();
       void packDelegate(PackBuilder packBuilder) {
-        final branches = repo.branches;
+        final branches = repo.branchesLocal;
         for (final branch in branches) {
           final ref = repo.lookupReference('refs/heads/${branch.name}');
           for (final commit in repo.log(oid: ref.target)) {

test/reference_test.dart

@@ -30,6 +30,7 @@ void main() {
           'refs/heads/feature',
           'refs/heads/master',
           'refs/notes/commits',
+          'refs/remotes/origin/master',
           'refs/tags/v0.1',
           'refs/tags/v0.2',
         ],
@@ -80,14 +81,14 @@ void main() {
 
     test('returns the short name', () {
       final ref = repo.createReference(
-        name: 'refs/remotes/origin/master',
+        name: 'refs/remotes/origin/upstream',
         target: repo[lastCommit],
       );
 
       final head = repo.head;
 
       expect(head.shorthand, 'master');
-      expect(ref.shorthand, 'origin/master');
+      expect(ref.shorthand, 'origin/upstream');
 
       head.free();
       ref.free();
@@ -106,13 +107,8 @@ void main() {
     });
 
     test('checks if reference is a remote branch', () {
-      final ref = repo.createReference(
-        name: 'refs/remotes/origin/master',
-        target: repo[lastCommit],
-      );
-
+      final ref = repo.lookupReference('refs/remotes/origin/master');
       expect(ref.isRemote, true);
-
       ref.free();
     });
 
@@ -431,7 +427,7 @@ void main() {
 
         expect(ref1.target.sha, '78b8bf123e3952c970ae5c1ce0a3ea1d1336f6e8');
         expect(ref2.target.sha, 'f0fdbf506397e9f58c59b88dfdd72778ec06cc0c');
-        expect(repo.references.length, 5);
+        expect(repo.references.length, 6);
 
         repo.renameReference(
           oldName: 'refs/tags/v0.1',
@@ -445,7 +441,7 @@ void main() {
           '78b8bf123e3952c970ae5c1ce0a3ea1d1336f6e8',
         );
         expect(repo.references, isNot(contains('refs/tags/v0.1')));
-        expect(repo.references.length, 4);
+        expect(repo.references.length, 5);
 
         ref1.free();
         ref2.free();