bowler 0.9.0

为现代Python项目提供安全代码重构。

概述

Bowler是一个在语法树级别操作Python的重构工具。它允许进行安全的、大规模的代码修改，同时保证生成的代码可以编译和运行。它提供了简单的命令行界面和Python中的流畅API，以生成复杂的代码修改。

Bowler使用“流畅”的Query API通过一系列选择器、过滤器修改器构建重构脚本。许多简单的修改已经可以使用现有的API实现，但您也可以根据需要提供自定义选择器、过滤器修改器，以构建更复杂或定制的重构。请参阅查询参考以获取更多详细信息。

使用查询API重命名单个函数，并从结果中生成交互式diff，看起来可能像这样

query = (
    Query(<paths to modify>)
    .select_function("old_name")
    .rename("new_name")
    .diff(interactive=True)
)

有关更多详情或文档，请访问https://pybowler.io

安装Bowler

Bowler支持对Python 2或3任何版本的代码进行修改，但运行时需要Python 3.6或更高版本。Bowler可以使用大多数常见的Python打包工具轻松安装。我们建议使用pip从PyPI安装最新稳定版本。

pip install bowler

您也可以通过检出Git仓库来从源安装开发版本。

git clone https://github.com/facebookincubator/bowler
cd bowler
python setup.py install

许可协议

Bowler采用MIT许可证，如LICENSE文件所示。