Skip to content

[py] Update docstring and comments in keys.py #16187

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Aug 15, 2025
Merged

[py] Update docstring and comments in keys.py #16187

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
2c04636
Update keys.py
Aidoni0797 Aug 15, 2025
699326b
Refine docstring and clarify NUMPAD comment as per review feedback
Aidoni0797 Aug 15, 2025
9e8eb0a
Minor formatting
cgoldberg Aug 15, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 11 additions & 3 deletions py/selenium/webdriver/common/keys.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,16 @@
# KIND, either express or implied. See the License for the
# specific language governing permissions and limitations
# under the License.

"""The Keys implementation."""


class Keys:
"""Set of special keys codes."""
"""Set of special key codes for input actions.

Primarily intended for keyboard usage, but also applied in other contexts
such as Action Chains and IME interactions.
"""

NULL = "\ue000"
CANCEL = "\ue001" # ^break
Expand Down Expand Up @@ -58,7 +63,8 @@ class Keys:
SEMICOLON = "\ue018"
EQUALS = "\ue019"

NUMPAD0 = "\ue01a" # number pad keys
# Keys representing number pad digits
NUMPAD0 = "\ue01a"
NUMPAD1 = "\ue01b"
NUMPAD2 = "\ue01c"
NUMPAD3 = "\ue01d"
Expand All @@ -68,14 +74,16 @@ class Keys:
NUMPAD7 = "\ue021"
NUMPAD8 = "\ue022"
NUMPAD9 = "\ue023"

MULTIPLY = "\ue024"
ADD = "\ue025"
SEPARATOR = "\ue026"
SUBTRACT = "\ue027"
DECIMAL = "\ue028"
DIVIDE = "\ue029"

F1 = "\ue031" # function keys
# Function keys
F1 = "\ue031"
F2 = "\ue032"
F3 = "\ue033"
F4 = "\ue034"
Expand Down