all-hies 开源项目安装与使用指南

all-hies 开源项目安装与使用指南

all-hiesCached Haskell IDE Engine Nix builds for all GHC versions项目地址:https://gitcode.com/gh_mirrors/al/all-hies

项目概述

all-hies 是一个用于简化 Haskell 开发环境配置的 Nix 包集合，它特别关注于 Haskell IDE Engine（HIE）的支持。该项目通过Nix包管理和自定义overlay来帮助开发者快速获得适用于不同GHC版本的HIE工具链。

目录结构及介绍

all-hies 的具体目录结构可能会随着其版本更新而有所变化，但基于常规的GitHub仓库结构，大致可以包括以下部分：

• .git: 版本控制系统的元数据。
• default.nix: 核心的Nix表达式文件，用于定义如何构建和获取项目所需的资源。
• overlays/: 存放Nix overlay的目录，其中可能包含了自定义的HIE配置和其他Haskell相关的工具的重写或添加逻辑。
• README.md: 项目的主要说明文档，包含了基本的使用指南和重要信息。
• 可能还包括一些脚本文件，用于自动化常见任务，或者额外的文档子目录如 docs.

注: 实际项目中的文件和目录名称应以仓库最新的文件结构为准。

项目的启动文件介绍

在all-hies中，并没有一个传统的“启动文件”概念，因为其工作原理是通过Nix配置和命令来激活和管理开发环境。关键在于如何正确调用Nix命令来创建一个包含HIE的shell环境，这通常通过执行类似下面的Nix表达式完成：

{ haskellNix ? ... }: # 假设这里定义了haskellNix相关参数
let
  all-hies = fetchTarball "..."; # 这里替换为实际的URL和SHA256哈希值
  pkgs = import nixpkgs (haskellNix.nixpkgsArgs // [
    { overlays = haskellNix.nixpkgsArgs.overlays ++ [import all-hies.overlay]; }
  ]);
in
pkgs.haskellPackages.hie

这其实不是一个单独的启动文件，而是Nix语言编写的配置片段，通过这种方式来构建或进入包含HIE的开发环境。

项目的配置文件介绍

Nix 配置

主要的配置不体现在单一的“配置文件”中，而是分散在Nix表达式中。对于用户来说，调整shell.nix 或其他用于创建开发环境的Nix文件，以包含正确的haskellPackages.hie引用，就是进行配置的过程。例如：

with import <nixpkgs> {};
(haskell.nix.project {
  name = "myProject";
  buildDepends = [ ];
  nativeBuildInputs = [ haskellPackages.hie ];
}).shell

上述配置将HIE加入到你的项目构建环境中。

all-hies 自定义

实际上，all-hies自身不维护一个显式的用户配置文件。它的配置逻辑嵌入在其提供的Nix overlay和示例脚本中。要定制行为，往往需要直接修改或扩展这些Nix表达式。

总结，all-hies的使用更多地依赖于Nix生态系统内的配置而非传统意义上的启动或配置文件，因此理解和掌握Nix语言是关键。

all-hiesCached Haskell IDE Engine Nix builds for all GHC versions项目地址:https://gitcode.com/gh_mirrors/al/all-hies