keybinds 1.3.0__tar.gz → 1.3.2__tar.gz

{keybinds-1.3.0 → keybinds-1.3.2}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: keybinds
-Version: 1.3.0
-Summary: Flexible and high-performance global keyboard & mouse hotkeys for Windows
+Version: 1.3.2
+Summary: Flexible global keyboard & mouse hotkeys for Windows
 Author: echolane
 License: MIT License
         
@@ -43,11 +43,14 @@ Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: typing_extensions>=4.0; python_version < "3.8"
+Provides-Extra: test
+Requires-Dist: pytest<8,>=7.4; python_version < "3.8" and extra == "test"
+Requires-Dist: pytest<9,>=8; python_version >= "3.8" and extra == "test"
 Dynamic: license-file
 
 # keybinds
 
-Flexible and high-performance global keyboard & mouse hotkeys for Windows.
+Flexible global keyboard & mouse hotkeys for Windows.
 
 ![Python](https://img.shields.io/badge/python-3.7%2B-blue)
 ![Platform](https://img.shields.io/badge/platform-windows-lightgrey)
@@ -189,6 +192,23 @@ Top-level helpers use the default hook. If you use multiple hooks, prefer `hook.
 
 ---
 
+## Bind state and waiting
+
+All bind objects expose two small runtime helpers:
+
+```python
+if bind.is_pressed():
+    print("bind is currently active")
+
+bind.wait()          # wait until the bind fires
+bind.wait(0.5)       # wait up to 0.5s, returns True/False
+```
+
+`is_pressed()` checks whether the bind is currently pressed.
+`wait(timeout=None)` blocks until the bind fires and returns `True`, or returns `False` on timeout.
+
+---
+
 ## Keyboard Basics
 
 ### Press (default)
@@ -453,16 +473,6 @@ Supports common patterns with simple flags:
 
 Logical binds, typed-text matching, and abbreviations are currently **experimental**. The API and behavior may still change in future releases.
 
-## Performance
-
-Measured using `examples/benchmark.py` on one test system and Python build. These numbers are intended as a rough reference, not a universal baseline.
-
-- p50 ≈ 0.3 ms
-- p99 ≈ 0.5 ms
-- max < 1 ms (rare spikes up to 3–5 ms)
-
-Latency includes hook dispatch and callback scheduling (no heavy user code).
-
 ## Suppression limitations
 
 On Windows, suppression depends on low-level hook order. See [Advanced Usage — Hook chain limitations and `reinstall_hooks()`](Advanced%20Usage.md#41-hook-chain-limitations-and-reinstall_hooks).

{keybinds-1.3.0 → keybinds-1.3.2}/README.md

@@ -1,6 +1,6 @@
 # keybinds
 
-Flexible and high-performance global keyboard & mouse hotkeys for Windows.
+Flexible global keyboard & mouse hotkeys for Windows.
 
 ![Python](https://img.shields.io/badge/python-3.7%2B-blue)
 ![Platform](https://img.shields.io/badge/platform-windows-lightgrey)
@@ -142,6 +142,23 @@ Top-level helpers use the default hook. If you use multiple hooks, prefer `hook.
 
 ---
 
+## Bind state and waiting
+
+All bind objects expose two small runtime helpers:
+
+```python
+if bind.is_pressed():
+    print("bind is currently active")
+
+bind.wait()          # wait until the bind fires
+bind.wait(0.5)       # wait up to 0.5s, returns True/False
+```
+
+`is_pressed()` checks whether the bind is currently pressed.
+`wait(timeout=None)` blocks until the bind fires and returns `True`, or returns `False` on timeout.
+
+---
+
 ## Keyboard Basics
 
 ### Press (default)
@@ -406,16 +423,6 @@ Supports common patterns with simple flags:
 
 Logical binds, typed-text matching, and abbreviations are currently **experimental**. The API and behavior may still change in future releases.
 
-## Performance
-
-Measured using `examples/benchmark.py` on one test system and Python build. These numbers are intended as a rough reference, not a universal baseline.
-
-- p50 ≈ 0.3 ms
-- p99 ≈ 0.5 ms
-- max < 1 ms (rare spikes up to 3–5 ms)
-
-Latency includes hook dispatch and callback scheduling (no heavy user code).
-
 ## Suppression limitations
 
 On Windows, suppression depends on low-level hook order. See [Advanced Usage — Hook chain limitations and `reinstall_hooks()`](Advanced%20Usage.md#41-hook-chain-limitations-and-reinstall_hooks).

{keybinds-1.3.0 → keybinds-1.3.2}/keybinds/__init__.py

@@ -36,7 +36,7 @@ from ._backend import reinstall_hooks, rehook
 
 from ._constants import register_key_token
 
-__version__ = "1.3.0"
+__version__ = "1.3.2"
 
 __all__ = [
     "Trigger","SuppressPolicy","ChordPolicy","OrderPolicy","FocusPolicy","InjectedPolicy","TextBoundaryPolicy","TextBackspacePolicy","OsKeyRepeatPolicy","ReplacementPolicy",