From baca1d6981f0658664b1e976b51c39db9a631a2c Mon Sep 17 00:00:00 2001 From: Ryan Yin Date: Sun, 4 Feb 2024 17:53:08 +0800 Subject: [PATCH] feat: flakes feature is just a wrapper of other nix files --- docs/nixos-with-flakes/introduction-to-flakes.md | 5 +++++ docs/zh/nixos-with-flakes/introduction-to-flakes.md | 6 +++++- 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/nixos-with-flakes/introduction-to-flakes.md b/docs/nixos-with-flakes/introduction-to-flakes.md index de717f7..a93f963 100644 --- a/docs/nixos-with-flakes/introduction-to-flakes.md +++ b/docs/nixos-with-flakes/introduction-to-flakes.md @@ -9,9 +9,14 @@ In simple terms, if you've worked with some JavaScript/Go/Rust/Python, you shoul Similarly, the package managers in these programming languages also use files like `package-lock.json`/`go.sum`/`Cargo.lock`/`poetry.lock` to lock the versions of dependencies, ensuring the reproducibility of projects. Flakes borrow ideas from these package managers to enhance the reproducibility, composability, and usability of the Nix ecosystem. + Flakes introduce `flake.nix`, similar to `package.json`, to describe the dependencies between Nix packages and how to build projects. Additionally, it provides `flake.lock`, akin to `package-lock.json`, to lock the versions of dependencies, ensuring project reproducibility. +On the other hand, Flakes experimental features did not break Nix's original design at the user level. +The two new files `flake.nix`/`flake.lock` introduced by Flakes are just a wrapper for other Nix configurations. +In the following chapters, we will see that Flakes features provide a new and more convenient way to manage the dependencies between Nix expressions based on Nix's original design. + ## A Word of Caution about Flakes The benefits of Flakes are evident, and the entire NixOS community has embraced it wholeheartedly. Currently, more than half of the users utilize Flakes[^3], providing assurance that Flakes will not be deprecated. diff --git a/docs/zh/nixos-with-flakes/introduction-to-flakes.md b/docs/zh/nixos-with-flakes/introduction-to-flakes.md index cdde194..5c492a8 100644 --- a/docs/zh/nixos-with-flakes/introduction-to-flakes.md +++ b/docs/zh/nixos-with-flakes/introduction-to-flakes.md @@ -9,10 +9,14 @@ Flakes 特性是 Nix 项目中最有意义的变化之一。[^2] 在这些编程语言中，这些文件用来描述软件包之间的依赖关系，以及如何构建项目。 同样的，这些编程语言的包管理器还通过 `package-lock.json`/`go.sum`/`Cargo.lock`/`poetry.lock` 这些文件来锁定依赖的版本，以保证项目的可复现性。 -Flakes 就是从上述这类编程语言的包管理器中借鉴了一些思想，以提高 Nix 生态系统中的可复现性、可组合性和可用性。 +Flakes 就是从上述这类编程语言的包管理器中借鉴了这种描述依赖关系与锁定依赖版本的思路，以提高 Nix 生态系统中的可复现性、可组合性和可用性。 + Flakes 提供了 `flake.nix`，它类似 `package.json`，用来描述 Nix 包之间的依赖关系，以及如何构建项目。 同时它还提供了 `flake.lock`，这是一个类似 `package-lock.json` 的文件，用来锁定依赖的版本，以保证项目的可复现性。 +另一方面，Flakes 实验特性并没有破坏 Nix 用户层面的原有设计， +它新引入的 `flake.nix`/`flake.lock` 两个文件只是其他 Nix 配置的一个 Wrapper， +在后面的章节的学习中我们将会看到，Flakes 特性是在 Nix 原有设计的基础上提供了一种新的、更方便的管理 Nix 表达式之间的依赖关系的方式。 ## 注意事项