Pending Removal in Future Versions¶
The following APIs will be removed in the future, although there is currently no date scheduled for their removal.
- argparse: Nesting argument groups and nesting mutually exclusive groups are deprecated.
- 
- bool(NotImplemented).
- Generators: - throw(type, exc, tb)and- athrow(type, exc, tb)signature is deprecated: use- throw(exc)and- athrow(exc)instead, the single argument signature.
- Currently Python accepts numeric literals immediately followed by keywords, for example - 0in x,- 1or x,- 0if 1else 2. It allows confusing and ambiguous expressions like- [0x1for x in y](which can be interpreted as- [0x1 for x in y]or- [0x1f or x in y]). A syntax warning is raised if the numeric literal is immediately followed by one of keywords- and,- else,- for,- if,- in,- isand- or. In a future release it will be changed to a syntax error. (gh-87999)
- Support for - __index__()and- __int__()method returning non-int type: these methods will be required to return an instance of a strict subclass of- int.
- Support for - __float__()method returning a strict subclass of- float: these methods will be required to return an instance of- float.
- Support for - __complex__()method returning a strict subclass of- complex: these methods will be required to return an instance of- complex.
- Delegation of - int()to- __trunc__()method.
- Passing a complex number as the real or imag argument in the - complex()constructor is now deprecated; it should only be passed as a single positional argument. (Contributed by Serhiy Storchaka in gh-109218.)
 
- calendar:- calendar.Januaryand- calendar.Februaryconstants are deprecated and replaced by- calendar.JANUARYand- calendar.FEBRUARY. (Contributed by Prince Roshan in gh-103636.)
- codeobject.co_lnotab: use the- codeobject.co_lines()method instead.
- 
- utcnow(): use- datetime.datetime.now(tz=datetime.UTC).
- utcfromtimestamp(): use- datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC).
 
- gettext: Plural value must be an integer.
- 
- load_module()method: use- exec_module()instead.
- cache_from_source()debug_override parameter is deprecated: use the optimization parameter instead.
 
- 
- EntryPointstuple interface.
- Implicit - Noneon return values.
 
- logging: the- warn()method has been deprecated since Python 3.3, use- warning()instead.
- mailbox: Use of StringIO input and text mode is deprecated, use BytesIO and binary mode instead.
- os: Calling- os.register_at_fork()in multi-threaded process.
- pydoc.ErrorDuringImport: A tuple value for exc_info parameter is deprecated, use an exception instance.
- re: More strict rules are now applied for numerical group references and group names in regular expressions. Only sequence of ASCII digits is now accepted as a numerical reference. The group name in bytes patterns and replacement strings can now only contain ASCII letters and digits and underscore. (Contributed by Serhiy Storchaka in gh-91760.)
- sre_compile,- sre_constantsand- sre_parsemodules.
- shutil:- rmtree()’s onerror parameter is deprecated in Python 3.12; use the onexc parameter instead.
- ssloptions and protocols:- ssl.SSLContextwithout protocol argument is deprecated.
- ssl.SSLContext:- set_npn_protocols()and- selected_npn_protocol()are deprecated: use ALPN instead.
- ssl.OP_NO_SSL*options
- ssl.OP_NO_TLS*options
- ssl.PROTOCOL_SSLv3
- ssl.PROTOCOL_TLS
- ssl.PROTOCOL_TLSv1
- ssl.PROTOCOL_TLSv1_1
- ssl.PROTOCOL_TLSv1_2
- ssl.TLSVersion.SSLv3
- ssl.TLSVersion.TLSv1
- ssl.TLSVersion.TLSv1_1
 
- sysconfig.is_python_build()check_home parameter is deprecated and ignored.
- threadingmethods:- threading.Condition.notifyAll(): use- notify_all().
- threading.Event.isSet(): use- is_set().
- threading.Thread.isDaemon(),- threading.Thread.setDaemon(): use- threading.Thread.daemonattribute.
- threading.Thread.getName(),- threading.Thread.setName(): use- threading.Thread.nameattribute.
- threading.currentThread(): use- threading.current_thread().
- threading.activeCount(): use- threading.active_count().
 
- unittest.IsolatedAsyncioTestCase: it is deprecated to return a value that is not- Nonefrom a test case.
- urllib.parsedeprecated functions:- urlparse()instead- splitattr()
- splithost()
- splitnport()
- splitpasswd()
- splitport()
- splitquery()
- splittag()
- splittype()
- splituser()
- splitvalue()
- to_bytes()
 
- urllib.request:- URLopenerand- FancyURLopenerstyle of invoking requests is deprecated. Use newer- urlopen()functions and methods.
- wsgiref:- SimpleHandler.stdout.write()should not do partial writes.
- xml.etree.ElementTree: Testing the truth value of an- Elementis deprecated. In a future release it will always return- True. Prefer explicit- len(elem)or- elem is not Nonetests instead.
- zipimport.zipimporter.load_module()is deprecated: use- exec_module()instead.