kylekrein/snowfall-lib
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge pull request #88 from snowfallorg/dev

Browse source 
Snowfall Lib v3
This commit is contained in:
Jake Hamilton 2024-05-22 20:06:12 -07:00 • committed by GitHub
commit c58023878d
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
23 changed files with 1322 additions and 1144 deletions
Download patch file Download diff file Expand all files Collapse all files

10
default.nix
View file

@ -1,10 +1,14 @@
(import
( (
let lock = builtins.fromJSON (builtins.readFile ./flake.lock); in import
(
let
lock = builtins.fromJSON (builtins.readFile ./flake.lock);
in
fetchTarball { fetchTarball {
url = "https://github.com/edolstra/flake-compat/archive/${lock.nodes.flake-compat.locked.rev}.tar.gz"; url = "https://github.com/edolstra/flake-compat/archive/${lock.nodes.flake-compat.locked.rev}.tar.gz";
sha256 = lock.nodes.flake-compat.locked.narHash; sha256 = lock.nodes.flake-compat.locked.narHash;
} }
) )
{src = ./.;} {src = ./.;}
).defaultNix )
.defaultNix

8
flake.lock generated
View file

@ -54,16 +54,16 @@
}, },
"nixpkgs": { "nixpkgs": {
"locked": { "locked": {
"lastModified": 1677028070, "lastModified": 1716181197,
"narHash": "sha256-sUKqd8HYBrtPxCRXFWvsnQDnwqnw1uIDwu4khcZuL2k=", "narHash": "sha256-IXOUlMlt0f5n9BoJ56+CseCLV9aaBDoEygIWV/hnUso=",
"owner": "nixos", "owner": "nixos",
"repo": "nixpkgs", "repo": "nixpkgs",
"rev": "d3a15cd8dc917f4364ba0b332a1c389dc3177603", "rev": "461aad7a53142b9f9e2a666c810e86b20f5da76b",
"type": "github" "type": "github"
}, },
"original": { "original": {
"owner": "nixos", "owner": "nixos",
"ref": "release-22.11", "ref": "release-23.11",
"repo": "nixpkgs", "repo": "nixpkgs",
"type": "github" "type": "github"
} }

35
flake.nix
View file

@ -2,7 +2,7 @@
description = "Snowfall Lib"; description = "Snowfall Lib";
inputs = { inputs = {
nixpkgs.url = "github:nixos/nixpkgs/release-22.11"; nixpkgs.url = "github:nixos/nixpkgs/release-23.11";
flake-utils-plus.url = "github:gytis-ivaskevicius/flake-utils-plus"; flake-utils-plus.url = "github:gytis-ivaskevicius/flake-utils-plus";
flake-compat = { flake-compat = {
@ -11,9 +11,10 @@
}; };
}; };
outputs = inputs: outputs = inputs: let
let core-inputs =
core-inputs = inputs // { inputs
// {
src = ./.; src = ./.;
}; };
@ -27,16 +28,19 @@
# A convenience wrapper to create the library and then call `lib.mkFlake`. # A convenience wrapper to create the library and then call `lib.mkFlake`.
# Usage: mkFlake { inherit inputs; src = ./.; ... } # Usage: mkFlake { inherit inputs; src = ./.; ... }
# result: <flake-outputs> # result: <flake-outputs>
mkFlake = flake-and-lib-options@{ inputs, src, snowfall ? { }, ... }: mkFlake = flake-and-lib-options @ {
let inputs,
src,
snowfall ? {},
...
}: let
lib = mkLib { lib = mkLib {
inherit inputs src snowfall; inherit inputs src snowfall;
}; };
flake-options = builtins.removeAttrs flake-and-lib-options ["inputs" "src"]; flake-options = builtins.removeAttrs flake-and-lib-options ["inputs" "src"];
in in
lib.mkFlake flake-options; lib.mkFlake flake-options;
in in {
{
inherit mkLib mkFlake; inherit mkLib mkFlake;
nixosModules = { nixosModules = {
@ -51,8 +55,14 @@
user = ./modules/home/user/default.nix; user = ./modules/home/user/default.nix;
}; };
_snowfall = rec { formatter = {
x86_64-linux = inputs.nixpkgs.legacyPackages.x86_64-linux.alejandra;
aarch64-linux = inputs.nixpkgs.legacyPackages.aarch64-linux.alejandra;
x86_64-darwin = inputs.nixpkgs.legacyPackages.x86_64-darwin.alejandra;
aarch64-darwin = inputs.nixpkgs.legacyPackages.aarch64-darwin.alejandra;
};
snowfall = rec {
raw-config = config; raw-config = config;
config = { config = {
@ -67,12 +77,13 @@
}; };
}; };
internal-lib = internal-lib = let
let
lib = mkLib { lib = mkLib {
src = ./.; src = ./.;
inputs = inputs // { inputs =
inputs
// {
self = {}; self = {};
}; };
}; };

60
modules/darwin/user/default.nix
View file

@ -1,26 +1,42 @@
{ pkgs, lib, options, config, inputs, ... }: {
pkgs,
let lib,
inherit (lib) types mkOption mkDefault foldl optionalAttrs; options,
config,
inputs,
...
}: let
inherit
(lib)
types
mkOption
mkDefault
mkRenamedOptionModule
foldl
optionalAttrs
;
cfg = config.snowfallorg; cfg = config.snowfallorg;
user-names = builtins.attrNames cfg.user; user-names = builtins.attrNames cfg.users;
create-system-users = system-users: name: create-system-users = system-users: name: let
let user = cfg.users.${name};
user = cfg.user.${name};
in in
system-users // (optionalAttrs user.create { system-users
// (optionalAttrs user.create {
${name} = { ${name} = {
home = mkDefault user.home.path; home = mkDefault user.home.path;
isHidden = mkDefault false; isHidden = mkDefault false;
}; };
}); });
in in {
{ imports = [
(mkRenamedOptionModule ["snowfallorg" "user"] ["snowfallorg" "users"])
];
options.snowfallorg = { options.snowfallorg = {
user = mkOption { users = mkOption {
description = "User configuration."; description = "User configuration.";
default = {}; default = {};
type = types.attrsOf (types.submodule ({name, ...}: { type = types.attrsOf (types.submodule ({name, ...}: {
@ -46,12 +62,19 @@ in
# HM-compatible options taken from: # HM-compatible options taken from:
# https://github.com/nix-community/home-manager/blob/0ee5ab611dc1fbb5180bd7d88d2aeb7841a4d179/nixos/common.nix#L14 # https://github.com/nix-community/home-manager/blob/0ee5ab611dc1fbb5180bd7d88d2aeb7841a4d179/nixos/common.nix#L14
type = types.submoduleWith { type = types.submoduleWith {
specialArgs = { specialArgs =
{
osConfig = config; osConfig = config;
modulesPath = "${inputs.home-manager}/modules"; modulesPath = "${inputs.home-manager}/modules";
} // config.home-manager.extraSpecialArgs; }
modules = [ // config.home-manager.extraSpecialArgs;
({ lib, modulesPath, ... }: { modules =
[
({
lib,
modulesPath,
...
}: {
imports = import "${modulesPath}/modules.nix" { imports = import "${modulesPath}/modules.nix" {
inherit pkgs lib; inherit pkgs lib;
useNixpkgsModule = !config.home-manager.useGlobalPkgs; useNixpkgsModule = !config.home-manager.useGlobalPkgs;
@ -67,7 +90,8 @@ in
nix.package = config.nix.package; nix.package = config.nix.package;
}; };
}) })
] ++ config.home-manager.sharedModules; ]
++ config.home-manager.sharedModules;
}; };
}; };
}; };
@ -77,6 +101,6 @@ in
}; };
config = { config = {
users.users = (foldl create-system-users { } (user-names)); users.users = foldl create-system-users {} user-names;
}; };
} }

26
modules/home/user/default.nix
View file

@ -1,25 +1,27 @@
inputs@{ pkgs, lib, options, config, ... }: inputs @ {
pkgs,
let lib,
options,
config,
...
}: let
inherit (lib) types mkOption mkIf mkDefault; inherit (lib) types mkOption mkIf mkDefault;
cfg = config.snowfallorg; cfg = config.snowfallorg;
# @NOTE(jakehamilton): The module system chokes if it finds `osConfig` named in the module arguments # NOTE: The module system chokes if it finds `osConfig` named in the module arguments
# when being used in standalone home-manager. To remedy this, we have to refer to the arguments set directly. # when being used in standalone home-manager. To remedy this, we have to refer to the arguments set directly.
os-user-home = inputs.osConfig.users.users.${cfg.name}.home or null; os-user-home = inputs.osConfig.users.users.${cfg.name}.home or null;
has-user-name = (cfg.user.name or null) != null; has-user-name = (cfg.user.name or null) != null;
default-home-directory = default-home-directory =
if (os-user-home != null) then if (os-user-home != null)
os-user-home then os-user-home
else if pkgs.stdenv.isDarwin then else if pkgs.stdenv.isDarwin
"/Users/${cfg.user.name}" then "/Users/${cfg.user.name}"
else else "/home/${cfg.user.name}";
"/home/${cfg.user.name}"; in {
in
{
options.snowfallorg = { options.snowfallorg = {
user = { user = {
enable = mkOption { enable = mkOption {

67
modules/nixos/user/default.nix
View file

@ -1,19 +1,32 @@
args@{ pkgs, lib, options, config, ... }: args @ {
pkgs,
let lib,
inherit (lib) types mkOption mkDefault foldl optionalAttrs optional; options,
config,
...
}: let
inherit
(lib)
types
mkOption
mkDefault
mkRenamedOptionModule
foldl
optionalAttrs
optional
;
cfg = config.snowfallorg; cfg = config.snowfallorg;
inputs = args.inputs or {}; inputs = args.inputs or {};
user-names = builtins.attrNames cfg.user; user-names = builtins.attrNames cfg.users;
create-system-users = system-users: name: create-system-users = system-users: name: let
let user = cfg.users.${name};
user = cfg.user.${name};
in in
system-users // (optionalAttrs user.create { system-users
// (optionalAttrs user.create {
${name} = { ${name} = {
isNormalUser = mkDefault true; isNormalUser = mkDefault true;
@ -25,11 +38,13 @@ let
extraGroups = optional user.admin "wheel"; extraGroups = optional user.admin "wheel";
}; };
}); });
in {
imports = [
(mkRenamedOptionModule ["snowfallorg" "user"] ["snowfallorg" "users"])
];
in
{
options.snowfallorg = { options.snowfallorg = {
user = mkOption { users = mkOption {
description = "User configuration."; description = "User configuration.";
default = {}; default = {};
type = types.attrsOf (types.submodule ({name, ...}: { type = types.attrsOf (types.submodule ({name, ...}: {
@ -60,16 +75,24 @@ in
config = mkOption { config = mkOption {
# HM-compatible options taken from: # HM-compatible options taken from:
# https://github.com/nix-community/home-manager/blob/0ee5ab611dc1fbb5180bd7d88d2aeb7841a4d179/nixos/common.nix#L14 # https://github.com/nix-community/home-manager/blob/0ee5ab611dc1fbb5180bd7d88d2aeb7841a4d179/nixos/common.nix#L14
# @NOTE(jakehamilton): This has been adapted to support documentation generation without # NOTE: This has been adapted to support documentation generation without
# having home-manager options fully declared. # having home-manager options fully declared.
type = types.submoduleWith { type = types.submoduleWith {
specialArgs = { specialArgs =
{
osConfig = config; osConfig = config;
modulesPath = "${inputs.home-manager or "/"}/modules"; modulesPath = "${inputs.home-manager or "/"}/modules";
} // (config.home-manager.extraSpecialArgs or { }); }
modules = [ // (config.home-manager.extraSpecialArgs or {});
({ lib, modulesPath, ... }: modules =
if inputs ? home-manager then { [
({
lib,
modulesPath,
...
}:
if inputs ? home-manager
then {
imports = import "${modulesPath}/modules.nix" { imports = import "${modulesPath}/modules.nix" {
inherit pkgs lib; inherit pkgs lib;
useNixpkgsModule = !(config.home-manager.useGlobalPkgs or false); useNixpkgsModule = !(config.home-manager.useGlobalPkgs or false);
@ -84,8 +107,10 @@ in
nix.package = config.nix.package; nix.package = config.nix.package;
}; };
} else { }) }
] ++ (config.home-manager.sharedModules or [ ]); else {})
]
++ (config.home-manager.sharedModules or []);
}; };
}; };
}; };
@ -95,6 +120,6 @@ in
}; };
config = { config = {
users.users = (foldl (create-system-users) { } (user-names)); users.users = foldl create-system-users {} user-names;
}; };
} }

42
snowfall-lib/attrs/default.nix
View file

@ -1,11 +1,11 @@
{ core-inputs {
, user-inputs core-inputs,
, snowfall-lib user-inputs,
, snowfall-config snowfall-lib,
}: snowfall-config,
}: let
let inherit
inherit (core-inputs.nixpkgs.lib) (core-inputs.nixpkgs.lib)
assertMsg assertMsg
mapAttrsToList mapAttrsToList
mapAttrs mapAttrs
@ -13,9 +13,9 @@ let
foldl foldl
recursiveUpdate recursiveUpdate
mergeAttrs mergeAttrs
isDerivation; isDerivation
in ;
{ in {
attrs = { attrs = {
## Map and flatten an attribute set into a list. ## Map and flatten an attribute set into a list.
## Example Usage: ## Example Usage:
@ -66,15 +66,17 @@ in
#@ [Attrs] -> Attrs #@ [Attrs] -> Attrs
merge-shallow-packages = items: merge-shallow-packages = items:
foldl foldl
(result: item: (
result // (mapAttrs result: item:
(name: value: result
if isDerivation value then // (mapAttrs
value (
else if builtins.isAttrs value then name: value:
(result.${name} or { }) // value if isDerivation value
else then value
value else if builtins.isAttrs value
then (result.${name} or {}) // value
else value
) )
item) item)
) )

56
snowfall-lib/checks/default.nix Normal file
View file

@ -0,0 +1,56 @@
{
core-inputs,
user-inputs,
snowfall-lib,
snowfall-config,
}: let
inherit (core-inputs.flake-utils-plus.lib) filterPackages;
inherit (core-inputs.nixpkgs.lib) assertMsg foldl mapAttrs callPackageWith;
user-checks-root = snowfall-lib.fs.get-snowfall-file "checks";
in {
check = {
## Create flake output packages.
## Example Usage:
## ```nix
## create-checks { inherit channels; src = ./my-checks; overrides = { inherit another-check; }; alias = { default = "another-check"; }; }
## ```
## Result:
## ```nix
## { another-check = ...; my-check = ...; default = ...; }
## ```
#@ Attrs -> Attrs
create-checks = {
channels,
src ? user-checks-root,
pkgs ? channels.nixpkgs,
overrides ? {},
alias ? {},
}: let
user-checks = snowfall-lib.fs.get-default-nix-files-recursive src;
create-check-metadata = check: let
extra-inputs =
pkgs
// {
inherit channels;
lib = snowfall-lib.internal.system-lib;
inputs = snowfall-lib.flake.without-src user-inputs;
namespace = snowfall-config.namespace;
};
in {
name = builtins.unsafeDiscardStringContext (snowfall-lib.path.get-parent-directory check);
drv = callPackageWith extra-inputs check {};
};
checks-metadata = builtins.map create-check-metadata user-checks;
merge-checks = checks: metadata:
checks
// {
${metadata.name} = metadata.drv;
};
checks-without-aliases = foldl merge-checks {} checks-metadata;
aliased-checks = mapAttrs (name: value: checks-without-aliases.${value}) alias;
checks = checks-without-aliases // aliased-checks // overrides;
in
filterPackages pkgs.system checks;
};
}

54
snowfall-lib/default.nix
View file

@ -1,13 +1,12 @@
# @NOTE(jakehamilton): The role of this file is to bootstrap the # NOTE: The role of this file is to bootstrap the
# Snowfall library. There is some duplication shared between this # Snowfall library. There is some duplication shared between this
# file and the library itself due to the library needing to pass through # file and the library itself due to the library needing to pass through
# another extended library for its own applications. # another extended library for its own applications.
core-inputs: core-inputs: user-options: let
user-options:
let
raw-snowfall-config = user-options.snowfall or {}; raw-snowfall-config = user-options.snowfall or {};
snowfall-config = raw-snowfall-config // { snowfall-config =
raw-snowfall-config
// {
src = user-options.src; src = user-options.src;
root = raw-snowfall-config.root or user-options.src; root = raw-snowfall-config.root or user-options.src;
namespace = raw-snowfall-config.namespace or "internal"; namespace = raw-snowfall-config.namespace or "internal";
@ -19,7 +18,7 @@ let
user-inputs = user-options.inputs // {src = user-options.src;}; user-inputs = user-options.inputs // {src = user-options.src;};
inherit (core-inputs.nixpkgs.lib) assertMsg fix filterAttrs mergeAttrs fold recursiveUpdate callPackageWith; inherit (core-inputs.nixpkgs.lib) assertMsg fix filterAttrs mergeAttrs fold recursiveUpdate callPackageWith isFunction;
# Recursively merge a list of attribute sets. # Recursively merge a list of attribute sets.
# Type: [Attrs] -> Attrs # Type: [Attrs] -> Attrs
@ -39,10 +38,10 @@ let
# Type: Attrs -> Attrs # Type: Attrs -> Attrs
# Usage: get-lib { x = nixpkgs; y = {}; } # Usage: get-lib { x = nixpkgs; y = {}; }
# result: { x = nixpkgs.lib; } # result: { x = nixpkgs.lib; }
get-libs = attrs: get-libs = attrs: let
let
# @PERF(jakehamilton): Replace filter+map with a fold. # @PERF(jakehamilton): Replace filter+map with a fold.
attrs-with-libs = filterAttrs attrs-with-libs =
filterAttrs
(name: value: builtins.isAttrs (value.lib or null)) (name: value: builtins.isAttrs (value.lib or null))
attrs; attrs;
libs = libs =
@ -59,23 +58,23 @@ let
core-inputs-libs = get-libs (without-self core-inputs); core-inputs-libs = get-libs (without-self core-inputs);
user-inputs-libs = get-libs (without-self user-inputs); user-inputs-libs = get-libs (without-self user-inputs);
# @NOTE(jakehamilton): This root is different to accomodate the creation # NOTE: This root is different to accommodate the creation
# of a fake user-lib in order to run documentation on this flake. # of a fake user-lib in order to run documentation on this flake.
snowfall-lib-root = "${core-inputs.src}/snowfall-lib"; snowfall-lib-root = "${core-inputs.src}/snowfall-lib";
snowfall-lib-dirs = snowfall-lib-dirs = let
let
files = builtins.readDir snowfall-lib-root; files = builtins.readDir snowfall-lib-root;
dirs = filterAttrs (name: kind: kind == "directory") files; dirs = filterAttrs (name: kind: kind == "directory") files;
names = builtins.attrNames dirs; names = builtins.attrNames dirs;
in in
names; names;
snowfall-lib = fix (snowfall-lib: snowfall-lib = fix (
let snowfall-lib: let
attrs = { attrs = {
inherit snowfall-lib snowfall-config core-inputs user-inputs; inherit snowfall-lib snowfall-config core-inputs user-inputs;
}; };
libs = builtins.map libs =
builtins.map
(dir: import "${snowfall-lib-root}/${dir}" attrs) (dir: import "${snowfall-lib-root}/${dir}" attrs)
snowfall-lib-dirs; snowfall-lib-dirs;
in in
@ -95,15 +94,25 @@ let
user-lib-root = "${user-inputs.src}/lib"; user-lib-root = "${user-inputs.src}/lib";
user-lib-modules = snowfall-lib.fs.get-default-nix-files-recursive user-lib-root; user-lib-modules = snowfall-lib.fs.get-default-nix-files-recursive user-lib-root;
user-lib = fix (user-lib: user-lib = fix (
let user-lib: let
attrs = { attrs = {
inherit (user-options) inputs; inherit (user-options) inputs;
snowfall-inputs = core-inputs; snowfall-inputs = core-inputs;
namespace = snowfall-config.namespace;
lib = merge-shallow [base-lib {${snowfall-config.namespace} = user-lib;}]; lib = merge-shallow [base-lib {${snowfall-config.namespace} = user-lib;}];
}; };
libs = builtins.map libs =
(path: callPackageWith attrs path { }) builtins.map
(
path: let
imported-module = import path;
in
if isFunction imported-module
then callPackageWith attrs path {}
# the only difference is that there is no `override` and `overrideDerivation` on returned value
else imported-module
)
user-lib-modules; user-lib-modules;
in in
merge-deep libs merge-deep libs
@ -117,6 +126,5 @@ let
user-inputs-has-self = builtins.elem "self" (builtins.attrNames user-inputs); user-inputs-has-self = builtins.elem "self" (builtins.attrNames user-inputs);
user-inputs-has-src = builtins.elem "src" (builtins.attrNames user-inputs); user-inputs-has-src = builtins.elem "src" (builtins.attrNames user-inputs);
in in
assert (assertMsg (user-inputs-has-self) "Missing attribute `self` for mkLib."); assert (assertMsg user-inputs-has-self "Missing attribute `self` for mkLib.");
assert (assertMsg (user-inputs-has-src) "Missing attribute `src` for mkLib."); assert (assertMsg user-inputs-has-src "Missing attribute `src` for mkLib."); lib
lib

67
snowfall-lib/flake/default.nix
View file

@ -1,13 +1,11 @@
{ core-inputs {
, user-inputs core-inputs,
, snowfall-lib user-inputs,
, snowfall-config snowfall-lib,
}: snowfall-config,
}: let
let
inherit (core-inputs.nixpkgs.lib) assertMsg foldl filterAttrs const; inherit (core-inputs.nixpkgs.lib) assertMsg foldl filterAttrs const;
in in rec {
rec {
flake = rec { flake = rec {
## Remove the `self` attribute from an attribute set. ## Remove the `self` attribute from an attribute set.
## Example Usage: ## Example Usage:
@ -67,9 +65,10 @@ rec {
"outputsBuilder" "outputsBuilder"
"packagesPrefix" "packagesPrefix"
"hosts" "hosts"
"homes"
"channels-config" "channels-config"
"templates" "templates"
"package-namespace" "checks"
"alias" "alias"
"snowfall" "snowfall"
]; ];
@ -84,10 +83,10 @@ rec {
## { x = nixpkgs.lib; } ## { x = nixpkgs.lib; }
## ``` ## ```
#@ Attrs -> Attrs #@ Attrs -> Attrs
get-libs = attrs: get-libs = attrs: let
let
# @PERF(jakehamilton): Replace filter+map with a fold. # @PERF(jakehamilton): Replace filter+map with a fold.
attrs-with-libs = filterAttrs attrs-with-libs =
filterAttrs
(name: value: builtins.isAttrs (value.lib or null)) (name: value: builtins.isAttrs (value.lib or null))
attrs; attrs;
libs = libs =
@ -96,50 +95,48 @@ rec {
libs; libs;
}; };
mkFlake = full-flake-options: mkFlake = full-flake-options: let
let namespace = snowfall-config.namespace or "internal";
package-namespace = full-flake-options.package-namespace or snowfall-config.namespace or "internal";
custom-flake-options = flake.without-snowfall-options full-flake-options; custom-flake-options = flake.without-snowfall-options full-flake-options;
alias = full-flake-options.alias or {}; alias = full-flake-options.alias or {};
homes = snowfall-lib.home.create-homes (full-flake-options.homes or {}); homes = snowfall-lib.home.create-homes (full-flake-options.homes or {});
systems = snowfall-lib.system.create-systems { systems = snowfall-lib.system.create-systems {
systems = (full-flake-options.systems or { }); systems = full-flake-options.systems or {};
homes = (full-flake-options.homes or { }); homes = full-flake-options.homes or {};
}; };
hosts = snowfall-lib.attrs.merge-shallow [(full-flake-options.systems.hosts or {}) systems homes]; hosts = snowfall-lib.attrs.merge-shallow [(full-flake-options.systems.hosts or {}) systems homes];
templates = snowfall-lib.template.create-templates { templates = snowfall-lib.template.create-templates {
overrides = (full-flake-options.templates or { }); overrides = full-flake-options.templates or {};
alias = alias.templates or {}; alias = alias.templates or {};
}; };
nixos-modules = snowfall-lib.module.create-modules { nixos-modules = snowfall-lib.module.create-modules {
src = snowfall-lib.fs.get-snowfall-file "modules/nixos"; src = snowfall-lib.fs.get-snowfall-file "modules/nixos";
overrides = (full-flake-options.modules.nixos or { }); overrides = full-flake-options.modules.nixos or {};
alias = alias.modules.nixos or {}; alias = alias.modules.nixos or {};
}; };
darwin-modules = snowfall-lib.module.create-modules { darwin-modules = snowfall-lib.module.create-modules {
src = snowfall-lib.fs.get-snowfall-file "modules/darwin"; src = snowfall-lib.fs.get-snowfall-file "modules/darwin";
overrides = (full-flake-options.modules.darwin or { }); overrides = full-flake-options.modules.darwin or {};
alias = alias.modules.darwin or {}; alias = alias.modules.darwin or {};
}; };
home-modules = snowfall-lib.module.create-modules { home-modules = snowfall-lib.module.create-modules {
src = snowfall-lib.fs.get-snowfall-file "modules/home"; src = snowfall-lib.fs.get-snowfall-file "modules/home";
overrides = (full-flake-options.modules.home or { }); overrides = full-flake-options.modules.home or {};
alias = alias.modules.home or {}; alias = alias.modules.home or {};
}; };
overlays = snowfall-lib.overlay.create-overlays { overlays = snowfall-lib.overlay.create-overlays {
inherit package-namespace; inherit namespace;
extra-overlays = full-flake-options.extra-exported-overlays or {}; extra-overlays = full-flake-options.extra-exported-overlays or {};
}; };
outputs-builder = channels: outputs-builder = channels: let
let
user-outputs-builder = user-outputs-builder =
full-flake-options.outputs-builder full-flake-options.outputs-builder
or full-flake-options.outputsBuilder or full-flake-options.outputsBuilder
or (const {}); or (const {});
user-outputs = user-outputs-builder channels; user-outputs = user-outputs-builder channels;
packages = snowfall-lib.package.create-packages { packages = snowfall-lib.package.create-packages {
inherit channels package-namespace; inherit channels namespace;
overrides = (full-flake-options.packages or {}) // (user-outputs.packages or {}); overrides = (full-flake-options.packages or {}) // (user-outputs.packages or {});
alias = alias.packages or {}; alias = alias.packages or {};
}; };
@ -148,16 +145,23 @@ rec {
overrides = (full-flake-options.shells or {}) // (user-outputs.devShells or {}); overrides = (full-flake-options.shells or {}) // (user-outputs.devShells or {});
alias = alias.shells or {}; alias = alias.shells or {};
}; };
checks = snowfall-lib.check.create-checks {
inherit channels;
overrides = (full-flake-options.checks or {}) // (user-outputs.checks or {});
alias = alias.checks or {};
};
outputs = { outputs = {
inherit packages; inherit packages checks;
devShells = shells; devShells = shells;
}; };
in in
snowfall-lib.attrs.merge-deep [user-outputs outputs]; snowfall-lib.attrs.merge-deep [user-outputs outputs];
flake-options = custom-flake-options // { flake-options =
custom-flake-options
// {
inherit hosts templates; inherit hosts templates;
inherit (user-inputs) self; inherit (user-inputs) self;
@ -171,13 +175,13 @@ rec {
channelsConfig = full-flake-options.channels-config or {}; channelsConfig = full-flake-options.channels-config or {};
channels.nixpkgs.overlaysBuilder = snowfall-lib.overlay.create-overlays-builder { channels.nixpkgs.overlaysBuilder = snowfall-lib.overlay.create-overlays-builder {
inherit package-namespace; inherit namespace;
extra-overlays = full-flake-options.overlays or []; extra-overlays = full-flake-options.overlays or [];
}; };
outputsBuilder = outputs-builder; outputsBuilder = outputs-builder;
_snowfall = { snowfall = {
config = snowfall-config; config = snowfall-config;
raw-config = full-flake-options.snowfall or {}; raw-config = full-flake-options.snowfall or {};
user-lib = snowfall-lib.internal.user-lib; user-lib = snowfall-lib.internal.user-lib;
@ -188,7 +192,8 @@ rec {
core-inputs.flake-utils-plus.lib.mkFlake flake-options; core-inputs.flake-utils-plus.lib.mkFlake flake-options;
flake-outputs = flake-outputs =
flake-utils-plus-outputs // { flake-utils-plus-outputs
// {
inherit overlays; inherit overlays;
}; };
in in

16
snowfall-lib/fp/default.nix
View file

@ -1,14 +1,12 @@
{ core-inputs {
, user-inputs core-inputs,
, snowfall-lib user-inputs,
, snowfall-config snowfall-lib,
}: snowfall-config,
}: let
let
inherit (builtins) baseNameOf dirOf; inherit (builtins) baseNameOf dirOf;
inherit (core-inputs.nixpkgs.lib) id foldr flip; inherit (core-inputs.nixpkgs.lib) id foldr flip;
in in {
{
fp = rec { fp = rec {
## Compose two functions. ## Compose two functions.
## Example Usage: ## Example Usage:

57
snowfall-lib/fs/default.nix
View file

@ -1,17 +1,15 @@
{ core-inputs {
, user-inputs core-inputs,
, snowfall-lib user-inputs,
, snowfall-config snowfall-lib,
}: snowfall-config,
}: let
let
inherit (builtins) readDir pathExists; inherit (builtins) readDir pathExists;
inherit (core-inputs) flake-utils-plus; inherit (core-inputs) flake-utils-plus;
inherit (core-inputs.nixpkgs.lib) assertMsg filterAttrs mapAttrsToList flatten; inherit (core-inputs.nixpkgs.lib) assertMsg filterAttrs mapAttrsToList flatten;
file-name-regex = "(.*)\\.(.*)$"; file-name-regex = "(.*)\\.(.*)$";
in in {
{
fs = rec { fs = rec {
## Matchers for file kinds. These are often used with `readDir`. ## Matchers for file kinds. These are often used with `readDir`.
## Example Usage: ## Example Usage:
@ -38,7 +36,7 @@ in
## "/user-source/systems" ## "/user-source/systems"
## ``` ## ```
#@ Path -> Path #@ Path -> Path
get-file = path: "${user-inputs.src}/${path}"; get-file = path: user-inputs.src + "/${path}";
## Get a file path relative to the user's snowfall directory. ## Get a file path relative to the user's snowfall directory.
## Example Usage: ## Example Usage:
@ -50,7 +48,7 @@ in
## "/user-source/snowfall-dir/systems" ## "/user-source/snowfall-dir/systems"
## ``` ## ```
#@ Path -> Path #@ Path -> Path
get-snowfall-file = path: "${snowfall-config.root}/${path}"; get-snowfall-file = path: snowfall-config.root + "/${path}";
## Get a file path relative to the this flake. ## Get a file path relative to the this flake.
## Example Usage: ## Example Usage:
@ -62,7 +60,7 @@ in
## "/user-source/systems" ## "/user-source/systems"
## ``` ## ```
#@ Path -> Path #@ Path -> Path
internal-get-file = path: "${core-inputs.src}/${path}"; internal-get-file = path: core-inputs.src + "/${path}";
## Safely read from a directory if it exists. ## Safely read from a directory if it exists.
## Example Usage: ## Example Usage:
@ -75,10 +73,9 @@ in
## ``` ## ```
#@ Path -> Attrs #@ Path -> Attrs
safe-read-directory = path: safe-read-directory = path:
if pathExists path then if pathExists path
readDir path then readDir path
else else {};
{ };
## Get directories at a given path. ## Get directories at a given path.
## Example Usage: ## Example Usage:
@ -90,8 +87,7 @@ in
## [ "./something/a-directory" ] ## [ "./something/a-directory" ]
## ``` ## ```
#@ Path -> [Path] #@ Path -> [Path]
get-directories = path: get-directories = path: let
let
entries = safe-read-directory path; entries = safe-read-directory path;
filtered-entries = filterAttrs (name: kind: is-directory-kind kind) entries; filtered-entries = filterAttrs (name: kind: is-directory-kind kind) entries;
in in
@ -107,8 +103,7 @@ in
## [ "./something/a-file" ] ## [ "./something/a-file" ]
## ``` ## ```
#@ Path -> [Path] #@ Path -> [Path]
get-files = path: get-files = path: let
let
entries = safe-read-directory path; entries = safe-read-directory path;
filtered-entries = filterAttrs (name: kind: is-file-kind kind) entries; filtered-entries = filterAttrs (name: kind: is-file-kind kind) entries;
in in
@ -124,22 +119,20 @@ in
## [ "./something/some-directory/a-file" ] ## [ "./something/some-directory/a-file" ]
## ``` ## ```
#@ Path -> [Path] #@ Path -> [Path]
get-files-recursive = path: get-files-recursive = path: let
let
entries = safe-read-directory path; entries = safe-read-directory path;
filtered-entries = filtered-entries =
filterAttrs filterAttrs
(name: kind: (is-file-kind kind) || (is-directory-kind kind)) (name: kind: (is-file-kind kind) || (is-directory-kind kind))
entries; entries;
map-file = name: kind: map-file = name: kind: let
let
path' = "${path}/${name}"; path' = "${path}/${name}";
in in
if is-directory-kind kind then if is-directory-kind kind
get-files-recursive path' then get-files-recursive path'
else else path';
path'; files =
files = snowfall-lib.attrs.map-concat-attrs-to-list snowfall-lib.attrs.map-concat-attrs-to-list
map-file map-file
filtered-entries; filtered-entries;
in in
@ -217,7 +210,8 @@ in
#@ Path -> [Path] #@ Path -> [Path]
get-non-default-nix-files = path: get-non-default-nix-files = path:
builtins.filter builtins.filter
(name: (
name:
(snowfall-lib.path.has-file-extension "nix" name) (snowfall-lib.path.has-file-extension "nix" name)
&& (builtins.baseNameOf name != "default.nix") && (builtins.baseNameOf name != "default.nix")
) )
@ -235,7 +229,8 @@ in
#@ Path -> [Path] #@ Path -> [Path]
get-non-default-nix-files-recursive = path: get-non-default-nix-files-recursive = path:
builtins.filter builtins.filter
(name: (
name:
(snowfall-lib.path.has-file-extension "nix" name) (snowfall-lib.path.has-file-extension "nix" name)
&& (builtins.baseNameOf name != "default.nix") && (builtins.baseNameOf name != "default.nix")
) )

223
snowfall-lib/home/default.nix
View file

@ -1,11 +1,11 @@
{ core-inputs {
, user-inputs core-inputs,
, snowfall-lib user-inputs,
, snowfall-config snowfall-lib,
}: snowfall-config,
}: let
let inherit
inherit (core-inputs.nixpkgs.lib) (core-inputs.nixpkgs.lib)
assertMsg assertMsg
foldl foldl
head head
@ -23,29 +23,31 @@ let
mkAliasDefinitions mkAliasDefinitions
mkAliasAndWrapDefinitions mkAliasAndWrapDefinitions
mkOption mkOption
types; types
hasInfix
hasSuffix
;
user-homes-root = snowfall-lib.fs.get-snowfall-file "homes"; user-homes-root = snowfall-lib.fs.get-snowfall-file "homes";
user-modules-root = snowfall-lib.fs.get-snowfall-file "modules"; user-modules-root = snowfall-lib.fs.get-snowfall-file "modules";
in in {
{
home = rec { home = rec {
# Modules in home-manager expect `hm` to be available directly on `lib` itself. # Modules in home-manager expect `hm` to be available directly on `lib` itself.
home-lib = home-lib =
# @NOTE(jakehamilton): This prevents an error during evaluation if the input does # NOTE: This prevents an error during evaluation if the input does
# not exist. # not exist.
if user-inputs ? home-manager then if user-inputs ? home-manager
then
snowfall-lib.internal.system-lib.extend snowfall-lib.internal.system-lib.extend
(final: prev: (final: prev:
# @NOTE(jakehamilton): This order is important, this library's extend and other utilities must write # NOTE: This order is important, this library's extend and other utilities must write
# _over_ the original `system-lib`. # _over_ the original `system-lib`.
snowfall-lib.internal.system-lib snowfall-lib.internal.system-lib
// prev // prev
// { // {
hm = snowfall-lib.internal.system-lib.home-manager.hm; hm = snowfall-lib.internal.system-lib.home-manager.hm;
}) })
else else {};
{ };
## Get the user and host from a combined string. ## Get the user and host from a combined string.
## Example Usage: ## Example Usage:
@ -57,23 +59,19 @@ in
## { user = "myuser"; host = "myhost"; } ## { user = "myuser"; host = "myhost"; }
## ``` ## ```
#@ String -> Attrs #@ String -> Attrs
split-user-and-host = target: split-user-and-host = target: let
let
raw-name-parts = builtins.split "@" target; raw-name-parts = builtins.split "@" target;
name-parts = builtins.filter builtins.isString raw-name-parts; name-parts = builtins.filter builtins.isString raw-name-parts;
user = builtins.elemAt name-parts 0; user = builtins.elemAt name-parts 0;
host = host =
if builtins.length name-parts > 1 then if builtins.length name-parts > 1
builtins.elemAt name-parts 1 then builtins.elemAt name-parts 1
else else "";
""; in {
in
{
inherit user host; inherit user host;
}; };
## Create a home. ## Create a home.
## Example Usage: ## Example Usage:
## ```nix ## ```nix
@ -84,60 +82,66 @@ in
## <flake-utils-plus-home-configuration> ## <flake-utils-plus-home-configuration>
## ``` ## ```
#@ Attrs -> Attrs #@ Attrs -> Attrs
create-home = create-home = {
{ path path,
, name ? builtins.unsafeDiscardStringContext (snowfall-lib.system.get-inferred-system-name path) name ? builtins.unsafeDiscardStringContext (snowfall-lib.system.get-inferred-system-name path),
, modules ? [ ] modules ? [],
, specialArgs ? { } specialArgs ? {},
, channelName ? "nixpkgs" channelName ? "nixpkgs",
, system ? "x86_64-linux" system ? "x86_64-linux",
}: }: let
let
user-metadata = split-user-and-host name; user-metadata = split-user-and-host name;
# @NOTE(jakehamilton): home-manager has trouble with `pkgs` recursion if it isn't passed in here. # NOTE: home-manager has trouble with `pkgs` recursion if it isn't passed in here.
pkgs = user-inputs.self.pkgs.${system}.${channelName} // {lib = home-lib;}; pkgs = user-inputs.self.pkgs.${system}.${channelName} // {lib = home-lib;};
lib = home-lib; lib = home-lib;
in in
assert assertMsg (user-inputs ? home-manager) "In order to create home-manager configurations, you must include `home-manager` as a flake input."; assert assertMsg (user-inputs ? home-manager) "In order to create home-manager configurations, you must include `home-manager` as a flake input.";
assert assertMsg (user-metadata.host != "") "Snowfall Lib homes must be named with the format: user@system"; assert assertMsg ((user-metadata.host != "") || !(hasInfix "@" name)) "Snowfall Lib homes must be named with the format: user@system"; {
{
inherit channelName system; inherit channelName system;
output = "homeConfigurations"; output = "homeConfigurations";
modules = [ modules =
[
path path
../../modules/home/user/default.nix ../../modules/home/user/default.nix
] ++ modules; ]
++ modules;
specialArgs = { specialArgs = {
inherit name; inherit name system;
inherit (user-metadata) user host; inherit (user-metadata) user host;
format = "home"; format = "home";
inputs = snowfall-lib.flake.without-src user-inputs; inputs = snowfall-lib.flake.without-src user-inputs;
namespace = snowfall-config.namespace;
# @NOTE(jakehamilton): home-manager has trouble with `pkgs` recursion if it isn't passed in here. # NOTE: home-manager has trouble with `pkgs` recursion if it isn't passed in here.
inherit pkgs lib; inherit pkgs lib;
}; };
builder = args: builder = args:
user-inputs.home-manager.lib.homeManagerConfiguration user-inputs.home-manager.lib.homeManagerConfiguration
((builtins.removeAttrs args [ "system" "specialArgs" ]) // { ((builtins.removeAttrs args ["system" "specialArgs"])
// {
inherit pkgs lib; inherit pkgs lib;
modules = args.modules ++ [ modules =
(module-args: import ./nix-registry-module.nix (module-args // { args.modules
++ [
(module-args:
import ./nix-registry-module.nix (module-args
// {
inherit user-inputs core-inputs; inherit user-inputs core-inputs;
})) }))
({ {
snowfallorg.user = { snowfallorg.user = {
name = mkDefault user-metadata.user; name = mkDefault user-metadata.user;
enable = mkDefault true; enable = mkDefault true;
}; };
}) }
]; ];
extraSpecialArgs = specialArgs // args.specialArgs; extraSpecialArgs = specialArgs // args.specialArgs;
@ -154,8 +158,7 @@ in
## [ { system = "x86_64-linux"; name = "my-home"; path = "/homes/x86_64-linux/my-home";} ] ## [ { system = "x86_64-linux"; name = "my-home"; path = "/homes/x86_64-linux/my-home";} ]
## ``` ## ```
#@ String -> [Attrs] #@ String -> [Attrs]
get-target-homes-metadata = target: get-target-homes-metadata = target: let
let
homes = snowfall-lib.fs.get-directories target; homes = snowfall-lib.fs.get-directories target;
existing-homes = builtins.filter (home: builtins.pathExists "${home}/default.nix") homes; existing-homes = builtins.filter (home: builtins.pathExists "${home}/default.nix") homes;
create-home-metadata = path: { create-home-metadata = path: {
@ -183,8 +186,7 @@ in
## { "my-user@my-system" = <flake-utils-plus-home-configuration>; } ## { "my-user@my-system" = <flake-utils-plus-home-configuration>; }
## ``` ## ```
#@ Attrs -> Attrs #@ Attrs -> Attrs
create-homes = homes: create-homes = homes: let
let
targets = snowfall-lib.fs.get-directories user-homes-root; targets = snowfall-lib.fs.get-directories user-homes-root;
target-homes-metadata = concatMap get-target-homes-metadata targets; target-homes-metadata = concatMap get-target-homes-metadata targets;
@ -192,19 +194,22 @@ in
src = "${user-modules-root}/home"; src = "${user-modules-root}/home";
}; };
user-home-modules-list = mapAttrsToList user-home-modules-list =
(module-path: module: args@{ pkgs, ... }: (module args) // { mapAttrsToList
(module-path: module: args @ {pkgs, ...}:
(module args)
// {
_file = "${user-homes-root}/${module-path}/default.nix"; _file = "${user-homes-root}/${module-path}/default.nix";
}) })
user-home-modules; user-home-modules;
create-home' = home-metadata: create-home' = home-metadata: let
let
inherit (home-metadata) name; inherit (home-metadata) name;
overrides = homes.users.${name} or {}; overrides = homes.users.${name} or {};
in in {
{ "${name}" = create-home (overrides
"${name}" = create-home (overrides // home-metadata // { // home-metadata
// {
modules = user-home-modules-list ++ (homes.users.${name}.modules or []) ++ (homes.modules or []); modules = user-home-modules-list ++ (homes.users.${name}.modules or []) ++ (homes.modules or []);
}); });
}; };
@ -223,14 +228,18 @@ in
## [Module] ## [Module]
## ``` ## ```
#@ Attrs -> [Module] #@ Attrs -> [Module]
create-home-system-modules = users: create-home-system-modules = users: let
let
created-users = create-homes users; created-users = create-homes users;
user-home-modules = snowfall-lib.module.create-modules { user-home-modules = snowfall-lib.module.create-modules {
src = "${user-modules-root}/home"; src = "${user-modules-root}/home";
}; };
shared-modules = mapAttrsToList shared-modules = builtins.map (module: {
config.home-manager.sharedModules = [module];
}) (users.modules or []);
shared-user-modules =
mapAttrsToList
(module-path: module: { (module-path: module: {
_file = "${user-modules-root}/home/${module-path}/default.nix"; _file = "${user-modules-root}/home/${module-path}/default.nix";
@ -250,18 +259,17 @@ in
}; };
}; };
extra-special-args-module = extra-special-args-module = args @ {
args@{ config config,
, pkgs pkgs,
, system ? pkgs.system system ? pkgs.system,
, target ? system target ? system,
, format ? "home" format ? "home",
, host ? "" host ? "",
, virtual ? (snowfall-lib.system.is-virtual target) virtual ? (snowfall-lib.system.is-virtual target),
, systems ? { } systems ? {},
, ... ...
}: }: {
{
_file = "virtual:snowfallorg/home/extra-special-args"; _file = "virtual:snowfallorg/home/extra-special-args";
config = { config = {
@ -275,31 +283,39 @@ in
}; };
}; };
system-modules = builtins.map system-modules =
(name: builtins.map
let (
name: let
created-user = created-users.${name}; created-user = created-users.${name};
user-module = head created-user.modules; user-module = head created-user.modules;
other-modules = users.users.${name}.modules or []; other-modules = users.users.${name}.modules or [];
user-name = created-user.specialArgs.user; user-name = created-user.specialArgs.user;
in in
args@{ config args @ {
, options config,
, pkgs options,
, host ? "" pkgs,
, ... host ? "",
}: system ? pkgs.system,
let ...
host-matches = created-user.specialArgs.host == host; }: let
host-matches =
(created-user.specialArgs.host == host)
|| (created-user.specialArgs.host == "" && created-user.specialArgs.system == system);
# @NOTE(jakehamilton): To conform to the config structure of home-manager, we have to # NOTE: To conform to the config structure of home-manager, we have to
# remap the options coming from `snowfallorg.user.<name>.home.config` since `mkAliasDefinitions` # remap the options coming from `snowfallorg.user.<name>.home.config` since `mkAliasDefinitions`
# does not let us target options within a submodule. # does not let us target options within a submodule.
wrap-user-options = user-option: wrap-user-options = user-option:
if (user-option ? "_type") && user-option._type == "merge" then if (user-option ? "_type") && user-option._type == "merge"
user-option // { then
contents = builtins.map user-option
(merge-entry: // {
contents =
builtins.map
(
merge-entry:
merge-entry.${user-name}.home.config or {} merge-entry.${user-name}.home.config or {}
) )
user-option.contents; user-option.contents;
@ -308,31 +324,44 @@ in
(builtins.trace '' (builtins.trace ''
============= =============
Snowfall Lib: Snowfall Lib:
Option value for `snowfallorg.user.${user-name}` was not detected to be merged. Option value for `snowfallorg.users.${user-name}` was not detected to be merged.
Please report the issue on GitHub with a link to your configuration so we can debug the problem: Please report the issue on GitHub with a link to your configuration so we can debug the problem:
https://github.com/snowfallorg/lib/issues/new https://github.com/snowfallorg/lib/issues/new
============= =============
'') '')
user-option; user-option;
in
{ home-config = mkAliasAndWrapDefinitions wrap-user-options options.snowfallorg.users;
in {
_file = "virtual:snowfallorg/home/user/${name}"; _file = "virtual:snowfallorg/home/user/${name}";
config = mkIf host-matches { config = mkIf host-matches {
# Initialize user information. # Initialize user information.
snowfallorg.user.${user-name}.home.config = { snowfallorg.users.${user-name}.home.config = {
snowfallorg.user = { snowfallorg.user = {
enable = true; enable = mkDefault true;
name = mkDefault user-name; name = mkDefault user-name;
}; };
# NOTE: specialArgs are not propagated by Home-Manager without this.
# However, not all specialArgs values can be set when using `_module.args`.
_module.args = builtins.removeAttrs ((users.users.${name}.specialArgs or {})
// {
namespace = snowfall-config.namespace;
})
["options" "config" "lib" "pkgs" "specialArgs" "host"];
}; };
home-manager = { home-manager = {
users.${user-name} = mkAliasAndWrapDefinitions wrap-user-options options.snowfallorg.user; users.${user-name} = mkIf config.snowfallorg.users.${user-name}.home.enable ({pkgs, ...}: {
imports = (home-config.imports or []) ++ other-modules ++ [user-module];
config = builtins.removeAttrs home-config ["imports"];
});
# sharedModules = other-modules ++ optional config.snowfallorg.user.${user-name}.home.enable wrapped-user-module; # NOTE: Without this home-manager will instead create its own package set which won't contain the same config and
sharedModules = other-modules ++ optional config.snowfallorg.user.${user-name}.home.enable user-module; # user-defined packages/overlays as the flake's nixpkgs channel.
useGlobalPkgs = mkDefault true;
}; };
}; };
} }
@ -343,8 +372,8 @@ in
extra-special-args-module extra-special-args-module
snowfall-user-home-module snowfall-user-home-module
] ]
++ (users.modules or [ ])
++ shared-modules ++ shared-modules
++ shared-user-modules
++ system-modules; ++ system-modules;
}; };
} }

8
snowfall-lib/home/nix-registry-module.nix
View file

@ -1,8 +1,12 @@
# This code is adapted from flake-utils-plus: # This code is adapted from flake-utils-plus:
# https://github.com/gytis-ivaskevicius/flake-utils-plus/blob/2bf0f91643c2e5ae38c1b26893ac2927ac9bd82a/lib/options.nix # https://github.com/gytis-ivaskevicius/flake-utils-plus/blob/2bf0f91643c2e5ae38c1b26893ac2927ac9bd82a/lib/options.nix
{ lib, config, user-inputs, core-inputs, ... }:
{ {
lib,
config,
user-inputs,
core-inputs,
...
}: {
disabledModules = [ disabledModules = [
# The module from flake-utils-plus only works on NixOS and nix-darwin. For home-manager # The module from flake-utils-plus only works on NixOS and nix-darwin. For home-manager
# to build, this module needs to be disabled. # to build, this module needs to be disabled.

38
snowfall-lib/internal/default.nix
View file

@ -1,11 +1,10 @@
{ core-inputs {
, user-inputs core-inputs,
, snowfall-lib user-inputs,
, snowfall-config snowfall-lib,
}: snowfall-config,
}: let
let inherit (core-inputs.nixpkgs.lib) fix filterAttrs callPackageWith isFunction;
inherit (core-inputs.nixpkgs.lib) assertMsg fix fold filterAttrs callPackageWith;
core-inputs-libs = snowfall-lib.flake.get-libs (snowfall-lib.flake.without-self core-inputs); core-inputs-libs = snowfall-lib.flake.get-libs (snowfall-lib.flake.without-self core-inputs);
user-inputs-libs = snowfall-lib.flake.get-libs (snowfall-lib.flake.without-self user-inputs); user-inputs-libs = snowfall-lib.flake.get-libs (snowfall-lib.flake.without-self user-inputs);
@ -20,21 +19,31 @@ let
{snowfall = snowfall-lib;} {snowfall = snowfall-lib;}
]; ];
user-lib-root = snowfall-lib.fs.get-file "lib"; user-lib-root = snowfall-lib.fs.get-snowfall-file "lib";
user-lib-modules = snowfall-lib.fs.get-default-nix-files-recursive user-lib-root; user-lib-modules = snowfall-lib.fs.get-default-nix-files-recursive user-lib-root;
user-lib = fix (user-lib: user-lib = fix (
let user-lib: let
attrs = { attrs = {
inputs = snowfall-lib.flake.without-snowfall-inputs user-inputs; inputs = snowfall-lib.flake.without-snowfall-inputs user-inputs;
snowfall-inputs = core-inputs; snowfall-inputs = core-inputs;
namespace = snowfall-config.namespace;
lib = snowfall-lib.attrs.merge-shallow [ lib = snowfall-lib.attrs.merge-shallow [
base-lib base-lib
{internal = user-lib;} {internal = user-lib;}
]; ];
}; };
libs = builtins.map libs =
(path: callPackageWith attrs path { }) builtins.map
(
path: let
imported-module = import path;
in
if isFunction imported-module
then callPackageWith attrs path {}
# the only difference is that there is no `override` and `overrideDerivation` on returned value
else imported-module
)
user-lib-modules; user-lib-modules;
in in
snowfall-lib.attrs.merge-deep libs snowfall-lib.attrs.merge-deep libs
@ -44,8 +53,7 @@ let
base-lib base-lib
{"${snowfall-config.namespace}" = user-lib;} {"${snowfall-config.namespace}" = user-lib;}
]; ];
in in {
{
internal = { internal = {
inherit system-lib user-lib; inherit system-lib user-lib;
}; };

73
snowfall-lib/module/default.nix
View file

@ -1,16 +1,14 @@
{ core-inputs {
, user-inputs core-inputs,
, snowfall-lib user-inputs,
, snowfall-config snowfall-lib,
}: snowfall-config,
}: let
let
inherit (builtins) baseNameOf; inherit (builtins) baseNameOf;
inherit (core-inputs.nixpkgs.lib) assertMsg foldl mapAttrs hasPrefix; inherit (core-inputs.nixpkgs.lib) foldl mapAttrs hasPrefix isFunction;
user-modules-root = snowfall-lib.fs.get-snowfall-file "modules"; user-modules-root = snowfall-lib.fs.get-snowfall-file "modules";
in in {
{
module = { module = {
## Create flake output modules. ## Create flake output modules.
## Example Usage: ## Example Usage:
@ -22,58 +20,59 @@ in
## { another-module = ...; my-module = ...; default = ...; } ## { another-module = ...; my-module = ...; default = ...; }
## ``` ## ```
#@ Attrs -> Attrs #@ Attrs -> Attrs
create-modules = create-modules = {
{ src ? "${user-modules-root}/nixos" src ? "${user-modules-root}/nixos",
, overrides ? { } overrides ? {},
, alias ? { } alias ? {},
}: }: let
let
user-modules = snowfall-lib.fs.get-default-nix-files-recursive src; user-modules = snowfall-lib.fs.get-default-nix-files-recursive src;
create-module-metadata = module: { create-module-metadata = module: {
name = name = let
let
path-name = builtins.replaceStrings [src "/default.nix"] ["" ""] (builtins.unsafeDiscardStringContext module); path-name = builtins.replaceStrings [src "/default.nix"] ["" ""] (builtins.unsafeDiscardStringContext module);
in in
if hasPrefix "/" path-name then if hasPrefix "/" path-name
builtins.substring 1 ((builtins.stringLength path-name) - 1) path-name then builtins.substring 1 ((builtins.stringLength path-name) - 1) path-name
else else path-name;
path-name;
path = module; path = module;
}; };
modules-metadata = builtins.map create-module-metadata user-modules; modules-metadata = builtins.map create-module-metadata user-modules;
merge-modules = modules: metadata: merge-modules = modules: metadata:
modules // { modules
# @NOTE(jakehamilton): home-manager *requires* modules to specify named arguments or it will not // {
# NOTE: home-manager *requires* modules to specify named arguments or it will not
# pass values in. For this reason we must specify things like `pkgs` as a named attribute. # pass values in. For this reason we must specify things like `pkgs` as a named attribute.
${metadata.name} = args@{ pkgs, ... }: ${metadata.name} = args @ {pkgs, ...}: let
let
system = args.system or args.pkgs.system; system = args.system or args.pkgs.system;
target = args.target or system; target = args.target or system;
format = format = let
let
virtual-system-type = snowfall-lib.system.get-virtual-system-type target; virtual-system-type = snowfall-lib.system.get-virtual-system-type target;
in in
if virtual-system-type != "" then if virtual-system-type != ""
virtual-system-type then virtual-system-type
else if snowfall-lib.system.is-darwin target then else if snowfall-lib.system.is-darwin target
"darwin" then "darwin"
else else "linux";
"linux";
# Replicates the specialArgs from Snowfall Lib's system builder. # Replicates the specialArgs from Snowfall Lib's system builder.
modified-args = args // { modified-args =
args
// {
inherit system target format; inherit system target format;
virtual = args.virtual or (snowfall-lib.system.get-virtual-system-type target != ""); virtual = args.virtual or (snowfall-lib.system.get-virtual-system-type target != "");
systems = args.systems or {}; systems = args.systems or {};
lib = snowfall-lib.internal.system-lib; lib = snowfall-lib.internal.system-lib;
pkgs = user-inputs.self.pkgs.${system}.nixpkgs; pkgs = user-inputs.self.pkgs.${system}.nixpkgs;
inputs = snowfall-lib.flake.without-src user-inputs; inputs = snowfall-lib.flake.without-src user-inputs;
namespace = snowfall-config.namespace;
}; };
user-module = import metadata.path modified-args; imported-user-module = import metadata.path;
user-module =
if isFunction imported-user-module
then imported-user-module modified-args
else imported-user-module;
in in
user-module // {_file = metadata.path;}; user-module // {_file = metadata.path;};
}; };

155
snowfall-lib/overlay/default.nix
View file

@ -1,45 +1,49 @@
{ core-inputs {
, user-inputs core-inputs,
, snowfall-lib user-inputs,
, snowfall-config snowfall-lib,
}: snowfall-config,
}: let
let
inherit (core-inputs.nixpkgs.lib) assertMsg foldl concatStringsSep; inherit (core-inputs.nixpkgs.lib) assertMsg foldl concatStringsSep;
user-overlays-root = snowfall-lib.fs.get-snowfall-file "overlays"; user-overlays-root = snowfall-lib.fs.get-snowfall-file "overlays";
user-packages-root = snowfall-lib.fs.get-snowfall-file "packages"; user-packages-root = snowfall-lib.fs.get-snowfall-file "packages";
in in {
{
overlay = { overlay = {
## Create a flake-utils-plus overlays builder. ## Create a flake-utils-plus overlays builder.
## Example Usage: ## Example Usage:
## ```nix ## ```nix
## create-overlays { src = ./my-overlays; package-namespace = "my-packages"; } ## create-overlays { src = ./my-overlays; namespace = "my-packages"; }
## ``` ## ```
## Result: ## Result:
## ```nix ## ```nix
## (channels: [ ... ]) ## (channels: [ ... ])
## ``` ## ```
#@ Attrs -> Attrs -> [(a -> b -> c)] #@ Attrs -> Attrs -> [(a -> b -> c)]
create-overlays-builder = create-overlays-builder = {
{ src ? user-overlays-root src ? user-overlays-root,
, package-namespace ? "internal" namespace ? snowfall-config.namespace,
, extra-overlays ? [ ] extra-overlays ? [],
}: channels: }: channels: let
let
user-overlays = snowfall-lib.fs.get-default-nix-files-recursive src; user-overlays = snowfall-lib.fs.get-default-nix-files-recursive src;
create-overlay = overlay: import overlay (user-inputs // { inherit channels; }); create-overlay = overlay:
user-packages-overlay = final: prev: import overlay (
let # Deprecated: Use `inputs.*` instead of referencing the input name directly.
user-inputs
// {
inherit channels;
inputs = user-inputs;
lib = snowfall-lib.internal.system-lib;
}
);
user-packages-overlay = final: prev: let
user-packages = snowfall-lib.package.create-packages { user-packages = snowfall-lib.package.create-packages {
pkgs = final; pkgs = final;
channels = channels; inherit channels namespace;
}; };
in in {
{ ${namespace} =
${package-namespace} = (prev.${namespace} or {})
(prev.${package-namespace} or { })
// user-packages; // user-packages;
}; };
overlays = overlays =
@ -51,20 +55,19 @@ in
## ##
## Example Usage: ## Example Usage:
## ```nix ## ```nix
## create-overlays { src = ./my-overlays; packages-src = ./my-packages; package-namespace = "my-namespace"; extra-overlays = {}; } ## create-overlays { src = ./my-overlays; packages-src = ./my-packages; namespace = "my-namespace"; extra-overlays = {}; }
## ``` ## ```
## Result: ## Result:
## ```nix ## ```nix
## { default = final: prev: ...; some-overlay = final: prev: ...; } ## { default = final: prev: ...; some-overlay = final: prev: ...; }
## ``` ## ```
#@ Attrs -> Attrs #@ Attrs -> Attrs
create-overlays = create-overlays = {
{ src ? user-overlays-root src ? user-overlays-root,
, packages-src ? user-packages-root packages-src ? user-packages-root,
, package-namespace ? null namespace ? snowfall-config.namespace,
, extra-overlays ? { } extra-overlays ? {},
}: }: let
let
fake-pkgs = { fake-pkgs = {
callPackage = x: x; callPackage = x: x;
isFakePkgs = true; isFakePkgs = true;
@ -76,38 +79,45 @@ in
channel-systems = user-inputs.self.pkgs; channel-systems = user-inputs.self.pkgs;
user-packages-overlay = final: prev: user-packages-overlay = final: prev: let
let
user-packages = snowfall-lib.package.create-packages { user-packages = snowfall-lib.package.create-packages {
pkgs = final; pkgs = final;
channels = channel-systems.${prev.system}; channels = channel-systems.${prev.system};
inherit namespace;
}; };
in in
if package-namespace == null then if namespace == null
user-packages then user-packages
else else {
{ ${namespace} =
${package-namespace} = (prev.${namespace} or {})
(prev.${package-namespace} or { })
// user-packages; // user-packages;
}; };
create-overlay = (overlays: file: create-overlay = (
let overlays: file: let
name = builtins.unsafeDiscardStringContext (snowfall-lib.path.get-parent-directory file); name = builtins.unsafeDiscardStringContext (snowfall-lib.path.get-parent-directory file);
overlay = final: prev: overlay = final: prev: let
let
channels = channel-systems.${prev.system}; channels = channel-systems.${prev.system};
user-overlay = import file (user-inputs // { inherit channels; }); user-overlay = import file (
# Deprecated: Use `inputs.*` instead of referencing the input name directly.
user-inputs
// {
inherit channels namespace;
inputs = user-inputs;
lib = snowfall-lib.internal.system-lib;
}
);
packages = user-packages-overlay final prev; packages = user-packages-overlay final prev;
prev-with-packages = prev-with-packages =
if package-namespace == null then if namespace == null
prev // packages then prev // packages
else else
prev // { prev
${package-namespace} = // {
(prev.${package-namespace} or { }) ${namespace} =
// packages.${package-namespace}; (prev.${namespace} or {})
// packages.${namespace};
}; };
user-overlay-packages = user-overlay-packages =
user-overlay user-overlay
@ -116,16 +126,16 @@ in
outputs = outputs =
user-overlay-packages; user-overlay-packages;
in in
if user-overlay-packages.__dontExport or false == true then if user-overlay-packages.__dontExport or false == true
outputs // { __dontExport = true; } then outputs // {__dontExport = true;}
else else outputs;
outputs;
fake-overlay-result = overlay fake-pkgs fake-pkgs; fake-overlay-result = overlay fake-pkgs fake-pkgs;
in in
if fake-overlay-result.__dontExport or false == true then if fake-overlay-result.__dontExport or false == true
overlays then overlays
else else
overlays // { overlays
// {
${name} = overlay; ${name} = overlay;
} }
); );
@ -138,27 +148,25 @@ in
user-packages = snowfall-lib.fs.get-default-nix-files-recursive packages-src; user-packages = snowfall-lib.fs.get-default-nix-files-recursive packages-src;
create-package-overlay = package-overlays: file: create-package-overlay = package-overlays: file: let
let
name = builtins.unsafeDiscardStringContext (snowfall-lib.path.get-parent-directory file); name = builtins.unsafeDiscardStringContext (snowfall-lib.path.get-parent-directory file);
overlay = final: prev: overlay = final: prev: let
let
channels = channel-systems.${prev.system}; channels = channel-systems.${prev.system};
packages = snowfall-lib.package.create-packages { packages = snowfall-lib.package.create-packages {
inherit namespace;
channels = channel-systems.${prev.system}; channels = channel-systems.${prev.system};
}; };
in in
if package-namespace == null then if namespace == null
{ ${name} = packages.${name}; } then {${name} = packages.${name};}
else else {
{ ${namespace} =
${package-namespace} = (prev.${namespace} or {})
(prev.${package-namespace} or { })
// {${name} = packages.${name};}; // {${name} = packages.${name};};
}; };
in in
package-overlays // package-overlays
{ // {
"package/${name}" = overlay; "package/${name}" = overlay;
}; };
@ -168,15 +176,15 @@ in
{} {}
user-packages; user-packages;
default-overlay = final: prev: default-overlay = final: prev: let
let
overlays-list = builtins.attrValues overlays; overlays-list = builtins.attrValues overlays;
package-overlays-list = builtins.attrValues package-overlays; package-overlays-list = builtins.attrValues package-overlays;
overlays-results = builtins.map (overlay: overlay final prev) overlays-list; overlays-results = builtins.map (overlay: overlay final prev) overlays-list;
package-overlays-results = builtins.map (overlay: overlay final prev) package-overlays-list; package-overlays-results = builtins.map (overlay: overlay final prev) package-overlays-list;
merged-results = snowfall-lib.attrs.merge-shallow-packages merged-results =
snowfall-lib.attrs.merge-shallow-packages
(package-overlays-results ++ overlays-results); (package-overlays-results ++ overlays-results);
in in
merged-results; merged-results;
@ -187,4 +195,3 @@ in
// extra-overlays; // extra-overlays;
}; };
} }

63
snowfall-lib/package/default.nix
View file

@ -1,16 +1,14 @@
{ core-inputs {
, user-inputs core-inputs,
, snowfall-lib user-inputs,
, snowfall-config snowfall-lib,
}: snowfall-config,
}: let
let
inherit (core-inputs.flake-utils-plus.lib) filterPackages allSystems; inherit (core-inputs.flake-utils-plus.lib) filterPackages allSystems;
inherit (core-inputs.nixpkgs.lib) assertMsg foldl mapAttrs filterAttrs callPackageWith; inherit (core-inputs.nixpkgs.lib) assertMsg foldl mapAttrs filterAttrs callPackageWith;
user-packages-root = snowfall-lib.fs.get-snowfall-file "packages"; user-packages-root = snowfall-lib.fs.get-snowfall-file "packages";
in in {
{
package = rec { package = rec {
## Create flake output packages. ## Create flake output packages.
## Example Usage: ## Example Usage:
@ -22,36 +20,38 @@ in
## { another-package = ...; my-package = ...; default = ...; } ## { another-package = ...; my-package = ...; default = ...; }
## ``` ## ```
#@ Attrs -> Attrs #@ Attrs -> Attrs
create-packages = create-packages = {
{ channels channels,
, src ? user-packages-root src ? user-packages-root,
, pkgs ? channels.nixpkgs pkgs ? channels.nixpkgs,
, overrides ? { } overrides ? {},
, alias ? { } alias ? {},
, package-namespace ? "internal" namespace ? snowfall-config.namespace,
}: }: let
let
user-packages = snowfall-lib.fs.get-default-nix-files-recursive src; user-packages = snowfall-lib.fs.get-default-nix-files-recursive src;
create-package-metadata = package: create-package-metadata = package: let
let
namespaced-packages = { namespaced-packages = {
${package-namespace} = packages-without-aliases; ${namespace} = packages-without-aliases;
}; };
extra-inputs = pkgs // namespaced-packages // { extra-inputs =
inherit channels; pkgs
// namespaced-packages
// {
inherit channels namespace;
lib = snowfall-lib.internal.system-lib; lib = snowfall-lib.internal.system-lib;
pkgs = pkgs // namespaced-packages; pkgs = pkgs // namespaced-packages;
inputs = snowfall-lib.flake.without-snowfall-inputs user-inputs; inputs = user-inputs;
}; };
in in {
{
name = builtins.unsafeDiscardStringContext (snowfall-lib.path.get-parent-directory package); name = builtins.unsafeDiscardStringContext (snowfall-lib.path.get-parent-directory package);
drv = drv = let
let
pkg = callPackageWith extra-inputs package {}; pkg = callPackageWith extra-inputs package {};
in in
pkg // { pkg
meta = (pkg.meta or { }) // { // {
meta =
(pkg.meta or {})
// {
snowfall = { snowfall = {
path = package; path = package;
}; };
@ -60,7 +60,8 @@ in
}; };
packages-metadata = builtins.map create-package-metadata user-packages; packages-metadata = builtins.map create-package-metadata user-packages;
merge-packages = packages: metadata: merge-packages = packages: metadata:
packages // { packages
// {
${metadata.name} = metadata.drv; ${metadata.name} = metadata.drv;
}; };
packages-without-aliases = foldl merge-packages {} packages-metadata; packages-without-aliases = foldl merge-packages {} packages-metadata;

49
snowfall-lib/path/default.nix
View file

@ -1,16 +1,14 @@
{ core-inputs {
, user-inputs core-inputs,
, snowfall-lib user-inputs,
, snowfall-config snowfall-lib,
}: snowfall-config,
}: let
let
inherit (builtins) toString baseNameOf dirOf concatStringsSep; inherit (builtins) toString baseNameOf dirOf concatStringsSep;
inherit (core-inputs.nixpkgs.lib) assertMsg last init; inherit (core-inputs.nixpkgs.lib) assertMsg last init;
file-name-regex = "(.*)\\.(.*)$"; file-name-regex = "(.*)\\.(.*)$";
in in {
{
path = rec { path = rec {
## Split a file name and its extension. ## Split a file name and its extension.
## Example Usage: ## Example Usage:
@ -22,12 +20,10 @@ in
## [ "my-file" "md" ] ## [ "my-file" "md" ]
## ``` ## ```
#@ String -> [String] #@ String -> [String]
split-file-extension = file: split-file-extension = file: let
let
match = builtins.match file-name-regex file; match = builtins.match file-name-regex file;
in in
assert assertMsg (match != null) "lib.snowfall.split-file-extension: File must have an extension to split."; assert assertMsg (match != null) "lib.snowfall.split-file-extension: File must have an extension to split."; match;
match;
## Check if a file name has a file extension. ## Check if a file name has a file extension.
## Example Usage: ## Example Usage:
@ -39,8 +35,7 @@ in
## true ## true
## ``` ## ```
#@ String -> Bool #@ String -> Bool
has-any-file-extension = file: has-any-file-extension = file: let
let
match = builtins.match file-name-regex (toString file); match = builtins.match file-name-regex (toString file);
in in
match != null; match != null;
@ -56,13 +51,12 @@ in
## ``` ## ```
#@ String -> String #@ String -> String
get-file-extension = file: get-file-extension = file:
if has-any-file-extension file then if has-any-file-extension file
let then let
match = builtins.match file-name-regex (toString file); match = builtins.match file-name-regex (toString file);
in in
last match last match
else else "";
"";
## Check if a file name has a specific file extension. ## Check if a file name has a specific file extension.
## Example Usage: ## Example Usage:
@ -75,10 +69,9 @@ in
## ``` ## ```
#@ String -> String -> Bool #@ String -> String -> Bool
has-file-extension = extension: file: has-file-extension = extension: file:
if has-any-file-extension file then if has-any-file-extension file
extension == get-file-extension file then extension == get-file-extension file
else else false;
false;
## Get the parent directory for a given path. ## Get the parent directory for a given path.
## Example Usage: ## Example Usage:
@ -102,13 +95,11 @@ in
## "my-file" ## "my-file"
## ``` ## ```
#@ Path -> String #@ Path -> String
get-file-name-without-extension = path: get-file-name-without-extension = path: let
let
file-name = baseNameOf path; file-name = baseNameOf path;
in in
if has-any-file-extension file-name then if has-any-file-extension file-name
concatStringsSep "" (init (split-file-extension file-name)) then concatStringsSep "" (init (split-file-extension file-name))
else else file-name;
file-name;
}; };
} }

45
snowfall-lib/shell/default.nix
View file

@ -1,16 +1,14 @@
{ core-inputs {
, user-inputs core-inputs,
, snowfall-lib user-inputs,
, snowfall-config snowfall-lib,
}: snowfall-config,
}: let
let
inherit (core-inputs.flake-utils-plus.lib) filterPackages; inherit (core-inputs.flake-utils-plus.lib) filterPackages;
inherit (core-inputs.nixpkgs.lib) assertMsg foldl mapAttrs callPackageWith; inherit (core-inputs.nixpkgs.lib) assertMsg foldl mapAttrs callPackageWith;
user-shells-root = snowfall-lib.fs.get-snowfall-file "shells"; user-shells-root = snowfall-lib.fs.get-snowfall-file "shells";
in in {
{
shell = { shell = {
## Create flake output packages. ## Create flake output packages.
## Example Usage: ## Example Usage:
@ -22,30 +20,31 @@ in
## { another-shell = ...; my-shell = ...; default = ...; } ## { another-shell = ...; my-shell = ...; default = ...; }
## ``` ## ```
#@ Attrs -> Attrs #@ Attrs -> Attrs
create-shells = create-shells = {
{ channels channels,
, src ? user-shells-root src ? user-shells-root,
, pkgs ? channels.nixpkgs pkgs ? channels.nixpkgs,
, overrides ? { } overrides ? {},
, alias ? { } alias ? {},
}: }: let
let
user-shells = snowfall-lib.fs.get-default-nix-files-recursive src; user-shells = snowfall-lib.fs.get-default-nix-files-recursive src;
create-shell-metadata = shell: create-shell-metadata = shell: let
let extra-inputs =
extra-inputs = pkgs // { pkgs
// {
inherit channels; inherit channels;
lib = snowfall-lib.internal.system-lib; lib = snowfall-lib.internal.system-lib;
inputs = snowfall-lib.flake.without-src user-inputs; inputs = snowfall-lib.flake.without-src user-inputs;
namespace = snowfall-config.namespace;
}; };
in in {
{
name = builtins.unsafeDiscardStringContext (snowfall-lib.path.get-parent-directory shell); name = builtins.unsafeDiscardStringContext (snowfall-lib.path.get-parent-directory shell);
drv = callPackageWith extra-inputs shell {}; drv = callPackageWith extra-inputs shell {};
}; };
shells-metadata = builtins.map create-shell-metadata user-shells; shells-metadata = builtins.map create-shell-metadata user-shells;
merge-shells = shells: metadata: merge-shells = shells: metadata:
shells // { shells
// {
${metadata.name} = metadata.drv; ${metadata.name} = metadata.drv;
}; };
shells-without-aliases = foldl merge-shells {} shells-metadata; shells-without-aliases = foldl merge-shells {} shells-metadata;

185
snowfall-lib/system/default.nix
View file

@ -1,10 +1,9 @@
{ core-inputs {
, user-inputs core-inputs,
, snowfall-lib user-inputs,
, snowfall-config snowfall-lib,
}: snowfall-config,
}: let
let
inherit (builtins) dirOf baseNameOf; inherit (builtins) dirOf baseNameOf;
inherit (core-inputs.nixpkgs.lib) assertMsg fix hasInfix concatMap foldl optionals singleton; inherit (core-inputs.nixpkgs.lib) assertMsg fix hasInfix concatMap foldl optionals singleton;
@ -12,8 +11,7 @@ let
user-systems-root = snowfall-lib.fs.get-snowfall-file "systems"; user-systems-root = snowfall-lib.fs.get-snowfall-file "systems";
user-modules-root = snowfall-lib.fs.get-snowfall-file "modules"; user-modules-root = snowfall-lib.fs.get-snowfall-file "modules";
in in {
{
system = rec { system = rec {
## Get the name of a system based on its file path. ## Get the name of a system based on its file path.
## Example Usage: ## Example Usage:
@ -26,10 +24,9 @@ in
## ``` ## ```
#@ Path -> String #@ Path -> String
get-inferred-system-name = path: get-inferred-system-name = path:
if snowfall-lib.path.has-file-extension "nix" path then if snowfall-lib.path.has-file-extension "nix" path
snowfall-lib.path.get-parent-directory path then snowfall-lib.path.get-parent-directory path
else else baseNameOf path;
baseNameOf path;
## Check whether a named system is macOS. ## Check whether a named system is macOS.
## Example Usage: ## Example Usage:
@ -80,11 +77,11 @@ in
#@ String -> String #@ String -> String
get-virtual-system-type = target: get-virtual-system-type = target:
foldl foldl
(result: virtual-system: (
if result == "" && hasInfix virtual-system target then result: virtual-system:
virtual-system if result == "" && hasInfix virtual-system target
else then virtual-system
result else result
) )
"" ""
virtual-systems; virtual-systems;
@ -99,8 +96,7 @@ in
## [ { target = "x86_64-linux"; name = "my-machine"; path = "/systems/x86_64-linux/my-machine"; } ] ## [ { target = "x86_64-linux"; name = "my-machine"; path = "/systems/x86_64-linux/my-machine"; } ]
## ``` ## ```
#@ String -> [Attrs] #@ String -> [Attrs]
get-target-systems-metadata = target: get-target-systems-metadata = target: let
let
systems = snowfall-lib.fs.get-directories target; systems = snowfall-lib.fs.get-directories target;
existing-systems = builtins.filter (system: builtins.pathExists "${system}/default.nix") systems; existing-systems = builtins.filter (system: builtins.pathExists "${system}/default.nix") systems;
create-system-metadata = path: { create-system-metadata = path: {
@ -128,49 +124,62 @@ in
## (args: <system>) ## (args: <system>)
## ``` ## ```
#@ String -> Function #@ String -> Function
get-system-builder = target: get-system-builder = target: let
let
virtual-system-type = get-virtual-system-type target; virtual-system-type = get-virtual-system-type target;
virtual-system-builder = args: virtual-system-builder = args:
assert assertMsg (user-inputs ? nixos-generators) "In order to create virtual systems, you must include `nixos-generators` as a flake input."; assert assertMsg (user-inputs ? nixos-generators) "In order to create virtual systems, you must include `nixos-generators` as a flake input.";
user-inputs.nixos-generators.nixosGenerate user-inputs.nixos-generators.nixosGenerate
(args // { (args
// {
format = virtual-system-type; format = virtual-system-type;
specialArgs = args.specialArgs // { specialArgs =
args.specialArgs
// {
format = virtual-system-type; format = virtual-system-type;
}; };
modules = args.modules ++ [ modules =
args.modules
++ [
../../modules/nixos/user/default.nix ../../modules/nixos/user/default.nix
]; ];
}); });
darwin-system-builder = args: darwin-system-builder = args:
assert assertMsg (user-inputs ? darwin) "In order to create virtual systems, you must include `darwin` as a flake input."; assert assertMsg (user-inputs ? darwin) "In order to create virtual systems, you must include `darwin` as a flake input.";
user-inputs.darwin.lib.darwinSystem user-inputs.darwin.lib.darwinSystem
((builtins.removeAttrs args [ "system" "modules" ]) // { ((builtins.removeAttrs args ["system" "modules"])
specialArgs = args.specialArgs // { // {
specialArgs =
args.specialArgs
// {
format = "darwin"; format = "darwin";
}; };
modules = args.modules ++ [ modules =
args.modules
++ [
../../modules/darwin/user/default.nix ../../modules/darwin/user/default.nix
]; ];
}); });
linux-system-builder = args: linux-system-builder = args:
core-inputs.nixpkgs.lib.nixosSystem core-inputs.nixpkgs.lib.nixosSystem
(args // { (args
specialArgs = args.specialArgs // { // {
specialArgs =
args.specialArgs
// {
format = "linux"; format = "linux";
}; };
modules = args.modules ++ [ modules =
args.modules
++ [
../../modules/nixos/user/default.nix ../../modules/nixos/user/default.nix
]; ];
}); });
in in
if virtual-system-type != "" then if virtual-system-type != ""
virtual-system-builder then virtual-system-builder
else if is-darwin target then else if is-darwin target
darwin-system-builder then darwin-system-builder
else else linux-system-builder;
linux-system-builder;
## Get the flake output attribute for a system target. ## Get the flake output attribute for a system target.
## Example Usage: ## Example Usage:
@ -182,16 +191,14 @@ in
## "darwinConfigurations" ## "darwinConfigurations"
## ``` ## ```
#@ String -> String #@ String -> String
get-system-output = target: get-system-output = target: let
let
virtual-system-type = get-virtual-system-type target; virtual-system-type = get-virtual-system-type target;
in in
if virtual-system-type != "" then if virtual-system-type != ""
"${virtual-system-type}Configurations" then "${virtual-system-type}Configurations"
else if is-darwin target then else if is-darwin target
"darwinConfigurations" then "darwinConfigurations"
else else "nixosConfigurations";
"nixosConfigurations";
## Get the resolved (non-virtual) system target. ## Get the resolved (non-virtual) system target.
## Example Usage: ## Example Usage:
@ -203,14 +210,12 @@ in
## "x86_64-linux" ## "x86_64-linux"
## ``` ## ```
#@ String -> String #@ String -> String
get-resolved-system-target = target: get-resolved-system-target = target: let
let
virtual-system-type = get-virtual-system-type target; virtual-system-type = get-virtual-system-type target;
in in
if virtual-system-type != "" then if virtual-system-type != ""
builtins.replaceStrings [ virtual-system-type ] [ "linux" ] target then builtins.replaceStrings [virtual-system-type] ["linux"] target
else else target;
target;
## Create a system. ## Create a system.
## Example Usage: ## Example Usage:
@ -222,40 +227,40 @@ in
## <flake-utils-plus-system-configuration> ## <flake-utils-plus-system-configuration>
## ``` ## ```
#@ Attrs -> Attrs #@ Attrs -> Attrs
create-system = create-system = {
{ target ? "x86_64-linux" target ? "x86_64-linux",
, system ? get-resolved-system-target target system ? get-resolved-system-target target,
, path path,
, name ? builtins.unsafeDiscardStringContext (get-inferred-system-name path) name ? builtins.unsafeDiscardStringContext (get-inferred-system-name path),
, modules ? [ ] modules ? [],
, specialArgs ? { } specialArgs ? {},
, channelName ? "nixpkgs" channelName ? "nixpkgs",
, builder ? get-system-builder target builder ? get-system-builder target,
, output ? get-system-output target output ? get-system-output target,
, systems ? { } systems ? {},
, homes ? { } homes ? {},
}: }: let
let
lib = snowfall-lib.internal.system-lib; lib = snowfall-lib.internal.system-lib;
home-system-modules = snowfall-lib.home.create-home-system-modules homes; home-system-modules = snowfall-lib.home.create-home-system-modules homes;
home-manager-module = home-manager-module =
if is-darwin system then if is-darwin system
user-inputs.home-manager.darwinModules.home-manager then user-inputs.home-manager.darwinModules.home-manager
else else user-inputs.home-manager.nixosModules.home-manager;
user-inputs.home-manager.nixosModules.home-manager;
home-manager-modules = [home-manager-module] ++ home-system-modules; home-manager-modules = [home-manager-module] ++ home-system-modules;
in in {
{
inherit channelName system builder output; inherit channelName system builder output;
modules = [path] ++ modules ++ (optionals (user-inputs ? home-manager) home-manager-modules); modules = [path] ++ modules ++ (optionals (user-inputs ? home-manager) home-manager-modules);
specialArgs = specialArgs // { specialArgs =
specialArgs
// {
inherit target system systems lib; inherit target system systems lib;
host = name; host = name;
virtual = (get-virtual-system-type target) != ""; virtual = (get-virtual-system-type target) != "";
inputs = snowfall-lib.flake.without-src user-inputs; inputs = snowfall-lib.flake.without-src user-inputs;
namespace = snowfall-config.namespace;
}; };
}; };
@ -269,8 +274,10 @@ in
## { my-host = <flake-utils-plus-system-configuration>; } ## { my-host = <flake-utils-plus-system-configuration>; }
## ``` ## ```
#@ Attrs -> Attrs #@ Attrs -> Attrs
create-systems = { systems ? { }, homes ? { } }: create-systems = {
let systems ? {},
homes ? {},
}: let
targets = snowfall-lib.fs.get-directories user-systems-root; targets = snowfall-lib.fs.get-directories user-systems-root;
target-systems-metadata = concatMap get-target-systems-metadata targets; target-systems-metadata = concatMap get-target-systems-metadata targets;
user-nixos-modules = snowfall-lib.module.create-modules { user-nixos-modules = snowfall-lib.module.create-modules {
@ -282,31 +289,31 @@ in
nixos-modules = systems.modules.nixos or []; nixos-modules = systems.modules.nixos or [];
darwin-modules = systems.modules.darwin or []; darwin-modules = systems.modules.darwin or [];
create-system' = created-systems: system-metadata: create-system' = created-systems: system-metadata: let
let
overrides = systems.hosts.${system-metadata.name} or {}; overrides = systems.hosts.${system-metadata.name} or {};
user-modules = user-modules =
if is-darwin system-metadata.target then if is-darwin system-metadata.target
user-darwin-modules then user-darwin-modules
else else user-nixos-modules;
user-nixos-modules;
user-modules-list = builtins.attrValues user-modules; user-modules-list = builtins.attrValues user-modules;
system-modules = system-modules =
if is-darwin system-metadata.target then if is-darwin system-metadata.target
darwin-modules then darwin-modules
else else nixos-modules;
nixos-modules; in {
in ${system-metadata.name} = create-system (overrides
{ // system-metadata
${system-metadata.name} = create-system (overrides // system-metadata // { // {
systems = created-systems; systems = created-systems;
modules = user-modules-list ++ (overrides.modules or []) ++ system-modules; modules = user-modules-list ++ (overrides.modules or []) ++ system-modules;
inherit homes; inherit homes;
}); });
}; };
created-systems = fix (created-systems: created-systems = fix (
created-systems:
foldl foldl
(systems: system-metadata: (
systems: system-metadata:
systems // (create-system' created-systems system-metadata) systems // (create-system' created-systems system-metadata)
) )
{} {}

4
snowfall-lib/system/virtual-systems.nix
View file

@ -1,4 +1,4 @@
# @NOTE(jakehamilton): The order of these entries matters. We search them # NOTE: The order of these entries matters. We search them
# from start to finish and only match based on whether they appear in a # from start to finish and only match based on whether they appear in a
# system target. This means that entries like "vm" would match all cases # system target. This means that entries like "vm" would match all cases
# of "vm-bootloader", "vm-no-gui", and "vmware". To avoid this mismatch, # of "vm-bootloader", "vm-no-gui", and "vmware". To avoid this mismatch,
@ -10,8 +10,8 @@
"docker" "docker"
"do" "do"
"gce" "gce"
"hyperv"
"install-iso-hyperv" "install-iso-hyperv"
"hyperv"
"install-iso" "install-iso"
"iso" "iso"
"kexec" "kexec"

39
snowfall-lib/template/default.nix
View file

@ -1,16 +1,14 @@
{ core-inputs {
, user-inputs core-inputs,
, snowfall-lib user-inputs,
, snowfall-config snowfall-lib,
}: snowfall-config,
}: let
let
inherit (builtins) baseNameOf; inherit (builtins) baseNameOf;
inherit (core-inputs.nixpkgs.lib) assertMsg foldl mapAttrs; inherit (core-inputs.nixpkgs.lib) assertMsg foldl mapAttrs;
user-templates-root = snowfall-lib.fs.get-snowfall-file "templates"; user-templates-root = snowfall-lib.fs.get-snowfall-file "templates";
in in {
{
template = { template = {
## Create flake templates. ## Create flake templates.
## ##
@ -24,12 +22,11 @@ in
## { another-template = ...; my-template = ...; default = ...; } ## { another-template = ...; my-template = ...; default = ...; }
## ``` ## ```
#@ Attrs -> Attrs #@ Attrs -> Attrs
create-templates = create-templates = {
{ src ? user-templates-root src ? user-templates-root,
, overrides ? { } overrides ? {},
, alias ? { } alias ? {},
}: }: let
let
user-templates = snowfall-lib.fs.get-directories src; user-templates = snowfall-lib.fs.get-directories src;
create-template-metadata = template: { create-template-metadata = template: {
name = builtins.unsafeDiscardStringContext (baseNameOf template); name = builtins.unsafeDiscardStringContext (baseNameOf template);
@ -37,14 +34,20 @@ in
}; };
templates-metadata = builtins.map create-template-metadata user-templates; templates-metadata = builtins.map create-template-metadata user-templates;
merge-templates = templates: metadata: merge-templates = templates: metadata:
templates // { templates
${metadata.name} = (overrides.${metadata.name} or { }) // { // {
${metadata.name} =
(builtins.trace "name: ${metadata.name}")
(builtins.trace "path: ${metadata.path}")
(overrides.${metadata.name} or {})
// {
inherit (metadata) path; inherit (metadata) path;
}; };
}; };
templates-without-aliases = foldl merge-templates {} templates-metadata; templates-without-aliases = foldl merge-templates {} templates-metadata;
aliased-templates = mapAttrs (name: value: templates-without-aliases.${value}) alias; aliased-templates = mapAttrs (name: value: templates-without-aliases.${value}) alias;
templates = templates-without-aliases // aliased-templates // overrides; unused-overrides = builtins.removeAttrs overrides (builtins.map (metadata: metadata.name) templates-metadata);
templates = templates-without-aliases // aliased-templates // unused-overrides;
in in
templates; templates;
}; };