Introduce tracing

Author: Edward Thomson

Lib/NativeBinaries/amd64/git2-69db893.dll

@@ -124,6 +124,7 @@
     <Compile Include="TestHelpers\SelfCleaningDirectory.cs" />
     <Compile Include="TestHelpers\SignatureExtensions.cs" />
     <Compile Include="TestHelpers\SkippableFactAttribute.cs" />
+    <Compile Include="LogFixture.cs" />
     <Compile Include="TreeDefinitionFixture.cs" />
     <Compile Include="TreeFixture.cs" />
     <Compile Include="UnstageFixture.cs" />

Lib/NativeBinaries/amd64/git2-69db893.pdb

@@ -0,0 +1,40 @@
+using System;
+using LibGit2Sharp;
+using LibGit2Sharp.Core;
+using Xunit;
+
+namespace LibGit2Sharp.Tests
+{
+    public class LogFixture
+    {
+        [Fact]
+        public void CanEnableAndDisableLogging()
+        {
+            // Setting logging produces a log message at level Info,
+            // ensure that we catch it.
+            LogLevel level = LogLevel.None;
+            string message = null;
+
+            GlobalSettings.LogConfiguration = new LogConfiguration(LogLevel.Trace, (l, m) => { level = l; message = m; });
+
+            Assert.Equal(LogLevel.Info, level);
+            Assert.Equal("Logging enabled at level Trace", message);
+
+            // Configuring at Warning and higher means that the
+            // message at level Info should not be produced.
+            level = LogLevel.None;
+            message = null;
+
+            GlobalSettings.LogConfiguration = new LogConfiguration(LogLevel.Warning, (l, m) => { level = l; message = m; });
+
+            Assert.Equal(LogLevel.None, level);
+            Assert.Equal(null, message);
+
+            // Similarly, turning logging off should produce no messages.
+            GlobalSettings.LogConfiguration = LogConfiguration.None;
+
+            Assert.Equal(LogLevel.None, level);
+            Assert.Equal(null, message);
+        }
+    }
+}

Lib/NativeBinaries/x86/git2-69db893.dll

@@ -1492,6 +1492,11 @@ internal static extern int git_tag_delete(
         [DllImport(libgit2)]
         internal static extern void git_threads_shutdown();
 
+        internal delegate void git_trace_cb(LogLevel level, IntPtr message);
+
+        [DllImport(libgit2)]
+        internal static extern int git_trace_set(LogLevel level, git_trace_cb trace_cb);
+
         internal delegate int git_transfer_progress_callback(ref GitTransferProgress stats, IntPtr payload);
 
         internal delegate int git_transport_cb(out IntPtr transport, IntPtr remote, IntPtr payload);

Lib/NativeBinaries/x86/git2-69db893.pdb

@@ -2943,6 +2943,19 @@ public static GitObjectType git_tag_target_type(GitObjectSafeHandle tag)
 
         #endregion
 
+        #region git_trace_
+
+        public static void git_trace_set(LogLevel level, NativeMethods.git_trace_cb callback)
+        {
+            using (ThreadAffinity())
+            {
+                int res = NativeMethods.git_trace_set(level, callback);
+                Ensure.ZeroResult(res);
+            }
+        }
+
+        #endregion
+
         #region git_transport_
 
         public static void git_transport_register(String prefix, IntPtr transport_cb, IntPtr param)

LibGit2Sharp.Tests/LibGit2Sharp.Tests.csproj

@@ -1,5 +1,6 @@
 using System;
 using LibGit2Sharp.Core;
+using LibGit2Sharp.Handlers;
 
 namespace LibGit2Sharp
 {
@@ -10,6 +11,8 @@ public static class GlobalSettings
     {
         private static readonly Lazy<Version> version = new Lazy<Version>(Version.Build);
 
+        private static LogConfiguration logConfiguration = LogConfiguration.None;
+
         /// <summary>
         /// Returns all the optional features that were compiled into
         /// libgit2.
@@ -84,5 +87,38 @@ public static void UnregisterSmartSubtransport<T>(SmartSubtransportRegistration<
             Proxy.git_transport_unregister(registration.Scheme);
             registration.Free();
         }
+
+        /// <summary>
+        /// Registers a new <see cref="LogConfiguration"/> to receive
+        /// information logging information from libgit2 and LibGit2Sharp.
+        ///
+        /// Note that this configuration is global to an entire process
+        /// and does not honor application domains.
+        /// </summary>
+        public static LogConfiguration LogConfiguration
+        {
+            set
+            {
+                Ensure.ArgumentNotNull(value, "value");
+
+                logConfiguration = value;
+
+                if (logConfiguration.Level == LogLevel.None)
+                {
+                    Proxy.git_trace_set(0, null);
+                }
+                else
+                {
+                    Proxy.git_trace_set(value.Level, value.GitTraceHandler);
+
+                    Log.Write(LogLevel.Info, "Logging enabled at level {0}", value.Level);
+                }
+            }
+
+            get
+            {
+                return logConfiguration;
+            }
+        }
     }
 }

LibGit2Sharp.Tests/LogFixture.cs

@@ -111,4 +111,12 @@ public enum PackBuilderStage
         /// </summary>
         Deltafying
     }
+
+    /// <summary>
+    /// Delegate definition for logging.  This callback will be used to
+    /// write logging messages in libgit2 and LibGit2Sharp.
+    /// </summary>
+    /// <param name="level">The level of the log message.</param>
+    /// <param name="message">The log message.</param>
+    public delegate void LogHandler(LogLevel level, string message);
 }