Add -[GTBranch rename:]

Author: tiennou

ObjectiveGit/GTBranch.h

@@ -78,6 +78,9 @@ NS_ASSUME_NONNULL_BEGIN
 /// returns a GTCommit object or nil if an error occurred
 - (GTCommit * _Nullable)targetCommitWithError:(NSError **)error;
 
+/// Renames the branch. Setting `force` to YES to delete another branch with the same name.
+- (BOOL)rename:(NSString *)name force:(BOOL)force error:(NSError **)error;
+
 /// Count all commits in this branch
 ///
 /// error(out) - will be filled if an error occurs

ObjectiveGit/GTBranch.m

@@ -171,6 +171,19 @@ - (BOOL)deleteWithError:(NSError **)error {
 	return YES;
 }
 
+- (BOOL)rename:(NSString *)name force:(BOOL)force error:(NSError **)error {
+	git_reference *git_ref;
+	int gitError = git_branch_move(&git_ref, self.reference.git_reference, name.UTF8String, (force ? 1 : 0));
+	if (gitError != GIT_OK) {
+		if (error) *error = [NSError git_errorFor:gitError description:@"Rename branch failed"];
+		return NO;
+	}
+
+	_reference = [[GTReference alloc] initWithGitReference:git_ref repository:self.repository];
+
+	return YES;
+}
+
 - (GTBranch *)trackingBranchWithError:(NSError **)error success:(BOOL *)success {
 	if (self.branchType == GTBranchTypeRemote) {
 		if (success != NULL) *success = YES;

ObjectiveGitTests/GTBranchSpec.m

@@ -272,6 +272,41 @@
 	});
 });
 
+describe(@"-rename:force:error", ^{
+	__block GTBranch *masterBranch;
+	beforeEach(^{
+		masterBranch = [repository lookUpBranchWithName:@"master" type:GTBranchTypeLocal success:NULL error:NULL];
+		expect(masterBranch).notTo(beNil());
+	});
+
+	it(@"should rename the branch", ^{
+		NSError *error = nil;
+		BOOL success = [masterBranch rename:@"plop" force:NO error:&error];
+		expect(@(success)).to(beTruthy());
+		expect(error).to(beNil());
+
+		expect(masterBranch.shortName).to(equal(@"plop"));
+	});
+
+	it(@"should fail on duplicates", ^{
+		NSError *error = nil;
+		BOOL success = [masterBranch rename:@"feature" force:NO error:&error];
+		expect(@(success)).to(beFalsy());
+		expect(error).notTo(beNil());
+
+		expect(masterBranch.shortName).to(equal(@"master"));
+	});
+
+	it(@"should rename when forced", ^{
+		NSError *error = nil;
+		BOOL success = [masterBranch rename:@"feature" force:YES error:&error];
+		expect(@(success)).to(beTruthy());
+		expect(error).to(beNil());
+
+		expect(masterBranch.shortName).to(equal(@"feature"));
+	});
+});
+
 // TODO: Test branch renaming, branch upstream
 //- (void)testCanRenameBranch {
 //