From 309dd2b25fd57a30689f091365e0f6da0914fc6b Mon Sep 17 00:00:00 2001 From: Alexey Semenyuk Date: Sat, 19 Jul 2025 21:59:50 +0500 Subject: [PATCH] gh-136722: TurtleGraphicsError documentation --- Doc/library/turtle.rst | 76 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 76 insertions(+) diff --git a/Doc/library/turtle.rst b/Doc/library/turtle.rst index fea6b57edf0f1f..fe060e055e368e 100644 --- a/Doc/library/turtle.rst +++ b/Doc/library/turtle.rst @@ -2523,6 +2523,82 @@ Public classes * ``a.rotate(angle)`` rotation +Exceptions +---------- + + +.. exception:: TurtleGraphicsError + + Exception raised when a turtle graphics operation fails. + + This exception is raised in various error conditions, such as: + + * Invalid color specifications (e.g., color values out of range) + * Invalid shape types or names + * Invalid turtle graphics modes + * Invalid canvas arguments + * Other turtle graphics configuration errors + + Examples: + + **Invalid color specifications:** + + .. doctest:: + :skipif: _tkinter is None + + >>> screen.colormode(1.0) + >>> turtle.pencolor(240, 160, 80) + Traceback (most recent call last): + ... + TurtleGraphicsError: bad color sequence: (240, 160, 80) + + >>> turtle.pencolor("invalid_color_name") + Traceback (most recent call last): + ... + TurtleGraphicsError: bad color string: invalid_color_name + + **Invalid shape types:** + + .. doctest:: + :skipif: _tkinter is None + + >>> from turtle import Shape + >>> s = Shape("invalid_type", None) + Traceback (most recent call last): + ... + TurtleGraphicsError: There is no shape type invalid_type + + **Invalid turtle graphics modes:** + + .. doctest:: + :skipif: _tkinter is None + + >>> screen.mode("invalid_mode") + Traceback (most recent call last): + ... + TurtleGraphicsError: No turtle-graphics-mode invalid_mode + + **Invalid shape names:** + + .. doctest:: + :skipif: _tkinter is None + + >>> turtle.shape("nonexistent_shape") + Traceback (most recent call last): + ... + TurtleGraphicsError: There is no shape named nonexistent_shape + + **Invalid shape parameters:** + + .. doctest:: + :skipif: _tkinter is None + + >>> turtle.shapesize(stretch_wid=0, stretch_len=1) + Traceback (most recent call last): + ... + TurtleGraphicsError: stretch_wid/stretch_len must not be zero + + .. _turtle-explanation: Explanation pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.

Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy