nurl(1)

nurl(1) 💖 the General Commands Manual bestie era

okay so welcome to nurl(1) from the General Commands Manual — she's cute, she's useful, she generates Nix fetcher calls. periodt.

🌸 NAME 🌸

nurl — Generate Nix fetcher calls from repository URLs. The repo is literally https://github.com/nix-community/nurl. That's the name section, bestie 💅.

✨ SYNOPSIS ✨

nurl [-S|--submodules] [-f|--fetcher] [-F|--fallback] [-n|--nixpkgs]
[-i|--indent] [-H|--hash] [-j|--json] [-p|--parse] [-a|--arg]
[-A|--arg-str] [-o|--overwrite] [-O|--overwrite-str] [--overwrite-rev]
[--overwrite-rev-str] [-e|--expr] [-l|--list-fetchers]
[-L|--list-possible-fetchers] [-s|--list-sep] [-h|--help] [-V|--version]
[URL] [REV]

🦋 DESCRIPTION 🦋

Okay so real talk: nurl will Generate Nix fetcher calls from repository URLs. That's the whole vibe. The repo lives at https://github.com/nix-community/nurl and yes, it's iconic ✨.

💅 OPTIONS 💅

Every flag, every default, no skipping — we are not leaving the boring parts out, bestie 🫶.

• -S, --submodules[=<SUBMODULES>] — Fetch submodules instead of using the fetcher's default. Possible values: true, false.
• -f, --fetcher <FETCHER> — Specify the fetcher function instead of inferring from the URL. Possible values:
  • builtins.fetchGit
  • fetchCrate
  • fetchFromBitbucket
  • fetchFromGitHub
  • fetchFromGitLab
  • fetchFromGitea
  • fetchFromGitiles
  • fetchFromRepoOrCz
  • fetchFromSourcehut
  • fetchHex
  • fetchPypi
  • fetchgit
  • fetchhg
  • fetchpatch
  • fetchpatch2
  • fetchsvn
  • fetchurl
  • fetchzip
• -F, --fallback <FALLBACK> — The fetcher to fall back to when nurl fails to infer it from the URL. Default: fetchgit. Possible values: builtins.fetchGit, fetchCrate, fetchFromBitbucket, fetchFromGitHub, fetchFromGitLab, fetchFromGitea, fetchFromGitiles, fetchFromRepoOrCz, fetchFromSourcehut, fetchHex, fetchPypi, fetchgit, fetchhg, fetchpatch, fetchpatch2, fetchsvn, fetchurl, fetchzip.
• -n, --nixpkgs <NIXPKGS> — Path to nixpkgs (in nix). Default: <nixpkgs>.
• -i, --indent <INDENT> — Extra indentation (in number of spaces). Default: 0.
• -H, --hash — Only output the hash.
• -j, --json — Output in json format.
• -p, --parse — Parse the url without fetching the hash, output in json format. Note that --arg(-str) and --overwrite(-str) will be ignored silently.
• -a, --arg <NAME> <EXPR> — Additional arguments to pass to the fetcher.
• -A, --arg-str <NAME> <STRING> — Same as --arg, but accepts strings instead of Nix expressions.
• -o, --overwrite <NAME> <EXPR> — Overwrite arguments in the final output, not taken into consideration when fetching the hash. Note that nurl does not verify any of the overwrites; for the final output to be valid, the user should not overwrite anything that would change the hash. Examples: {n} --overwrite repo pname {n} --overwrite rev version.
• -O, --overwrite-str <NAME> <STRING> — Same as --overwrite, but accepts strings instead of Nix expressions. Examples: {n} --overwrite-str rev 'v${version}' {n} --overwrite-str meta.homepage https://example.org.
• --overwrite-rev <EXPR> — Same as --overwrite (rev|tag|version) <EXPR>, depending on the rev-like attribute the fetcher uses.
• --overwrite-rev-str <STRING> — Same as --overwrite-str (rev|tag|version) <STRING>, depending on the rev-like attribute the fetcher uses.
• -e, --expr <EXPR> — Instead of fetching a URL, get the hash of a fixed-output derivation, implies --hash and ignores all other options. Example: --expr '(import <nixpkgs> { }).nurl.src'.
• -l, --list-fetchers — List all available fetchers.
• -L, --list-possible-fetchers — List all fetchers that can be generated without --fetcher.
• -s, --list-sep <SEPARATOR> — Print out the listed fetchers with the specified separator, only used when --list-fetchers or --list-possible-fetchers is specified.
• -h, --help — Print help (see a summary with -h).
• -V, --version — Print version.
• [URL] — URL to the repository to be fetched.
• [REV] — The revision or reference to be fetched.

🌈 VERSION 🌈

v0.4.1 🎀

---

okay that's the whole page, bestie 🫶💖 the footer is giving source/version nurl 0.4.1 with nurl(1) on the right, and there's no date printed on it — that's the entire footer vibe, no cap. slay ✨