README

HHAST是处理Hack文件AST的工具包。

抽象语法树可以成为许多工具的强大基础，而不仅仅是编译器和优化；HHAST基于Hack的Full Fidelity Parser（FFP），提供了一种可变AST的Hack对象表示。

与传统AST不同，FFP的AST包括所有'琐碎'内容，例如空白和注释，这使得您可以从AST完全重建文件，或修改AST后创建更新后的文件，保留注释和空白。

HHAST有3个主要API

代码检查器

代码检查器旨在针对主观或风格更改，这些更改不会实质上改变代码的行为，并且可能根据具体情况被拒绝。代码检查错误可以提供建议的修复方案，这可能是基于AST更改的，但不一定必须是。

我们包括了一些代码检查器作为起点，包括

代码检查器既可以交互式使用，也可以无人值守使用。然而，自动修复不支持无人值守，如果存在任何代码检查问题，它将退出非零状态，以便于与CI系统集成。

HHAST由以下支持：

迁移适用于您希望在整个代码库中应用的大范围更改，并且通常更复杂。考虑到这一点，迁移框架内置了对多步迁移的支持（与代码检查器不同）。具有AST意识的迁移可以是强大的工具，用于

请参阅文档。

HHAST是MIT许可证。