commit 7c8a4efb688b4bf3e8dbf71a43e8b963d8fe3bca · pyrox.dev/nixpkgs

lib/default.nix

···

       433
        
               pathHasContext

     

       434
        
               canCleanSource

     

       435
        
               pathIsGitRepo

     

       0
        
       
     

       0
        
       
     

       436
        
               ;

     

       437
        
             inherit (self.modules)

     

       438
        
               evalModules

···

       433
        
               pathHasContext

     

       434
        
               canCleanSource

     

       435
        
               pathIsGitRepo

     

       436
       +
               revOrTag

     

       437
       +
               repoRevToName

     

       438
        
               ;

     

       439
        
             inherit (self.modules)

     

       440
        
               evalModules

+101 -1

lib/sources.nix

···

       3
        
       

     

       4
        
       # Tested in lib/tests/sources.sh

     

       5
        
       let

     

       6
       -
         inherit (builtins)

     

       7
        
           match

     

       8
        
           split

     

       9
        
           storeDir

     
···

       403
        
             };

     

       404
        
           };

     

       405
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       406
        
       in

     

       407
        
       {

     

       408
        
       

     
···

       430
        
           cleanSourceFilter

     

       431
        
           pathHasContext

     

       432
        
           canCleanSource

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       433
        
       

     

       434
        
           sourceByRegex

     

       435
        
           sourceFilesBySuffices

···

       3
        
       

     

       4
        
       # Tested in lib/tests/sources.sh

     

       5
        
       let

     

       6
       +
         inherit (lib.strings)

     

       7
        
           match

     

       8
        
           split

     

       9
        
           storeDir

     
···

       403
        
             };

     

       404
        
           };

     

       405
        
       

     

       406
       +
         # urlToName : (URL | Path | String) -> String

     

       407
       +
         #

     

       408
       +
         # Transform a URL (or path, or string) into a clean package name.

     

       409
       +
         urlToName =

     

       410
       +
           url:

     

       411
       +
           let

     

       412
       +
             inherit (lib.strings) stringLength;

     

       413
       +
             base = baseNameOf (lib.removeSuffix "/" (lib.last (lib.splitString ":" (toString url))));

     

       414
       +
             # chop away one git or archive-related extension

     

       415
       +
             removeExt =

     

       416
       +
               name:

     

       417
       +
               let

     

       418
       +
                 matchExt = match "(.*)\\.(git|tar|zip|gz|tgz|bz|tbz|bz2|tbz2|lzma|txz|xz|zstd)$" name;

     

       419
       +
               in

     

       420
       +
               if matchExt != null then lib.head matchExt else name;

     

       421
       +
             # apply function f to string x while the result shrinks

     

       422
       +
             shrink =

     

       423
       +
               f: x:

     

       424
       +
               let

     

       425
       +
                 v = f x;

     

       426
       +
               in

     

       427
       +
               if stringLength v < stringLength x then shrink f v else x;

     

       428
       +
           in

     

       429
       +
           shrink removeExt base;

     

       430
       +
       

     

       431
       +
         # shortRev : (String | Integer) -> String

     

       432
       +
         #

     

       433
       +
         # Given a package revision (like "refs/tags/v12.0"), produce a short revision ("12.0").

     

       434
       +
         shortRev =

     

       435
       +
           rev:

     

       436
       +
           let

     

       437
       +
             baseRev = baseNameOf (toString rev);

     

       438
       +
             matchHash = match "[a-f0-9]+" baseRev;

     

       439
       +
             matchVer = match "([A-Za-z]+[-_. ]?)*(v)?([0-9.]+.*)" baseRev;

     

       440
       +
           in

     

       441
       +
           if matchHash != null then

     

       442
       +
             builtins.substring 0 7 baseRev

     

       443
       +
           else if matchVer != null then

     

       444
       +
             lib.last matchVer

     

       445
       +
           else

     

       446
       +
             baseRev;

     

       447
       +
       

     

       448
       +
         # revOrTag : String -> String -> String

     

       449
       +
         #

     

       450
       +
         # Turn git `rev` and `tag` pair into a revision usable in `repoRevToName*`.

     

       451
       +
         revOrTag =

     

       452
       +
           rev: tag:

     

       453
       +
           if tag != null then

     

       454
       +
             tag

     

       455
       +
           else if rev != null then

     

       456
       +
             rev

     

       457
       +
           else

     

       458
       +
             "HEAD";

     

       459
       +
       

     

       460
       +
         # repoRevToNameFull : (URL | Path | String) -> (String | Integer | null) -> (String | null) -> String

     

       461
       +
         #

     

       462
       +
         # See `repoRevToName` below.

     

       463
       +
         repoRevToNameFull =

     

       464
       +
           repo_: rev_: suffix_:

     

       465
       +
           let

     

       466
       +
             repo = urlToName repo_;

     

       467
       +
             rev = if rev_ != null then "-${shortRev rev_}" else "";

     

       468
       +
             suffix = if suffix_ != null then "-${suffix_}" else "";

     

       469
       +
           in

     

       470
       +
           "${repo}${rev}${suffix}-source";

     

       471
       +
       

     

       472
       +
         # repoRevToName : String -> (URL | Path | String) -> (String | Integer | null) -> String -> String

     

       473
       +
         #

     

       474
       +
         # Produce derivation.name attribute for a given repository URL/path/name and (optionally) its revision/version tag.

     

       475
       +
         #

     

       476
       +
         # This is used by fetch(zip|git|FromGitHub|hg|svn|etc) to generate discoverable

     

       477
       +
         # /nix/store paths.

     

       478
       +
         #

     

       479
       +
         # This uses a different implementation depending on the `pretty` argument:

     

       480
       +
         #  "source" -> name everything as "source"

     

       481
       +
         #  "versioned" -> name everything as "${repo}-${rev}-source"

     

       482
       +
         #  "full" -> name everything as "${repo}-${rev}-${fetcher}-source"

     

       483
       +
         repoRevToName =

     

       484
       +
           kind:

     

       485
       +
           # match on `kind` first to minimize the thunk

     

       486
       +
           if kind == "source" then

     

       487
       +
             (

     

       488
       +
               repo: rev: suffix:

     

       489
       +
               "source"

     

       490
       +
             )

     

       491
       +
           else if kind == "versioned" then

     

       492
       +
             (

     

       493
       +
               repo: rev: suffix:

     

       494
       +
               repoRevToNameFull repo rev null

     

       495
       +
             )

     

       496
       +
           else if kind == "full" then

     

       497
       +
             repoRevToNameFull

     

       498
       +
           else

     

       499
       +
             throw "repoRevToName: invalid kind";

     

       500
       +
       

     

       501
        
       in

     

       502
        
       {

     

       503
        
       

     
···

       525
        
           cleanSourceFilter

     

       526
        
           pathHasContext

     

       527
        
           canCleanSource

     

       528
       +
       

     

       529
       +
           urlToName

     

       530
       +
           shortRev

     

       531
       +
           revOrTag

     

       532
       +
           repoRevToName

     

       533
        
       

     

       534
        
           sourceByRegex

     

       535
        
           sourceFilesBySuffices

+6 -2

pkgs/build-support/fetchbitbucket/default.nix

···

       1
       -
       { fetchzip, lib }:

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       2
        
       

     

       3
        
       lib.makeOverridable (

     

       4
        
         {

     

       5
        
           owner,

     

       6
        
           repo,

     

       7
        
           rev,

     

       8
       -
           name ? "source",

     

       9
        
           ... # For hash agility

     

       10
        
         }@args:

     

       11
        
         fetchzip (

···

       1
       +
       {

     

       2
       +
         lib,

     

       3
       +
         repoRevToNameMaybe,

     

       4
       +
         fetchzip,

     

       5
       +
       }:

     

       6
        
       

     

       7
        
       lib.makeOverridable (

     

       8
        
         {

     

       9
        
           owner,

     

       10
        
           repo,

     

       11
        
           rev,

     

       12
       +
           name ? repoRevToNameMaybe repo rev "bitbucket",

     

       13
        
           ... # For hash agility

     

       14
        
         }@args:

     

       15
        
         fetchzip (

+8 -12

pkgs/build-support/fetchgit/default.nix

···

       5
        
         git-lfs,

     

       6
        
         cacert,

     

       7
        
       }:

     

       0
        
       
     

       8
        
       let

     

       9
        
         urlToName =

     

       10
        
           url: rev:

     

       11
        
           let

     

       12
       -
             inherit (lib) removeSuffix splitString last;

     

       13
       -
             base = last (splitString ":" (baseNameOf (removeSuffix "/" url)));

     

       14
       -
       

     

       15
       -
             matched = builtins.match "(.*)\\.git" base;

     

       16
       -
       

     

       17
       -
             short = builtins.substring 0 7 rev;

     

       18
       -
       

     

       19
       -
             appendShort = lib.optionalString ((builtins.match "[a-f0-9]*" rev) != null) "-${short}";

     

       20
        
           in

     

       21
       -
           "${if matched == null then base else builtins.head matched}${appendShort}";

     

       22
        
       in

     

       0
        
       
     

       23
        
       lib.makeOverridable (

     

       24
        
         lib.fetchers.withNormalizedHash { } (

     

       25
        
           # NOTE Please document parameter additions or changes in

     

       26
       -
           #   doc/build-helpers/fetchers.chapter.md

     

       27
        
           {

     

       28
        
             url,

     

       29
        
             tag ? null,

     

       30
        
             rev ? null,

     

       0
        
       
     

       31
        
             leaveDotGit ? deepClone || fetchTags,

     

       32
        
             outputHash ? lib.fakeHash,

     

       33
        
             outputHashAlgo ? null,

     
···

       36
        
             branchName ? null,

     

       37
        
             sparseCheckout ? [ ],

     

       38
        
             nonConeMode ? false,

     

       39
       -
             name ? null,

     

       40
        
             nativeBuildInputs ? [ ],

     

       41
        
             # Shell code executed before the file has been fetched.  This, in

     

       42
        
             # particular, can do things like set NIX_PREFETCH_GIT_CHECKOUT_HOOK to

     
···

       108
        
               "Please provide directories/patterns for sparse checkout as a list of strings. Passing a (multi-line) string is not supported any more."

     

       109
        
           else

     

       110
        
             stdenvNoCC.mkDerivation {

     

       111
       -
               name = if name != null then name else urlToName url revWithTag;

     

       112
        
       

     

       113
        
               builder = ./builder.sh;

     

       114
        
               fetcher = ./nix-prefetch-git;

···

       5
        
         git-lfs,

     

       6
        
         cacert,

     

       7
        
       }:

     

       8
       +
       

     

       9
        
       let

     

       10
        
         urlToName =

     

       11
        
           url: rev:

     

       12
        
           let

     

       13
       +
             shortRev = lib.sources.shortRev rev;

     

       14
       +
             appendShort = lib.optionalString ((builtins.match "[a-f0-9]*" rev) != null) "-${shortRev}";

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       15
        
           in

     

       16
       +
           "${lib.sources.urlToName url}${appendShort}";

     

       17
        
       in

     

       18
       +
       

     

       19
        
       lib.makeOverridable (

     

       20
        
         lib.fetchers.withNormalizedHash { } (

     

       21
        
           # NOTE Please document parameter additions or changes in

     

       22
       +
           #   ../../../doc/build-helpers/fetchers.chapter.md

     

       23
        
           {

     

       24
        
             url,

     

       25
        
             tag ? null,

     

       26
        
             rev ? null,

     

       27
       +
             name ? urlToName url (lib.revOrTag rev tag),

     

       28
        
             leaveDotGit ? deepClone || fetchTags,

     

       29
        
             outputHash ? lib.fakeHash,

     

       30
        
             outputHashAlgo ? null,

     
···

       33
        
             branchName ? null,

     

       34
        
             sparseCheckout ? [ ],

     

       35
        
             nonConeMode ? false,

     

       0
        
       
     

       36
        
             nativeBuildInputs ? [ ],

     

       37
        
             # Shell code executed before the file has been fetched.  This, in

     

       38
        
             # particular, can do things like set NIX_PREFETCH_GIT_CHECKOUT_HOOK to

     
···

       104
        
               "Please provide directories/patterns for sparse checkout as a list of strings. Passing a (multi-line) string is not supported any more."

     

       105
        
           else

     

       106
        
             stdenvNoCC.mkDerivation {

     

       107
       +
               inherit name;

     

       108
        
       

     

       109
        
               builder = ./builder.sh;

     

       110
        
               fetcher = ./nix-prefetch-git;

+2 -1

pkgs/build-support/fetchgithub/default.nix

···

       1
        
       {

     

       2
        
         lib,

     

       0
        
       
     

       3
        
         fetchgit,

     

       4
        
         fetchzip,

     

       5
        
       }:

     
···

       10
        
           repo,

     

       11
        
           tag ? null,

     

       12
        
           rev ? null,

     

       13
       -
           name ? "source",

     

       14
        
           fetchSubmodules ? false,

     

       15
        
           leaveDotGit ? null,

     

       16
        
           deepClone ? false,

···

       1
        
       {

     

       2
        
         lib,

     

       3
       +
         repoRevToNameMaybe,

     

       4
        
         fetchgit,

     

       5
        
         fetchzip,

     

       6
        
       }:

     
···

       11
        
           repo,

     

       12
        
           tag ? null,

     

       13
        
           rev ? null,

     

       14
       +
           name ? repoRevToNameMaybe repo (lib.revOrTag rev tag) "github",

     

       15
        
           fetchSubmodules ? false,

     

       16
        
           leaveDotGit ? null,

     

       17
        
           deepClone ? false,

+6 -2

pkgs/build-support/fetchgitiles/default.nix

···

       1
       -
       { fetchzip, lib }:

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       2
        
       

     

       3
        
       lib.makeOverridable (

     

       4
        
         {

     

       5
        
           url,

     

       6
        
           rev ? null,

     

       7
        
           tag ? null,

     

       8
       -
           name ? "source",

     

       9
        
           ...

     

       10
        
         }@args:

     

       11

···

       1
       +
       {

     

       2
       +
         fetchzip,

     

       3
       +
         repoRevToNameMaybe,

     

       4
       +
         lib,

     

       5
       +
       }:

     

       6
        
       

     

       7
        
       lib.makeOverridable (

     

       8
        
         {

     

       9
        
           url,

     

       10
        
           rev ? null,

     

       11
        
           tag ? null,

     

       12
       +
           name ? repoRevToNameMaybe url (lib.revOrTag rev tag) "gitiles",

     

       13
        
           ...

     

       14
        
         }@args:

     

       15

+2 -1

pkgs/build-support/fetchgitlab/default.nix

···

       1
        
       {

     

       2
        
         lib,

     

       0
        
       
     

       3
        
         fetchgit,

     

       4
        
         fetchzip,

     

       5
        
       }:

     
···

       11
        
           repo,

     

       12
        
           rev ? null,

     

       13
        
           tag ? null,

     

       0
        
       
     

       14
        
           protocol ? "https",

     

       15
        
           domain ? "gitlab.com",

     

       16
       -
           name ? "source",

     

       17
        
           group ? null,

     

       18
        
           fetchSubmodules ? false,

     

       19
        
           leaveDotGit ? false,

···

       1
        
       {

     

       2
        
         lib,

     

       3
       +
         repoRevToNameMaybe,

     

       4
        
         fetchgit,

     

       5
        
         fetchzip,

     

       6
        
       }:

     
···

       12
        
           repo,

     

       13
        
           rev ? null,

     

       14
        
           tag ? null,

     

       15
       +
           name ? repoRevToNameMaybe repo (lib.revOrTag rev tag) "gitlab",

     

       16
        
           protocol ? "https",

     

       17
        
           domain ? "gitlab.com",

     

       0
        
       
     

       18
        
           group ? null,

     

       19
        
           fetchSubmodules ? false,

     

       20
        
           leaveDotGit ? false,

+6 -2

pkgs/build-support/fetchrepoorcz/default.nix

···

       1
       -
       { fetchzip }:

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       2
        
       

     

       3
        
       # gitweb example, snapshot support is optional in gitweb

     

       4
        
       {

     

       5
        
         repo,

     

       6
        
         rev,

     

       7
       -
         name ? "source",

     

       8
        
         ... # For hash agility

     

       9
        
       }@args:

     

       10
        
       fetchzip (

···

       1
       +
       {

     

       2
       +
         lib,

     

       3
       +
         repoRevToNameMaybe,

     

       4
       +
         fetchzip,

     

       5
       +
       }:

     

       6
        
       

     

       7
        
       # gitweb example, snapshot support is optional in gitweb

     

       8
        
       {

     

       9
        
         repo,

     

       10
        
         rev,

     

       11
       +
         name ? repoRevToNameMaybe repo rev "repoorcz",

     

       12
        
         ... # For hash agility

     

       13
        
       }@args:

     

       14
        
       fetchzip (

+6 -2

pkgs/build-support/fetchsavannah/default.nix

···

       1
       -
       { fetchzip, lib }:

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       2
        
       

     

       3
        
       lib.makeOverridable (

     

       4
        
         # cgit example, snapshot support is optional in cgit

     

       5
        
         {

     

       6
        
           repo,

     

       7
        
           rev,

     

       8
       -
           name ? "source",

     

       9
        
           ... # For hash agility

     

       10
        
         }@args:

     

       11
        
         fetchzip (

···

       1
       +
       {

     

       2
       +
         lib,

     

       3
       +
         repoRevToNameMaybe,

     

       4
       +
         fetchzip,

     

       5
       +
       }:

     

       6
        
       

     

       7
        
       lib.makeOverridable (

     

       8
        
         # cgit example, snapshot support is optional in cgit

     

       9
        
         {

     

       10
        
           repo,

     

       11
        
           rev,

     

       12
       +
           name ? repoRevToNameMaybe repo rev "savannah",

     

       13
        
           ... # For hash agility

     

       14
        
         }@args:

     

       15
        
         fetchzip (

+3 -2

pkgs/build-support/fetchsourcehut/default.nix

···

       1
        
       {

     

       0
        
       
     

       0
        
       
     

       2
        
         fetchgit,

     

       3
        
         fetchhg,

     

       4
        
         fetchzip,

     

       5
       -
         lib,

     

       6
        
       }:

     

       7
        
       

     

       8
        
       let

     
···

       18
        
           owner,

     

       19
        
           repo,

     

       20
        
           rev,

     

       0
        
       
     

       21
        
           domain ? "sr.ht",

     

       22
        
           vc ? "git",

     

       23
       -
           name ? "source",

     

       24
        
           fetchSubmodules ? false,

     

       25
        
           ... # For hash agility

     

       26
        
         }@args:

···

       1
        
       {

     

       2
       +
         lib,

     

       3
       +
         repoRevToNameMaybe,

     

       4
        
         fetchgit,

     

       5
        
         fetchhg,

     

       6
        
         fetchzip,

     

       0
        
       
     

       7
        
       }:

     

       8
        
       

     

       9
        
       let

     
···

       19
        
           owner,

     

       20
        
           repo,

     

       21
        
           rev,

     

       22
       +
           name ? repoRevToNameMaybe repo rev "sourcehut",

     

       23
        
           domain ? "sr.ht",

     

       24
        
           vc ? "git",

     

       0
        
       
     

       25
        
           fetchSubmodules ? false,

     

       26
        
           ... # For hash agility

     

       27
        
         }@args:

+2 -1

pkgs/build-support/fetchzip/default.nix

···

       7
        
       

     

       8
        
       {

     

       9
        
         lib,

     

       0
        
       
     

       10
        
         fetchurl,

     

       11
        
         withUnzip ? true,

     

       12
        
         unzip,

     
···

       14
        
       }:

     

       15
        
       

     

       16
        
       {

     

       17
       -
         name ? "source",

     

       18
        
         url ? "",

     

       19
        
         urls ? [ ],

     

       0
        
       
     

       20
        
         nativeBuildInputs ? [ ],

     

       21
        
         postFetch ? "",

     

       22
        
         extraPostFetch ? "",

···

       7
        
       

     

       8
        
       {

     

       9
        
         lib,

     

       10
       +
         repoRevToNameMaybe,

     

       11
        
         fetchurl,

     

       12
        
         withUnzip ? true,

     

       13
        
         unzip,

     
···

       15
        
       }:

     

       16
        
       

     

       17
        
       {

     

       0
        
       
     

       18
        
         url ? "",

     

       19
        
         urls ? [ ],

     

       20
       +
         name ? repoRevToNameMaybe (if url != "" then url else builtins.head urls) null "unpacked",

     

       21
        
         nativeBuildInputs ? [ ],

     

       22
        
         postFetch ? "",

     

       23
        
         extraPostFetch ? "",

pkgs/top-level/all-packages.nix

···

       574
        
           stdenv = if stdenv.hostPlatform.isDarwin then llvmPackages_18.stdenv else stdenv;

     

       575
        
         };

     

       576
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       577
        
         fetchpatch =

     

       578
        
           callPackage ../build-support/fetchpatch {

     

       579
        
             # 0.3.4 would change hashes: https://github.com/NixOS/nixpkgs/issues/25154

···

       574
        
           stdenv = if stdenv.hostPlatform.isDarwin then llvmPackages_18.stdenv else stdenv;

     

       575
        
         };

     

       576
        
       

     

       577
       +
         # this is used by most `fetch*` functions

     

       578
       +
         repoRevToNameMaybe = lib.repoRevToName config.fetchedSourceNameDefault;

     

       579
       +
       

     

       580
        
         fetchpatch =

     

       581
        
           callPackage ../build-support/fetchpatch {

     

       582
        
             # 0.3.4 would change hashes: https://github.com/NixOS/nixpkgs/issues/25154

+46

pkgs/top-level/config.nix

···

       59
        
             default = false;

     

       60
        
           };

     

       61
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       62
        
           doCheckByDefault = mkMassRebuild {

     

       63
        
             feature = "run `checkPhase` by default";

     

       64
        
           };

···

       59
        
             default = false;

     

       60
        
           };

     

       61
        
       

     

       62
       +
           fetchedSourceNameDefault = mkOption {

     

       63
       +
             type = types.uniq (

     

       64
       +
               types.enum [

     

       65
       +
                 "source"

     

       66
       +
                 "versioned"

     

       67
       +
                 "full"

     

       68
       +
               ]

     

       69
       +
             );

     

       70
       +
             default = "source";

     

       71
       +
             description = ''

     

       72
       +
               This controls the default derivation `name` attribute set by the

     

       73
       +
               `fetch*` (`fetchzip`, `fetchFromGitHub`, etc) functions.

     

       74
       +
       

     

       75
       +
               Possible values and the resulting `.name`:

     

       76
       +
       

     

       77
       +
               - `"source"` -> `"source"`

     

       78
       +
               - `"versioned"` -> `"''${repo}-''${rev}-source"`

     

       79
       +
               - `"full"` -> `"''${repo}-''${rev}-''${fetcherName}-source"`

     

       80
       +
       

     

       81
       +
               The default `"source"` is the best choice for minimal rebuilds, it

     

       82
       +
               will ignore any non-hash changes (like branches being renamed, source

     

       83
       +
               URLs changing, etc) at the cost of `/nix/store` being easily

     

       84
       +
               cache-poisoned (see [NixOS/nix#969](https://github.com/NixOS/nix/issues/969)).

     

       85
       +
       

     

       86
       +
               Setting this to `"versioned"` greatly helps with discoverability of

     

       87
       +
               sources in `/nix/store` and makes cache-poisoning of `/nix/store` much

     

       88
       +
               harder, at the cost of a single mass-rebuild for all `src`

     

       89
       +
               derivations, and an occasional rebuild when a source changes some of

     

       90
       +
               its non-hash attributes.

     

       91
       +
       

     

       92
       +
               Setting this to `"full"` is similar to setting it to `"versioned"`,

     

       93
       +
               but the use of `fetcherName` in the derivation name will force a

     

       94
       +
               rebuild when `src` switches between `fetch*` functions, thus forcing

     

       95
       +
               `nix` to check new derivation's `outputHash`, which is useful for

     

       96
       +
               debugging.

     

       97
       +
       

     

       98
       +
               Also, `"full"` is useful for easy collection and tracking of

     

       99
       +
               statistics of where the packages you use are hosted.

     

       100
       +
       

     

       101
       +
               If you are a developer, you should probably set this to at

     

       102
       +
               least`"versioned"`.

     

       103
       +
       

     

       104
       +
               Changing the default will cause a mass rebuild.

     

       105
       +
             '';

     

       106
       +
           };

     

       107
       +
       

     

       108
        
           doCheckByDefault = mkMassRebuild {

     

       109
        
             feature = "run `checkPhase` by default";

     

       110
        
           };