commit a82c8611ce47491bd3f80e2219bfaab06d47ec2f · pyrox.dev/nixpkgs

+11 -1

doc/languages-frameworks/go.section.md

···

       20
       20
        
       

     

       21
       21
        
         To obtain the actual hash, set `vendorHash = lib.fakeSha256;` and run the build ([more details here](#sec-source-hashes)).

     

       22
       22
        
       - `proxyVendor`: Fetches (go mod download) and proxies the vendor directory. This is useful if your code depends on c code and go mod tidy does not include the needed sources to build or if any dependency has case-insensitive conflicts which will produce platform dependant `vendorHash` checksums.

     

       23
       23
       +
       - `modPostBuild`: Shell commands to run after the build of the go-modules executes `go mod vendor`, and before calculating fixed output derivation's `vendorHash` (or `vendorSha256`). Note that if you change this attribute, you need to update `vendorHash` (or `vendorSha256`) attribute.

     

       23
       24
        
       

     

       24
       25
        
       ```nix

     

       25
       26
        
       pet = buildGoModule rec {

     
···

       114
       115
        
       

     

       115
       116
        
       ## Attributes used by the builders {#ssec-go-common-attributes}

     

       116
       117
        
       

     

       117
       117
       -
       Both `buildGoModule` and `buildGoPackage` can be tweaked to behave slightly differently, if the following attributes are used:

     

       118
       118
       +
       Many attributes [controlling the build phase](#variables-controlling-the-build-phase) are respected by both `buildGoModule` and `buildGoPackage`. Note that `buildGoModule` reads the following attributes also when building the `vendor/` go-modules fixed output derivation as well:

     

       119
       119
       +
       

     

       120
       120
       +
       - [`sourceRoot`](#var-stdenv-sourceRoot)

     

       121
       121
       +
       - [`prePatch`](#var-stdenv-prePatch)

     

       122
       122
       +
       - [`patches`](#var-stdenv-patches)

     

       123
       123
       +
       - [`patchFlags`](#var-stdenv-patchFlags)

     

       124
       124
       +
       - [`postPatch`](#var-stdenv-postPatch)

     

       125
       125
       +
       - [`preBuild`](#var-stdenv-preBuild)

     

       126
       126
       +
       

     

       127
       127
       +
       In addition to the above attributes, and the many more variables respected also by `stdenv.mkDerivation`, both `buildGoModule` and `buildGoPackage` respect Go-specific attributes that tweak them to behave slightly differently:

     

       118
       128
        
       

     

       119
       129
        
       ### `ldflags` {#var-go-ldflags}

     

       120
       130

+5 -1

pkgs/build-support/go/module.nix

···

       83
       83
        
           inherit (args) src;

     

       84
       84
        
           inherit (go) GOOS GOARCH;

     

       85
       85
        
       

     

       86
       86
       +
           # The following inheritence behavior is not trivial to expect, and some may

     

       87
       87
       +
           # argue it's not ideal. Changing it may break vendor hashes in Nixpkgs and

     

       88
       88
       +
           # out in the wild. In anycase, it's documented in:

     

       89
       89
       +
           # doc/languages-frameworks/go.section.md

     

       86
       90
        
           prePatch = args.prePatch or "";

     

       87
       91
        
           patches = args.patches or [];

     

       88
       92
        
           patchFlags = args.patchFlags or [];

     

       89
       93
        
           postPatch = args.postPatch or "";

     

       90
       94
        
           preBuild = args.preBuild or "";

     

       91
       91
       -
           postBuild = args.postBuild or "";

     

       95
       95
       +
           postBuild = args.modPostBuild or "";

     

       92
       96
        
           sourceRoot = args.sourceRoot or "";

     

       93
       97
        
       

     

       94
       98
        
           GO111MODULE = "on";