1
0
Fork 0
mirror of https://github.com/nix-community/home-manager synced 2024-10-01 02:37:27 +02:00
home-manager/modules/programs/papis.nix
Emily 36a53d9f26 treewide: convert all option docs to Markdown
This process was automated by [my fork of `nix-doc-munge`]. All
conversions were automatically checked to produce the same DocBook
result when converted back, modulo minor typographical/formatting
differences on the acceptable-to-desirable spectrum.

To reproduce this commit, run:

  $ NIX_PATH=nixpkgs=flake:nixpkgs/e7e69199f0372364a6106a1e735f68604f4c5a25 \
    nix shell nixpkgs#coreutils \
    -c find . -name '*.nix' \
    -exec nix run -- github:emilazy/nix-doc-munge/98dadf1f77351c2ba5dcb709a2a171d655f15099 \
    {} +
  $ ./format

[my fork of `nix-doc-munge`]: https://github.com/emilazy/nix-doc-munge/tree/home-manager
2023-07-17 18:40:56 +01:00

92 lines
2.5 KiB
Nix

{ config, lib, pkgs, ... }:
with lib;
let
cfg = config.programs.papis;
defaultLibraries = remove null
(mapAttrsToList (n: v: if v.isDefault then n else null) cfg.libraries);
settingsIni = (lib.mapAttrs (n: v: v.settings) cfg.libraries) // {
settings = cfg.settings // { "default-library" = head defaultLibraries; };
};
in {
meta.maintainers = [ ];
options.programs.papis = {
enable = mkEnableOption (lib.mdDoc "papis");
settings = mkOption {
type = with types; attrsOf (oneOf [ bool int str ]);
default = { };
example = literalExpression ''
{
editor = "nvim";
file-browser = "ranger"
add-edit = true;
}
'';
description = lib.mdDoc ''
Configuration written to
{file}`$XDG_CONFIG_HOME/papis/config`. See
<https://papis.readthedocs.io/en/latest/configuration.html>
for supported values.
'';
};
libraries = mkOption {
type = types.attrsOf (types.submodule ({ config, name, ... }: {
options = {
name = mkOption {
type = types.str;
default = name;
readOnly = true;
description = lib.mdDoc "This library's name.";
};
isDefault = mkOption {
type = types.bool;
default = false;
example = true;
description = lib.mdDoc ''
Whether this is a default library. There must be exactly one
default library.
'';
};
settings = mkOption {
type = with types; attrsOf (oneOf [ bool int str ]);
default = { };
example = literalExpression ''
{
dir = "~/papers/";
}
'';
description = lib.mdDoc ''
Configuration for this library.
'';
};
};
}));
description = lib.mdDoc "Attribute set of papis libraries.";
};
};
config = mkIf cfg.enable {
assertions = [{
assertion = cfg.libraries == { } || length defaultLibraries == 1;
message = "Must have exactly one default papis library, but found "
+ toString (length defaultLibraries)
+ optionalString (length defaultLibraries > 1)
(", namely " + concatStringsSep "," defaultLibraries);
}];
home.packages = [ pkgs.papis ];
xdg.configFile."papis/config" =
mkIf (cfg.libraries != { }) { text = generators.toINI { } settingsIni; };
};
}