Merge branch 'Marusyk-rmarusyk/ScriptCallerInfo-Alias' into develop

* Marusyk-rmarusyk/ScriptCallerInfo-Alias:
  Add ScriptCallerAliases

Author: devlead

src/Cake.Common/Diagnostics/ScriptCallerAliases.cs

@@ -0,0 +1,37 @@
+using System;
+using System.Runtime.CompilerServices;
+using Cake.Core;
+using Cake.Core.Annotations;
+
+namespace Cake.Common.Diagnostics
+{
+    /// <summary>
+    /// Contains functionality related to diagnostics.
+    /// </summary>
+    [CakeAliasCategory("Diagnostics")]
+    public static class ScriptCallerAliases
+    {
+        /// <summary>
+        /// Performs script caller information.
+        /// </summary>
+        /// <param name="context">The context.</param>
+        /// <param name="memberName">The member name.</param>
+        /// <param name="sourceFilePath">The source file path.</param>
+        /// <param name="sourceLineNumber">The source line number.</param>
+        /// <returns>A <see cref="GetCallerInfo"/> instance representing the caller information.</returns>
+        [CakeMethodAlias]
+        public static ScriptCallerInfo GetCallerInfo(
+            this ICakeContext context,
+            [CallerMemberName] string memberName = "",
+            [CallerFilePath] string sourceFilePath = "",
+            [CallerLineNumber] int sourceLineNumber = 0)
+        {
+            if (context == null)
+            {
+                throw new ArgumentNullException(nameof(context));
+            }
+
+            return new ScriptCallerInfo(memberName, sourceFilePath, sourceLineNumber);
+        }
+    }
+}

src/Cake.Common/Diagnostics/ScriptCallerInfo.cs

@@ -0,0 +1,46 @@
+using Cake.Core.IO;
+
+namespace Cake.Common.Diagnostics
+{
+    /// <summary>
+    /// Represents a caller information.
+    /// </summary>
+    public sealed class ScriptCallerInfo
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ScriptCallerInfo"/> class.
+        /// </summary>
+        /// <param name="memberName">The member name.</param>
+        /// <param name="sourceFilePath">The source file path.</param>
+        /// <param name="sourceLineNumber">The source line number.</param>
+        public ScriptCallerInfo(string memberName, FilePath sourceFilePath, int sourceLineNumber)
+        {
+            MemberName = memberName;
+            SourceFilePath = sourceFilePath;
+            SourceLineNumber = sourceLineNumber;
+        }
+
+        /// <summary>
+        /// Gets the method or property name of the caller to the method.
+        /// </summary>
+        public string MemberName { get; }
+
+        /// <summary>
+        /// Gets the full path of the source file that contains the caller.
+        /// </summary>
+        public FilePath SourceFilePath { get; }
+
+        /// <summary>
+        /// Gets the line number in the source file at which the method is called.
+        /// </summary>
+        public int SourceLineNumber { get; }
+
+        /// <summary>
+        /// Returns a <see cref="System.String" /> containing the full path of the source file and the line number in the source file at which the method is called.
+        /// </summary>
+        /// <returns>
+        /// A <see cref="System.String" /> containing the full path of the source file and the line number in the source file at which the method is called.
+        /// </returns>
+        public override string ToString() => $"{SourceFilePath}:{SourceLineNumber}";
+    }
+}