generated from atomicgo/template
-
-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1 from atomicgo/testing
- Loading branch information
Showing
4 changed files
with
302 additions
and
148 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,24 +1,64 @@ | ||
/* | ||
Package keyboard can be used to read key presses from the keyboard, while in a terminal application. It's crossplatform and keypresses can be combined to check for ctrl+c, alt+4, ctrl-shift, alt+ctrl+right, etc. | ||
It can also be used to simulate (mock) keypresses for CI testing. | ||
Works nicely with https://atomicgo.dev/cursor | ||
```go | ||
## Simple Usage | ||
keyboard.Listen(func(key keys.Key) (stop bool, err error) { | ||
if key.Code == keys.CtrlC { | ||
return true, nil // Stop listener by returning true on Ctrl+C | ||
} | ||
fmt.Println("\r" + key.String()) // Print every key press | ||
return false, nil // Return false to continue listening | ||
}) | ||
keyboard.StartListener() | ||
defer keyboard.StopListener() | ||
for { | ||
keyInfo, _ := keyboard.GetKey() | ||
key := keyInfo.Code | ||
## Advanced Usage | ||
if key == keys.CtrlC { | ||
break | ||
// Stop keyboard listener on Escape key press or CTRL+C. | ||
// Exit application on "q" key press. | ||
// Print every rune key press. | ||
// Print every other key press. | ||
keyboard.Listen(func(key keys.Key) (stop bool, err error) { | ||
switch key.Code { | ||
case keys.CtrlC, keys.Escape: | ||
return true, nil // Return true to stop listener | ||
case keys.RuneKey: // Check if key is a rune key (a, b, c, 1, 2, 3, ...) | ||
if key.String() == "q" { // Check if key is "q" | ||
fmt.Println("\rQuitting application") | ||
os.Exit(0) // Exit application | ||
} | ||
fmt.Printf("\rYou pressed the rune key: %s\n", key) | ||
default: | ||
fmt.Printf("\rYou pressed: %s\n", key) | ||
} | ||
fmt.Println("\r", keyInfo.String()) | ||
} | ||
return false, nil // Return false to continue listening | ||
}) | ||
## Simulate Key Presses (for mocking in tests) | ||
go func() { | ||
keyboard.SimulateKeyPress("Hello") // Simulate key press for every letter in string | ||
keyboard.SimulateKeyPress(keys.Enter) // Simulate key press for Enter | ||
keyboard.SimulateKeyPress(keys.CtrlShiftRight) // Simulate key press for Ctrl+Shift+Right | ||
keyboard.SimulateKeyPress('x') // Simulate key press for a single rune | ||
keyboard.SimulateKeyPress('x', keys.Down, 'a') // Simulate key presses for multiple inputs | ||
keyboard.SimulateKeyPress(keys.Escape) // Simulate key press for Escape, which quits the program | ||
}() | ||
keyboard.Listen(func(key keys.Key) (stop bool, err error) { | ||
if key.Code == keys.Escape || key.Code == keys.CtrlC { | ||
os.Exit(0) // Exit program on Escape | ||
} | ||
``` | ||
fmt.Println("\r" + key.String()) // Print every key press | ||
return false, nil // Return false to continue listening | ||
}) | ||
*/ | ||
package keyboard |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,63 @@ | ||
package keyboard | ||
|
||
import ( | ||
"fmt" | ||
"os" | ||
|
||
"atomicgo.dev/keyboard/keys" | ||
) | ||
|
||
func ExampleSimple() { | ||
Listen(func(key keys.Key) (stop bool, err error) { | ||
if key.Code == keys.CtrlC { | ||
return true, nil // Stop listener by returning true on Ctrl+C | ||
} | ||
|
||
fmt.Println("\r" + key.String()) // Print every key press | ||
return false, nil // Return false to continue listening | ||
}) | ||
} | ||
|
||
func ExampleAdvanced() { | ||
// Stop keyboard listener on Escape key press or CTRL+C. | ||
// Exit application on "q" key press. | ||
// Print every rune key press. | ||
// Print every other key press. | ||
Listen(func(key keys.Key) (stop bool, err error) { | ||
switch key.Code { | ||
case keys.CtrlC, keys.Escape: | ||
return true, nil // Return true to stop listener | ||
case keys.RuneKey: // Check if key is a rune key (a, b, c, 1, 2, 3, ...) | ||
if key.String() == "q" { // Check if key is "q" | ||
fmt.Println("\rQuitting application") | ||
os.Exit(0) // Exit application | ||
} | ||
fmt.Printf("\rYou pressed the rune key: %s\n", key) | ||
default: | ||
fmt.Printf("\rYou pressed: %s\n", key) | ||
} | ||
|
||
return false, nil // Return false to continue listening | ||
}) | ||
} | ||
|
||
func ExampleMocking() { | ||
go func() { | ||
SimulateKeyPress("Hello") // Simulate key press for every letter in string | ||
SimulateKeyPress(keys.Enter) // Simulate key press for Enter | ||
SimulateKeyPress(keys.CtrlShiftRight) // Simulate key press for Ctrl+Shift+Right | ||
SimulateKeyPress('x') // Simulate key press for a single rune | ||
SimulateKeyPress('x', keys.Down, 'a') // Simulate key presses for multiple inputs | ||
|
||
SimulateKeyPress(keys.Escape) // Simulate key press for Escape, which quits the program | ||
}() | ||
|
||
Listen(func(key keys.Key) (stop bool, err error) { | ||
if key.Code == keys.Escape || key.Code == keys.CtrlC { | ||
os.Exit(0) // Exit program on Escape | ||
} | ||
|
||
fmt.Println("\r" + key.String()) // Print every key press | ||
return false, nil // Return false to continue listening | ||
}) | ||
} |
Oops, something went wrong.