非推奨

Python 3.15 で削除予定

• インポートシステム：

  • Setting __cached__ on a module while failing to set __spec__.cached is deprecated. In Python 3.15, __cached__ will cease to be set or take into consideration by the import system or standard library. (gh-97879)

  • Setting __package__ on a module while failing to set __spec__.parent is deprecated. In Python 3.15, __package__ will cease to be set or take into consideration by the import system or standard library. (gh-97879)

• ctypes:

  • The undocumented ctypes.SetPointerType() function has been deprecated since Python 3.13.

• http.server:

  • The obsolete and rarely used CGIHTTPRequestHandler has been deprecated since Python 3.13. No direct replacement exists. Anything is better than CGI to interface a web server with a request handler.

  • The --cgi flag to the python -m http.server command-line interface has been deprecated since Python 3.13.

• importlib:

  • load_module() method: use exec_module() instead.

• pathlib:

  • PurePath.is_reserved() has been deprecated since Python 3.13. Use os.path.isreserved() to detect reserved paths on Windows.

• platform:

  • java_ver() has been deprecated since Python 3.13. This function is only useful for Jython support, has a confusing API, and is largely untested.

• sysconfig:

  • The check_home argument of sysconfig.is_python_build() has been deprecated since Python 3.12.

• threading:

  • RLock() will take no arguments in Python 3.15. Passing any arguments has been deprecated since Python 3.14, as the Python version does not permit any arguments, but the C version allows any number of positional or keyword arguments, ignoring every 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. May be removed in 3.15. (Contributed by Nikita Sobolev in gh-101866.)

• typing:

  • The undocumented keyword argument syntax for creating NamedTuple classes (for example, Point = NamedTuple("Point", x=int, y=int)) has been deprecated since Python 3.13. Use the class-based syntax or the functional syntax instead.

  • When using the functional syntax of TypedDicts, failing to pass a value to the fields parameter (TD = TypedDict("TD")) or passing None (TD = TypedDict("TD", None)) has been deprecated since Python 3.13. Use class TD(TypedDict): pass or TD = TypedDict("TD", {}) to create a TypedDict with zero field.

  • The @typing.no_type_check_decorator decorator function has been deprecated since Python 3.13. After eight years in the typing module, it has yet to be supported by any major type checker.

• wave:

  • The getmark(), setmark(), and getmarkers() methods of the Wave_read and Wave_write classes have been deprecated since Python 3.13.

• zipimport:

  • load_module() has been deprecated since Python 3.10. Use exec_module() instead. (Contributed by Jiahao Li in gh-125746.)

Python 3.16 で削除予定

• インポートシステム：

  • モジュールの __spec__.loader を設定せずに __loader__ を設定することは非推奨です。 Python 3.16 では、インポートシステムや標準ライブラリは __loader__ を設定しなくなり、その値も参照しなくなります。

• array:

  • 書式コード 'u' (wchar_t) は、Python 3.3 からドキュメントで非推奨とされ、Python 3.13 からは実行時にも非推奨とされています。 Unicode 文字には、代わりに書式コード 'w' (Py_UCS4) を使ってください。

• asyncio:

  • asyncio.iscoroutinefunction() は非推奨となり、Python 3.16 で削除されます。 代わりに inspect.iscoroutinefunction() を使ってください。 (Jiahao Li と Kumar Aditya が gh-122875 で貢献しました。)

  • asyncio のポリシーシステムは非推奨となり、Python 3.16 で削除されます。 具体的には、以下のクラスと関数が非推奨です：

    • asyncio.AbstractEventLoopPolicy

    • asyncio.DefaultEventLoopPolicy

    • asyncio.WindowsSelectorEventLoopPolicy

    • asyncio.WindowsProactorEventLoopPolicy

    • asyncio.get_event_loop_policy()

    • asyncio.set_event_loop_policy()

    使いたいイベントループの実装を指定するには、asyncio.run() または asyncio.Runner の loop_factory を使ってください。

    例えば、Windows で asyncio.SelectorEventLoop を使うには、次のようにします。

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

    (Kumar Aditya が gh-127949 で貢献しました。)

• builtins:

  • 真偽値に対するビット単位の反転 ~True や ~False は、直感に反する意外な結果 (-2 と -1) になるため、Python 3.12 から非推奨です。 真偽値の論理否定には、代わりに not x を使ってください。 元の整数値のビット単位の反転が必要になるまれな場合には、明示的に int に変換してください (~int(x))。

• functools:

  • functools.reduce() の Python 実装を、function や sequence をキーワード引数として指定して呼び出すことは、Python 3.14 から非推奨です。

• logging:

  strm 引数を持つカスタムログハンドラーへの対応は非推奨となり、Python 3.16 で削除予定です。 代わりに stream 引数を持つハンドラーを定義してください。 (Mariusz Felisiak が gh-115032 で貢献しました。)

• mimetypes:

  • mimetypes.MimeTypes.add_type() で有効な拡張子は、'.' で始まるものか空のものです。 ドットのない拡張子は非推奨となり、Python 3.16 では ValueError が発生します。 (Hugo van Kemenade が gh-75223 で貢献しました。)

• shutil:

  • ExecError 例外は Python 3.14 から非推奨です。 Python 3.4 以降は shutil のどの関数でも使われておらず、現在は RuntimeError の別名になっています。

• symtable:

  • Class.get_methods メソッドは Python 3.14 から非推奨です。

• sys:

  • _enablelegacywindowsfsencoding() 関数は Python 3.13 から非推奨です。 代わりに環境変数 PYTHONLEGACYWINDOWSFSENCODING を使ってください。

• sysconfig:

  • sysconfig.expand_makefile_vars() 関数は Python 3.14 から非推奨です。 代わりに sysconfig.get_paths() の vars 引数を使ってください。

• tarfile:

  • ドキュメント化されておらず、使われてもいない TarFile.tarfile 属性は Python 3.13 から非推奨です。

Python 3.17 で削除予定

• collections.abc:

  • collections.abc.ByteString は Python 3.17 で削除予定です。

    実行時に obj が バッファプロトコル を実装しているか調べるには、isinstance(obj, collections.abc.Buffer) を使ってください。 型アノテーションには Buffer を使うか、コードが対応する型を明示したユニオン (例えば bytes | bytearray | memoryview) を使ってください。

    ByteString は当初、bytes と bytearray の両方の上位型となる抽象クラスとして意図されていました。 しかし、この ABC はメソッドを一つも持たないため、あるオブジェクトが ByteString のインスタンスだと分かっても、そのオブジェクトに関する有用な情報は何も得られませんでした。 memoryview など、他の一般的なバッファ型も、実行時にも静的型チェッカーによっても ByteString のサブタイプとして認識されることはありませんでした。

    詳しくは PEP 688 を参照してください。 (Shantanu Jain が gh-91896 で貢献しました。)

• typing:

  • Python 3.14 より前は、従来のユニオンは非公開クラス typing._UnionGenericAlias を使って実装されていました。 このクラスは実装上は不要になりましたが、後方互換性のために残されており、Python 3.17 で削除予定です。 非公開の実装の詳細に依存する代わりに、typing.get_origin() や typing.get_args() など、ドキュメント化されたイントロスペクション用の補助関数を使ってください。

  • Python 3.9 から非推奨となっている typing.ByteString は、Python 3.17 で削除予定です。

    実行時に obj が バッファプロトコル を実装しているか調べるには、isinstance(obj, collections.abc.Buffer) を使ってください。 型アノテーションには Buffer を使うか、コードが対応する型を明示したユニオン (例えば bytes | bytearray | memoryview) を使ってください。

    ByteString は当初、bytes と bytearray の両方の上位型となる抽象クラスとして意図されていました。 しかし、この ABC はメソッドを一つも持たないため、あるオブジェクトが ByteString のインスタンスだと分かっても、そのオブジェクトに関する有用な情報は何も得られませんでした。 memoryview など、他の一般的なバッファ型も、実行時にも静的型チェッカーによっても ByteString のサブタイプとして認識されることはありませんでした。

    詳しくは PEP 688 を参照してください。 (Shantanu Jain が gh-91896 で貢献しました。)

Python 3.18 で削除予定

• decimal:

  • Decimal の標準外でドキュメント化されていない書式指定子 'N' は、Python 3.13 から非推奨です。 これは decimal モジュールの C 実装だけでサポートされています。 (Serhiy Storchaka が gh-89902 で貢献しました。)

Python 3.19 で削除予定

• ctypes:

  • Windows 以外のプラットフォームで、_layout_ を設定せずに _pack_ を設定することで、暗黙的に MSVC 互換の構造体レイアウトに切り替えること。

将来のバージョンで削除予定

以下の API は将来削除されますが、現時点では削除時期は決まっていません。

• argparse:

  • 引数グループの入れ子と、相互排他的なグループの入れ子は非推奨です。

  • add_argument_group() に、ドキュメント化されていないキーワード引数 prefix_chars を渡すことは非推奨になりました。

  • argparse.FileType 型コンバーターは非推奨です。

• builtins:

  • ジェネレーター：throw(type, exc, tb) と athrow(type, exc, tb) というシグネチャは非推奨です。 代わりに、引数が一つの throw(exc) と athrow(exc) を使ってください。

  • 現在の Python は、0in x、1or x、0if 1else 2 のように数値リテラルの直後にキーワードが続く記法を受け付けます。 そのため、[0x1for x in y] のような紛らわしく曖昧な式も書けます ([0x1 for x in y] とも [0x1f or x in y] とも解釈できます)。 数値リテラルの直後に and、else、for、if、in、is、or のいずれかが続く場合は、構文上の警告が発生します。 将来のリリースでは構文エラーになります。 (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.

  • __float__() メソッドが float の厳密なサブクラスのインスタンスを返すことへの対応：今後は float 自体のインスタンスを返すことが必須になります。

  • __complex__() メソッドが complex の厳密なサブクラスのインスタンスを返すことへの対応：今後は complex 自体のインスタンスを返すことが必須になります。

  • complex() コンストラクターの real 引数や imag 引数に複素数を渡すことは非推奨になりました。 複素数は単独の位置引数としてのみ渡してください。 (Serhiy Storchaka が gh-109218 で貢献しました。)

• calendar：定数 calendar.January と calendar.February は非推奨となり、calendar.JANUARY と calendar.FEBRUARY に置き換えられました。 (Prince Roshan が gh-103636 で貢献しました。)

• codecs：codecs.open() の代わりに open() を使ってください。 (gh-133038)

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

• datetime:

  • utcnow()：datetime.datetime.now(tz=datetime.UTC) を使ってください。

  • utcfromtimestamp()：datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC) を使ってください。

• gettext：複数形を選択するための値は整数でなければなりません。

• importlib:

  • cache_from_source() の debug_override パラメータは非推奨です。 代わりに optimization パラメータを使ってください。

• importlib.metadata:

  • EntryPoints のタプルインターフェース。

  • 戻り値として暗黙的に None を返すこと。

• logging：warn() メソッドは Python 3.3 から非推奨です。 代わりに warning() を使ってください。

• mailbox：StringIO による入力とテキストモードの使用は非推奨です。 代わりに BytesIO とバイナリモードを使ってください。

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

• pydoc.ErrorDuringImport：exc_info パラメータにタプルを渡すことは非推奨です。 例外インスタンスを使ってください。

• re：正規表現内の番号によるグループ参照とグループ名に、より厳しい規則が適用されるようになりました。 番号による参照には ASCII の数字の並びだけを使えます。 bytes パターンと置換文字列のグループ名には、ASCII の英字、数字、アンダースコアだけを使えます。 (Serhiy Storchaka が gh-91760 で貢献しました。)

• sre_compile, sre_constants and sre_parse modules.

• shutil：rmtree() の onerror パラメータは Python 3.12 で非推奨になりました。 代わりに onexc パラメータを使ってください。

• ssl のオプションとプロトコル：

  • プロトコル引数を指定せずに ssl.SSLContext を作成することは非推奨です。

  • ssl.SSLContext：set_npn_protocols() と selected_npn_protocol() は非推奨です。 代わりに ALPN を使ってください。

  • ssl.OP_NO_SSL* オプション

  • 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

• threading のメソッド：

  • threading.Condition.notifyAll()：notify_all() を使ってください。

  • threading.Event.isSet()：is_set() を使ってください。

  • threading.Thread.isDaemon()、threading.Thread.setDaemon()：threading.Thread.daemon 属性を使ってください。

  • threading.Thread.getName()、threading.Thread.setName()：threading.Thread.name 属性を使ってください。

  • threading.currentThread()：threading.current_thread() を使ってください。

  • threading.activeCount()：threading.active_count() を使ってください。

• typing.Text (gh-92332).

• 内部クラス typing._UnionGenericAlias は、typing.Union の実装には使われなくなりました。 この非公開クラスを使っているユーザーとの互換性を保つため、少なくとも Python 3.17 までは互換性を維持するための実装が提供されます。 (Jelle Zijlstra が gh-105499 で貢献しました。)

• unittest.IsolatedAsyncioTestCase：テストケースから None 以外の値を返すことは非推奨です。

• urllib.parse の非推奨の関数：代わりに urlparse() を使ってください。

  • splitattr()

  • splithost()

  • splitnport()

  • splitpasswd()

  • splitport()

  • splitquery()

  • splittag()

  • splittype()

  • splituser()

  • splitvalue()

  • to_bytes()

• wsgiref：SimpleHandler.stdout.write() は、渡されたデータの一部だけを書き込んで終了してはいけません。

• xml.etree.ElementTree：Element の真偽値を調べることは非推奨です。 将来のリリースでは、常に True を返すようになります。 代わりに len(elem) や elem is not None を使って明示的に判定してください。

• sys._clear_type_cache() は非推奨です。 代わりに sys._clear_internal_caches() を使ってください。

C API の非推奨事項

Python 3.15 で削除予定

• The PyImport_ImportModuleNoBlock(): Use PyImport_ImportModule() instead.

• PyWeakref_GetObject() and PyWeakref_GET_OBJECT(): Use PyWeakref_GetRef() instead. The pythoncapi-compat project can be used to get PyWeakref_GetRef() on Python 3.12 and older.

• Py_UNICODE type and the Py_UNICODE_WIDE macro: Use wchar_t instead.

• PyUnicode_AsDecodedObject()：代わりに PyCodec_Decode() を使ってください。

• PyUnicode_AsDecodedUnicode()：代わりに PyCodec_Decode() を使ってください。 一部のコーデック (例えば "base64") は、bytes など str 以外の型を返す場合があることに注意してください。

• PyUnicode_AsEncodedObject()：代わりに PyCodec_Encode() を使ってください。

• PyUnicode_AsEncodedUnicode(): Use PyCodec_Encode() instead; Note that some codecs (for example, "base64") may return a type other than bytes, such as str.

• Python 3.13 で非推奨となった Python 初期化関数：

  • Py_GetPath(): Use PyConfig_Get("module_search_paths") (sys.path) instead.

  • Py_GetPrefix(): Use PyConfig_Get("base_prefix") (sys.base_prefix) instead. Use PyConfig_Get("prefix") (sys.prefix) if virtual environments need to be handled.

  • Py_GetExecPrefix(): Use PyConfig_Get("base_exec_prefix") (sys.base_exec_prefix) instead. Use PyConfig_Get("exec_prefix") (sys.exec_prefix) if virtual environments need to be handled.

  • Py_GetProgramFullPath(): Use PyConfig_Get("executable") (sys.executable) instead.

  • Py_GetProgramName(): Use PyConfig_Get("executable") (sys.executable) instead.

  • Py_GetPythonHome(): Use PyConfig_Get("home") or the PYTHONHOME environment variable instead.

  pythoncapi-compat プロジェクト を使うと、Python 3.13 以前でも PyConfig_Get() を利用できます。

• Python 3.11 で非推奨となった、Python の初期化を設定する関数：

  • PySys_SetArgvEx()：代わりに PyConfig.argv を設定してください。

  • PySys_SetArgv()：代わりに PyConfig.argv を設定してください。

  • Py_SetProgramName()：代わりに PyConfig.program_name を設定してください。

  • Py_SetPythonHome()：代わりに PyConfig.home を設定してください。

  • PySys_ResetWarnOptions(): Clear sys.warnoptions and warnings.filters instead.

  代わりに PyConfig と Py_InitializeFromConfig() API を使ってください。

• グローバルな設定変数：

  • Py_DebugFlag：代わりに PyConfig.parser_debug または PyConfig_Get("parser_debug") を使ってください。

  • Py_VerboseFlag：代わりに PyConfig.verbose または PyConfig_Get("verbose") を使ってください。

  • Py_QuietFlag：代わりに PyConfig.quiet または PyConfig_Get("quiet") を使ってください。

  • Py_InteractiveFlag：代わりに PyConfig.interactive または PyConfig_Get("interactive") を使ってください。

  • Py_InspectFlag：代わりに PyConfig.inspect または PyConfig_Get("inspect") を使ってください。

  • Py_OptimizeFlag：代わりに PyConfig.optimization_level または PyConfig_Get("optimization_level") を使ってください。

  • Py_NoSiteFlag：代わりに PyConfig.site_import または PyConfig_Get("site_import") を使ってください。

  • Py_BytesWarningFlag：代わりに PyConfig.bytes_warning または PyConfig_Get("bytes_warning") を使ってください。

  • Py_FrozenFlag：代わりに PyConfig.pathconfig_warnings または PyConfig_Get("pathconfig_warnings") を使ってください。

  • Py_IgnoreEnvironmentFlag：代わりに PyConfig.use_environment または PyConfig_Get("use_environment") を使ってください。

  • Py_DontWriteBytecodeFlag：代わりに PyConfig.write_bytecode または PyConfig_Get("write_bytecode") を使ってください。

  • Py_NoUserSiteDirectory：代わりに PyConfig.user_site_directory または PyConfig_Get("user_site_directory") を使ってください。

  • Py_UnbufferedStdioFlag：代わりに PyConfig.buffered_stdio または PyConfig_Get("buffered_stdio") を使ってください。

  • Py_HashRandomizationFlag：代わりに PyConfig.use_hash_seed と PyConfig.hash_seed または PyConfig_Get("hash_seed") を使ってください。

  • Py_IsolatedFlag：代わりに PyConfig.isolated または PyConfig_Get("isolated") を使ってください。

  • Py_LegacyWindowsFSEncodingFlag：代わりに PyPreConfig.legacy_windows_fs_encoding または PyConfig_Get("legacy_windows_fs_encoding") を使ってください。

  • Py_LegacyWindowsStdioFlag：代わりに PyConfig.legacy_windows_stdio または PyConfig_Get("legacy_windows_stdio") を使ってください。

  • Py_FileSystemDefaultEncoding、Py_HasFileSystemDefaultEncoding：代わりに PyConfig.filesystem_encoding または PyConfig_Get("filesystem_encoding") を使ってください。

  • Py_FileSystemDefaultEncodeErrors：代わりに PyConfig.filesystem_errors または PyConfig_Get("filesystem_errors") を使ってください。

  • Py_UTF8Mode：代わりに PyPreConfig.utf8_mode または PyConfig_Get("utf8_mode") を使ってください。 (Py_PreInitialize() を参照)

  これらのオプションを設定するには、PyConfig と Py_InitializeFromConfig() API を使ってください。 実行時に値を取得するには PyConfig_Get() を使えます。

Python 3.18 で削除予定

• 以下の非公開関数は非推奨となり、Python 3.18 で削除予定です：

  • _PyBytes_Join()：PyBytes_Join() を使ってください。

  • _PyDict_GetItemStringWithError()：PyDict_GetItemStringRef() を使ってください。

  • _PyDict_Pop()：PyDict_Pop() を使ってください。

  • _PyLong_Sign()：PyLong_GetSign() を使ってください。

  • _PyLong_FromDigits() と _PyLong_New()：PyLongWriter_Create() を使ってください。

  • _PyThreadState_UncheckedGet()：PyThreadState_GetUnchecked() を使ってください。

  • _PyUnicode_AsString()：PyUnicode_AsUTF8() を使ってください。

  • _PyUnicodeWriter_Init()：_PyUnicodeWriter_Init(&writer) を writer = PyUnicodeWriter_Create(0) に置き換えてください。

  • _PyUnicodeWriter_Finish()：_PyUnicodeWriter_Finish(&writer) を PyUnicodeWriter_Finish(writer) に置き換えてください。

  • _PyUnicodeWriter_Dealloc()：_PyUnicodeWriter_Dealloc(&writer) を PyUnicodeWriter_Discard(writer) に置き換えてください。

  • _PyUnicodeWriter_WriteChar()：_PyUnicodeWriter_WriteChar(&writer, ch) を PyUnicodeWriter_WriteChar(writer, ch) に置き換えてください。

  • _PyUnicodeWriter_WriteStr()：_PyUnicodeWriter_WriteStr(&writer, str) を PyUnicodeWriter_WriteStr(writer, str) に置き換えてください。

  • _PyUnicodeWriter_WriteSubstring()：_PyUnicodeWriter_WriteSubstring(&writer, str, start, end) を PyUnicodeWriter_WriteSubstring(writer, str, start, end) に置き換えてください。

  • _PyUnicodeWriter_WriteASCIIString(): replace _PyUnicodeWriter_WriteASCIIString(&writer, str, size) with PyUnicodeWriter_WriteASCII(writer, str, size).

  • _PyUnicodeWriter_WriteLatin1String(): replace _PyUnicodeWriter_WriteLatin1String(&writer, str, size) by decoding the string with PyUnicode_DecodeLatin1(), writing the result with PyUnicodeWriter_WriteStr(), and releasing the result with Py_DECREF().

  • _PyUnicodeWriter_Prepare()：(代替なし)。

  • _PyUnicodeWriter_PrepareKind()：(代替なし)。

  • _Py_HashPointer()：Py_HashPointer() を使ってください。

  • _Py_fopen_obj()：Py_fopen() を使ってください。

  pythoncapi-compat プロジェクト を使うと、Python 3.13 以前でもこれらの新しい公開関数を利用できます。 (Victor Stinner が gh-128863 で貢献しました。)

将来のバージョンで削除予定

以下の API は非推奨となり、削除される予定ですが、現時点では削除時期は決まっていません。

• Py_TPFLAGS_HAVE_FINALIZE：Python 3.8 以降では不要です。

• PyErr_Fetch()：代わりに PyErr_GetRaisedException() を使ってください。

• PyErr_NormalizeException()：代わりに PyErr_GetRaisedException() を使ってください。

• PyErr_Restore()：代わりに PyErr_SetRaisedException() を使ってください。

• PyModule_GetFilename()：代わりに PyModule_GetFilenameObject() を使ってください。

• PyOS_AfterFork()：代わりに PyOS_AfterFork_Child() を使ってください。

• PySlice_GetIndicesEx()：代わりに PySlice_Unpack() と PySlice_AdjustIndices() を使ってください。

• PyUnicode_READY()：Python 3.12 以降では不要です。

• PyErr_Display()：代わりに PyErr_DisplayException() を使ってください。

• _PyErr_ChainExceptions()：代わりに _PyErr_ChainExceptions1() を使ってください。

• PyBytesObject.ob_shash メンバー：代わりに PyObject_Hash() を呼び出してください。

• スレッドローカルストレージ (TLS) API：

  • PyThread_create_key(): Use PyThread_tss_alloc() instead.

  • PyThread_delete_key()：代わりに PyThread_tss_free() を使ってください。

  • PyThread_set_key_value()：代わりに PyThread_tss_set() を使ってください。

  • PyThread_get_key_value()：代わりに PyThread_tss_get() を使ってください。

  • PyThread_delete_key_value(): Use PyThread_tss_delete() instead.

  • PyThread_ReInitTLS()：Python 3.7 以降では不要です。