Bind the missing refspec methods

These are actions, so they need the handle which we previously made the
code keep around.

Author: carlosmn

LibGit2Sharp.Tests/RefSpecFixture.cs

@@ -190,5 +190,43 @@ public void SettingInvalidRefSpecsThrows(string refSpec)
                 Assert.Equal(oldRefSpecs, newRemote.RefSpecs.Select(r => r.Specification).ToList());
             }
         }
+
+        [Theory]
+        [InlineData("refs/heads/master", true, false)]
+        [InlineData("refs/heads/some/master", true, false)]
+        [InlineData("refs/remotes/foo/master", false, true)]
+        [InlineData("refs/tags/foo", false, false)]
+        public void CanCheckForMatches(string reference, bool shouldMatchSource, bool shouldMatchDest)
+        {
+            var path = SandboxStandardTestRepo();
+            using (var repo = InitIsolatedRepository(path))
+            {
+                var remote = repo.Network.Remotes.Add("foo", "blahblah", "refs/heads/*:refs/remotes/foo/*");
+                var refspec = remote.RefSpecs.Single();
+
+                Assert.Equal(shouldMatchSource, refspec.SourceMatches(reference));
+                Assert.Equal(shouldMatchDest, refspec.DestinationMatches(reference));
+            }
+        }
+
+        [Theory]
+        [InlineData("refs/heads/master", "refs/remotes/foo/master")]
+        [InlineData("refs/heads/bar/master", "refs/remotes/foo/bar/master")]
+        [InlineData("refs/heads/master", "refs/remotes/foo/master")]
+        public void CanTransformRefspecs(string lhs, string rhs)
+        {
+            var path = SandboxStandardTestRepo();
+            using (var repo = InitIsolatedRepository(path))
+            {
+                var remote = repo.Network.Remotes.Add("foo", "blahblah", "refs/heads/*:refs/remotes/foo/*");
+                var refspec = remote.RefSpecs.Single();
+
+                var actualTransformed = refspec.Transform(lhs);
+                var actualReverseTransformed = refspec.ReverseTransform(rhs);
+
+                Assert.Equal(rhs, actualTransformed);
+                Assert.Equal(lhs, actualReverseTransformed);
+            }
+        }
     }
 }

LibGit2Sharp/Core/NativeMethods.cs

@@ -1109,6 +1109,12 @@ internal static extern IntPtr git_reflog_entry_committer(
         [return: MarshalAs(UnmanagedType.CustomMarshaler, MarshalCookie = UniqueId.UniqueIdentifier, MarshalTypeRef = typeof(LaxUtf8NoCleanupMarshaler))]
         internal static extern string git_reflog_entry_message(SafeHandle entry);
 
+        [DllImport(libgit2)]
+        internal static extern int git_refspec_transform(
+            GitBuf buf,
+            GitRefSpecHandle refspec,
+            [MarshalAs(UnmanagedType.CustomMarshaler, MarshalCookie = UniqueId.UniqueIdentifier, MarshalTypeRef = typeof(StrictUtf8Marshaler))] string name);
+
         [DllImport(libgit2)]
         internal static extern int git_refspec_rtransform(
             GitBuf buf,
@@ -1136,6 +1142,16 @@ internal static extern string git_refspec_src(
         [DllImport(libgit2)]
         internal static extern bool git_refspec_force(GitRefSpecHandle refSpec);
 
+        [DllImport(libgit2)]
+        internal static extern bool git_refspec_src_matches(
+            GitRefSpecHandle resfpec,
+            [MarshalAs(UnmanagedType.CustomMarshaler, MarshalCookie = UniqueId.UniqueIdentifier, MarshalTypeRef = typeof(StrictUtf8Marshaler))] string reference);
+
+        [DllImport(libgit2)]
+        internal static extern bool git_refspec_dst_matches(
+            GitRefSpecHandle resfpec,
+            [MarshalAs(UnmanagedType.CustomMarshaler, MarshalCookie = UniqueId.UniqueIdentifier, MarshalTypeRef = typeof(StrictUtf8Marshaler))] string reference);
+
         [DllImport(libgit2)]
         internal static extern int git_remote_autotag(RemoteSafeHandle remote);
 

LibGit2Sharp/Core/Proxy.cs

@@ -1992,6 +1992,17 @@ public static string git_reflog_entry_message(SafeHandle entry)
 
         #region git_refspec
 
+        public static string git_refspec_transform(GitRefSpecHandle refSpecPtr, string name)
+        {
+            using (var buf = new GitBuf())
+            {
+                int res = NativeMethods.git_refspec_transform(buf, refSpecPtr, name);
+                Ensure.ZeroResult(res);
+
+                return LaxUtf8Marshaler.FromNative(buf.ptr) ?? string.Empty;
+            }
+        }
+
         public static string git_refspec_rtransform(GitRefSpecHandle refSpecPtr, string name)
         {
             using (var buf = new GitBuf())
@@ -2028,6 +2039,16 @@ public static bool git_refspec_force(GitRefSpecHandle refSpec)
             return NativeMethods.git_refspec_force(refSpec);
         }
 
+        public static bool git_refspec_src_matches(GitRefSpecHandle refspec, string reference)
+        {
+            return NativeMethods.git_refspec_src_matches(refspec, reference);
+        }
+
+        public static bool git_refspec_dst_matches(GitRefSpecHandle refspec, string reference)
+        {
+            return NativeMethods.git_refspec_dst_matches(refspec, reference);
+        }
+
         #endregion
 
         #region git_remote_

LibGit2Sharp/RefSpec.cs

@@ -82,6 +82,46 @@ public virtual bool ForceUpdate
             }
         }
 
+        /// <summary>
+        /// Check whether the given reference matches the source (lhs) part of
+        /// this refspec.
+        /// </summary>
+        /// <param name="reference">The reference name to check</param>
+        public virtual bool SourceMatches(string reference)
+        {
+            return Proxy.git_refspec_src_matches(handle, reference);
+        }
+
+        /// <summary>
+        /// Check whether the given reference matches the target (rhs) part of
+        /// this refspec.
+        /// </summary>
+        /// <param name="reference">The reference name to check</param>
+        public virtual bool DestinationMatches(string reference)
+        {
+            return Proxy.git_refspec_dst_matches(handle, reference);
+        }
+
+        /// <summary>
+        /// Perform the transformation described by this refspec on the given
+        /// reference name (from source to destination).
+        /// </summary>
+        /// <param name="reference">The reference name to transform</param>
+        public virtual string Transform(string reference)
+        {
+            return Proxy.git_refspec_transform(handle, reference);
+        }
+
+        /// <summary>
+        /// Perform the reverse of the transformation described by this refspec
+        /// on the given reference name (from destination to source).
+        /// </summary>
+        /// <param name="reference">The reference name to transform</param>
+        public virtual string ReverseTransform(string reference)
+        {
+            return Proxy.git_refspec_rtransform(handle, reference);
+        }
+
         private string DebuggerDisplay
         {
             get