Skip to content

README.md

Latest commit

 

History

History
79 lines (58 loc) · 1.81 KB

README.md

File metadata and controls

79 lines (58 loc) · 1.81 KB
Raw

Pomni

Nix dependency locking and updating, inspired by Lon and tack.

Features

  • Management via CLI or hand-editable pomni.json file
  • Resolves tarball URLs and Git revisions via Codeberg/GitHub API
  • Supports pinning Git branches or Codeberg/GitHub releases

Usage

Description:
  Lock & update Nix dependencies

Usage:
  pomni [command] [options]

Options:
  -?, -h, --help  Show help and usage information
  --version       Show version information

Commands:
  init                                       Create Pomni files
  add <name> <Codeberg|GitHub> <repository>  Add a new pin
  update                                     Update pins to their latest commit or release
  modify <name>                              Modify an existing pin
  remove <name>                              Remove a pin
  bot <Codeberg|GitHub>                      Raise a pull request for pin updates

Getting the CLI

nix-build https://github.com/drakon64/Pomni/archive/refs/heads/main.zip
./result/bin/pomni

Adding a pin

pomni add nixpkgs github NixOS/nixpkgs --branch nixpkgs-unstable
pomni add lix github lix-project/lix # Uses the default branch of the repository
pomni add crane github ipetkov/crane --type release # Uses the latest GitHub release within the repository

pomni update # Required to sync `pomni.json` with `pomni.lock.json`

Updating pins

pomni update

Updating pins and raising a pull request via GitHub Actions

- run: pomni bot github
  env:
    BEARER_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Using from Nix

let
  pomni = import ./pomni;
in
let
  pkgs = import pomni.nixpkgs { };
  lix = import pomni.lix;
  crane = import pomni.crane;
in

License

EUPL v. 1.2 only.