Qlot 项目使用教程

1. 项目介绍

Qlot（发音为 kyü-'lät，类似于 culotte）是一个使用 Quicklisp 设施的项目本地库安装器。它的目标是类似于 Ruby 的 Bundler 或 Perl 的 Carton。Qlot 解决了以下问题：

• 我们拥有 Quicklisp，这是一个中央库注册表，使得库的安装变得非常容易。
• 然而，你只能指定分发的月份，这意味着你必须使用同一时刻的所有库，无法为你的项目使用较新或较旧版本的库。
• "local-projects/" 或 ASDF 配置可能是解决这个问题的方法，但它们有一些问题：它们不是项目本地的，如果你有多个项目使用不同版本的同一库，这将是一个问题。
• 它们难以固定版本或更新。如果你的项目需要在其他机器上运行，例如在其他人的机器或服务器上，依赖库的版本应该相同。

Qlot 正是为了解决这些问题而设计的。

2. 项目快速启动

安装 Qlot

推荐使用自动安装器进行安装：

$ curl -L https://qlot.tech/installer | sh

初始化项目

在项目根目录下运行以下命令来初始化 Qlot：

$ qlot init

这将创建两个文件 qlfile 和 qlfile.lock，以及一个目录 qlot/。

添加依赖

使用以下命令添加新的依赖库：

$ qlot add <library name>

例如，添加 mito 库：

$ qlot add mito

安装依赖

运行以下命令来安装项目本地的库：

$ qlot install

更新依赖

使用以下命令更新特定库：

$ qlot update mito

运行 REPL

使用以下命令在项目本地的 Quicklisp 环境中运行 REPL：

$ qlot exec sbcl

3. 应用案例和最佳实践

应用案例

Qlot 可以用于以下场景：

• 项目本地库管理：确保每个项目使用特定版本的库，避免版本冲突。
• 持续集成：在 CI/CD 环境中使用 Qlot 确保构建环境的一致性。
• 开发环境：在开发环境中使用 Qlot 确保所有开发者使用相同的库版本。

最佳实践

• 版本控制：确保 qlfile 和 qlfile.lock 文件被添加到版本控制系统中。
• 自动化：在 CI/CD 流程中集成 Qlot，确保每次构建使用相同的库版本。
• 文档化：在项目文档中明确说明使用 Qlot 进行依赖管理。

4. 典型生态项目

Qlot 可以与其他 Common Lisp 生态项目结合使用，例如：

• Roswell：一个 Common Lisp 的安装和管理工具，可以与 Qlot 结合使用。
• Quicklisp：一个 Common Lisp 的库管理器，Qlot 基于 Quicklisp 构建。
• SLIME：一个 Common Lisp 的开发环境，可以使用 Qlot 启动项目本地的 REPL。

通过结合这些工具，可以构建一个完整的 Common Lisp 开发和部署环境。