Merge pull request #7 from brminnick/Release-1.1.0

Release 1.1.0

Author: TheCodeTraveler

README.md

@@ -8,6 +8,7 @@ Extensions for `System.Threading.Tasks.Task`, inspired by [John Thiriet](https:/
 - AsyncAwaitBestPractices
   - An extension method to safely fire-and-forget a `Task`:
     - `SafeFireAndForget`
+    - `WeakEventManager`
   - [Usage instructions below](#asyncawaitbestpractices)
 - AsyncAwaitBestPractices.MVVM
   - Allows for `Task` to safely be used asynchronously with `ICommand`:
@@ -60,6 +61,21 @@ async Task ExampleAsyncMethod()
 }
 ```
 
+An event implementation that enables the [garbage collector to collect an object without needing to unsubscribe event handlers](http://paulstovell.com/blog/weakevents):
+- `WeakEventManager`
+
+```csharp
+readonly WeakEventManager _weakEventManager = new WeakEventManager();
+
+public event EventHandler CanExecuteChanged
+{
+    add => _weakEventManager.AddEventHandler(value);
+    remove => _weakEventManager.RemoveEventHandler(value);
+}
+
+public void RaiseCanExecuteChanged() => _weakEventManager.HandleEvent(this, EventArgs.Empty, nameof(CanExecuteChanged));
+```
+
 ### AsyncAwaitBestPractices.MVVM
 
 Allows for `Task` to safely be used asynchronously with `ICommand`:

Src/AsyncAwaitBestPractices.MVVM.nuspec

@@ -2,7 +2,7 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd">
   <metadata minClientVersion="2.5">
     <id>AsyncAwaitBestPractices.MVVM</id>
-    <version>1.0.1</version>
+    <version>1.1.0</version>
     <title>Task Extensions for MVVM</title>
     <authors>Brandon Minnick, John Thiriet</authors>
     <owners>Brandon Minnick</owners>
@@ -14,12 +14,12 @@
     <summary>Includes AsyncCommand and IAsyncCommand which allows ICommand to safely be used asynchronously with Task.</summary>
     <tags>task,fire and forget, threading, extensions, system.threading.tasks,async,await</tags>
     <dependencies>
-      <dependency id="AsyncAwaitBestPractices" version="1.0.1" />
+      <dependency id="AsyncAwaitBestPractices" version="1.1.0" />
     </dependencies>
     <releaseNotes>
       New In This Release:
-        - AsyncAwaitBestPractices.MVVM.AsyncCommand
-        - AsyncAwaitBestPractices.MVVM.IAsyncCommand
+        - Improved memory management
+        - Implemented WeakEventManager for AsyncCommand.CanExecuteChanged
     </releaseNotes>
     <copyright>Copyright (c) 2018 Brandon Minnick</copyright>
    </metadata>

Src/AsyncAwaitBestPractices.MVVM/AsyncCommand.cs

@@ -43,8 +43,8 @@ public AsyncCommand(Func<T, Task> execute,
         /// </summary>
         public event EventHandler CanExecuteChanged
         {
-            add { _weakEventManager.AddEventHandler(nameof(CanExecuteChanged), value); }
-            remove { _weakEventManager.RemoveEventHandler(nameof(CanExecuteChanged), value); }
+            add => _weakEventManager.AddEventHandler(value);
+            remove => _weakEventManager.RemoveEventHandler(value);
         }
         #endregion
 
@@ -135,8 +135,8 @@ public AsyncCommand(Func<Task> execute,
         /// </summary>
         public event EventHandler CanExecuteChanged
         {
-            add { _weakEventManager.AddEventHandler(nameof(CanExecuteChanged), value); }
-            remove { _weakEventManager.RemoveEventHandler(nameof(CanExecuteChanged), value); }
+            add => _weakEventManager.AddEventHandler(value);
+            remove => _weakEventManager.RemoveEventHandler(value);
         }
         #endregion
 

Src/AsyncAwaitBestPractices.nuspec

@@ -2,7 +2,7 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd">
   <metadata minClientVersion="2.5">
     <id>AsyncAwaitBestPractices</id>
-    <version>1.0.1</version>
+    <version>1.1.0</version>
     <title>Task Extensions for System.Threading.Tasks</title>
     <authors>Brandon Minnick, John Thiriet</authors>
     <owners>Brandon Minnick</owners>
@@ -19,8 +19,7 @@
     <tags>task,fire and forget, threading, extensions, system.threading.tasks,async,await</tags>
     <releaseNotes>
       New In This Release:
-        - Improved memory management
-        - Implemented WeakEventManager
+        - Added WeakEventManager
     </releaseNotes>
     <copyright>Copyright (c) 2018 Brandon Minnick</copyright>
    </metadata>

Src/AsyncAwaitBestPractices/WeakEventManager.cs

@@ -3,6 +3,7 @@
 using System.Reflection;
 
 using static System.String;
+using System.Runtime.CompilerServices;
 
 namespace AsyncAwaitBestPractices
 {
@@ -17,10 +18,10 @@ public class WeakEventManager
         /// <summary>
         /// Adds the event handler
         /// </summary>
-        /// <param name="eventName">Event name</param>
         /// <param name="handler">Handler</param>
+        /// <param name="eventName">Event name</param>
         /// <typeparam name="TEventArgs">EventHandler type</typeparam>
-        public void AddEventHandler<TEventArgs>(string eventName, EventHandler<TEventArgs> handler)
+        public void AddEventHandler<TEventArgs>(EventHandler<TEventArgs> handler, [CallerMemberName] string eventName = "")
             where TEventArgs : EventArgs
         {
             if (IsNullOrWhiteSpace(eventName))
@@ -35,9 +36,9 @@ public void AddEventHandler<TEventArgs>(string eventName, EventHandler<TEventArg
         /// <summary>
         /// Adds the event handler
         /// </summary>
-        /// <param name="eventName">Event name</param>
         /// <param name="handler">Handler</param>
-        public void AddEventHandler(string eventName, EventHandler handler)
+        /// <param name="eventName">Event name</param>
+        public void AddEventHandler(EventHandler handler, [CallerMemberName] string eventName = "")
         {
             if (IsNullOrWhiteSpace(eventName))
                 throw new ArgumentNullException(nameof(eventName));
@@ -96,10 +97,10 @@ public void HandleEvent(object sender, object args, string eventName)
         /// <summary>
         /// Removes the event handler
         /// </summary>
-        /// <param name="eventName">Event name</param>
         /// <param name="handler">Handler</param>
+        /// <param name="eventName">Event name</param>
         /// <typeparam name="TEventArgs">EventHandler type</typeparam>
-        public void RemoveEventHandler<TEventArgs>(string eventName, EventHandler<TEventArgs> handler)
+        public void RemoveEventHandler<TEventArgs>(EventHandler<TEventArgs> handler, [CallerMemberName] string eventName = "")
             where TEventArgs : EventArgs
         {
             if (IsNullOrEmpty(eventName))
@@ -114,9 +115,9 @@ public void RemoveEventHandler<TEventArgs>(string eventName, EventHandler<TEvent
         /// <summary>
         /// Removes the event handler.
         /// </summary>
-        /// <param name="eventName">Event name</param>
         /// <param name="handler">Handler</param>
-        public void RemoveEventHandler(string eventName, EventHandler handler)
+        /// <param name="eventName">Event name</param>
+        public void RemoveEventHandler(EventHandler handler, [CallerMemberName] string eventName = "")
         {
             if (IsNullOrEmpty(eventName))
                 throw new ArgumentNullException(nameof(eventName));