Descontinuações

Remoção pendente no Python 3.17

• datetime:

  • strptime() calls using a format string containing %e (day of month) without a year. This has been deprecated since Python 3.15. (Contributed by Stan Ulbrych in gh-70647.)

• collections.abc:

  • collections.abc.ByteString está agendado para remoção no Python 3.17.

    Use isinstance(obj, collections.abc.Buffer) para testar se obj implementa o protocolo de buffer em tempo de execução. Para uso em anotações de tipo, use Buffer ou uma união que especifique explicitamente os tipos suportados pelo seu código (por exemplo, bytes | bytearray | memoryview).

    ByteString foi originalmente concebido para ser uma classe abstrata que serviria como um supertipo de bytes e bytearray. No entanto, como o ABC nunca teve métodos, saber que um objeto era uma instância de ByteString nunca lhe dizia nada de útil sobre o objeto. Outros tipos comuns de buffer, como memoryview, também nunca foram entendidos como subtipos de ByteString (seja em tempo de execução ou por verificadores de tipo estáticos).

    Veja PEP 688 para mais detalhes. (Contribuição de Shantanu Jain em gh-91896.)

• encodings:

  • Passing non-ascii encoding names to encodings.normalize_encoding() is deprecated and scheduled for removal in Python 3.17. (Contributed by Stan Ulbrych in gh-136702.)

• webbrowser:

  • webbrowser.MacOSXOSAScript is deprecated in favour of webbrowser.MacOS. (gh-137586)

• typing:

  • Antes do Python 3.14, as uniões antigas eram implementadas usando a classe privada typing._UnionGenericAlias. Essa classe não é mais necessária para a implementação, mas foi mantida para compatibilidade com versões anteriores, com remoção prevista para o Python 3.17. Os usuários devem usar auxiliares de introspecção documentados, como typing.get_origin() e typing.get_args(), em vez de depender de detalhes de implementação privada.

  • typing.ByteString, obsoleto desde o Python 3.9, está programado para ser removido no Python 3.17.

    Use isinstance(obj, collections.abc.Buffer) para testar se obj implementa o protocolo de buffer em tempo de execução. Para uso em anotações de tipo, use Buffer ou uma união que especifique explicitamente os tipos suportados pelo seu código (por exemplo, bytes | bytearray | memoryview).

    ByteString foi originalmente concebido para ser uma classe abstrata que serviria como um supertipo de bytes e bytearray. No entanto, como o ABC nunca teve métodos, saber que um objeto era uma instância de ByteString nunca lhe dizia nada de útil sobre o objeto. Outros tipos comuns de buffer, como memoryview, também nunca foram entendidos como subtipos de ByteString (seja em tempo de execução ou por verificadores de tipo estáticos).

    Veja PEP 688 para mais detalhes. (Contribuição de Shantanu Jain em gh-91896.)

• tkinter:

  • The tkinter.Variable methods trace_variable(), trace() (an alias of trace_variable()), trace_vdelete() and trace_vinfo(), deprecated since Python 3.14, are scheduled for removal in Python 3.17. Use trace_add(), trace_remove() and trace_info() instead. (Contributed by Serhiy Storchaka in gh-120220.)

Remoção pendente no Python 3.18

• No longer accept a boolean value when a file descriptor is expected. (Contributed by Serhiy Storchaka in gh-82626.)

• decimal:

  • O especificador de formato de Decimal não padrão e não documentado 'N', que só é suportado na implementação C do módulo decimal, foi descontinuada desde o Python 3.13. (Contribuição de Serhiy Storchaka em gh-89902.)

• Deprecations defined by PEP 829:

  • import lines in name.pth files are silently ignored.

  (Contributed by Barry Warsaw in gh-148641.)

Remoção pendente no Python 3.19

• ctypes:

  • Troca implícita para o layout de estrutura compatível com MSVC definindo _pack_, mas não _layout_ em plataformas não Windows.

• hashlib:

  • In hash function constructors such as new() or the direct hash-named constructors such as md5() and sha256(), their optional initial data parameter could also be passed a keyword argument named data= or string= in various hashlib implementations.

    Support for the string keyword argument name is now deprecated and slated for removal in Python 3.19.

    Before Python 3.13, the string keyword parameter was not correctly supported depending on the backend implementation of hash functions. Prefer passing the initial data as a positional argument for maximum backwards compatibility.

• http.cookies:

  • http.cookies.Morsel.js_output() is deprecated and will be removed in Python 3.19.

  • http.cookies.BaseCookie.js_output() is deprecated and will be removed in Python 3.19.

• imaplib:

  • Altering IMAP4.file is now deprecated and slated for removal in Python 3.19. This property is now unused and changing its value does not automatically close the current file.

    Before Python 3.14, this property was used to implement the corresponding read() and readline() methods for IMAP4 but this is no longer the case since then.

Remoção pendente no Python 3.20

• Calling the __new__() method of struct.Struct without the format argument is deprecated and will be removed in Python 3.20. Calling __init__() method on initialized Struct objects is deprecated and will be removed in Python 3.20.

  (Contributed by Sergey B Kirpichev and Serhiy Storchaka in gh-143715.)

• The __version__, version and VERSION attributes have been deprecated in these standard library modules and will be removed in Python 3.20. Use sys.version_info instead.

  • argparse

  • csv

  • ctypes

  • ctypes.macholib

  • decimal (use decimal.SPEC_VERSION instead)

  • http.server

  • imaplib

  • ipaddress

  • json

  • logging (__date__ also deprecated)

  • optparse

  • pickle

  • platform

  • re

  • socketserver

  • tabnanny

  • tarfile

  • tkinter.font

  • tkinter.ttk

  • wsgiref.simple_server

  • xml.etree.ElementTree

  • xml.sax.expatreader

  • xml.sax.handler

  • zlib

  (Contributed by Hugo van Kemenade and Stan Ulbrych in gh-76007.)

• Deprecations defined by PEP 829:

  • Warnings are produced for import lines found in name.pth files.

  • name.pth files are no longer decoded in the locale encoding by default. They MUST be encoded in utf-8-sig.

  (Contributed by Barry Warsaw in gh-148641.)

• ast:

  • Creating instances of abstract AST nodes (such as ast.AST or ast.expr) is deprecated and will raise an error in Python 3.20.

Pending removal in Python 3.21

• abc

  • Soft-deprecated since Python 3.3 abc.abstractclassmethod, abc.abstractstaticmethod, and abc.abstractproperty now raise a DeprecationWarning. These classes will be removed in Python 3.21, instead use abc.abstractmethod() with classmethod(), staticmethod(), and property respectively.

• ast:

  • Classes slice, Index, ExtSlice, Suite, Param, AugLoad and AugStore, will be removed in Python 3.21. These types are not generated by the parser or accepted by the code generator.

  • The dims property of ast.Tuple will be removed in Python 3.21. Use the ast.Tuple.elts property instead.

Remoção pendente em versões futuras

As APIs a seguir serão removidas no futuro, embora atualmente não haja uma data agendada para sua remoção.

• argparse:

  • O aninhamento de grupos de argumentos e o aninhamento de grupos mutuamente exclusivos estão descontinuado.

  • A passagem do argumento nomeado não documentado prefix_chars para add_argument_group() agora está descontinuado.

  • O conversor de tipo argparse.FileType está descontinuado.

• builtins:

  • Geradores: a assinatura throw(type, exc, tb) e athrow(type, exc, tb) está descontinuada: use throw(exc) e athrow(exc), a assinatura do argumento único.

  • Atualmente Python aceita literais numéricos imediatamente seguidos por palavras reservadas como, por exemplo, 0in x, 1or x, 0if 1else 2. Ele permite expressões confusas e ambíguas como [0x1for x in y] (que pode ser interpretada como [0x1 for x in y] ou [0x1f or x in y]). Um aviso de sintaxe é levantado se o literal numérico for imediatamente seguido por uma das palavras reservadas and, else, for, if, in , is e or. Em uma versão futura, será alterado para um erro de sintaxe. (gh-87999)

  • Suporte para métodos __index__() e __int__() retornando tipo não-int: esses métodos serão necessários para retornar uma instância de uma subclasse estrita de int.

  • Suporte para o método __float__() retornando uma subclasse estrita de float: esses métodos serão necessários para retornar uma instância de float.

  • Suporte para o método __complex__() retornando uma subclasse estrita de complex: esses métodos serão necessários para retornar uma instância de complex.

  • Passar um número complexo como argumento real ou imag no construtor complex() agora está descontinuado; deve ser passado apenas como um único argumento posicional. (Contribuição de Serhiy Storchaka em gh-109218.)

• calendar: as constantes calendar.January e calendar.February foram descontinuadas e substituídas por calendar.JANUARY e calendar.FEBRUARY. (Contribuição de Prince Roshan em gh-103636.)

• codecs: use open() em vez de codecs.open(). (gh-133038)

• codeobject.co_lnotab: use the codeobject.co_lines() method instead.

• datetime:

  • utcnow(): use datetime.datetime.now(tz=datetime.UTC).

  • utcfromtimestamp(): use datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC).

• gettext: o valor de plural deve ser um número inteiro.

• importlib:

  • O parâmetro debug_override de cache_from_source() foi descontinuado: em vez disso, use o parâmetro optimization.

• importlib.metadata:

  • Interface de tupla EntryPoints.

  • None implícito nos valores de retorno.

• logging: o método warn() foi descontinuado desde o Python 3.3, use warning().

• mailbox: o uso da entrada StringIO e do modo de texto foi descontinuado; em vez disso, use BytesIO e o modo binário.

• os: Calling os.register_at_fork() in a multi-threaded process.

• os.path: os.path.commonprefix() is deprecated, use os.path.commonpath() for path prefixes. The os.path.commonprefix() function is being deprecated due to having a misleading name and module. The function is not safe to use for path prefixes despite being included in a module about path manipulation, meaning it is easy to accidentally introduce path traversal vulnerabilities into Python programs by using this function.

• pydoc.ErrorDuringImport: um valor de tupla para o parâmetro exc_info foi descontinuado, use uma instância de exceção.

• re: regras mais rigorosas agora são aplicadas para referências numéricas de grupos e nomes de grupos em expressões regulares. Apenas a sequência de dígitos ASCII agora é aceita como referência numérica. O nome do grupo em padrões de bytes e strings de substituição agora pode conter apenas letras e dígitos ASCII e sublinhado. (Contribuição de Serhiy Storchaka em gh-91760.)

• shutil: o parâmetro onerror de rmtree() foi descontinuado no Python 3.12; use o parâmetro onexc.

• Protocolos e opções de ssl

  • ssl.SSLContext sem argumento de protocolo foi descontinuado.

  • ssl.SSLContext: set_npn_protocols() e selected_npn_protocol() foram descontinuados: use ALPN.

  • Opções de ssl.OP_NO_SSL*

  • Opções de ssl.OP_NO_TLS*

  • 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

• Métodos de threading:

  • threading.Condition.notifyAll(): use notify_all().

  • threading.Event.isSet(): use is_set().

  • threading.Thread.isDaemon(), threading.Thread.setDaemon(): use o atributo threading.Thread.daemon.

  • threading.Thread.getName(), threading.Thread.setName(): use o atributo threading.Thread.name.

  • threading.currentThread(): use threading.current_thread().

  • threading.activeCount(): use threading.active_count().

• typing.Text (gh-92332).

• A classe interna typing._UnionGenericAlias não é mais usada para implementar typing.Union. Para preservar a compatibilidade com usuários que utilizam esta classe privada, uma correção de compatibilidade será fornecida pelo menos até a versão 3.17 do Python. (Contribuição de Jelle Zijlstra em gh-105499.)

• unittest.IsolatedAsyncioTestCase: foi descontinuado retornar um valor que não seja None de um caso de teste.

• Funções descontinuadas de urllib.parse: use urlparse()

  • splitattr()

  • splithost()

  • splitnport()

  • splitpasswd()

  • splitport()

  • splitquery()

  • splittag()

  • splittype()

  • splituser()

  • splitvalue()

  • to_bytes()

• wsgiref: SimpleHandler.stdout.write() não deve fazer gravações parciais.

• xml.etree.ElementTree: testar o valor verdade de um Element está descontinuado. Em um lançamento futuro isso sempre retornará True. Em vez disso, prefira os testes explícitos len(elem) ou elem is not None.

• sys._clear_type_cache() está descontinuada: use sys._clear_internal_caches().

Soft deprecations

There are no plans to remove soft deprecated APIs.

• re.match() and re.Pattern.match() are now soft deprecated in favor of the new re.prefixmatch() and re.Pattern.prefixmatch() APIs, which have been added as alternate, more explicit names. These are intended to be used to alleviate confusion around what match means by following the Zen of Python’s “Explicit is better than implicit” mantra. Most other language regular expression libraries use an API named match to mean what Python has always called search.

  We do not plan to remove the older match() name, as it has been used in code for over 30 years. Code supporting older versions of Python should continue to use match(), while new code should prefer prefixmatch(). See prefixmatch() vs. match().

  (Contributed by Gregory P. Smith in gh-86519 and Hugo van Kemenade in gh-148100.)

• Using 'F' and 'D' format type codes of the struct module now are soft deprecated in favor of two-letter forms 'Zf' and 'Zd'. (Contributed by Sergey B Kirpichev in gh-121249.)

Descontinuações na API C

Remoção pendente no Python 3.18

• As seguintes funções privadas estão descontinuado e planejadas para remoção no Python 3.18:

  • _PyBytes_Join(): use PyBytes_Join().

  • _PyDict_GetItemStringWithError(): use PyDict_GetItemStringRef().

  • _PyDict_Pop(): use PyDict_Pop().

  • _PyLong_Sign(): use PyLong_GetSign().

  • _PyLong_FromDigits() e _PyLong_New(): use PyLongWriter_Create().

  • _PyThreadState_UncheckedGet(): use PyThreadState_GetUnchecked().

  • _PyUnicode_AsString(): use PyUnicode_AsUTF8().

  • _PyUnicodeWriter_Init(): substitua _PyUnicodeWriter_Init(&writer) com writer = PyUnicodeWriter_Create(0).

  • _PyUnicodeWriter_Finish(): substitua _PyUnicodeWriter_Finish(&writer) por PyUnicodeWriter_Finish(writer).

  • _PyUnicodeWriter_Dealloc(): substitua _PyUnicodeWriter_Dealloc(&writer) por PyUnicodeWriter_Discard(writer).

  • _PyUnicodeWriter_WriteChar(): substituta _PyUnicodeWriter_WriteChar(&writer, ch) com PyUnicodeWriter_WriteChar(writer, ch).

  • _PyUnicodeWriter_WriteStr(): substitua _PyUnicodeWriter_WriteStr(&writer, str) por PyUnicodeWriter_WriteStr(writer, str).

  • _PyUnicodeWriter_WriteSubstring(): substitua _PyUnicodeWriter_WriteSubstring(&writer, str, start, end) por PyUnicodeWriter_WriteSubstring(writer, str, start, end).

  • _PyUnicodeWriter_WriteASCIIString(): substitua _PyUnicodeWriter_WriteASCIIString(&writer, str) por PyUnicodeWriter_WriteASCII(writer, str).

  • _PyUnicodeWriter_WriteLatin1String(): substitua _PyUnicodeWriter_WriteLatin1String(&writer, str) por PyUnicodeWriter_WriteUTF8(writer, str).

  • _PyUnicodeWriter_Prepare(): (sem substituto).

  • _PyUnicodeWriter_PrepareKind(): (sem substituto).

  • _Py_HashPointer(): use Py_HashPointer().

  • _Py_fopen_obj(): use Py_fopen().

  • PyGen_New(): (no replacement).

  • PyGen_NewWithQualName(): (no replacement).

  • PyCoro_New(): (no replacement).

  • PyAsyncGen_New(): (no replacement).

  O projeto pythoncapi-compat pode ser usado para obter essas novas funções públicas no Python 3.13 e versões anteriores. (Contribuição de Victor Stinner em gh-128863.)

Remoção pendente no Python 3.19

• PEP 456 embedders support for the string hashing scheme definition.

Remoção pendente no Python 3.20

• _PyObject_CallMethodId(), _PyObject_GetAttrId() e _PyUnicode_FromId() foram descontinuadas desde o 3.15 e serão removidas na versão 3.20. Em vez delas, use PyUnicode_InternFromString() and armazene em cache o resultado no estado do módulo e chame PyObject_CallMethod() ou PyObject_GetAttr(). (Contribuição de Victor Stinner em gh-141049.)

• O campo cval em PyComplexObject (gh-128813). Use PyComplex_AsCComplex() e PyComplex_FromCComplex() para converter um número complexo Python de/para a representação C de Py_complex.

• Macros Py_MATH_PIl e Py_MATH_El.

Remoção pendente em versões futuras

As APIs a seguir foram descontinuadas e serão removidas, embora atualmente não haja uma data agendada para sua remoção.

• Py_TPFLAGS_HAVE_FINALIZE: desnecessária desde o Python 3.8.

• PyErr_Fetch(): use PyErr_GetRaisedException().

• PyErr_NormalizeException(): use PyErr_GetRaisedException().

• PyErr_Restore(): use PyErr_SetRaisedException().

• PyModule_GetFilename(): use PyModule_GetFilenameObject().

• PyOS_AfterFork(): use PyOS_AfterFork_Child().

• PySlice_GetIndicesEx(): use PySlice_Unpack() e PySlice_AdjustIndices().

• PyUnicode_READY(): desnecessário desde o Python 3.12

• PyErr_Display(): use PyErr_DisplayException().

• _PyErr_ChainExceptions(): use _PyErr_ChainExceptions1().

• O membro PyBytesObject.ob_shash: chame PyObject_Hash().

• API do Thread Local Storage (TLS):

  • PyThread_create_key(): use PyThread_tss_alloc().

  • PyThread_delete_key(): use PyThread_tss_free().

  • PyThread_set_key_value(): use PyThread_tss_set().

  • PyThread_get_key_value(): use PyThread_tss_get().

  • PyThread_delete_key_value(): use PyThread_tss_delete().

  • PyThread_ReInitTLS(): desnecessário desde o Python 3.7.