背景：
当前python社区的各个分支状态如下，3.7和3.8分支均为稳定版本，其中3.9还未发布正式版本，3.8分支基于3.7合入了较多的新特性和bugfix。
目标：
升级openeuler python3开源软件，准备从3.7.4版本更新到3.8.3稳定版本，两个版本间存在较多差异，需要适配的变更点罗列如下，具体详见附件，后期若有疑问请在该邮件中回复讨论。
|
差异描述 |
差异类型 |
差异引入原因 |
差异引入版本 |
影响分析 |
是否需要适配 |
适配方案 |
|
在函数调用中允许使用的关键字名称语法受到进一步的限制。 特别地，f((keyword)=arg) 不再被允许。 关键字参数赋值形式的左侧绝不允许一般标识符以外的其他内容 |
修改 |
bugfix |
3.8 |
f((keyword)=arg) 不再被允许 |
Y |
使用者适配该变更 |
|
当类似 [(10, 20) (30, 40)]
这样在代码中少了一个逗号时，编译器将显示 SyntaxWarning 并附带更有帮助的提示。 这相比原来用 TypeError
来提示第一个元组是不可调用的更容易被理解 |
修改 |
DFX增强 |
3.8 |
当类似 [(10, 20) (30, 40)]
这样在代码中少了一个逗号时，编译器将从原来的TypeError变为显示 SyntaxWarning |
Y |
使用者适配该变更 |
|
datetime.date 或 datetime.datetime 和 datetime.timedelta 对象之间的算术运算现在将返回相应子类的实例而不是基类的实例 |
修改 |
bugfix |
3.8 |
datetime.date 或 datetime.datetime 和 datetime.timedelta 对象之间的算术运算现在将返回相应子类的实例而不是基类的实例 |
Y |
使用者适配该变更 |
|
字典推导式已与字典字面值实现同步，会先计算键再计算值 |
修改 |
bugfix |
3.8 |
字典推导式已与字典字面值实现同步，会先计算键再计算值 |
Y |
使用者适配该变更 |
|
异常 asyncio.CancelledError
现在继承自 BaseException 而不是 Exception |
修改 |
DFX增强 |
3.8 |
异常 asyncio.CancelledError
现在继承自 BaseException 而不是 Exception |
Y |
使用者适配该变更 |
|
collections.namedtuple()
的 _asdict()
方法现在将返回 dict 而不是 collections.OrderedDict。 |
修改 |
bugfix |
3.8 |
collections.namedtuple()
的 _asdict()
方法现在将返回 dict 而不是 collections.OrderedDict。 |
Y |
使用者适配该变更 |
|
csv.DictReader
现在将返回 dict
而不是 collections.OrderedDict |
修改 |
bugfix |
3.8 |
csv.DictReader
现在将返回 dict
而不是 collections.OrderedDict |
Y |
使用者适配该变更 |
|
对于特定类型的无效或已损坏 gzip
文件现在将引发 BadGzipFile 而不是 OSError |
修改 |
DFX增强 |
3.8 |
对于特定类型的无效或已损坏 gzip
文件现在将引发 BadGzipFile 而不是 OSError |
Y |
使用者适配该变更 |
|
函数 math.factorial()
不再接受非整数类参数 |
修改 |
bugfix |
3.8 |
函数 math.factorial()
不再接受非整数类参数 |
Y |
使用者适配该变更 |
|
返回布尔值结果的 os.path
函数例如 exists(), lexists(), isdir(), isfile(), islink(),
以及 ismount() 现在对于包含在 OS 层级无法表示的字符或字节的路径将会返回 False
而不是引发 ValueError 或其子类 UnicodeEncodeError
和 UnicodeDecodeError。 |
修改 |
DFX增强 |
3.8 |
返回布尔值结果的 os.path
函数在对于包含在 OS 层级无法表示的字符或字节的路径将会返回 False
而不是引发 ValueError 或其子类 UnicodeEncodeError
和 UnicodeDecodeError。 |
Y |
使用者适配该变更 |
|
返回布尔值结果的 pathlib.Path
方法例如 exists(), is_dir(), is_file(), is_mount(), is_symlink(), is_block_device(), is_char_device(), is_fifo(), is_socket()
现在对于包含在 OS 层级无法表示的字符或字节的路径将会返回 False
而不是引发 ValueError 或其子类 UnicodeEncodeError |
修改 |
DFX增强 |
3.8 |
返回布尔值结果的 pathlib.Path
方法在对于包含在 OS 层级无法表示的字符或字节的路径将会返回 False
而不是引发 ValueError 或其子类 UnicodeEncodeError |
Y |
使用者适配该变更 |
|
shutil.make_archive()
现在对于通过 format="tar"
创建的归档文件将使用新式的 pax (POSIX.1-2001) 格式而非旧式的 GNU
格式 |
修改 |
bugfix |
3.8 |
shutil.make_archive()
现在对于通过 format="tar"
创建的归档文件将使用新式的 pax (POSIX.1-2001) 格式而非旧式的 GNU
格式 |
Y |
使用者适配该变更 |
|
tarfile
模块现在对新的归档默认使用 modern pax (POSIX.1-2001)
格式而不再是之前的 GNU 专属格式 |
修改 |
bugfix |
3.8 |
tarfile
模块现在对新的归档默认使用 modern pax (POSIX.1-2001)
格式而不再是之前的 GNU 专属格式 |
Y |
使用者适配该变更 |
|
作为对 DTD
和外部实体检索的缓解，在默认情况下 xml.dom.minidom 和 xml.sax
模块不再处理外部实体 |
修改 |
bugfix |
3.8 |
作为对 DTD
和外部实体检索的缓解，在默认情况下 xml.dom.minidom 和 xml.sax
模块不再处理外部实体 |
Y |
使用者适配该变更 |
|
只会安装 python3.8
程序，不再有 python3.8m 程序 |
修改 |
bugfix |
3.8 |
m
已经从动态库文件名后缀中移除：包括标准库中的扩展模块以及第三方包所产生和安装的模块 |
Y |
spec文件中需要修改 |
|
重新组织了所有头文件以更好地区分不同种类的 API： |
修改 |
bugfix |
3.8 |
Include/internal/*.h
应为 CPython
特别专属的私有内部 C API。 此 API
不具备向下兼容保证并且不应在 CPython 以外被使用 |
Y |
使用者适配该变更 |
|
distutils
的 bdist_wininst
命令现在已弃用，请改用 bdist_wheel (wheel 包) |
修改 |
bugfix |
3.8 |
distutils
的 bdist_wininst
命令现在已弃用，请改用 bdist_wheel (wheel 包) |
Y |
使用者适配该变更 |
|
ElementTree
模块中的已弃用方法 getchildren()
和 getiterator() 现在会引发 DeprecationWarning
而不是 PendingDeprecationWarning |
修改 |
DFX增强 |
3.8 |
ElementTree
模块中的已弃用方法 getchildren()
和 getiterator() 现在会引发 DeprecationWarning
而不是 PendingDeprecationWarning |
Y |
使用者适配该变更 |
|
将不是 concurrent.futures.ThreadPoolExecutor
的实例的对象传给 loop.set_default_executor() 已被弃用 |
修改 |
bugfix |
3.8 |
将不是 concurrent.futures.ThreadPoolExecutor
的实例的对象传给 loop.set_default_executor() 已被弃用 |
Y |
使用者适配该变更 |
|
xml.dom.pulldom.DOMEventStream, wsgiref.util.FileWrapper
和 fileinput.FileInput
的 __getitem__() 方法已被弃用 |
修改 |
bugfix |
3.8 |
xml.dom.pulldom.DOMEventStream, wsgiref.util.FileWrapper
和 fileinput.FileInput
的 __getitem__() 方法已被弃用 |
Y |
使用者适配该变更 |
|
typing.NamedTuple
类已弃用了 _field_types
属性而改用具有同样信息的 __annotations__ 属性 |
修改 |
bugfix |
3.8 |
typing.NamedTuple
类已弃用了 _field_types
属性而改用具有同样信息的 __annotations__ 属性 |
Y |
使用者适配该变更 |
|
ast
类 Num, Str, Bytes, NameConstant
和 Ellipsis 被视为已弃用，应当改用 Constant |
修改 |
bugfix |
3.8 |
ast
类 Num, Str, Bytes, NameConstant
和 Ellipsis 被视为已弃用，应当改用 Constant |
Y |
使用者适配该变更 |
|
ast.NodeVisitor
的方法 visit_Num(), visit_Str(), visit_Bytes(), visit_NameConstant()
和 visit_Ellipsis() 现在已被弃用，添加 visit_Constant()
方法来处理所有常量节点 |
修改 |
bugfix |
3.8 |
ast.NodeVisitor
的方法 visit_Num(), visit_Str(), visit_Bytes(), visit_NameConstant()
和 visit_Ellipsis() 现在已被弃用，添加 visit_Constant()
方法来处理所有常量节点 |
Y |
使用者适配该变更 |
|
asyncio.coroutine() decorator
已弃用，原有的 @asyncio.coroutine
请改用 async def 来替代 |
修改 |
bugfix |
3.8 |
asyncio.coroutine() decorator
已弃用，原有的 @asyncio.coroutine
请改用 async def 来替代 |
Y |
使用者适配该变更 |
|
在 asyncio
中，loop 参数的显式传递已被弃用 |
修改 |
bugfix |
3.8 |
在 asyncio
中，loop 参数的显式传递已被弃用 |
Y |
使用者适配该变更 |
|
将协程对象显式传递给 asyncio.wait()
的做法已被弃用 |
修改 |
bugfix |
3.8 |
将协程对象显式传递给 asyncio.wait()
的做法已被弃用 |
Y |
使用者适配该变更 |
|
gettext
模块中的下列函数和方法已被弃用: lgettext(), ldgettext(), lngettext()
和 ldngettext() |
修改 |
bugfix |
3.8 |
gettext
模块中的下列函数和方法已被弃用: lgettext(), ldgettext(), lngettext()
和 ldngettext() |
Y |
使用者适配该变更 |
|
函数 bind_textdomain_codeset()，方法 output_charset()
和 set_output_charset()，以及函数 translation()
和 install() 的 codeset
形参也被弃用 |
修改 |
bugfix |
3.8 |
函数 bind_textdomain_codeset()，方法 output_charset()
和 set_output_charset()，以及函数 translation()
和 install() 的 codeset
形参也被弃用 |
Y |
使用者适配该变更 |
|
threading.Thread
的 isAlive()
方法已弃用 |
修改 |
bugfix |
3.8 |
threading.Thread
的 isAlive()
方法已弃用 |
Y |
使用者适配该变更 |
|
macpath
模块，在 Python 3.7
中弃用，现已被移除 |
修改 |
bugfix |
3.8 |
macpath
模块，在 Python 3.7
中弃用，现已被移除 |
Y |
使用者适配该变更 |
|
函数 platform.popen()
已被移除，它自 Python 3.3 起就已被弃用：请改用 os.popen() |
修改 |
bugfix |
3.8 |
函数 platform.popen()
已被移除，它自 Python 3.3 起就已被弃用：请改用 os.popen() |
Y |
使用者适配该变更 |
|
函数 time.clock()
已被移除，它自 Python 3.3 起就已被弃用：请根据具体需求改用 time.perf_counter()
或 time.process_time() 以获得具有良好定义的行为 |
修改 |
bugfix |
3.8 |
函数 time.clock()
已被移除，它自 Python 3.3 起就已被弃用：请根据具体需求改用 time.perf_counter()
或 time.process_time() 以获得具有良好定义的行为 |
Y |
使用者适配该变更 |
|
pyvenv
脚本已被移除，推荐改用 python3.8 -m venv
来帮助消除容易混淆 pyvenv 脚本所关联的 Python
解释器这一问题 |
修改 |
bugfix |
3.8 |
pyvenv
脚本已被移除，推荐改用 python3.8 -m venv
来帮助消除容易混淆 pyvenv 脚本所关联的 Python
解释器这一问题 |
Y |
spec文件中需要修改 |
|
parse_qs, parse_qsl
和 escape
已从 cgi 模块中被移除。 这些函数自 Python 3.2
或更早就已被弃用。 它们应改为从 urllib.parse 和 html
模块导入 |
修改 |
bugfix |
3.8 |
parse_qs, parse_qsl
和 escape
已从 cgi 模块中被移除。 这些函数自 Python 3.2
或更早就已被弃用。 它们应改为从 urllib.parse 和 html
模块导入 |
Y |
使用者适配该变更 |
|
filemode
函数已从 tarfile
模块中被移除 |
修改 |
bugfix |
3.8 |
filemode
函数已从 tarfile
模块中被移除 |
Y |
使用者适配该变更 |
|
XMLParser
构造器不再接受 html
参数 |
修改 |
bugfix |
3.8 |
XMLParser
构造器不再接受 html
参数 |
Y |
使用者适配该变更 |
|
XMLParser
的 doctype()
方法已被移除 |
修改 |
bugfix |
3.8 |
XMLParser
的 doctype()
方法已被移除 |
Y |
使用者适配该变更 |
|
"unicode_internal"
编解码器已被移除 |
修改 |
bugfix |
3.8 |
"unicode_internal"
编解码器已被移除 |
Y |
使用者适配该变更 |
|
sqlite3
模块的 Cache
和 Statement 对象已不再公开给用户 |
修改 |
bugfix |
3.8 |
sqlite3
模块的 Cache
和 Statement 对象已不再公开给用户 |
Y |
使用者适配该变更 |
|
fileinput.input()
和 fileinput.FileInput()
中自 Python 3.6 起就已被忽略并弃用的 bufsize
关键字参数已被移除 |
修改 |
bugfix |
3.8 |
fileinput.input()
和 fileinput.FileInput()
中自 Python 3.6 起就已被忽略并弃用的 bufsize
关键字参数已被移除 |
Y |
使用者适配该变更 |
|
在 Python 3.7
中弃用的函数 sys.set_coroutine_wrapper() 和 sys.get_coroutine_wrapper()
已被移除 |
修改 |
bugfix |
3.8 |
在 Python 3.7
中弃用的函数 sys.set_coroutine_wrapper() 和 sys.get_coroutine_wrapper()
已被移除 |
Y |
使用者适配该变更 |
|
yield
表达式（包括 yield
和 yield from 子句）现在不允许在推导式和生成器表达式中使用（但 for
子句最左边的可迭代对象表达式除外） |
修改 |
bugfix |
3.8 |
yield
表达式（包括 yield
和 yield from 子句）现在不允许在推导式和生成器表达式中使用（但 for
子句最左边的可迭代对象表达式除外） |
Y |
使用者适配该变更 |
|
当标识号检测 (is
和 is not) 与特定类型的字面值 (例如字符串和数字)
一同使用时编译器现在会产生 SyntaxWarning。 该警告会建议用户改用相等性检测 (== and !=) |
修改 |
bugfix |
3.8 |
当标识号检测 (is
和 is not) 与特定类型的字面值 (例如字符串和数字)
一同使用时编译器现在会产生 SyntaxWarning。 该警告会建议用户改用相等性检测 (== and !=) |
Y |
使用者适配该变更 |
|
从内置类型 bool, int, float, complex
和标准库的一些类中移除了 __str__ 实现。 它们现在会从 object
继承 __str__()。 作为结果，在这些类的子类中定义 __repr__()
方法将会影响它们的字符串表示 |
修改 |
bugfix |
3.8 |
从内置类型 bool, int, float, complex
和标准库的一些类中移除了 __str__ 实现。 它们现在会从 object
继承 __str__()。 作为结果，在这些类的子类中定义 __repr__()
方法将会影响它们的字符串表示 |
Y |
使用者适配该变更 |
|
subprocess.Popen的preexec_fn参数不再与子解释器兼容。在子解释器中使用该参数会引起RuntimeError |
修改 |
bugfix |
3.8 |
subprocess.Popen的preexec_fn参数不再与子解释器兼容。在子解释器中使用该参数会引起RuntimeError |
Y |
使用者适配该变更 |
|
当传入多模数据时 statistics.mode()
函数不会再引发异常 |
修改 |
bugfix |
3.8 |
当传入多模数据时 statistics.mode()
函数不会再引发异常 |
Y |
使用者适配该变更 |
|
tkinter.ttk.Treeview
类的 selection()
方法不再接受参数。 带参数调用该方法来改变选择在 Python 3.6 中已弃用。 请使用专门方法例如 selection_set()
来改变选择 |
修改 |
bugfix |
3.8 |
tkinter.ttk.Treeview
类的 selection()
方法不再接受参数。 带参数调用该方法来改变选择在 Python 3.6 中已弃用。 请使用专门方法例如 selection_set()
来改变选择 |
Y |
使用者适配该变更 |
|
附带 'r'
旗标打开的 dbm.dumb 数据库现在将是只读的。 如果数据库不存在，附带 'r'
和 'w' 旗标的 dbm.dumb.open()
不会再创建数据库 |
修改 |
bugfix |
3.8 |
附带 'r'
旗标打开的 dbm.dumb 数据库现在将是只读的。 如果数据库不存在，附带 'r'
和 'w' 旗标的 dbm.dumb.open()
不会再创建数据库 |
Y |
使用者适配该变更 |
|
现在当自定义元类未在传给 type.__new__
的命名空间中提供 __classcell__ 入口时将引发 RuntimeError。 在 Python 3.6--3.7
中是则是引发 DeprecationWarning |
修改 |
DFX增强 |
3.8 |
现在当自定义元类未在传给 type.__new__
的命名空间中提供 __classcell__ 入口时将引发 RuntimeError。 在 Python 3.6--3.7
中是则是引发 DeprecationWarning |
Y |
使用者适配该变更 |
|
现在所有平台下的 mmap.flush()
方法都会在成功时返回 None 并在错误时引发异常。 之前 Unix
下会在成功时返回零；在失败时引发错误。 |
修改 |
bugfix |
3.8 |
现在所有平台下的
mmap.flush() 方法都会在成功时返回 None
并在错误时引发异常。 之前 Unix 下会在成功时返回零；在失败时引发错误。
|
Y |
使用者适配该变更 |
|
从只读的 dbm
数据库 (dbm.dumb, dbm.gnu 或 dbm.ndbm)
删除键将会引发 error (dbm.dumb.error, dbm.gnu.error 或 dbm.ndbm.error)
而不是 KeyError |
修改 |
DFX增强 |
3.8 |
从只读的 dbm
数据库 (dbm.dumb, dbm.gnu 或 dbm.ndbm)
删除键将会引发 error (dbm.dumb.error, dbm.gnu.error 或 dbm.ndbm.error)
而不是 KeyError |
Y |
使用者适配该变更 |
|
当将 'socket'
作为 name 形参传入时，函数 asyncio.BaseTransport.get_extra_info()
现在会返回一个可安全使用的套接字对象 |
修改 |
bugfix |
3.8 |
当将 'socket'
作为 name 形参传入时，函数 asyncio.BaseTransport.get_extra_info()
现在会返回一个可安全使用的套接字对象 |
Y |
使用者适配该变更 |
|
PyEval_ReInitThreads()
函数已从 C API
中移除。 它不应当被显式地调用；请改用 PyOS_AfterFork_Child() |
修改 |
bugfix |
3.8 |
PyEval_ReInitThreads()
函数已从 C API
中移除。 它不应当被显式地调用；请改用 PyOS_AfterFork_Child() |
Y |
使用者适配该变更 |
|
在 Unix
上，C 扩展不会再被链接到 libpython,
当 Python 被嵌入时，libpython 不可使用 RTLD_LOCAL
加载，而要改用 RTLD_GLOBAL。 |
修改 |
bugfix |
3.8 |
在 Unix
上，C 扩展不会再被链接到 libpython,
当 Python 被嵌入时，libpython 不可使用 RTLD_LOCAL
加载，而要改用 RTLD_GLOBAL。 |
Y |
使用者适配该变更 |
|
移除了操作码 BREAK_LOOP, CONTINUE_LOOP, SETUP_LOOP
和 SETUP_EXCEPT。 添加了新的操作码 ROT_FOUR, BEGIN_FINALLY, CALL_FINALLY
和 POP_FINALLY。 修改了 END_FINALLY
和 WITH_CLEANUP_START 的行为 |
修改 |
bugfix |
3.8 |
移除了操作码 BREAK_LOOP, CONTINUE_LOOP, SETUP_LOOP
和 SETUP_EXCEPT。 添加了新的操作码 ROT_FOUR, BEGIN_FINALLY, CALL_FINALLY
和 POP_FINALLY。 修改了 END_FINALLY
和 WITH_CLEANUP_START 的行为 |
Y |
使用者适配该变更 |
|
platform.dist()和linux_distribution()已经被删除 |
修改 |
bugfix |
3.8 |
platform.dist()和linux_distribution()已经被删除 |
Y |
使用者适配该变更 |