jenkinsPlugins2nix: Generate nix for Jenkins plugins.

[ bsd3, library, nix, program ] [ Propose Tags ]
Dependencies ansi‑wl‑pprint, attoparsec, base (>=4.7 && <5), bimap, bytestring, containers, cryptohash, hnix, http‑conduit, jenkinsPlugins2nix, mtl, optparse‑applicative, text, zip‑archive [details]
License BSD-3-Clause
Copyright 2017 Mateusz Kowalczyk
Author Mateusz Kowalczyk
Category Nix
Home page
Source repo head: git clone
Uploaded by MateuszKowalczyk at Sun May 28 17:09:49 UTC 2017
Distributions NixOS:
Executables jenkinsPlugins2nix
Downloads 672 total (13 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2017-05-28 [all 1 reports]
Hackage Matrix CI

Generate nix for Jenkins plugins.

[Skip to Readme]




Maintainer's Corner

For package maintainers and hackage trustees

Readme for jenkinsPlugins2nix-

[back to package description]


Usage: jenkinsPlugins2nix [-r|--dependency-resolution [as-given|latest]]
                          (-p|--plugin PLUGIN_NAME{:PLUGIN_VERSION})
  Generate nix expressions for requested Jenkins plugins.

Available options:
  -r,--dependency-resolution [as-given|latest]
                           Dependency resolution (default: latest)
                           Plugins we should generate nix for. Latest version is
                           used if not specified.
  -h,--help                Show this help text

Along with recent nixpkgs, you can then do the following.

jenkinsPlugins2nix -p github-api > plugins.nix

and in your configuration.nix:

services.jenkins.plugins = import plugins.nix { inherit (pkgs) fetchurl stdenv; };

Version specification

Care is taken to preserve versions of plugins explicitly specified by the user, even with the as-given resolution strategy. For example, if plugin A has a dependency B:0.2 in its manifest file and we specify:

jenkins2nix -r latest -p A:0.7 -p B:0.1

We will end up with A:0.7 and B:0.1. This also applies when no explicit version is provided which is equivalent to asking for the latest one.

In case we only ask for A, the version of B will depend on --resolution-strategy.