PyMuPDF 1.24.4 中文文档（十四）

原文：https://pymupdf.readthedocs.io/en/latest/

废弃名称

原文：pymupdf.readthedocs.io/en/latest/znames.html

方法和属性的原始命名约定是“驼峰命名法”。自 2013 年左右创建以来，PyMuPDF 的功能大幅增加，对应地增加了类、方法和属性。在许多情况下，这导致了不直观、不合逻辑和难看的名称，难以记忆或猜测。

几个版本之前，我因此决定转变方向，改用“蛇形命名法”标准。这是一项重大工作，需要逐步进行。我认为现在已经完成了（版本 1.18.14）。

以下列表将废弃的名称映射到它们的新版本。例如，属性pageCount在 Document 类中变为page_count。还有一些不那么明显的名称变更，例如方法getPNGdata在 Pixmap 类中被重命名为tobytes。

类的名称（驼峰命名法）和包范围的常量（大多数是大写）保持不变。

旧名称将保持为废弃的别名，直到 MuPDF 版本 1.19.0，并在随后的版本中被删除 - 可能是版本 1.20.0，但这取决于上游决策（MuPDF）。

从版本 1.19.0 开始，当使用别名方法时，我们将在sys.stderr上发出废弃警告，例如Deprecation: 'newPage' removed from class 'Document' after v1.19.0 - use 'new_page'。使用废弃的属性将不会引发此类型的警告。

从现在开始，所有废弃对象（方法和属性）将显示原始文档字符串的副本，并附带废弃消息，例如：

>>> print(pymupdf.Document.pageCount.__doc__)
*** Deprecated and removed in version following 1.19.0 - use 'page_count'. ***
Number of pages.
>>> print(pymupdf.Document.newPage.__doc__)
*** Deprecated and removed in version following 1.19.0 - use 'new_page'. ***
Create and return a new page object.

 Args:
 pno: (int) insert before this page. Default: after last page.
 width: (float) page width in points. Default: 595 (ISO A4 width).
 height: (float) page height in points. Default 842 (ISO A4 height).
 Returns:
 A Page object. 

有一个实用程序脚本alias-changer.py可用于在您的脚本中进行批量重命名。它接受单个文件或文件夹作为参数。如果提供了一个文件夹，则会更改其所有 Python 文件及其子文件夹中的文件。可以选择备份脚本。

对此页面有任何反馈吗？

本软件按原样提供，不附带任何明示或暗示的担保。本软件根据许可证分发，除非根据该许可证的条款明确授权，否则不得复制、修改或分发。有关更多信息，请参阅artifex.com的许可信息，或联系 Artifex Software Inc.，39 Mesa Street，Suite 108A，San Francisco CA 94129，美国。

本文档覆盖了所有版本直到 1.24.4。