beads/overlay.nix
Harry Miller 63bef27fe8
feat(nix): expose packages as an overlay for downstream override (#3910)
Restructure the nix packaging so downstream consumers can use the
standard `callPackage` `.override` pattern (e.g. swap vendorHash,
buildGoModule, or other inputs) and consume beads with their own
nixpkgs version:

  final: prev: {
    beads-unwrapped = prev.beads-unwrapped.override (prevArgs: {
      buildGoModule = args:
        prevArgs.buildGoModule (args // { vendorHash = "..."; });
    });
  }

Changes:
- Add overlay.nix exposing `beads-unwrapped` (the buildGoModule
  output) and `beads` (the wrapper with shell completions baked in
  plus per-shell completion passthru attrs).
- default.nix: drop the `self` flake-ref input and use `src = ./.;`
  so the package is consumable via the overlay outside the flake
  context.
- flake.nix: expose `overlays.default` and apply the overlay to the
  nixpkgs instance used for `packages` / `devShells`.
- packages.nix: thin wrapper that pulls outputs from the overlayed
  package set.
- nix-build CI: include overlay.nix and packages.nix in the path
  filter so overlay-only changes still trigger builds.

This is a focused overlay-only follow-up to #3422 against current
main (post-#3491). The ICU / version / env-var rearrangements from
the original PR are intentionally omitted because they no longer
apply: ICU is gone (`gms_pure_go`), `proxyVendor = true` is in
place, and the env plumbing has been reshaped upstream.

Co-authored-by: Dylan Johnston <dylan.johnston@cba.com.au>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: matt wilkie <maphew@gmail.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-07-06 22:39:37 -07:00

68 lines
2.5 KiB
Nix

# Curried on the flake's `self` so default.nix's `src = self;` keeps working
# outside the `pkgs.callPackage` auto-argument machinery (callPackage cannot
# supply a flake output on its own). flake.nix applies this as
# `import ./overlay.nix self`.
self: final: prev: {
# Unwrapped Go build of the bd binary. Exposed so downstream consumers can
# override inputs (vendorHash, buildGoModule, etc.) via the standard
# callPackage `.override` pattern, e.g.
#
# final: prev: {
# beads-unwrapped = prev.beads-unwrapped.override (prevArgs: {
# buildGoModule = args:
# prevArgs.buildGoModule (args // { vendorHash = "..."; });
# });
# }
beads-unwrapped = final.callPackage ./default.nix {
inherit self;
buildGoModule = final.buildGo126Module;
};
# Wrap the unwrapped binary with shell completions and a `beads` alias.
beads = final.stdenv.mkDerivation {
pname = "beads";
version = final.beads-unwrapped.version;
phases = [ "installPhase" ];
env.BD_DISABLE_METRICS = "1";
env.BD_DISABLE_EVENT_FLUSH = "1";
installPhase = ''
mkdir -p $out/bin
cp ${final.beads-unwrapped}/bin/bd $out/bin/bd
# Create 'beads' alias symlink
ln -s bd $out/bin/beads
# Generate shell completions
mkdir -p $out/share/fish/vendor_completions.d
mkdir -p $out/share/bash-completion/completions
mkdir -p $out/share/zsh/site-functions
$out/bin/bd completion fish > $out/share/fish/vendor_completions.d/bd.fish
$out/bin/bd completion bash > $out/share/bash-completion/completions/bd
$out/bin/bd completion zsh > $out/share/zsh/site-functions/_bd
'';
meta = final.beads-unwrapped.meta;
passthru = {
# Per-shell completion outputs for users who only want one shell.
fish-completions = final.runCommand "bd-fish-completions" { } ''
mkdir -p $out/share/fish/vendor_completions.d
ln -s ${final.beads}/share/fish/vendor_completions.d/bd.fish $out/share/fish/vendor_completions.d/bd.fish
'';
bash-completions = final.runCommand "bd-bash-completions" { } ''
mkdir -p $out/share/bash-completion/completions
ln -s ${final.beads}/share/bash-completion/completions/bd $out/share/bash-completion/completions/bd
'';
zsh-completions = final.runCommand "bd-zsh-completions" { } ''
mkdir -p $out/share/zsh/site-functions
ln -s ${final.beads}/share/zsh/site-functions/_bd $out/share/zsh/site-functions/_bd
'';
};
};
}