[Python-checkins] gh-104876: Remove deprecated turtle.RawTurtle.settiltangle (#104877)
hugovk
webhook-mailer at python.org
Fri May 26 00:26:01 EDT 2023
https://github.com/python/cpython/commit/10c45838e1de47ef57708c71e3d9c2ddb78d493d
commit: 10c45838e1de47ef57708c71e3d9c2ddb78d493d
branch: main
author: Hugo van Kemenade <hugovk at users.noreply.github.com>
committer: hugovk <hugovk at users.noreply.github.com>
date: 2023-05-26T07:25:52+03:00
summary:
gh-104876: Remove deprecated turtle.RawTurtle.settiltangle (#104877)
Co-authored-by: Victor Stinner <vstinner at python.org>
files:
A Misc/NEWS.d/next/Library/2023-05-24-19-48-16.gh-issue-104876.Z00Qnk.rst
M Doc/library/turtle.rst
M Doc/whatsnew/3.11.rst
M Doc/whatsnew/3.13.rst
M Lib/turtle.py
M Misc/NEWS.d/3.11.0a3.rst
diff --git a/Doc/library/turtle.rst b/Doc/library/turtle.rst
index c656f6d9cfda..c9ce955a6d2b 100644
--- a/Doc/library/turtle.rst
+++ b/Doc/library/turtle.rst
@@ -166,7 +166,6 @@ Turtle state
| :func:`resizemode`
| :func:`shapesize` | :func:`turtlesize`
| :func:`shearfactor`
- | :func:`settiltangle`
| :func:`tiltangle`
| :func:`tilt`
| :func:`shapetransform`
@@ -1301,28 +1300,6 @@ Appearance
>>> turtle.fd(50)
-.. function:: settiltangle(angle)
-
- :param angle: a number
-
- Rotate the turtleshape to point in the direction specified by *angle*,
- regardless of its current tilt-angle. *Do not* change the turtle's heading
- (direction of movement).
-
- .. doctest::
- :skipif: _tkinter is None or 'always; deprecated method'
-
- >>> turtle.reset()
- >>> turtle.shape("circle")
- >>> turtle.shapesize(5,2)
- >>> turtle.settiltangle(45)
- >>> turtle.fd(50)
- >>> turtle.settiltangle(-45)
- >>> turtle.fd(50)
-
- .. deprecated:: 3.1
-
-
.. function:: tiltangle(angle=None)
:param angle: a number (optional)
@@ -2529,8 +2506,7 @@ Changes since Python 3.0
:func:`get_shapepoly` have been added. Thus the full range of
regular linear transforms is now available for transforming turtle shapes.
:func:`tiltangle` has been enhanced in functionality: it now can
- be used to get or set the tilt angle. :func:`settiltangle` has been
- deprecated.
+ be used to get or set the tilt angle.
- The :class:`Screen` method :func:`onkeypress` has been added as a complement to
:func:`onkey`. As the latter binds actions to the key release event,
diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst
index ccdf3fc34682..7186ba5521f9 100644
--- a/Doc/whatsnew/3.11.rst
+++ b/Doc/whatsnew/3.11.rst
@@ -1817,7 +1817,7 @@ Standard Library
They will be removed in Python 3.13.
(Contributed by Serhiy Storchaka and Miro Hrončok in :gh:`92728`.)
-* :func:`turtle.settiltangle` has been deprecated since Python 3.1;
+* :func:`!turtle.settiltangle` has been deprecated since Python 3.1;
it now emits a deprecation warning and will be removed in Python 3.13. Use
:func:`turtle.tiltangle` instead (it was earlier incorrectly marked
as deprecated, and its docstring is now corrected).
diff --git a/Doc/whatsnew/3.13.rst b/Doc/whatsnew/3.13.rst
index caf09668e824..29ad0febb8b4 100644
--- a/Doc/whatsnew/3.13.rst
+++ b/Doc/whatsnew/3.13.rst
@@ -118,6 +118,11 @@ Removed
* Remove support for using :class:`pathlib.Path` objects as context managers.
This functionality was deprecated and made a no-op in Python 3.9.
+* Remove the :meth:`!turtle.RawTurtle.settiltangle` method,
+ deprecated in docs since Python 3.1
+ and with a deprecation warning since Python 3.11.
+ (Contributed by Hugo van Kemenade in :gh:`104876`.)
+
* Removed the following :mod:`unittest` functions, deprecated in Python 3.11:
* :func:`!unittest.findTestCases`
@@ -130,8 +135,6 @@ Removed
* :meth:`unittest.TestLoader.loadTestsFromTestCase`
* :meth:`unittest.TestLoader.getTestCaseNames`
- (Contributed by Hugo van Kemenade in :gh:`104835`.)
-
* :pep:`594`: Remove the :mod:`!cgi`` and :mod:`!cgitb` modules,
deprecated in Python 3.11.
diff --git a/Lib/turtle.py b/Lib/turtle.py
index cf111158b7c1..54f0efa4c062 100644
--- a/Lib/turtle.py
+++ b/Lib/turtle.py
@@ -127,7 +127,7 @@
'isvisible', 'left', 'lt', 'onclick', 'ondrag', 'onrelease', 'pd',
'pen', 'pencolor', 'pendown', 'pensize', 'penup', 'pos', 'position',
'pu', 'radians', 'right', 'reset', 'resizemode', 'rt',
- 'seth', 'setheading', 'setpos', 'setposition', 'settiltangle',
+ 'seth', 'setheading', 'setpos', 'setposition',
'setundobuffer', 'setx', 'sety', 'shape', 'shapesize', 'shapetransform', 'shearfactor', 'showturtle',
'speed', 'st', 'stamp', 'teleport', 'tilt', 'tiltangle', 'towards',
'turtlesize', 'undo', 'undobufferentries', 'up', 'width',
@@ -2896,33 +2896,6 @@ def shearfactor(self, shear=None):
return self._shearfactor
self.pen(resizemode="user", shearfactor=shear)
- def settiltangle(self, angle):
- """Rotate the turtleshape to point in the specified direction
-
- Argument: angle -- number
-
- Rotate the turtleshape to point in the direction specified by angle,
- regardless of its current tilt-angle. DO NOT change the turtle's
- heading (direction of movement).
-
- Deprecated since Python 3.1
-
- Examples (for a Turtle instance named turtle):
- >>> turtle.shape("circle")
- >>> turtle.shapesize(5,2)
- >>> turtle.settiltangle(45)
- >>> turtle.stamp()
- >>> turtle.fd(50)
- >>> turtle.settiltangle(-45)
- >>> turtle.stamp()
- >>> turtle.fd(50)
- """
- warnings._deprecated("turtle.RawTurtle.settiltangle()",
- "{name!r} is deprecated since Python 3.1 and scheduled "
- "for removal in Python {remove}. Use tiltangle() instead.",
- remove=(3, 13))
- self.tiltangle(angle)
-
def tiltangle(self, angle=None):
"""Set or return the current tilt-angle.
@@ -2935,9 +2908,6 @@ def tiltangle(self, angle=None):
between the orientation of the turtleshape and the heading of the
turtle (its direction of movement).
- (Incorrectly marked as deprecated since Python 3.1, it is really
- settiltangle that is deprecated.)
-
Examples (for a Turtle instance named turtle):
>>> turtle.shape("circle")
>>> turtle.shapesize(5, 2)
diff --git a/Misc/NEWS.d/3.11.0a3.rst b/Misc/NEWS.d/3.11.0a3.rst
index 426531904993..7fdc191c2448 100644
--- a/Misc/NEWS.d/3.11.0a3.rst
+++ b/Misc/NEWS.d/3.11.0a3.rst
@@ -440,7 +440,7 @@ Added missing kw_only parameter to dataclasses.make_dataclass().
.. nonce: aGyr1I
.. section: Library
-The :meth:`turtle.RawTurtle.settiltangle` is deprecated since Python 3.1, it
+The :meth:`!turtle.RawTurtle.settiltangle` is deprecated since Python 3.1, it
now emits a deprecation warning and will be removed in Python 3.13.
Use :meth:`turtle.RawTurtle.tiltangle` instead.
diff --git a/Misc/NEWS.d/next/Library/2023-05-24-19-48-16.gh-issue-104876.Z00Qnk.rst b/Misc/NEWS.d/next/Library/2023-05-24-19-48-16.gh-issue-104876.Z00Qnk.rst
new file mode 100644
index 000000000000..ce1f56064150
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2023-05-24-19-48-16.gh-issue-104876.Z00Qnk.rst
@@ -0,0 +1,3 @@
+Remove the :meth:`!turtle.RawTurtle.settiltangle` method, deprecated in docs
+since Python 3.1 and with a deprecation warning since Python 3.11. Patch by
+Hugo van Kemenade.
More information about the Python-checkins
mailing list