Nix Error Messages পড়া: কাঁদতে না দিয়ে

1. Infinite Recursion Encountered

এটা মানে Nix এমন Attribute Evaluate করতে চেয়েছে যেটা নিজের উপর Depend করে। Common Causes: Overlay-এ self বা super Incorrect Use করা, বা callPackage যেখানে Attribute Defined হচ্ছে সেই Derivation-এর দিকে Refer Back করে।

# Classic trap: 'pkgs' fully construct হওয়ার আগে Refer করা
let
  pkgs = import <nixpkgs> { overlays = [ overlay ]; };
  overlay = final: prev: {
    myPkg = pkgs.stdenv.mkDerivation { ... }; # ← হওয়া উচিত 'final.stdenv'
  };
in pkgs

Debug strategy: nix build বা nix eval-এ --show-trace Add করো। Trace ঠিক কোন Attribute Cycle Trigger করেছে Point করবে।

2. Value Is Not a Function / Not an Attribute Set

Nix-এর Type System Lazy — Errors শুধু Evaluation-এর সময় Surface করে। মানে তুমি Wrong Shape Pass করেছো। Usually Missing Argument, Attribute Name-এ Typo, বা Function Apply করা ভুলে।

# Often caused by:
let
  f = { foo }: foo + 1;
in
f 42  # int Pass করা Function-এ Expecting Attrset

Error বলে "value is not an attribute set" আর Nixpkgs-এ Point করে, সাধারণত মানে Derivation Pass করেছো যেখানে Options Set Expect করছিল, বা উল্টো — যেমন pkgs.python3.withPackages Call করা এবং Lambda ভুলে।

3. Attribute Not Found

Nixpkgs Newcomers-এর সবচেয়ে Common Error। Set-এ এমন Attribute Access করার চেষ্টা করছো যেটা Exist করে না। Spelling Check করো, Package Right Channel-এ আছে কিনা Check করো, আর Package Set (যেমন pkgs.python3Packages) আর Package (pkgs.python3) Confuse করছো কিনা দেখো।

error: attribute 'pythonPackages' missing

# Attribute set 'pkgs'-এর এই Path আছে, শুধু নাম আলাদা:
# pkgs.python3Packages.requests   ← correct
# pkgs.pythonPackages.requests    ← exist করে না

4. Builder Failed with Exit Code N

এটা Build-time Error, Evaluation Error নয়। Nix Successfully তোমার Derivation Evaluate করেছে, কিন্তু Build Script Fail করেছে। Error Message Itself Almost Never Useful — Real Information Build Log-এ।

error: builder for '/nix/store/...-my-package-1.0.drv' failed with exit code 1
       For full logs, run 'nix log /nix/store/...-my-package-1.0.drv'.

Critical: Always nix log /nix/store/... Immediately Run করো। Exit Code Alone কিছু বলে না। Log Everything বলে — Missing Headers, Failed Tests, Network Errors, Wrong Phase Outputs।

5. Hash Mismatch

fetchurl, fetchgit, বা Similar Fetcher Content পেয়েছে Declared Hash Match করে না। Either Derivation-এ Stale Hash, বা Upstream Source In-place Change করেছে (যেটা Hope করার চেয়ে বেশি হয়)।

error: hash mismatch in fixed-output derivation '/nix/store/...':
         specified: sha256-AAAA...
         got:       sha256-BBBB...

Hash Update করে Fix করো। "Got" Value টা Correct — Derivation-এ Copy করো। fetchgit-এর জন্য, Source Move করলে rev Update করো।

Leveling Up: Better REPL

Default nix repl Barebones। Months :lf . Type করে আর Manual Navigate করার পর, Custom repl.nix Build করেছিলাম যেটা Preload করে সব Host, Configs, আর Helper Functions।

{
  # Repl Start করার সময় Host Name Pass করো
  host ? "xenomorph",
  ...
}:
let
  flake = builtins.getFlake (toString ./.);
  inherit (flake.inputs.nixpkgs) lib;
in
{
  inherit lib;
  inherit (flake) inputs;

  # Current Host-এর Quick Access
  c = flake.nixosConfigurations.${host}.config;
  config = c;
  co = c.custom;
  pkgs = flake.nixosConfigurations.${host}.pkgs;

  # Debugging-এর জন্য Helper Functions
  keys = lib.attrNames;                    # Set-এর সব Attributes List করো
  deps = pkg: map (p: p.name or "unknown") (pkg.buildInputs ++ pkg.nativeBuildInputs or []);

  # কোন Option কোথায় Defined খুঁজো (nixos internals Filter করে)
  where = path: let
    opt = lib.attrByPath (lib.splitString "." path) null
          flake.nixosConfigurations.${host}.options;
    decls = if opt != null && opt ? files then opt.files else [];
    isMine = f: !(lib.hasInfix "nixos/modules/" (toString f));
    in lib.filter isMine decls;

  # Repl Exit না করে Reload
  reload = import ./repl.nix { inherit host; };
}
// flake.nixosConfigurations  # সব Host Configs Merge করো

কেন এটা Better:

• keys pkgs: :p pkgs Type করে 50,000 Attributes Scroll করার পরিবর্তে Clean List পাও
• where "services.nginx.virtualHosts": Exact File খুঁজে পাও যেটা Option Define করে, Nixpkgs Internals Ignore করে
• deps pkgs.hello: Nixpkgs Source Dig না করে কোনো Package-এর Build Inputs দেখো
• c / config / co: Current Host-এর Config আর Custom Options-এর Short Aliases
• reload: Repl Exit না করে repl.nix Re-import করো (Repl Itself Edit করার সময় Great)

Helper Script দিয়ে Use করা:

#!/usr/bin/env bash
if [[ -f repl.nix ]]; then
  nix repl --arg host '"xenomorph"' --file ./repl.nix "$@"
else
  # repl.nix না থাকলে Regular repl-এ Fallback
  nix repl .
fi

এখন Error Hit করলে Repl-এ Jump করে Immediately Values Inspect করতে পারি:

nix-repl> c.services.nginx.enable
true

nix-repl> where "services.nginx.virtualHosts"
[ /home/k1ng/nix/dotfiles.nix/modules/web/nginx.nix ]

nix-repl> keys co.persist.home
directories files

nix-repl> deps pkgs.neovim
[ "libuv" "msgpack" "tree-sitter" ... ]

Inspiration টা Brian McGee-এর Post থেকে এসেছিল Nix-এর Slow Feedback Loop নিয়ে। REPL Real Debugging Tool হয়ে যায়, শুধু Calculator নয়।