fix: add esc alias for escape key

Fixes #93

Author: socsieng

Sources/SendKeysLib/Commands/KeyPressCommand.swift

@@ -30,7 +30,7 @@ public class KeyPressCommand: Command, RequiresKeyPresser {
     }
 
     public override func execute() throws {
-        try! keyPresser!.keyPress(key: key!, modifiers: modifiers)
+        let _ = try! keyPresser!.keyPress(key: key!, modifiers: modifiers)
     }
 
     public override func equals(_ comparison: Command) -> Bool {

Sources/SendKeysLib/KeyCodes.swift

@@ -153,6 +153,7 @@ struct KeyCodes {
         "space": KeyCodeWithFlags(space),
         "delete": KeyCodeWithFlags(delete),
         "escape": KeyCodeWithFlags(escape),
+        "esc": KeyCodeWithFlags(escape),
         "⌘": KeyCodeWithFlags(command),
         "cmd": KeyCodeWithFlags(command),
         "command": KeyCodeWithFlags(command),

Sources/SendKeysLib/KeyPresser.swift

@@ -9,10 +9,12 @@ public class KeyPresser {
         self.application = app
     }
 
-    func keyPress(key: String, modifiers: [String]) throws {
+    func keyPress(key: String, modifiers: [String]) throws -> CGEvent? {
         if let keyDownEvent = try! keyDown(key: key, modifiers: modifiers) {
-            let _ = keyUp(key: key, modifiers: modifiers, event: keyDownEvent)
+            return keyUp(key: key, modifiers: modifiers, event: keyDownEvent)
         }
+
+        return nil
     }
 
     func keyDown(key: String, modifiers: [String]) throws -> CGEvent? {

Tests/SendKeysTests/KeyPresserTests.swift

@@ -0,0 +1,42 @@
+import XCTest
+
+@testable import SendKeysLib
+
+final class KeyPresserTests: XCTestCase {
+    func testEscapeKey() throws {
+        let presser = KeyPresser(app: nil)
+        let event = try! presser.keyPress(key: "escape", modifiers: [])
+
+        XCTAssertEqual(event!.getIntegerValueField(.keyboardEventKeycode), 53)
+    }
+
+    func testEscapeKeyUsingAlias() throws {
+        let presser = KeyPresser(app: nil)
+        let event = try! presser.keyPress(key: "esc", modifiers: [])
+
+        XCTAssertEqual(event!.getIntegerValueField(.keyboardEventKeycode), 53)
+    }
+
+    func testEnterKey() throws {
+        let presser = KeyPresser(app: nil)
+        let event = try! presser.keyPress(key: "return", modifiers: [])
+
+        XCTAssertEqual(event!.getIntegerValueField(.keyboardEventKeycode), 36)
+    }
+
+    func testShiftModifier() throws {
+        let presser = KeyPresser(app: nil)
+        let event = try! presser.keyPress(key: "a", modifiers: ["shift"])
+
+        XCTAssertEqual(event!.getIntegerValueField(.keyboardEventKeycode), 0)
+        XCTAssertTrue(event!.flags.contains([.maskShift]))
+    }
+
+    func testCommandControlModifier() throws {
+        let presser = KeyPresser(app: nil)
+        let event = try! presser.keyPress(key: "c", modifiers: ["command", "control"])
+
+        XCTAssertEqual(event!.getIntegerValueField(.keyboardEventKeycode), 8)
+        XCTAssertTrue(event!.flags.contains([.maskCommand, .maskControl]))
+    }
+}