haskell-flake使用指南

最新推荐文章于 2024-10-10 08:44:37 发布

邓娉靓Melinda

最新推荐文章于 2024-10-10 08:44:37 发布

阅读量794

点赞数 26

本文链接：https://blog.csdn.net/gitblog_00936/article/details/142296301

版权

haskell-flake使用指南

haskell-flake A `flake-parts` Nix module for Haskell development 项目地址: https://gitcode.com/gh_mirrors/ha/haskell-flake

一、项目目录结构及介绍

srid/haskell-flake 是一个专为Haskell项目设计的Nix Flakes模块，简化了Haskell开发、打包和部署流程。以下是典型的项目结构当你应用此Flake到你的项目中时：

核心目录解析

.gitignore: 包含不需要纳入版本控制的文件类型。
flake.nix: 主要配置文件，定义了整个Flake的结构和依赖，是接入haskell-flake的关键。
envrc: 可选，用于direnv环境设置，自动化加载Nix壳环境。
CHANGELOG.md, LICENSE, README.md: 分别记录版本更新日志、许可证信息和项目介绍。
nix 文件夹: 包含Nix相关的配置文件，如构建规则和Flake的自定义逻辑。
**example, test**等: 可能包含示例代码或测试套件。

自定义添加的目录

你的Haskell源码通常包括顶级的cabal或cabal.project文件，位于项目根目录或特定子目录下。
开发工具和其他辅助脚本可能放置在项目特定路径中，根据需要自定义组织。

二、项目的启动文件介绍

在Haskell-flake框架下，没有传统的单一“启动文件”，但有一个关键的配置点——flake.nix。这个文件是项目运行和构建的起点，通过它指定Haskell项目的配置、依赖、以及如何在不同的系统上构建和运行。

示例配置简化版如下：

{ inputs ? { ... } }:
inputs.flake-parts.lib.mkFlake {
  inputs = {
    flake-parts = { url = "github:hercules-ci/flake-parts"; };
    haskell-flake = { url = "github:srid/haskell-flake"; };
  };
  outputs = inputs: inputs.flake-parts.lib.mkFlake {
    systems = ["x86_64-linux"];
    imports = [
      inputs.haskell-flake.flakeModule
    ];
    perSystem = _: [
      { haskellProjects.default = { ... }; }
    ];
  };
}

这里flake.nix定义了项目的基础输入（依赖）、支持的系统、导入的Flake模块和每个系统上的具体配置。

三、项目的配置文件介绍

flake.nix —— 核心配置

inputs: 指定了flake-parts和haskell-flake这两个外部Flake作为项目输入。
outputs: 定义了项目输出的方式，以及如何构建这些输出。
systems: 列出了该Flake支持的目标操作系统，例如这里仅支持64位Linux。
imports: 引入其他Flake模块以增强功能。
perSystem: 根据不同的系统，可以定制化配置，如haskellProjects.default部分控制着Haskell项目的基本配置，比如基础包、额外包、开发壳配置等。