一句话：首次实证研究 Python 库 API 弃用，揭示维护者声明与文档不足、用户处理困难。
本文首次对 Python 库已弃用 API 进行探索性实证研究，旨在了解 Python 库中 API 弃用的现状。作者考察六个知名 Python 库如何声明和文档化已弃用 API，并分析 1200 个 GitHub 项目如何应对这些弃用。实验观察表明，库维护者对 API 弃用的处理普遍不佳，导致 Python 开发者难以正确解决对已弃用库 API 的使用。该经验证据呼吁社区立即采取措施，妥善处理 Python 库 API 的弃用问题。
In this paper, we present the first exploratory study of deprecated Python library APIs to understand the status quo of API deprecation in the realm of Python libraries. Specifically, we aim to comprehend how deprecated library APIs are declared and documented in practice by their maintainers, and how library users react to them. By thoroughly looking into six reputed Python libraries and 1,200 GitHub projects, we experimentally observe that API deprecation is poorly handled by library contributors, which subsequently introduce difficulties for Python developers to resolve the usage of deprecated library APIs. This empirical evidence suggests that our community should take immediate actions to appropriately handle the deprecation of Python library APIs.
DOI 原文 ·
@inproceedings{paperbot5711,
title = {Exploring how deprecated Python library APIs are (not) handled},
author = {Jiawei Wang and Li Li and Kui Liu and Haipeng Cai},
booktitle = {FSE},
year = {2020},
doi = {10.1145/3368089.3409735}
}