Adding Structural data to the master branch

.github/ISSUE_TEMPLATE/MakeRelease.md

@@ -17,4 +17,10 @@ assignees: 'mpostol'
 - [ ] Publish release
 - [ ] Update the repository front page
 - [ ] Update the GitHub pages documentation
-- [ ] Close this issue and the parent milestone
+- [ ] Close this issue and the parent milestone
+
+``` txt
+//Alpha, Bravo, Charlie, Delta, Echo, Foxtrot, Golf, Hotel, India, Juliet, 
+//Kilo, Lima, Mike, November, Oscar, Papa, Quebec, Romeo, Sierra, Tango,
+//Uniform, Victor, Whiskey, X-Ray, Yankee, Zulu 
+```

ExDataManagement/FunctionalProgramming/FunctionalProgramming.UnitTest/AnonymousFunctionsUnitTest.cs

@@ -1,6 +1,6 @@
 //____________________________________________________________________________________________________________________________________
 //
-//  Copyright (C) 2023, Mariusz Postol LODZ POLAND.
+//  Copyright (C) 2024, Mariusz Postol LODZ POLAND.
 //
 //  To be in touch join the community by pressing the `Watch` button and get started commenting using the discussion panel at
 //
@@ -19,24 +19,19 @@ namespace TP.FunctionalProgramming
   [TestClass]
   public class AnonymousFunctionsUnitTest
   {
-    [TestMethod]
-    public void StringIsLongPredicateTest()
-    {
-      Assert.IsTrue(AnonymousFunctions.StringIsLongPredicate("g5F|z*tC&yKJU$"));
-    }
-
     [TestMethod]
     public void NamedMethodCallBackTest()
     {
       AnonymousFunctions _newInstance = new AnonymousFunctions();
       CallBackTestClass _callBackResult = new CallBackTestClass();
       Assert.IsFalse(_callBackResult.m_TestResult);
-      _newInstance.ConsistencyCheck(new AnonymousFunctions.CallBackTestDelegate(_callBackResult.CallBackTestResult));
+      AnonymousFunctions.CallBackTestDelegate _CallBackTestResult = new AnonymousFunctions.CallBackTestDelegate(_callBackResult.CallBackTestResult);
+      _newInstance.ConsistencyCheck(_CallBackTestResult);
       Assert.IsTrue(_callBackResult.m_TestResult);
     }
 
     [TestMethod]
-    public void AnonymousMethodTest()
+    public void AnonymousMethodCallBackTest()
     {
       AnonymousFunctions _newInstance = new AnonymousFunctions();
       bool _testResult = false;
@@ -47,11 +42,12 @@ public void AnonymousMethodTest()
     }
 
     [TestMethod]
-    public void LambdaCallTest()
+    public void LambdaExpressionCallBackTest()
     {
       AnonymousFunctions _newInstance = new AnonymousFunctions();
       bool _testResult = false;
-      _newInstance.ConsistencyCheck(_result => _testResult = _result);
+      AnonymousFunctions.CallBackTestDelegate _CallBackTestResult = _result => _testResult = _result;
+      _newInstance.ConsistencyCheck(_CallBackTestResult);
       Assert.IsTrue(_testResult);
     }
 
@@ -97,6 +93,8 @@ public void EventTestMethod()
       //_newInstance.OnStateChanged(_newInstance, _newInstance.CurrentStateHandler.CurrentState);  //Error CS0070  The event 'AnonymousFunctions.OnStateChanged' can only appear on the left hand side of += or -= (except when used from within the type 'AnonymousFunctions')
     }
 
+    #region Instrumentation
+
     private class CallBackTestClass
     {
       internal bool m_TestResult = false;
@@ -106,5 +104,7 @@ internal void CallBackTestResult(bool returnResult)
         m_TestResult = returnResult;
       }
     }
+
+    #endregion Instrumentation
   }
 }

ExDataManagement/FunctionalProgramming/FunctionalProgramming.UnitTest/ExtensionMethodsUnitTest.cs

@@ -35,7 +35,7 @@ public void TypicalCallTestMethod()
     /// You can invoke the extension method with instance method syntax.
     /// </summary>
     [TestMethod]
-    public void SequentialCallTestMethod()
+    public void CascadedCallTestMethod()
     {
       string _TestString = "Hello Extension Methods";
       Assert.IsFalse(_TestString.WordCount().Even()); //To enable extension methods for a particular type, the definition must be visible.
@@ -46,32 +46,22 @@ public void SequentialCallTestMethod()
     /// Test method of the rule: the existing class method cannot be replaced by an extension method.
     /// </summary>
     [TestMethod]
-    public void OverrideTestMethod()
+    public void CollisionWithInstanceMemberTest()
     {
-      string _TestString = "Hello Extension Methods";
-      Assert.IsTrue(_TestString.Contains("Hello")); //An extension method with the same name and signature as an interface or class method will never be called.
+      string testString = "Hello Extension Methods";
+      Assert.IsTrue(testString.Contains("Hello")); //An extension method with the same name and signature as an interface or class method will never be called.
+      Assert.ThrowsException<NotImplementedException>(() => ExtensionMethods.Contains(testString, "Hello"));
     }
 
     /// <summary>
-    /// Calling the instance method if the reference is null is impossible.
+    /// Instance method call if the reference is null
     /// </summary>
     [TestMethod]
-    [ExpectedException(typeof(NullReferenceException))]
     public void NullCallExceptionTest()
     {
       IMyInterface _myInterface = null;
-      _myInterface.MyInterfaceMethod(); //Here the runtime throws the exception NullReferenceException.
-    }
-
-    /// <summary>
-    /// Calling the extension method if the reference is null proceeds normally.
-    /// </summary>
-    [TestMethod]
-    [ExpectedException(typeof(ArgumentNullException))]
-    public void NullCallTest()
-    {
-      IMyInterface _myInterface = null;
-      _myInterface.ProtectedMyInterfaceMethodCall();
+      Assert.ThrowsException<NullReferenceException>(() => _myInterface.MyInterfaceMethod()); //Here the runtime throws the exception NullReferenceException.
+      Assert.ThrowsException<ArgumentNullException>(() => _myInterface.ProtectedMyInterfaceMethodCall()); //Here the ProtectedMyInterfaceMethodCall method is executed despite the reference being null.
     }
   }
 }

ExDataManagement/FunctionalProgramming/FunctionalProgramming.UnitTest/FunctionalProgramming.UnitTest.csproj

@@ -52,8 +52,10 @@
   <ItemGroup>
     <Compile Include="DelegateExampleUnitTest.cs" />
     <Compile Include="ExtensionMethodsUnitTest.cs" />
+    <Compile Include="FunctionalProgrammingTest.cs" />
     <Compile Include="Properties\AssemblyInfo.cs" />
     <Compile Include="AnonymousFunctionsUnitTest.cs" />
+    <Compile Include="StaticClassTest.cs" />
   </ItemGroup>
   <ItemGroup>
     <ProjectReference Include="..\FunctionalProgramming\FunctionalProgramming.csproj">

ExDataManagement/FunctionalProgramming/FunctionalProgramming.UnitTest/FunctionalProgrammingTest.cs

@@ -0,0 +1,32 @@
+//____________________________________________________________________________________________________________________________________
+//
+//  Copyright (C) 2024, Mariusz Postol LODZ POLAND.
+//
+//  To be in touch join the community by pressing the `Watch` button and get started commenting using the discussion panel at
+//
+//  https://github.com/mpostol/TP/discussions/182
+//
+//  by introducing yourself and telling us what you do with this community.
+//_____________________________________________________________________________________________________________________________________
+
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+using static TP.FunctionalProgramming.FunctionalProgramming;
+
+namespace TP.FunctionalProgramming
+{
+  /// <summary>
+  /// Summary description for FunctionalProgrammingTest
+  /// </summary>
+  [TestClass]
+  public class FunctionalProgrammingTest
+  {
+    [TestMethod]
+    public void StringIsLongPredicateTest()
+    {
+      Assert.IsTrue(StringIsLongPredicate("g5F|z*tC&yKJU$"));
+      Assert.IsFalse(StringIsLongPredicate("g5F|z"));
+    }
+
+    //public TP.FunctionalProgramming.FunctionalProgramming variable; //Error CS0723  Cannot declare a variable of static type 'FunctionalProgramming'
+  }
+}

ExDataManagement/FunctionalProgramming/FunctionalProgramming.UnitTest/StaticClassTest.cs

@@ -0,0 +1,33 @@
+//____________________________________________________________________________________________________________________________________
+//
+//  Copyright (C) 2024, Mariusz Postol LODZ POLAND.
+//
+//  To be in touch join the community by pressing the `Watch` button and get started commenting using the discussion panel at
+//
+//  https://github.com/mpostol/TP/discussions/182
+//
+//  by introducing yourself and telling us what you do with this community.
+//_____________________________________________________________________________________________________________________________________
+
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+
+namespace TP.FunctionalProgramming
+{
+  [TestClass]
+  public class StaticClassTest
+  {
+    [TestMethod]
+    public void StaticClassTestMethod()
+    {
+      // StaticClass staticClassVariable; //Cannot declare a variable of static type 'StaticClass'
+
+      //StaticClass staticVariable;
+      Assert.AreEqual(123456.789, StaticClass.MinIncome);
+      Assert.AreEqual(987654.321, StaticClass.MaxIncome);
+      StaticClass.StaticClassInitializer(3.0, 1.0);
+      Assert.AreEqual(1.0, StaticClass.MinIncome);
+      Assert.AreEqual(3.0, StaticClass.MaxIncome);
+      Assert.AreEqual(2.0, StaticClass.AverageIncome);
+    }
+  }
+}

ExDataManagement/FunctionalProgramming/FunctionalProgramming/AnonymousFunctions.cs

@@ -1,6 +1,6 @@
 //____________________________________________________________________________________________________________________________________
 //
-//  Copyright (C) 2023, Mariusz Postol LODZ POLAND.
+//  Copyright (C) 2024, Mariusz Postol LODZ POLAND.
 //
 //  To be in touch join the community by pressing the `Watch` button and get started commenting using the discussion panel at
 //
@@ -30,15 +30,6 @@ public interface IStateHandler
 
   public class AnonymousFunctions
   {
-    #region predicate
-
-    public static bool StringIsLongPredicate(string stringToTest)
-    {
-      return stringToTest.Length > 10;
-    }
-
-    #endregion predicate
-
     #region test instrumentation
 
     internal delegate void CallBackTestDelegate(bool testResult);

ExDataManagement/FunctionalProgramming/FunctionalProgramming/DelegateExample.cs

@@ -1,6 +1,6 @@
 //____________________________________________________________________________________________________________________________________
 //
-//  Copyright (C) 2023, Mariusz Postol LODZ POLAND.
+//  Copyright (C) 2024, Mariusz Postol LODZ POLAND.
 //
 //  To be in touch join the community by pressing the `Watch` button and get started commenting using the discussion panel at
 //
@@ -22,14 +22,17 @@ public class DelegateExample
     /// <param name="y">The y.</param>
     public delegate int PerformCalculation(int x, int y);
 
-    public event EventHandler PerformSumMethodCalled;
-
     /// <summary>
     /// The perform calculation variable
     /// </summary>
     /// <returns>System.Int32.</returns>
     public PerformCalculation PerformCalculationVar;
 
+    /// <summary>
+    /// An example of event
+    /// </summary>
+    public event EventHandler PerformSumMethodCalled;
+
     /// <summary>
     /// Initializes a new instance of the <see cref="DelegateExample"/> class.
     /// </summary>

ExDataManagement/FunctionalProgramming/FunctionalProgramming/ExtensionMethods.cs

@@ -1,6 +1,6 @@
 //____________________________________________________________________________________________________________________________________
 //
-//  Copyright (C) 2023, Mariusz Postol LODZ POLAND.
+//  Copyright (C) 2024, Mariusz Postol LODZ POLAND.
 //
 //  To be in touch join the community by pressing the `Watch` button and get started commenting using the discussion panel at
 //
@@ -13,6 +13,17 @@
 
 namespace TP.FunctionalProgramming
 {
+  /// <summary>
+  /// Define an example interface named IMyInterface.
+  /// </summary>
+  public interface IMyInterface
+  {
+    /// <summary>
+    /// Any class that implements IMyInterface must implement the method that matches the following signature.
+    /// </summary>
+    void MyInterfaceMethod();
+  }
+
   /// <summary>
   /// Class ExtensionMethods - defines a few extension methods.
   /// </summary>

ExDataManagement/FunctionalProgramming/FunctionalProgramming/FunctionalProgramming.cs

@@ -0,0 +1,29 @@
+
+//____________________________________________________________________________________________________________________________________
+//
+//  Copyright (C) 2024, Mariusz Postol LODZ POLAND.
+//
+//  To be in touch join the community by pressing the `Watch` button and get started commenting using the discussion panel at
+//
+//  https://github.com/mpostol/TP/discussions/182
+//
+//  by introducing yourself and telling us what you do with this community.
+//_____________________________________________________________________________________________________________________________________
+
+namespace TP.FunctionalProgramming
+{
+  public static class FunctionalProgramming
+  {
+
+    /// <summary>
+    /// An example of predicate - stateless processing of the input argument
+    /// </summary>
+    /// <param name="stringToTest">text to be the subject of testing</param>
+    /// <returns>testing result of comparison the <paramref name="stringToTest"/> and 10 and returning <true> if it is greater than 10</returns>
+    public static bool StringIsLongPredicate(string stringToTest)
+    {
+      return stringToTest.Length > 10;
+    }
+
+  }
+}

ExDataManagement/FunctionalProgramming/FunctionalProgramming/FunctionalProgramming.csproj

@@ -44,12 +44,16 @@
     <Compile Include="AnonymousFunctions.cs" />
     <Compile Include="DelegateExample.cs" />
     <Compile Include="ExtensionMethods.cs" />
+    <Compile Include="FunctionalProgramming.cs" />
     <Compile Include="GlobalSuppressions.cs" />
-    <Compile Include="IMyInterface.cs" />
     <Compile Include="Properties\AssemblyInfo.cs" />
+    <Compile Include="StaticClass.cs" />
   </ItemGroup>
   <ItemGroup>
+    <None Include="README.AnonymousFunctions.md" />
+    <None Include="README.ExtensionMethods.md" />
     <None Include="Readme.md" />
+    <None Include="READMEDelegateEvents.md" />
   </ItemGroup>
   <ItemGroup />
   <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />