Utfasningar

Väntar på borttagning i Python 3.15

• Importsystemet:

  • Att ställa in __cached__ på en modul samtidigt som man misslyckas med att ställa in __spec__.cached är föråldrat. I Python 3.15 kommer __cached__ inte längre att anges eller tas i beaktande av importsystemet eller standardbiblioteket. (gh-97879)

  • Att ställa in __package__ på en modul utan att ställa in __spec__.parent är föråldrat. I Python 3.15 kommer __package__ inte längre att anges eller tas i beaktande av importsystemet eller standardbiblioteket. (gh-97879)

• ctypes:

  • Den odokumenterade ctypes.SetPointerType()-funktionen är föråldrad sedan Python 3.13.

• http.server:

  • Den föråldrade och sällan använda CGIHTTPRequestHandler har utgått sedan Python 3.13. Ingen direkt ersättare finns. Anything är bättre än CGI för att koppla en webbserver till en request-hanterare.

  • Flaggan --cgi till kommandoradsgränssnittet python -m http.server har utgått sedan Python 3.13.

• importlib:

  • load_module() metod: använd exec_module() istället.

• locale:

  • Funktionen getdefaultlocale() har varit föråldrad sedan Python 3.11. Dess borttagning var ursprungligen planerad till Python 3.13 (gh-90817), men har skjutits upp till Python 3.15. Använd getlocale(), setlocale(), och getencoding() istället. (Bidrag från Hugo van Kemenade i gh-111187.)

• pathlib:

  • PurePath.is_reserved() har utgått sedan Python 3.13. Använd os.path.isreserved() för att upptäcka reserverade sökvägar i Windows.

• plattform:

  • java_ver() har utgått sedan Python 3.13. Denna funktion är endast användbar för Jython-stöd, har ett förvirrande API och är i stort sett otestad.

• sysconfig:

  • Argumentet check_home i sysconfig.is_python_build() har utgått sedan Python 3.12.

• threading:

  • RLock() kommer inte att ta några argument i Python 3.15. Att skicka några argument har varit föråldrat sedan Python 3.14, eftersom Python-versionen inte tillåter några argument, men C-versionen tillåter valfritt antal positionella eller nyckelordsargument och ignorerar varje argument.

• types:

  • types.CodeType: Accessing co_lnotab was deprecated in PEP 626 since 3.10 and was planned to be removed in 3.12, but it only got a proper DeprecationWarning in 3.12. Kan komma att tas bort i 3.15. (Bidrag från Nikita Sobolev i gh-101866.)

• typning:

  • Den odokumenterade syntaxen för nyckelordsargument för att skapa NamedTuple-klasser (till exempel Point = NamedTuple("Point", x=int, y=int)) har utgått sedan Python 3.13. Använd den klassbaserade syntaxen eller den funktionella syntaxen istället.

  • När man använder den funktionella syntaxen för TypedDicts, att inte skicka ett värde till parametern fields (TD = TypedDict("TD")) eller att skicka None (TD = TypedDict("TD", None)) har varit föråldrat sedan Python 3.13. Använd class TD(TypedDict): pass eller TD = TypedDict("TD", {}) för att skapa en TypedDict med noll fält.

  • Dekoratorfunktionen typing.no_type_check_decorator() har varit föråldrad sedan Python 3.13. Efter åtta år i modulen typing har den ännu inte fått stöd av någon större typkontroll.

• våg:

  • Metoderna getmark(), setmark() och getmarkers() i klasserna Wave_read och Wave_write har utgått sedan Python 3.13.

• zipimport:

  • load_module() är föråldrad sedan Python 3.10. Använd exec_module() istället. (Bidrag från Jiahao Li i gh-125746.)

Väntar på borttagning i Python 3.16

• Importsystemet:

  • Att ställa in __loader__ på en modul medan man misslyckas med att ställa in __spec__.loader är föråldrat. I Python 3.16 kommer __loader__ inte längre att anges eller tas i beaktande av importsystemet eller standardbiblioteket.

• array:

  • Formatkoden 'u' (wchar_t) har utgått i dokumentation sedan Python 3.3 och vid körning sedan Python 3.13. Använd istället formatkoden 'w' (Py_UCS4) för Unicode-tecken.

• asyncio:

  • asyncio.iscoroutinefunction() är föråldrad och kommer att tas bort i Python 3.16; använd inspect.iscoroutinefunction() istället. (Bidrag från Jiahao Li och Kumar Aditya i gh-122875.)

  • asyncio-policysystemet är föråldrat och kommer att tas bort i Python 3.16. I synnerhet är följande klasser och funktioner föråldrade:

    • asyncio.AbstractEventLoopPolicy

    • asyncio.DefaultEventLoopPolicy

    • asyncio.WindowsSelectorEventLoopPolicy

    • asyncio.WindowsProactorEventLoopPolicy

    • asyncio.get_event_loop_policy()

    • asyncio.set_event_loop_policy()

    Användare bör använda asyncio.run() eller asyncio.Runner med loop_factory för att använda önskad implementering av händelseslingan.

    Till exempel, för att använda asyncio.SelectorEventLoop på Windows:

    import asyncio
    
    async def main():
        ...
    
    asyncio.run(main(), loop_factory=asyncio.SelectorEventLoop)
    

    (Bidrag från Kumar Aditya i gh-127949.)

• builtins:

  • Bitvis invertering på booleska typer, ~True eller ~False har varit föråldrad sedan Python 3.12, eftersom det ger överraskande och ointuitiva resultat (-2 och -1). Använd not x istället för den logiska negationen av en booleansk formel. I det sällsynta fallet att du behöver den bitvisa inverteringen av det underliggande heltalet, konvertera till int explicit (~int(x)).

• functools:

  • Att anropa Python-implementationen av functools.reduce() med funktion eller sekvens som nyckelordsargument är inte längre aktuellt sedan Python 3.14.

• logging:

  Stöd för anpassade logghanterare med strm-argumentet är föråldrat och planeras att tas bort i Python 3.16. Definiera hanterare med stream-argumentet istället. (Bidrag från Mariusz Felisiak i gh-115032.)

• mimetypes:

  • Giltiga tillägg börjar med en ’.’ eller är tomma för mimetypes.MimeTypes.add_type(). Okommenterade tillägg är föråldrade och kommer att ge upphov till ett ValueError i Python 3.16. (Bidrag från Hugo van Kemenade i gh-75223.)

• shutil:

  • Undantaget ExecError har varit föråldrat sedan Python 3.14. Det har inte använts av någon funktion i shutil sedan Python 3.4, och är nu ett alias för RuntimeError.

• symtable:

  • Metoden Class.get_methods har utgått sedan Python 3.14.

• sys:

  • Funktionen _enablelegacywindowsfsencoding() är föråldrad sedan Python 3.13. Använd miljövariabeln PYTHONLEGACYWINDOWSFSENCODING istället.

• sysconfig:

  • Funktionen sysconfig.expand_makefile_vars() är föråldrad sedan Python 3.14. Använd vars-argumentet i sysconfig.get_paths() istället.

• tarfile:

  • Det odokumenterade och oanvända attributet TarFile.tarfile är föråldrat sedan Python 3.13.

Väntar på borttagning i Python 3.17

• typning:

  • Före Python 3.14 implementerades gamla tiders unioner med hjälp av den privata klassen typing._UnionGenericAlias. Denna klass behövs inte längre för implementationen, men den har behållits för bakåtkompatibilitet, med borttagning planerad till Python 3.17. Användare bör använda dokumenterade introspektionshjälpmedel som typing.get_origin() och typing.get_args() istället för att förlita sig på privata implementationsdetaljer.

Väntar på borttagning i Python 3.19

• ctypes:

  • Implicit byte till MSVC-kompatibel struct-layout genom att ställa in _pack_ men inte _layout_ på icke-Windows-plattformar.

Avser att tas bort i framtida versioner

Följande API:er kommer att tas bort i framtiden, även om det för närvarande inte finns något datum för när de ska tas bort.

• argparse:

  • Nesting av argumentgrupper och nesting av ömsesidigt uteslutande grupper är avförda.

  • Att skicka det odokumenterade nyckelordsargumentet prefix_chars till add_argument_group() är nu föråldrat.

  • Typomvandlaren argparse.FileType är föråldrad.

• builtins:

  • bool(NotImplemented).

  • Generatorer: throw(type, exc, tb) och athrow(type, exc, tb) signaturen är föråldrad: använd throw(exc) och athrow(exc) istället, signaturen med ett enda argument.

  • För närvarande accepterar Python numeriska literaler omedelbart följt av nyckelord, till exempel 0in x, 1or x, 0if 1else 2. Det tillåter förvirrande och tvetydiga uttryck som [0x1for x in y] (som kan tolkas som [0x1 for x in y] eller [0x1f or x in y]). En syntaxvarning visas om den numeriska litteralen omedelbart följs av något av nyckelorden and, else, for, if, in, is och or. I en framtida version kommer det att ändras till ett syntaxfel. (gh-87999)

  • Stöd för metoderna __index__() och __int__() som returnerar icke-int-typer: dessa metoder kommer att behöva returnera en instans av en strikt underklass av int.

  • Stöd för metoden __float__() som returnerar en strikt underklass av float: dessa metoder måste returnera en instans av float.

  • Stöd för metoden __complex__() som returnerar en strikt underklass av complex: dessa metoder måste returnera en instans av complex.

  • Delegering av int() till metoden __trunc__().

  • Att skicka ett komplext tal som real eller imag argument i complex()-konstruktorn är nu föråldrat; det bör endast skickas som ett enda positionellt argument. (Bidrag från Serhiy Storchaka i gh-109218.)

• calendar: Konstanterna calendar.January och calendar.February är föråldrade och ersätts av calendar.JANUARY och calendar.FEBRUARY. (Bidrag från Prince Roshan i gh-103636.)

• codecs: använd open() istället för codecs.open(). (gh-133038)

• codeobject.co_lnotab: använd istället metoden codeobject.co_lines().

• datetime:

  • utcnow(): använd datetime.datetime.now(tz=datetime.UTC).

  • utcfromtimestamp(): använd datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC).

• gettext: Pluralvärdet måste vara ett heltal.

• importlib:

  • cache_from_source() Parametern debug_override är föråldrad: använd parametern optimization istället.

• importlib.metadata:

  • EntryPoints tuple-gränssnitt.

  • Implicit None på returvärden.

• logging: metoden warn() har utgått sedan Python 3.3, använd warning() istället.

• mailbox: Användning av StringIO-ingång och textläge är föråldrad, använd BytesIO och binärt läge istället.

• os: Anropar os.register_at_fork() i flertrådad process.

• pydoc.ErrorDuringImport: Ett tupelvärde för parametern exc_info är föråldrat, använd en undantagsinstans.

• re: Strängare regler tillämpas nu för numeriska gruppreferenser och gruppnamn i reguljära uttryck. Endast sekvenser av ASCII-siffror accepteras nu som numeriska referenser. Gruppnamnet i bytesmönster och ersättningssträngar kan nu endast innehålla ASCII-bokstäver och siffror samt understreck. (Bidrag från Serhiy Storchaka i gh-91760.)

• modulerna sre_compile, sre_constants och sre_parse.

• shutil: rmtree():s parameter onerror är föråldrad i Python 3.12; använd istället parametern onexc.

• ssl alternativ och protokoll:

  • ssl.SSLContext utan protokollargument är föråldrad.

  • ssl.SSLContext: set_npn_protocols() and selected_npn_protocol() are deprecated: use ALPN instead.

  • ssl.OP_NO_SSL* alternativ

  • ssl.OP_NO_TLS* alternativ

  • 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

• threading metoder:

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

  • threading.Event.isSet(): använd is_set().

  • threading.Thread.isDaemon(), threading.Thread.setDaemon(): använd attributet threading.Thread.daemon.

  • threading.Thread.getName(), threading.Thread.setName(): använd attributet threading.Thread.name.

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

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

• typing.Text (gh-92332).

• Den interna klassen typing._UnionGenericAlias används inte längre för att implementera typing.Union. För att bevara kompatibiliteten med användare som använder denna privata klass, kommer en kompatibilitets-shim att tillhandahållas åtminstone fram till Python 3.17. (Bidrag från Jelle Zijlstra i gh-105499.)

• unittest.IsolatedAsyncioTestCase: det är förkastligt att returnera ett värde som inte är None från ett testfall.

• urllib.parse föråldrade funktioner: urlparse() istället

  • splitattr()

  • splithost()

  • splitnport()

  • splitpasswd()

  • splitport()

  • splitquery()

  • splittag()

  • splittype()

  • splituser()

  • splitvalue()

  • to_bytes()

• wsgiref: SimpleHandler.stdout.write() bör inte göra partiella skrivningar.

• xml.etree.ElementTree: Att testa sanningsvärdet för en Element är föråldrat. I en framtida version kommer det alltid att returnera True. Föredra istället explicita len(elem) eller elem is not None tester.

• sys._clear_type_cache() är föråldrad: använd sys._clear_internal_caches() istället.

C API-utfasningar

Väntar på borttagning i Python 3.15

• PyImport_ImportModuleNoBlock(): Använd PyImport_ImportModule() istället.

• PyWeakref_GetObject() och PyWeakref_GET_OBJECT(): Använd PyWeakref_GetRef() istället. Projektet pythoncapi-compat kan användas för att hämta PyWeakref_GetRef() på Python 3.12 och äldre.

• Py_UNICODE typ och Py_UNICODE_WIDE makro: Använd wchar_t istället.

• PyUnicode_AsDecodedObject(): Använd PyCodec_Decode() istället.

• PyUnicode_AsDecodedUnicode(): Använd PyCodec_Decode() istället; Observera att vissa codecs (t.ex. ”base64”) kan returnera en annan typ än str, t.ex. bytes.

• PyUnicode_AsEncodedObject(): Använd PyCodec_Encode() istället.

• PyUnicode_AsEncodedUnicode(): Använd PyCodec_Encode() istället; Observera att vissa codecs (t.ex. ”base64”) kan returnera en annan typ än bytes, t.ex. str.

• Python-initialiseringsfunktioner, föråldrade i Python 3.13:

  • Py_GetPath(): Använd PyConfig_Get("module_search_paths") (sys.path) istället.

  • Py_GetPrefix(): Använd PyConfig_Get("base_prefix") (sys.base_prefix) istället. Använd PyConfig_Get("prefix") (sys.prefix) om virtuella miljöer behöver hanteras.

  • Py_GetExecPrefix(): Använd PyConfig_Get("base_exec_prefix") (sys.base_exec_prefix) istället. Använd PyConfig_Get("exec_prefix") (sys.exec_prefix) om virtuella miljöer behöver hanteras.

  • Py_GetProgramFullPath(): Använd PyConfig_Get("executable") (sys.executable) istället.

  • Py_GetProgramName(): Använd PyConfig_Get("executable") (sys.executable) istället.

  • Py_GetPythonHome(): Använd PyConfig_Get("home") eller miljövariabeln PYTHONHOME istället.

  Projektet pythoncapi-compat kan användas för att få PyConfig_Get() på Python 3.13 och äldre.

• Funktioner för att konfigurera Pythons initialisering, föråldrad i Python 3.11:

  • PySys_SetArgvEx(): Ställ in PyConfig.argv istället.

  • PySys_SetArgv(): Ställ in PyConfig.argv istället.

  • Py_SetProgramName(): Ställ in PyConfig.program_name istället.

  • Py_SetPythonHome(): Ställ in PyConfig.home istället.

  • PySys_ResetWarnOptions(): Rensa sys.warnoptions och warnings.filters istället.

  API:t Py_InitializeFromConfig() bör användas med PyConfig istället.

• Variabler för global konfiguration:

  • Py_DebugFlag: Använd PyConfig.parser_debug eller PyConfig_Get("parser_debug") istället.

  • Py_VerboseFlag: Använd PyConfig.verbose eller PyConfig_Get("verbose") istället.

  • Py_QuietFlag: Använd PyConfig.quiet eller PyConfig_Get("quiet") istället.

  • Py_InteractiveFlag: Använd PyConfig.interactive eller PyConfig_Get("interactive") istället.

  • Py_InspectFlag: Använd PyConfig.inspect eller PyConfig_Get("inspect") istället.

  • Py_OptimizeFlag: Använd PyConfig.optimization_level eller PyConfig_Get("optimization_level") istället.

  • Py_NoSiteFlag: Använd PyConfig.site_import eller PyConfig_Get("site_import") istället.

  • Py_BytesWarningFlag: Använd PyConfig.bytes_warning eller PyConfig_Get("bytes_warning") istället.

  • Py_FrozenFlag: Använd PyConfig.pathconfig_warnings eller PyConfig_Get("pathconfig_warnings") istället.

  • Py_IgnoreEnvironmentFlag: Använd PyConfig.use_environment eller PyConfig_Get("use_environment") istället.

  • Py_DontWriteBytecodeFlag: Använd PyConfig.write_bytecode eller PyConfig_Get("write_bytecode") istället.

  • Py_NoUserSiteDirectory: Använd PyConfig.user_site_directory eller PyConfig_Get("user_site_directory") istället.

  • Py_UnbufferedStdioFlag: Använd PyConfig.buffered_stdio eller PyConfig_Get("buffered_stdio") istället.

  • Py_HashRandomizationFlag: Använd PyConfig.use_hash_seed och PyConfig.hash_seed eller PyConfig_Get("hash_seed") istället.

  • Py_IsolatedFlag: Använd PyConfig.isolated eller PyConfig_Get("isolated") istället.

  • Py_LegacyWindowsFSEncodingFlag: Använd PyPreConfig.legacy_windows_fs_encoding eller PyConfig_Get("legacy_windows_fs_encoding") istället.

  • Py_LegacyWindowsStdioFlag: Använd PyConfig.legacy_windows_stdio eller PyConfig_Get("legacy_windows_stdio") istället.

  • Py_FileSystemDefaultEncoding, Py_HasFileSystemDefaultEncoding: Använd PyConfig.filesystem_encoding eller PyConfig_Get("filesystem_encoding") istället.

  • Py_FileSystemDefaultEncodeErrors: Använd PyConfig.filesystem_errors eller PyConfig_Get("filesystem_errors") istället.

  • Py_UTF8Mode: Använd PyPreConfig.utf8_mode eller PyConfig_Get("utf8_mode") istället. (se Py_PreInitialize())

  API:et Py_InitializeFromConfig() bör användas med PyConfig för att ställa in dessa alternativ. Eller så kan PyConfig_Get() användas för att hämta dessa alternativ vid körning.

Väntar på borttagning i Python 3.18

• Föråldrade privata funktioner (gh-128863):

  • _PyBytes_Join(): använd PyBytes_Join().

  • _PyDict_GetItemStringWithError(): använd PyDict_GetItemStringRef().

  • _PyDict_Pop(): PyDict_Pop().

  • _PyLong_Sign(): använd PyLong_GetSign().

  • _PyLong_FromDigits() och _PyLong_New(): använd PyLongWriter_Create().

  • _PyThreadState_UncheckedGet(): använd PyThreadState_GetUnchecked().

  • _PyUnicode_AsString(): använd PyUnicode_AsUTF8().

  • _PyUnicodeWriter_Init(): ersätt _PyUnicodeWriter_Init(&writer) med writer = PyUnicodeWriter_Create(0).

  • _PyUnicodeWriter_Finish(): ersätt _PyUnicodeWriter_Finish(&writer) med PyUnicodeWriter_Finish(writer).

  • _PyUnicodeWriter_Dealloc(): ersätt _PyUnicodeWriter_Dealloc(&writer) med PyUnicodeWriter_Discard(writer).

  • _PyUnicodeWriter_WriteChar(): ersätt _PyUnicodeWriter_WriteChar(&writer, ch) med PyUnicodeWriter_WriteChar(writer, ch).

  • _PyUnicodeWriter_WriteStr(): ersätt _PyUnicodeWriter_WriteStr(&writer, str) med PyUnicodeWriter_WriteStr(writer, str).

  • _PyUnicodeWriter_WriteSubstring(): ersätt _PyUnicodeWriter_WriteSubstring(&writer, str, start, end) med PyUnicodeWriter_WriteSubstring(writer, str, start, end).

  • _PyUnicodeWriter_WriteASCIIString(): ersätt _PyUnicodeWriter_WriteASCIIString(&writer, str) med PyUnicodeWriter_WriteUTF8(writer, str).

  • _PyUnicodeWriter_WriteLatin1String(): ersätt _PyUnicodeWriter_WriteLatin1String(&writer, str) med PyUnicodeWriter_WriteUTF8(writer, str).

  • _PyUnicodeWriter_Prepare(): (ingen ersättning).

  • _PyUnicodeWriter_PrepareKind(): (ingen ersättning).

  • _Py_HashPointer(): använd Py_HashPointer().

  • _Py_fopen_obj(): använd Py_fopen().

  Projektet pythoncapi-compat kan användas för att få dessa nya offentliga funktioner på Python 3.13 och äldre.

Avser att tas bort i framtida versioner

Följande API:er är föråldrade och kommer att tas bort, även om det för närvarande inte finns något datum för när de ska tas bort.

• Py_TPFLAGS_HAVE_FINALIZE: Behövs inte sedan Python 3.8.

• PyErr_Fetch(): Använd PyErr_GetRaisedException() istället.

• PyErr_NormalizeException(): Använd PyErr_GetRaisedException() istället.

• PyErr_Restore(): Använd PyErr_SetRaisedException() istället.

• PyModule_GetFilename(): Använd PyModule_GetFilenameObject() istället.

• PyOS_AfterFork(): Använd PyOS_AfterFork_Child() istället.

• PySlice_GetIndicesEx(): Använd PySlice_Unpack() och PySlice_AdjustIndices() istället.

• PyUnicode_READY(): Behövs inte sedan Python 3.12

• PyErr_Display(): Använd PyErr_DisplayException() istället.

• _PyErr_ChainExceptions(): Använd _PyErr_ChainExceptions1() istället.

• PyBytesObject.ob_shash member: anropa PyObject_Hash() istället.

• API för lokal lagring av trådar (TLS):

  • PyThread_create_key(): Använd PyThread_tss_alloc() istället.

  • PyThread_delete_key(): Använd PyThread_tss_free() istället.

  • PyThread_set_key_value(): Använd PyThread_tss_set() istället.

  • PyThread_get_key_value(): Använd PyThread_tss_get() istället.

  • PyThread_delete_key_value(): Använd PyThread_tss_delete() istället.

  • PyThread_ReInitTLS(): Behövs inte sedan Python 3.7.