wrangler 的安装和配置教程

项目基础介绍

wrangler 是一个支持交互式重构Erlang程序的开源工具。它可以进行函数、变量和模块的重命名，函数提取和泛化等结构性修改。wrangler 不仅识别代码中的宏，还能在单个文件或整个项目中使用。此外，它还可以用于查找和删除代码克隆，以及改进项目的模块结构。wrangler 是可扩展的，提供了编写新重构操作的API和一个用于编写复杂重构组合的领域特定语言（DSL）。

编程语言

该项目主要使用Erlang语言开发，同时也包含了一些Emacs Lisp和C语言的代码。

关键技术和框架

• Erlang模式：wrangler 集成了Erlang模式，可在Emacs编辑器中使用。
• 交互式重构：提供了多种重构功能，如重命名、提取方法等。
• 代码克隆检测：能够检测和移除重复的代码块。
• API迁移：支持API函数接口变更时的自动迁移。

准备工作

在开始安装wrangler之前，您需要确保您的系统中已经安装了以下依赖项：

1. Erlang/OTP：Erlang编程环境的运行时和库。
2. Emacs：一个功能强大的文本编辑器，用于编辑代码。
3. Git：版本控制系统，用于从GitHub克隆项目。

确保这些工具已经安装并且正确配置之后，您可以继续以下安装步骤。

安装步骤

1. 克隆项目

   打开终端（或命令提示符），然后执行以下命令来克隆wrangler仓库：

   git clone https://github.com/RefactoringTools/wrangler.git
   

   这将在当前目录下创建一个名为wrangler的文件夹，其中包含了所有项目文件。

2. 安装依赖项

   在wrangler目录中，执行以下命令来编译项目：

   make
   

   如果编译成功，wrangler的相关文件将被编译并放置在适当的位置。

3. 配置Emacs

   为了在Emacs中使用wrangler，您需要在Emacs的配置文件中（通常是.emacs或.emacs.d/init.el）添加以下行来加载wrangler：

   (load-file "/path/to/wrangler/elisp/wrangler.el")
   

   替换/path/to/wrangler/elisp/wrangler.el为您系统中wrangler.el文件的实际路径。

4. 启动Wrangler

   在Emacs中打开一个Erlang源文件，然后执行M-x erlang-wrangler-on命令来启动wrangler。您应该会看到一个名为“Wrangler”的新菜单出现在菜单栏中。

5. 使用Wrangler

   现在您可以开始使用wrangler提供的各种重构功能了。根据需要选择相应的菜单项，并按照提示进行操作。

以上就是wrangler的安装和配置指南。按照这些步骤操作后，您应该能够在Emacs中使用wrangler进行Erlang代码的重构。