Inline Pass-throughs for Central Event Dispatcher

I've added Inline Pass-Through methods/properties for the Central Event Dispatcher, eliminating the need to do `EventCentral.shared.<method>` you can now just do `EventCentral.<method>` instead.

Author: LK-Simon

Sources/EventDrivenSwift/Central/EventCentral.swift

@@ -9,20 +9,63 @@
 import Foundation
 
 /**
-Singleton for the Central Event Handler.
+Singleton for the Central Event Dispatcher.
  - Author: Simon J. Stuart
  - Version: 1.0.0
  - Note: This is a Singleton!
  - Note: This is used when invoking the `queue` and `stack` methods of `Eventable`.
  */
-final public class EventCentral: EventDispatcher {
-    private static var _shared: EventDispatcher = EventCentral()
+final public class EventCentral: EventDispatcher, EventCentralable {
+    /**
+     Singleton Instance of our Central Event Dispatcher
+     - Author: Simon J. Stuart
+     - Version: 1.0.0
+     */
+    private static var _shared: EventDispatchable = EventCentral()
 
+    /**
+     Returns the Central Event Dispatcher
+     - Author: Simon J. Stuart
+     - Version: 1.0.0
+     */
     public static var shared: EventDispatchable {
         get {
             return _shared
         }
     }
 
+    public static subscript() -> EventDispatchable {
+        get {
+            return _shared
+        }
+    }
+    
+    /// This just makes it so that your code cannot initialise instances of `EventCentral`. It's a Singleton!
     override private init() {}
+    
+    @inline(__always) public static func addListener(_ listener: EventReceivable, forEventType: Eventable.Type) {
+        _shared.addListener(listener, forEventType: forEventType)
+    }
+    
+    @inline(__always) public static func removeListener(_ listener: EventReceivable, forEventType: Eventable.Type) {
+        _shared.removeListener(listener, forEventType: forEventType)
+    }
+    
+    @inline(__always) public static func removeListener(_ listener: EventReceivable) {
+        _shared.removeListener(listener)
+    }
+    
+    @inline(__always) public static func queueEvent(_ event: Eventable, priority: EventPriority) {
+        _shared.queueEvent(event, priority: priority)
+    }
+    
+    @inline(__always) public static func stackEvent(_ event: Eventable, priority: EventPriority) {
+        _shared.stackEvent(event, priority: priority)
+    }
+    
+    @inline(__always) public static var eventCount: Int {
+        get {
+            return _shared.eventCount
+        }
+    }
 }

Sources/EventDrivenSwift/Central/EventCentralable.swift

@@ -0,0 +1,60 @@
+//
+// EventCentralable.swift
+// Copyright (c) 2022, Flowduino
+// Authored by Simon J. Stuart on 4th August 2022
+//
+// Subject to terms, restrictions, and liability waiver of the MIT License
+//
+
+import Foundation
+
+public protocol EventCentralable {
+    /**
+     Registers the given `listener` for the given `Eventable` Type with the Central Event Dispatcher
+     - Author: Simon J. Stuart
+     - Version: 1.0.0
+     */
+    static func addListener(_ listener: any EventReceivable, forEventType: Eventable.Type)
+    
+    /**
+     Unregisters the given `listener` from the given `Eventable` Type for the Central Event Dispatcher
+     - Author: Simon J. Stuart
+     - Version: 1.0.0
+     */
+    static func removeListener(_ listener: any EventReceivable, forEventType: Eventable.Type)
+    
+    /**
+     Unregisters the given `listener` from all `Eventable` Types from the Central Event Dispatcher
+     - Author: Simon J. Stuart
+     - Version: 1.0.0
+     */
+    static func removeListener(_ listener: any EventReceivable)
+    
+    /**
+     Adds the given `event` to the Central Event Queue with the given `priority`
+     - Author: Simon J. Stuart
+     - Version: 1.0.0
+     - Parameters:
+        - event: The Event
+        - priority: The Priority of the Event
+     */
+    static func queueEvent(_ event: any Eventable, priority: EventPriority)
+    
+    /**
+     Adds the given `event` to the Central Event Stack with the given `priority`
+     - Author: Simon J. Stuart
+     - Version: 1.0.0
+     - Parameters:
+        - event: The Event
+        - priority: The Priority of the Event
+     */
+    static func stackEvent(_ event: any Eventable, priority: EventPriority)
+    
+    /**
+     The number of Events currently pending in the Queue and Stack (combined) of the Central Event Dispatcher
+     - Author: Simon J. Stuart
+     - Version: 1.0.0
+     - Returns: The number of Events currently pending in the Queue and Stack combined
+     */
+    static var eventCount: Int { get }
+}

Tests/EventDrivenSwiftTests/BasicEventReceiverTests.swift

@@ -52,7 +52,6 @@ final class BasicEventReceiverTests: XCTestCase {
         let eventThread = TestEventThread() // Create the Thread
 
         XCTAssertEqual(eventThread.foo, 0, "Expect initial value of eventThread.foo to be 0, but it's \(eventThread.foo)")
-        
         EventCentral.shared.queueEvent(testOne, priority: .normal) // Now let's dispatch our Event to change this value
 
         let result = eventThread.awaiter.wait(timeout: DispatchTime.now().advanced(by: DispatchTimeInterval.seconds(10)))