fukamachi/qlot

Qlot

Qlot（发音为kyü-'lät，类似"culotte"）是一个使用Quicklisp工具的项目本地库安装器。它的目标类似于Ruby的Bundler或Perl的Carton。

警告：此软件仍处于BETA测试阶段。API可能会发生变化。

核心功能与特性

• 项目本地库安装，避免版本冲突
• 精确控制依赖库版本，确保开发环境一致性
• 支持多种库来源：Quicklisp、Git、GitHub、HTTP等
• 类似Bundler的工作流，包括安装、更新和执行命令
• 生成锁定文件(qlfile.lock)确保所有环境使用相同版本

使用场景

当你需要：

• 在多个Common Lisp项目中使用不同版本的同一库
• 确保团队成员或部署环境使用完全相同的依赖版本
• 精确控制项目依赖的版本，而非使用全局Quicklisp发行版
• 在不影响其他项目的情况下管理项目特定依赖

要求

• ASDF 3.2或更高版本

安装方法

通过Quicklisp

common
(ql:quickload :qlot)

通过Roswell

也可以使用https://github.com/roswell/roswell%E5%AE%89%E8%A3%85%EF%BC%9A

bash
# 安装稳定版
$ ros install qlot

# 从GitHub安装最新版本
$ ros install fukamachi/qlot

Roswell安装会提供qlot命令行工具：

bash
$ which qlot
/Users/nitro_idiot/.roswell/bin/qlot

使用方法

基本工作流

1. 创建项目并添加qlfile文件
2. 安装依赖
3. 在项目中使用本地依赖

创建qlfile

在项目根目录创建qlfile文件，声明项目依赖：

# 示例qlfile
git clack https://github.com/fukamachi/clack.git
github datafly fukamachi/datafly :branch v0.7.x
ql log4cl 2014-03-17

安装依赖

bash
$ cd /path/to/myapp

# 项目本地安装库
$ qlot install

这将创建.qlot/目录（包含所有依赖）和qlfile.lock文件（锁定依赖版本）。

更新依赖

bash
# 更新所有依赖
$ qlot update

# 更新特定依赖
$ qlot update --project mito

添加新依赖

bash
# 添加Quicklisp库
$ qlot add mito

# 添加Ultralisp库
$ qlot add ultralisp egao1980-cl-idna

# 添加GitHub库
$ qlot add github datafly fukamachi/datafly

执行命令

使用qlot exec在项目环境中执行命令：

bash
# 启动REPL
$ qlot exec ros -S . run

# 启动Web应用
$ qlot exec clackup app.lisp

# 构建项目
$ qlot exec ros build some-app.ros

qlfile语法详解

qlfile是依赖声明文件，每行代表一个库，格式为：

<source> <project name> [参数...]

支持的源类型

ql (Quicklisp官方库)

ql <project name> [<version>]
ql log4cl 2014-03-17  # 指定版本
ql clack             # 使用最新版本

ultralisp (Ultralisp库)

ultralisp <project name> [<version>]
ultralisp egao1980-cl-idna

http (HTTP下载tarball)

http <project name> <url> [<file md5>]
http yason http://netzhansa.com/yason.tar.gz

git (Git仓库)

git <project name> <repos url> [:ref|:branch|:tag <标识符>]
git clack https://github.com/fukamachi/clack.git
git clack https://github.com/fukamachi/clack.git :branch develop
git datafly https://github.com/fukamachi/datafly.git :tag v0.7.4
git cl-dbi https://github.com/fukamachi/cl-dbi.git :ref 54928984e5756e92ba298aae51de8b95a6b0cf4b

私有仓库通过SSH访问：

git myapp git@github.com:company/private-repo.git

github (GitHub仓库，无需git命令)

github <project name> <user/repo> [:ref|:branch|:tag <标识符>]
github datafly fukamachi/datafly
github datafly fukamachi/datafly :branch develop

dist (自定义发行版)

dist <dist name> <distribution URL> [<dist version>]
dist quicklisp http://beta.quicklisp.org/dist/quicklisp.txt
dist ultralisp http://dist.ultralisp.org/

发行版优先级

如果多个发行版提供相同库，后面声明的发行版优先级更高。

高级配置

与SLIME集成

在Emacs配置中添加：

emacs
(defun slime-qlot-exec (directory)
  (interactive (list (read-directory-name "项目目录: ")))
  (slime-start :program "qlot"
               :program-args '("exec" "ros" "-S" "." "run")
               :directory directory
               :name 'qlot
               :env (list (concat "PATH=" (mapconcat 'identity exec-path ":")))))

使用M-x slime-qlot-exec启动项目本地SLIME REPL。

使用本地Git仓库

可以通过PROJECT_ROOT/.qlot/local-projects目录或符号链接添加本地开发的库。

命令参考

为什么选择Qlot

Quicklisp虽然极大简化了Common Lisp库的安装，但存在版本控制限制：

• 只能指定发行版月份，无法为单个项目选择不同版本
• 全局安装会导致多项目间版本冲突
• 难以确保团队或部署环境的依赖一致性

Qlot通过项目本地安装和版本锁定解决了这些问题，让Common Lisp项目的依赖管理更加可靠和可预测。

版权与许可

Copyright (c) 2014 Eitaro Fukamachi
根据MIT许可证授权。